M7 详细设计：缺少一级标题治理试点与趋势展示设计

这份详细设计文档用于描述 M7 的核心设计：如何在不破坏当前知识库生成结构的前提下，进行一次真实的标题治理试点，并把结果展示成趋势视图。

设计目标

M7 主要解决两个问题：

• 如何低风险地批量修复一类高频问题
• 如何把修复结果直接体现在治理视图里

一、自动修复脚本设计

1.1 脚本职责

新增 scripts/fix-missing-h1.mjs，职责是：

• 扫描目标目录下所有 Markdown 文件
• 判断首个有效内容是否已经是一级标题
• 若没有，则自动补一个 # 标题

1.2 标题推导规则

为了尽量保持低风险，本轮采用简单稳定的推导规则：

• 普通文件：使用文件名去扩展名后的内容
• index.md / README.md：使用所在目录名

1.3 frontmatter 兼容

若文件已有 frontmatter，则把自动补的一级标题插到 frontmatter 之后，而不是直接插到文件最顶部。

二、试点模块设计

2.1 为什么选 07四艺

07四艺 在当前治理热点里具备两个特点：

• 缺少一级标题问题较集中
• 模块整体体量可控，适合一次试点完成

2.2 本轮策略

本轮不追求“一次性清理所有热点模块”，而是先通过 07四艺 验证：

• 自动修复脚本是否可用
• 标题推导规则是否够稳
• 指标是否会真实下降

三、治理趋势展示设计

3.1 数据来源

治理趋势继续基于：

• 当前最新质量报告
• docs-quality-baseline.json

3.2 展示维度

治理页展示四类趋势：

• 占位/空文件
• 缺少一级标题
• 缺失资源引用
• 重复标题

并用“较基线上升 / 下降 / 持平”表达变化。

四、基线更新设计

4.1 基线更新时机

本轮在试点治理完成并自测通过后，更新基线文件到新的更优状态。

4.2 更新原则

只有在：

• 修复结果稳定
• 构建通过
• docs:check 通过

的前提下，才回写新基线。