22 链接巡检与失效源自动告警
本章对应每周自动巡检工作流:.github/workflows/link-check.yml。
1) 目标
- 每周自动检查 Markdown 链接可达性。
- 检查失败时自动创建/更新同一条告警 Issue(避免噪音)。
- 支持手动触发(
workflow_dispatch)。
2) 设计原则
- 部署与巡检解耦:链接波动不应阻断生产部署。
- 告警去重:同标题 issue 复用,持续追加报告。
- 重试与超时:降低短时网络抖动导致的误报。
3) 默认扫描范围
README.mddocs/**/*.md
4) 调优建议
- 对高波动外链设置排除(
--exclude)。 - 分层策略:站内链接严格阻断,外链允许重试后告警。
- 将周检结果纳入维护月报(见
21-maintenance-playbook.md)。