Skip to content

开发记录:VitePress 缺少一级标题治理试点与趋势增强

背景

M6 已经把治理推进到“能看见问题、能排序优先级、能阻止回归”的阶段,但治理如果一直停留在报表层,就还差最后一段:真实修复。

所以 M7 的重点,是做一次可复用的治理落地试点。

本轮改动

1. 新增缺少一级标题修复脚本

新增 scripts/fix-missing-h1.mjs,支持按目录批量补齐缺少一级标题的 Markdown 文档。

2. 选 07四艺 做试点模块

本轮选择 07四艺 作为试点,一次性补齐了 35 个缺少一级标题的文档。

3. 治理页增加趋势表达

治理页新增了相对基线的变化信息,开始可以直接看出某类问题是下降、持平还是回退。

4. 更新质量基线

在试点修复稳定通过后,把新的更优指标回写到基线文件,后续 docs:check 将基于更严格的新基线守门。

本轮价值

M7 的价值不在于一次性清理完所有问题,而在于证明:

  • 治理可以通过脚本批量落地
  • 治理结果可以被趋势视图直接感知
  • 更优结果可以回写成新的守门基线

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