M3详细设计：JavaScript热点模块内容治理扩面

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

设计目标

让 03JavaScript 成为 M2 之后的下一轮治理对象，继续沿用 Dao 的顺序推进：

先识别热点 -> 再确认子目录 -> 再设计 -> 再治理 -> 再校验 -> 再沉淀

为什么选择 03JavaScript

根据当前质量报告，03JavaScript 是下一顺位热点模块：

• 热点分数 187
• 缺少一级标题 50

它既比 00面试相关整理 的规模更可控，又足够说明治理方法能否跨模块复用，因此适合作为 M3。

业务流程

主流程

1. 读取当前质量报告
2. 分析 03JavaScript 内部子目录分布
3. 选择首个治理子目录
4. 判断是否可直接复用现有修复脚本
5. 执行治理
6. 运行 docs:sync
7. 运行 docs:check
8. 更新开发记录与开发笔记
9. 提交当前子任务

分支流程

如果首个治理对象仍然以“缺少一级标题”为唯一主要问题，则继续优先使用现有批量修复方式。

如果 JavaScript 模块出现更复杂的混合问题，则在 M3 内先收缩到最可控的一类问题，不强行同时解决多类问题。

异常流程

如果在执行治理后出现：

• 构建失败
• 质量回归
• 页面生成异常

则必须停留在当前子任务修复，直到重新通过。

结构设计

M3 继续沿用现有标准文档结构：

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

首个治理对象

M3 首个治理对象确定为：

03JavaScript/正则表达式

选择依据：

• 当前子目录缺少一级标题 9 篇
• 与 前端跨域 并列第一，但主题边界更收敛
• 目录结构集中，适合作为 JavaScript 模块的首轮治理样本
• 可直接复用现有 fix-missing-h1 脚本

模块边界

• 本轮只处理 03JavaScript
• 当前轮次只治理 正则表达式
• 优先处理最稳定可控的问题类型
• 本轮不把脚手架和治理系统再次扩写成更大改造

自测设计

本轮继续沿用三层自测：

1. 局部治理结果检查
2. npm run docs:sync
3. npm run docs:check

只有全部通过，当前子任务才算完成。