666svip.cn 友链内嵌与接入规范 (Skill)

1. 核心引用地址 (Core URLs)

主站域名为 666svip.cn，提供以下标准化资源：

资源类型	线上完整地址 (生产环境)	说明
独立卡片 HTML	`https://666svip.cn/friends-card.html`	自包含苹果风卡片，供 iframe 直接内嵌
纯数据 JSON	`https://666svip.cn/friends.json`	纯友链数据源，供外部 API / fetch 自定义开发
在线文档 Skill	`https://666svip.cn/666svip_cn.html`	本规范文档说明页

2. 方式一：纯 JSON 数据源接入

若不便嵌入 iframe 或需要深度自定义卡片外观，可直接请求 friends.json：

2.1 数据字段说明

字段	类型	说明
`id`	string	站点唯一标识（如 `666svip`, `xtools`）
`name`	string	站点名称
`domain`	string	站点域名（如 `666svip.cn`）
`url`	string	跳转完整 URL
`desc`	string	站点描述与特色
`cta`	string	按钮引导文字（如 `访问官网 →`）
`type`	string	分类风格标识
`isComing`	boolean	是否建设中（`true` 表示敬请期待）
`iconSvg`	string	矢量 SVG 图标代码

2.2 JavaScript 调用示例

// 获取友链并过滤排除自身域名
async function getFriends() {
  const res = await fetch('https://666svip.cn/friends.json');
  const list = await res.json();
  
  // 排除当前嵌入方的域名
  const myDomain = 'xtools.666svip.cn';
  return list.filter(item => item.domain !== myDomain);
}

3. 方式二：HTML 卡片 URL 入参规范 (iframe)

通过 iframe 引入 friends-card.html 时支持参数自定义：

参数名	别名	类型	说明与示例	默认值
`exclude`	`excludes`	字符串	排除站点，支持多个逗号分隔。如 `exclude=666svip.cn`	无（展示全部）
`theme`	-	字符串	主题模式：`auto` / `light` / `dark`	`auto`
`primary`	`accent`	颜色	强调色，如 `primary=6a5cff`、`primary=%230070f3`	`#6a5cff`
`bg`	`background`	颜色	页面背景，对应 `var(--card-bg-page)`，默认全透明；如需实体底色可传入 `bg=ffffff`	`transparent` (默认全透明)
`card_bg`	`surface`	颜色	卡片底色，如 `card_bg=ffffff`	浅白 / 深夜黑
`text`	`textColor`	颜色	主文字颜色	自适应文本色
`muted`	`mutedColor`	颜色	副标题与描述颜色	自适应灰度色
`border`	`borderColor`	颜色	边框颜色	半透明细边框
`radius`	-	尺寸	卡片圆角，如 `radius=16px`	`26px`
`cols`	`columns`	数字	网格列数，如 `cols=3`	智能自适应网格
`target`	-	字符串	打开方式：`_blank` / `_self`	`_blank`

局部覆盖规则：页面背景默认全透明（var(--card-bg-page): transparent），无缝融入任何宿主页面。传入任意参数仅覆盖所传属性，其余样式继续保持默认。

4. 收录站点与排除标识一览

ID	站点名称	域名 (用于 exclude)	目标链接
`666svip`	放飞梦想的风筝官网	`666svip.cn`	https://666svip.cn
`xtools`	localBox工具箱	`xtools.666svip.cn`	https://xtools.666svip.cn
`ssh`	sshweb工具	`ssh.666svip.cn`	https://ssh.666svip.cn
`java`	Java学习站	`java.666svip.cn`	https://java.666svip.cn
`linux`	Linux运维学习	`linux.666svip.cn`	https://linux.666svip.cn
`shop`	淘宝天猫优惠券	`shop.666svip.cn`	https://shop.666svip.cn
`jd`	京东优惠券	`jd.666svip.cn`	https://jd.666svip.cn
`go`	互传	`go.666svip.cn`	https://go.666svip.cn
`docker`	Docker 镜像仓库	`dockerImage.666svip.cn`	https://dockerImage.666svip.cn
`k8s`	easy-linux 运维面板	`k8s.666svip.cn`	https://k8s.666svip.cn

5. 标准嵌入代码范例

推荐采用具有高度自适应监听的代码片段：

<!-- 1. iframe 容器 -->
<iframe
  id="friends-card-frame"
  src="https://666svip.cn/friends-card.html?exclude=xtools.666svip.cn&bg=transparent"
  title="友情链接"
  frameborder="0"
  allowtransparency="true"
  style="width: 100%; border: none; min-height: 480px; display: block; overflow: hidden; background: transparent;"
  scrolling="no"
  loading="lazy"
></iframe>

<!-- 2. postMessage 高度自适应脚本 -->
<script>
  window.addEventListener("message", function (event) {
    if (event.data && event.data.type === "666svip-friends-height") {
      var iframe = document.getElementById("friends-card-frame");
      if (iframe && event.data.height) {
        iframe.style.height = event.data.height + "px";
      }
    }
  });
</script>