M2详细设计：面试热点模块内容治理扩面

这份文档用于说明 M2 的详细设计。

设计目标

把 00面试相关整理 这个当前站点质量报告中的第一热点模块，拆成一个可以稳定治理的里程碑对象，并保证整轮工作继续遵循 Dao 的交付顺序：

先认出问题 -> 再明确路径 -> 再做治理 -> 再自测 -> 再沉淀

本轮设计重点不是“修得越多越好”，而是“用最清楚的边界跑通最完整的一轮”。

为什么选择 00面试相关整理

根据当前质量报告：

• 00面试相关整理 的热点分数最高，为 342
• 当前 missingTitleCount 贡献最高，为 86
• 它已经在既有治理里多次出现，说明这是一个持续性热点，而不是一次性异常

因此，M2 选它作为第一个真实业务里程碑对象，符合“先处理真正的复杂度中心”的 Dao 原则。

业务流程

主流程

1. 读取当前质量报告
2. 确认 00面试相关整理 为本轮热点模块
3. 统计模块内子目录问题分布
4. 选择一个最适合当前轮次的优先子目录
5. 判断该子目录是否适合继续使用现有批量修复脚本
6. 执行修复与必要的导航/治理配置更新
7. 运行 docs:sync
8. 运行 docs:check
9. 记录结果并完成当前子任务提交

分支流程

如果当前优先子目录满足“问题类型单一、以缺少一级标题为主”，则优先沿用现有 fix-missing-h1 脚本能力，避免在 M2 首轮引入过多新变量。

如果当前优先子目录同时存在占位文件、失效资源或多类问题混杂，则应先收缩范围，仅治理最可控的问题类型，确保本轮里程碑边界清楚。

异常流程

如果修复后出现以下任一情况，则不进入下一个子任务：

• docs:sync 失败
• docs:check 失败
• 页面生成异常
• 质量指标回归

处理方式：

1. 立即停止继续扩面
2. 回到当前子任务修复脚本、文档或配置
3. 重新执行构建和校验
4. 通过后再继续推进

结构设计

文档资产

M2 继续使用 M1 建立的标准文档组：

• 01-M2任务拆解-面试热点模块内容治理扩面.md
• 02-M2详细设计-面试热点模块内容治理扩面.md
• 03-M2开发记录-面试热点模块内容治理扩面.md
• 04-M2里程碑开发笔记-面试热点模块内容治理扩面.md

首个治理对象

M2 首个治理对象确定为：

00面试相关整理/2019高频知识点整理

选择依据：

• 当前子目录缺少一级标题数量最高，为 20
• 暂未混入占位文件与缺失资源问题
• 可直接复用当前 fix-missing-h1 能力
• 适合作为 M2 第一轮完整治理闭环

代码与配置资产

本轮可能涉及的资产包括：

• scripts/fix-missing-h1.mjs
• package.json
• scripts/docs-quality-baseline.json
• 被治理子目录下的 Markdown 文档

数据输入

本轮主要输入包括：

• docs-site/.vitepress/generated/quality-report.json
• 当前模块内真实 Markdown 文件分布
• 已有治理脚本和治理配置

数据输出

本轮预期输出包括：

• 一个明确治理完成的热点子目录
• 更新后的质量指标
• 更新后的 M2 开发记录和开发笔记

模块边界

本轮必须明确的边界

• 只优先治理 00面试相关整理
• 当前轮次只治理 2019高频知识点整理
• 优先处理最可控的问题类型
• 只补脚本入口，不重写底层修复脚本

本轮刻意不做的边界

• 不同时开启多个热点模块治理
• 不在 M2 第一轮里同时做站点治理视图重构
• 不把本轮变成“纯粹追数字下降”的无边界修复

首轮子任务建议

M2 的实际首个治理子任务为：

治理 00面试相关整理/2019高频知识点整理 中缺少一级标题的 20 篇文档。

执行方式：

• 在 package.json 增加专用脚本入口
• 执行批量修复
• 重新同步与校验
• 回写开发记录与开发笔记

自测设计

本轮自测继续分三层：

第一层：局部检查

• 当前治理子目录的改动文件是否正确
• 一级标题是否补齐
• 文件命名与链接是否仍可解析

第二层：站点同步检查

• 执行 npm run docs:sync
• 确认生成结果正常

第三层：质量与页面校验

• 执行 npm run docs:check
• 检查是否存在质量回归
• 检查目标页面是否可正常生成

只有三层都通过，当前子任务才算完成。