Mahiro-Blog 新手教程（六）：友链自动审核工作流实战

Mahiro-Blog 的一大亮点是友链自动审核：提交 PR 后，机器人自动检查并处理。对站长来说，这能大幅降低维护负担。

1. 相关工作流在哪

主要看这几个文件：

• .github/workflows/auto-pr.yml
• .github/workflows/auto-issue.yml
• .github/workflows/deploy.yml

它们共同构成“申请 → 审核 → 合并/部署”的链路。

2. 自动审核会检查什么

从规则设计上，通常包含：

• 文件路径是否合法（必须在指定目录）
• JSON 格式是否合法
• 网站可访问性
• 是否存在反链

这几条能过滤掉大多数无效申请。

3. 友链数据怎么组织最稳

建议保持“一个站点一个 JSON 文件”，并统一字段：

• name
• avatar
• description
• url
• backlink（可选）
• badge

统一结构能让自动化脚本简单且稳定。

4. 申请失败时怎么定位

按这个顺序看：

1. PR 检查日志第一条失败原因
2. JSON 字段是否缺失
3. 链接是否可访问
4. 反链地址是否正确

不要只看“失败”二字，要看 workflow 输出的具体错误项。

5. 如何优化审核体验

可以从三点入手：

1. 提供清晰的 PR 模板
2. 失败时给出可复制的修复示例
3. 通过标签区分“格式错误 / 访问失败 / 反链失败”

这样申请者更容易一次通过。

6. 新手维护建议

• 规则不要一次加太多
• 优先保证“误杀少”
• 每次调整 workflow 都先在测试分支演练

自动化系统的目标不是“严格”，而是“稳定可维护”。

系列导航

新手专栏目录入口