docs: versions/README 补失效链接类型对照表，记录 ai-coding 重叠保留决策

Author: Aparencia

docs/Foresight/2026-08-full-repo-optimization-plan.md

@@ -13,7 +13,7 @@
 
 | 阶段 | 状态 | 说明 |
 |------|------|------|
-| 任务一 D1-D6（docs 整理） | ✅ 全部完成 | 链接修复/索引补齐/过期更新/标准引用/重组/自动化（docs-check.mjs 已接入 lint-staged） |
+| 任务一 D1-D6（docs 整理） | ✅ 全部完成 | 链接修复/索引补齐/过期更新/标准引用/重组/自动化（docs-check.mjs 已接入 lint-staged + CI）；补充：versions/README 新增失效链接类型对照表（区分预期失效/误失效）；ai-coding.md 安全红线与 §4/§5 重叠经审计确认系有意保留（审查视角 vs 生成视角），维持现状 |
 | 任务二（docs-starter-kit） | ✅ 完成 | 根目录 `docs-starter-kit/` 纯净模板树（standards 20 + templates 12 + 各层 README + 启用指南） |
 | P0 C1-C7（安全与正确性） | ✅ 全部完成 | Feynman bug/Go panic 防护/依赖升级/lint-staged 修复/tier 核对/产物清理/安全日志 |
 | P1 D7-D14（开发者体验） | ✅ 全部完成 | 脚本补全/lint 158→0/静默 catch 95 处/环境变量/订阅收敛/工具统一/audit/postcss |

docs/versions/README.md

@@ -34,6 +34,18 @@
 - v0.3.0 ~ v0.11.0 的发版文档撰写于 docs 重组（10 目录 → 7 区块）之前，**内部链接指向已不存在的旧目录**（phase0~phase6、v0.X.0/ 合集目录等），部分链接失效；这些文档作为历史快照保留原貌，仅作追溯参考
 - v0.27.0 中 `./v1.0.0.md` 指向未沉淀的 v1.0.0 规划文档，属预期缺失
 
+### 失效链接类型对照（2026-08 体检核实）
+
+历史文档中的失效链接可归为三类，便于阅读时区分"预期失效"与"误失效"：
+
+| 类型 | 示例 | 处置 |
+|------|------|------|
+| 旧目录失效（phase0~phase6、vX.Y.0/ 合集） | `../../phase3/01-系统架构设计.md`、`../v0.7.0/01-版本迭代计划.md` | docs 重组前路径，内容已并入 standards/product/versions 新结构；**预期失效**，保留原貌 |
+| 根目录中文文档失效 | `../../需求池v1.0.md`、`../../ui设计规范.md`、`../../网课学习全链路痛点图谱v1.0.md` | 对应内容已迁移至 `docs/product/requirements-pool.md`、`docs/product/ui-ux-system.md`、`docs/product/pain-points.md`；**预期失效**（可按映射找到现文档） |
+| 工具产物引用 | v0.3.0 中 `../../../.qoder/specs/…` | 指向仓库外的代理工具产物，**不可用且无对应**；预期失效 |
+
+> 历史文档全部列入 `docs/.docscheckignore` 豁免清单，不纳入链接门禁；如需精确修复某一处，按上表映射到新路径即可。
+
 ## 沉淀规则
 
 - **何时沉淀**：版本含重大架构变更、多模块协同发版、或值得事后回顾的决策时，为版本撰写深度文档