Skip to content

M14 详细设计:标题治理扩面与脚本复用继续推进

这份详细设计文档用于描述 M14 的核心设计:如何在资源问题已收口后,把治理重点切回标题缺失,并继续用子目录级方式推进跨模块扩面。

设计目标

M14 主要解决三个问题:

  • 如何选择最值得继续治理的标题缺失子目录
  • 如何继续复用现有 fix-missing-h1 脚本
  • 如何让治理页继续表达本轮范围与累计里程碑

一、治理对象选择设计

本轮选择:

  • 00面试相关整理/02HTTP
  • 09构建、运维、后端等/learn-webpack

原因:

  • 两个子目录都位于当前推荐子目录前列
  • 目录边界清晰,适合直接套用批量修复脚本
  • 一处属于面试知识体系,一处属于工程化知识体系,能继续验证跨模块复用

二、修复方式设计

本轮继续复用 scripts/fix-missing-h1.mjs

脚本行为保持不变:

  • 若文件已存在一级标题,则跳过
  • 若文件缺少一级标题,则按文件名推导标题
  • 若文件带 frontmatter,则在 frontmatter 后插入一级标题

同时新增脚本入口,便于后续把这两个范围作为独立治理动作反复执行。

三、治理配置设计

remediationConfigs 在 M14 中继续新增两条 missingTitle 配置,用于表达:

  • 当前本轮已治理范围
  • 累计治理清单
  • 治理里程碑视图

这样可以保持标题治理和资源治理使用同一套表达方式。

四、验收设计

本轮验收按下面顺序执行:

  1. 运行对应的标题修复脚本
  2. 运行 npm run docs:sync
  3. 运行 npm run build
  4. 运行 npm run docs:check
  5. 检查治理页中的 M14 范围是否归零

通过标准:

  • 构建成功
  • 巡检成功
  • 本轮治理范围中的标题缺失归零
  • missingTitleCount 较上一轮继续下降

共 20 个模块,1301 篇 Markdown 文档。