技术博客：VitePress 知识站如何把治理从“看见问题”推进到“阻止回归”

只有问题列表，还不算治理闭环

很多项目在加上巡检之后，会觉得治理已经开始了。

但如果只有“问题列表”，通常还差两步：

• 不知道先修哪里
• 也不知道下一次是否又变差了

所以真正的治理闭环，至少应该具备：

• 问题可见
• 优先级可判断
• 回归可阻止

为什么要做模块级热点排序

单个问题列表适合看细节，但不适合做优先级。

把问题聚合到模块维度后，维护者就可以快速判断：

• 哪个模块的问题密度最高
• 哪个模块最值得先投入治理时间

这会让治理工作从“随机修”变成“有顺序地修”。

质量基线的意义，不是追求零问题，而是防止退步

对这种历史资料型仓库来说，短期内很难一下把所有问题都清零。

所以更现实的做法是先建立基线：

• 今天有哪些问题
• 数量大概是多少
• 明天不要比今天更多

这就是为什么基线文件很重要。它不是完美主义工具，而是稳定演进工具。

docs:check 真正有价值的地方

当 docs:check 开始和基线比较后，它就从“报告工具”变成了“守门工具”。

它的意义不只是输出一段 JSON，而是让团队或未来的自己在改动站点时，第一时间知道：

• 哪些质量指标变差了
• 这次改动是否引入新的治理负担

结语

如果说 M5 是让知识站拥有维护视角，那么 M6 就是在开始给它补维护纪律。

从这一轮开始，站点治理不再只是“知道问题存在”，而是在逐步具备：

• 排序
• 比较
• 守门

这也是知识库走向长期可维护的关键一步。