M15 详细设计:知识型目录标题治理与多层结构复用
这份详细设计文档用于描述 M15 的核心设计:如何把标题治理继续扩展到知识型目录,并验证多层级目录中的批量修复仍然稳定可用。
设计目标
M15 主要解决三个问题:
- 如何选择更偏知识卡片型的标题治理目录
- 如何在更深层目录结构中继续复用
fix-missing-h1 - 如何让治理页继续表达本轮累计推进结果
一、治理对象选择设计
本轮选择:
03JavaScript/JS API09构建、运维、后端等/Java学习
原因:
- 两个目录都处于当前推荐子目录前列
- 都包含大量知识点拆分文档,标题语义对阅读入口影响更明显
- 一个偏前端 API 知识卡片,一个偏课程式后端学习资料,适合继续验证跨模块通用性
二、修复方式设计
本轮继续复用 scripts/fix-missing-h1.mjs,不额外引入新的修复策略。
脚本在本轮中的价值主要是:
- 自动跳过已有一级标题的文件
- 以文件名快速补齐最基础的页面语义
- 继续保证治理动作可以重复执行
同时新增两个脚本入口,方便后续单独回放本轮修复动作。
三、治理配置设计
remediationConfigs 在 M15 中继续新增两条 missingTitle 配置,用于:
- 表达本轮已治理范围
- 更新累计治理清单
- 更新治理里程碑视图
这样可以继续维持从 M7 到 M15 的统一治理表达。
四、验收设计
本轮验收按下面顺序执行:
- 运行对应标题修复命令
- 运行
npm run docs:sync - 运行
npm run build - 运行
npm run docs:check - 检查治理页中 M15 范围是否归零
通过标准:
- 构建成功
- 巡检成功
- 本轮治理范围中的标题缺失归零
missingTitleCount较上一轮继续下降
