Skip to content

M15 详细设计:知识型目录标题治理与多层结构复用

这份详细设计文档用于描述 M15 的核心设计:如何把标题治理继续扩展到知识型目录,并验证多层级目录中的批量修复仍然稳定可用。

设计目标

M15 主要解决三个问题:

  • 如何选择更偏知识卡片型的标题治理目录
  • 如何在更深层目录结构中继续复用 fix-missing-h1
  • 如何让治理页继续表达本轮累计推进结果

一、治理对象选择设计

本轮选择:

  • 03JavaScript/JS API
  • 09构建、运维、后端等/Java学习

原因:

  • 两个目录都处于当前推荐子目录前列
  • 都包含大量知识点拆分文档,标题语义对阅读入口影响更明显
  • 一个偏前端 API 知识卡片,一个偏课程式后端学习资料,适合继续验证跨模块通用性

二、修复方式设计

本轮继续复用 scripts/fix-missing-h1.mjs,不额外引入新的修复策略。

脚本在本轮中的价值主要是:

  • 自动跳过已有一级标题的文件
  • 以文件名快速补齐最基础的页面语义
  • 继续保证治理动作可以重复执行

同时新增两个脚本入口,方便后续单独回放本轮修复动作。

三、治理配置设计

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

  • 表达本轮已治理范围
  • 更新累计治理清单
  • 更新治理里程碑视图

这样可以继续维持从 M7 到 M15 的统一治理表达。

四、验收设计

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

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

通过标准:

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

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