#3603 的门禁半件有两层：judgeHref() 解析站内绝对 URL（第 2 层）与 SCAN_ROOTS 追加包 README（第 1 层）。第 2 层已由 PR #3629 落地并测量为零死链 ；第 1 层没有落地 ，本 issue 是它的入场价。
原因就是 scripts/check-doc-links.mjs 头注释自 #3572 起写死的规矩：先量扫描面，单独付清红账，再加那一行 （"measure the surface first, pay its backlog separately, then add the row"）——对照 #3479 （16 个死目标）与 #3490 （18 个）那种「门禁与欠账同时到货」。PR #3629 已把下面这份测量结果写进头注释的 "Measured and NOT bought" 一节，避免下一个人不量就加行。
实测：加上那一行会红 11 条，且都不在 #3603 的 9 条里
在 #3603 内容半件已清干净（那 9 条全部改指真实页或删除）之后，对 origin/main + 第 2 层解析 + 一条 disk 规则的包 README 扫描根实测：
位置
链接
为什么死
packages/components/README.md:30../../docs/SHADCN_SYNC.md磁盘路径，docs/ 下只有 ARCHITECTURE.md / CONSOLE-STREAMLINING-SUMMARY.md / adr / audits / screenshots，没有这个文件
packages/components/README.md:212https://objectui.org/api/components/api/components 不是站点路由（apps/site/app/api 下只有 search/route.ts）
packages/core/README.md:144https://objectui.org/api/core同上，/api/core 无路由
packages/core/README.md:158https://www.objectui.org/docs/corecontent/docs/core/ 是真目录但没有 index 页 ，fumadocs 不为它生成路由
packages/fields/README.md:131https://www.objectui.org/docs/fields同上，content/docs/fields/ 无 index
packages/layout/README.md:122https://www.objectui.org/docs/layout同上，content/docs/layout/ 无 index
packages/layout/README.md:137https://www.objectui.org/docs/layout同一目标，同一页第二处
packages/react/README.md:228https://objectui.org/api/react/api/react 无路由（#3490 清过同款 17 条中的一条）
packages/types/README.md:329https://objectui.org/docs/typescontent/docs/types 完全不存在
packages/vscode-extension/README.md:190https://www.objectui.org/examples/examples 不是站点路由（#3490 已确认）
packages/vscode-extension/README.md:242./LICENSE磁盘路径，packages/vscode-extension/ 下没有 LICENSE 文件
涉及 5 个 #3603 从未触及的包（components / core / fields / layout / types），外加 react、vscode-extension 各一条不同的行 。
值得单独点名：#3603 正文的复核脚本漏计了 3 条
/docs/core、/docs/fields、/docs/layout 在 #3603 的复核脚本下是绿 的，因为那段脚本把裸目录 也算作 fumadocs 候选——候选数组的最后一项就是 rel 本身（目录），排在四种文件拼写之后。
门禁不这么算，而且它是对的：routeCandidates() 只有 .md / .mdx / index.md / index.mdx 四种拼写，且既有 pin 测试 rejects a relative link to a directory that has no index page 就是这条规则。实测 content/docs/ 下 core / fields / layout / rfcs 四个目录确实没有 index 页，api / blocks / components / guide / plugins / utilities 有。所以 /docs/core 真的 404。
结论：这一类的真实规模是 20 条 （#3603 的 9 + 本单的 11），不是 9 条。
完成范围
逐条处置上表 11 条（查到真实页 → 改指；查不到 → 删该行，同 packages/*/README.md 里还有 9 条 404 的站内文档链接,且链接门禁有两层原因永远看不见它们 #3603 /docs/core、/docs/fields、/docs/layout 这三条另有一种更好的解法值得考虑：给这三个目录补 index 页 ，那样这些链接原地就活了（见下方「顺带」）。
红账清零后，SCAN_ROOTS 追加一行（38 个包 README 全在内），沿用 disk 规则。⚠️ 注意：该 glob 里的星号加斜杠会提前闭合 check-doc-links.mjs 的块注释，头注释里只能用散文描述，不能原样写出来（PR fix(docs,scripts): 清掉 9 条包 README 死链,并让链接门禁认站内绝对 URL (#3603) #3629
disk vs docs 规则的理由要写进头注释./CHANGELOG.md、./LICENSE），不是 content/docs 的路由语义——与 examples/**、README.md、CONTRIBUTING.md、ROADMAP.md、docs/** 同类，无需新规则类。测试：SCAN_ROOTS 的 toEqual pin 会响，按新表扩写；新根加 count 下限（反空绿）。
顺带（不在本单完成范围，供分诊判断是否另开）
content/docs/ 下 core / fields / layout / rfcs 四个目录没有 index 页，意味着侧边栏里这四个分组的标题本身不可点。补 index 页会同时修好本单的 4 条链接，属另一件事。
另有一件相邻的内容欠账：#3603 的 7 个包（auth / collaboration / i18n / mobile / permissions / providers / react）共同假设了一个不存在的 /docs/packages/PKG 命名空间，PR #3629 只能删链接止血，因为这些包根本没有文档页 。把它们写出来是另一件事。
Depends-on: 本单红账清零是 #3603 门禁第 1 层落地的前置条件。
#3603 的门禁半件有两层：
judgeHref()解析站内绝对 URL（第 2 层）与SCAN_ROOTS追加包 README（第 1 层）。第 2 层已由 PR #3629 落地并测量为零死链；第 1 层没有落地，本 issue 是它的入场价。原因就是
scripts/check-doc-links.mjs头注释自 #3572 起写死的规矩：先量扫描面，单独付清红账，再加那一行（"measure the surface first, pay its backlog separately, then add the row"）——对照 #3479（16 个死目标）与 #3490（18 个）那种「门禁与欠账同时到货」。PR #3629 已把下面这份测量结果写进头注释的 "Measured and NOT bought" 一节，避免下一个人不量就加行。实测：加上那一行会红 11 条，且都不在 #3603 的 9 条里
在 #3603 内容半件已清干净（那 9 条全部改指真实页或删除）之后，对
origin/main+ 第 2 层解析 + 一条disk规则的包 README 扫描根实测：packages/components/README.md:30../../docs/SHADCN_SYNC.mddocs/下只有ARCHITECTURE.md/CONSOLE-STREAMLINING-SUMMARY.md/adr/audits/screenshots，没有这个文件packages/components/README.md:212https://objectui.org/api/components/api/components不是站点路由（apps/site/app/api下只有search/route.ts）packages/core/README.md:144https://objectui.org/api/core/api/core无路由packages/core/README.md:158https://www.objectui.org/docs/corecontent/docs/core/是真目录但没有 index 页，fumadocs 不为它生成路由packages/fields/README.md:131https://www.objectui.org/docs/fieldscontent/docs/fields/无 indexpackages/layout/README.md:122https://www.objectui.org/docs/layoutcontent/docs/layout/无 indexpackages/layout/README.md:137https://www.objectui.org/docs/layoutpackages/react/README.md:228https://objectui.org/api/react/api/react无路由（#3490 清过同款 17 条中的一条）packages/types/README.md:329https://objectui.org/docs/typescontent/docs/types完全不存在packages/vscode-extension/README.md:190https://www.objectui.org/examples/examples不是站点路由（#3490 已确认）packages/vscode-extension/README.md:242./LICENSEpackages/vscode-extension/下没有 LICENSE 文件涉及 5 个 #3603 从未触及的包（components / core / fields / layout / types），外加 react、vscode-extension 各一条不同的行。
值得单独点名：#3603 正文的复核脚本漏计了 3 条
/docs/core、/docs/fields、/docs/layout在 #3603 的复核脚本下是绿的，因为那段脚本把裸目录也算作 fumadocs 候选——候选数组的最后一项就是rel本身（目录），排在四种文件拼写之后。门禁不这么算，而且它是对的：
routeCandidates()只有.md/.mdx/index.md/index.mdx四种拼写，且既有 pin 测试rejects a relative link to a directory that has no index page就是这条规则。实测content/docs/下core/fields/layout/rfcs四个目录确实没有 index 页，api/blocks/components/guide/plugins/utilities有。所以/docs/core真的 404。结论：这一类的真实规模是 20 条（#3603 的 9 + 本单的 11），不是 9 条。
完成范围
/docs/core、/docs/fields、/docs/layout这三条另有一种更好的解法值得考虑：给这三个目录补 index 页，那样这些链接原地就活了（见下方「顺带」）。SCAN_ROOTS追加一行（38 个包 README 全在内），沿用disk规则。check-doc-links.mjs的块注释，头注释里只能用散文描述，不能原样写出来（PR fix(docs,scripts): 清掉 9 条包 README 死链,并让链接门禁认站内绝对 URL (#3603) #3629 踩过一次）。diskvsdocs规则的理由要写进头注释：包 README 在 npm 与 GitHub 上被阅读，其相对链接是磁盘路径语义（./CHANGELOG.md、./LICENSE），不是content/docs的路由语义——与examples/**、README.md、CONTRIBUTING.md、ROADMAP.md、docs/**同类，无需新规则类。SCAN_ROOTS的toEqualpin 会响，按新表扩写；新根加 count 下限（反空绿）。顺带（不在本单完成范围，供分诊判断是否另开）
content/docs/下core/fields/layout/rfcs四个目录没有 index 页，意味着侧边栏里这四个分组的标题本身不可点。补 index 页会同时修好本单的 4 条链接，属另一件事。另有一件相邻的内容欠账：#3603 的 7 个包（auth / collaboration / i18n / mobile / permissions / providers / react）共同假设了一个不存在的
/docs/packages/PKG命名空间，PR #3629 只能删链接止血，因为这些包根本没有文档页。把它们写出来是另一件事。Depends-on: 本单红账清零是 #3603 门禁第 1 层落地的前置条件。