This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 4, 2026. It is now read-only.
check-doc-links 扫描面第三扩:CONTRIBUTING.md + ROADMAP.md + docs/**(实测 70 链接、今日零死链、纯配置三行) #3572
Description
PM 立单(#3545 的 step 2 —— 该单随 PR #3571 关闭,step 2 依分诊座位"ship step 1 alone and re-file step 2"的建议重新安家)。查重:承接 #3545 线程,无其它同源单。
内容
scripts/check-doc-links.mjs 的 SCAN_ROOTS 表(#3542 起为数据表)追加三行:
{ path: 'CONTRIBUTING.md', rule: 'disk' },
{ path: 'ROADMAP.md', rule: 'disk' },
{ path: 'docs', rule: 'disk' },为什么现在是纯收益(#3571 的实测,不是猜测)
- 三面合计 70 条链接 / 52 条可判定;
docs/**(15 文件 49 链接)今日零死链(分诊座位曾警告这一面从未量过 —— 现在量了); - CONTRIBUTING/ROADMAP 的三条死链已由 PR docs: 修正 CONTRIBUTING.md / ROADMAP.md 的 3 条死链 #3571 修掉 —— 扩展落地时零清理清单(对比 content/docs 有 16 个失效的相对链接,且 check-doc-links.mjs 对相对链接一律放行 #3479 带 16 处、content/docs 有 18 条链接在站上是 404,但 check-doc-links 按设计放行(1 条相对链接跑出 docs collection + 17 条 /spec /protocol /api /examples 绝对链接) #3490 带 18 处的入场费);
- 这两文件正是 CONTRIBUTING.md / ROADMAP.md 共 3 条死链:处在 check-doc-links 与 lychee 的双重扫描盲区 #3545 三条死链能积攒的原因:两个检查器盲区的交集,不扩就会再积。
验收
- 沿用 feat(scripts): check-doc-links 两向扩展 —— 扫描面扩到 examples/** 与根 README,自仓 GitHub URL 离线校验 #3542 的 fixture 风格补 reject/accept 用例(disk 规则已存在,新根不需要新规则类);
- 真仓跑:预告零红并确认(docs: 修正 CONTRIBUTING.md / ROADMAP.md 的 3 条死链 #3571 合并后);
- 逆向:临时植入一条 CONTRIBUTING 死链,
contributing(或既有example-relative)reason 正确拒绝; - 已知边界如实写进头注释:围栏内代码(stripCode 抹掉)里的链接不在覆盖面(CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 的三条死"正确示例"即此类,修它是 CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 的事,不是本单的)。
Blocked-by: #3571
关联:#3545 / PR #3571(step 1 + 成本实测)、#3536 / PR #3542(SCAN_ROOTS 数据表)、#3570(围栏盲区实例)。
Activity
yinlianghui commentedon Aug 7, 2026
解锁 + 认领 — Blocked-by PR #3571 已落 main(d126607),blocked 摘除。会话
session_01GTRjn8xBqp75dk7kFupVRt,分支claude/issue-3572-scan-roots-third-ext。按正文执行:SCAN_ROOTS 三行 + fixture 用例 + 真仓零红预告确认 + 逆向植入验证 + 头注释如实写围栏盲区边界。文件面:⚠️ 与 #3570(改 CONTRIBUTING.md 内容)同批在飞 —— 本单只改检查器,不碰 CONTRIBUTING.md;若真仓跑出 CONTRIBUTING 新红恰是 #3570 要修的三条死"示例",报告不修(它们在代码围栏内,stripCode 抹掉,理论上扫不到 —— 若扫到了说明实现有误,回头查)。越界即停。
scripts/check-doc-links.mjs、scripts/__tests__/check-doc-links.test.ts。Generated by Claude Code
yinlianghui commentedon Aug 7, 2026
验收:ACCEPT — PR #3589。
核过 GitHub 实物(3 文件恰在围栏,ci-cd-pipeline.md 为披露过的最小事实修正)。裁定要点:
fail: true且根本没有 PR 触发器 #3587(检查器 prose 把 lychee 机制写反的两处旧址)已核存在 —— 与 CONTRIBUTING.md 的 Documentation 一节有两处与仓库现状不符:门禁描述指错工具/触发条件,"✅ 正确链接示例" 里 3 条路由是死的 #3570 dev 纠正过的我派单同款错误,现在有了自己的单;PR 转 ready + auto-merge。
Generated by Claude Code
docs(contributing): 按现状改写链接门禁分工,换掉三条死的"正确示例"路由 (objectstack-ai#3570) (o…
docs(contributing): 按现状改写文档目录说明,站点源是 content/docs/ (objectstack-ai#3584…
feat(scripts): check-doc-links 扫描面第三扩 CONTRIBUTING/ROADMAP/docs (obje…