M14 详细设计:标题治理扩面与脚本复用继续推进
这份详细设计文档用于描述 M14 的核心设计:如何在资源问题已收口后,把治理重点切回标题缺失,并继续用子目录级方式推进跨模块扩面。
设计目标
M14 主要解决三个问题:
- 如何选择最值得继续治理的标题缺失子目录
- 如何继续复用现有
fix-missing-h1脚本 - 如何让治理页继续表达本轮范围与累计里程碑
一、治理对象选择设计
本轮选择:
00面试相关整理/02HTTP09构建、运维、后端等/learn-webpack
原因:
- 两个子目录都位于当前推荐子目录前列
- 目录边界清晰,适合直接套用批量修复脚本
- 一处属于面试知识体系,一处属于工程化知识体系,能继续验证跨模块复用
二、修复方式设计
本轮继续复用 scripts/fix-missing-h1.mjs。
脚本行为保持不变:
- 若文件已存在一级标题,则跳过
- 若文件缺少一级标题,则按文件名推导标题
- 若文件带 frontmatter,则在 frontmatter 后插入一级标题
同时新增脚本入口,便于后续把这两个范围作为独立治理动作反复执行。
三、治理配置设计
remediationConfigs 在 M14 中继续新增两条 missingTitle 配置,用于表达:
- 当前本轮已治理范围
- 累计治理清单
- 治理里程碑视图
这样可以保持标题治理和资源治理使用同一套表达方式。
四、验收设计
本轮验收按下面顺序执行:
- 运行对应的标题修复脚本
- 运行
npm run docs:sync - 运行
npm run build - 运行
npm run docs:check - 检查治理页中的 M14 范围是否归零
通过标准:
- 构建成功
- 巡检成功
- 本轮治理范围中的标题缺失归零
missingTitleCount较上一轮继续下降
