Fork Friend-Circle-Lite 后我做了什么

真源 local/remote 开关 + 字段桥接#

原版把友链真源远程读取 json_url。我加了个 spider_settings.source 开关：

• local：真源在 FCL 仓库的 friends.json，Issue 申请通过后自动写回这里；
• remote：真源在外部博客的 /friends.json 端点，FCL 只巡检展示、不维护，对应 Issue 自助申请整套关闭。

同一份字段映射既管读取又管发布：我博客用 title/siteurl/imgurl，FCL 内部用 name/link/avatar，两边都不用迁就对方。配起来就是 conf.yaml 里这几行：

1
spider_settings:
2
  source: local
3
  list_key: "friends"
4
  friends_input:
5
    rename:
6
      name: "title"
7
      link: "siteurl"
8
      avatar: "imgurl"
9
      linkpage: ""
10
      verified: ""

值留空 "" 表示直接用 FCL 原生字段名，不做映射；填了就按外部端点字段名取/重命名。这样不同的端点字段名不一也能零改动适配。

反链检测：能认 JS 渲染的站了#

原版只在静态 HTML 里找你的域名。可部分网站的友链是客户端渲染的，静态 HTML 里根本没有友链列表，反链永远判「无」。我加了 Playwright 无头渲染兜底（backlink_headless），没装 playwright 时自动回退静态匹配、不阻断主流程，装了就用无头浏览器渲染后再判定。

可达性：国内探针 + verified 人工核验#

由于GitHub Actions服务器在美国，访问国内网站延迟会失真，于是我加了 eo_ping_url 国内延迟探针，额外测一个国内视角并自动取优显示；另加了 verified 人工核验标记（默认关），用于给个别网站添加白名单，避免反链误报反复打扰。

1
link_check:
2
  enable_backlink_check: true
3
  author_url: "x1anyu.cn"
4
  eo_ping_url: ""          # 留空则走仓库环境变量 EO_PING_URL
5
  backlink_headless: true  # 未装 playwright 自动跳过

主页截图会过期重拍#

postprocess.siteshot.refresh_days 控制截图有效期，图龄超过天数自动重新截：

1
postprocess:
2
  siteshot:
3
    enable: true
4
    upload_folder: "friends"
5
    max_workers: 2
6
    refresh_days: 7        # 7 天前的截图自动重拍；0 = 永久有效

自助申请友链 + 巡检回评#

apply-friend.yml 支持 Issue 形式的友链自助申请：访客提交 [友链申请] Issue → 工作流解析 → Playwright 验证可访问性 + 反链 → 通过即写回 friends.json，失败打 待更新 标签。

主流程里再用 github-script 做巡检回评：不可达或反链丢失就自动给对应申请 Issue 回评、打标签，恢复了再撤。verified 站点不会因反链误报被反复打扰。

后处理#

postprocess 拆成三段，开关集中在 conf.yaml，CI 只注入敏感信息与路径：

• geo_diagnose：不可达站点地域屏蔽二次诊断（含国内视角二次探测）；
• siteshot：截图回填 + 图床上传；
• alert：状态翻转告警，QQ 机器人经 blog-bot 转发消息

顺手补了 CNB 流水线#

加了一份 .cnb.yml（cnb.cool 的流水线），和 GitHub Actions 二选一，跑的是同一组命令。

5.1 FCL 仓库：GitHub Actions + Vercel#

流水线 .github/workflows/friend_circle_lite.yml 三个触发入口：每 4 小时定时（00 */4 * * *）、推 friends.json 到 main 自动巡检、workflow_dispatch 手动。步骤是：恢复 cache 分支缓存 → run.py 抓取检测 → postprocess all 后处理 → Issue 回评 → 组装静态产物强推 page 分支。并发做了串行化，避免定时 / 手动 / 截图 job 互相覆盖。

Vercel 这边 vercel.json 只一句，只从 page 分支部署：

1
{
2
  "git": { "branch": "page", "deploymentEnabled": { "main": false } }
3
}

缓存由根目录 _headers 控制（注意：Vercel 只读根 _headers，不读 static/edgeone.json，后者是死配置），给 index.html / all.json / link.json / errors.json / friends.json 设 no-cache，图片字体等长缓存。

需要在 FCL 仓库 Settings → Secrets and variables → Actions 里配的 Secrets：

conf.yaml 里凡标注「推荐走环境变量、配置留空」的项，就对应上面这些 Secrets；填了 Secrets 后 conf.yaml 里保持空串即可。

5.2 blog-bot：Cloudflare Worker#

非敏感变量写在 wrangler.toml 的 [vars] 里（随代码提交），敏感信息用 wrangler secret put 注入（不进仓库）：

1
wrangler secret put WX_TOKEN       # 企微回调 Token（只用企微才需要）
2
wrangler secret put WX_AESKEY      # 企微 EncodingAESKey
3
wrangler secret put WX_CORPID      # 企业 ID
4
wrangler secret put WX_SECRET      # 应用 Secret
5
wrangler secret put ALERT_TOKEN    # /api/alert 鉴权 token，须与 FCL 的 QQ_BOT_ALERT_TOKEN 一致
6
wrangler secret put GH_TOKEN       # GitHub PAT（repo 权限），写文章/动态/开友链 Issue 用
7
wrangler secret put QQ_PRIVATE_KEY  # QQ 机器人 Ed25519 私钥（只用 QQ 才需要）

wrangler.toml 里已固化的关键 [vars]：

KV（草稿 / access_token 缓存）和 R2（图床）在 wrangler.toml 以 binding 形式声明，不是 Secret。

自动触发#

手动触发（按需）#

进仓库 Actions → Friend Circle Lite → Run workflow，只有一个参数：

• target_link：填友链名称或 URL 关键词（多个用 | 或逗号分隔），只处理匹配的那几个；留空 = 按增量规则处理全部。改这个就能「只截某几个友链的图 / 只重测某几个」，不会把其他友链的数据冲掉。

自助申请#

在我博客友链页填表单 → 开 [友链申请] Issue → apply-friend.yml 解析并 Playwright 验证 → 通过写回 friends.json。失败会打 待更新 标签，修复后在 Issue 下回任意内容即可重验。