Skip to content

开发记录:VitePress 标题治理扩面与热点子目录再推进

背景

M13 之后,资源问题已经收口,治理重点自然回到标题缺失。

M14 的目标,是继续沿用子目录级方式推进标题治理,并在热点列表中再拿下两块更有代表性的目录。

开发顺序

本轮按下面顺序推进:

  1. 先确认当前推荐子目录中的热点范围。
  2. 再为本轮对象补充脚本入口和治理配置。
  3. 然后执行标题批量修复。
  4. 接着生成新治理页并检查本轮范围结果。
  5. 最后执行构建与巡检自测,并回写新基线。

本轮改动

1. 新增两条标题治理范围

本轮把下面两个子目录纳入 M14:

  • 00面试相关整理/02HTTP
  • 09构建、运维、后端等/learn-webpack

2. 继续复用批量修复脚本

本轮没有引入新的修复逻辑,而是继续复用 fix-missing-h1,验证已有脚本在热点目录里仍然稳定可用。

3. 新增脚本入口

为 M14 对象补充独立脚本入口,让这轮治理动作更容易回放和复查。

4. 回写质量基线

在修复完成并通过自测后,把新的标题缺失结果回写为基线,为下一轮继续扩面提供新起点。

自测记录

本轮自测执行:

  • npm run docs:fix-h1:http
  • npm run docs:fix-h1:webpack
  • npm run docs:check

通过标准:

  • 构建通过
  • 巡检通过
  • 本轮治理范围中的标题缺失归零

结果

M14 完成后,自测结果为:

  • Markdown 文档:1209
  • 占位/空文件:25
  • 缺少一级标题:364
  • 缺失资源引用:0
  • 重复标题:38

标题治理在热点子目录上继续扩面,治理节奏从资源问题收口重新切回标题修复主线,并保持了跨模块复用能力。

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