开发记录：VitePress 资源巡检降噪与资源治理试点

背景

前几轮治理主要集中在缺少一级标题，治理链路已经比较稳定，但资源问题仍然混杂着大量误报，导致“看起来问题很多，实际上难以下手”。

M12 的重点，是先把资源巡检结果做干净，再选两个小范围对象验证资源治理是否能像标题治理一样继续滚动推进。

开发顺序

本轮按“先设计、再开发、后自测”的顺序推进：

1. 先确认资源缺失列表中的误报来源。
2. 再调整资源提取逻辑，改为基于 Markdown Token 检测。
3. 然后修复两处真实存在的资源引用问题。
4. 接着增强治理页，补充资源问题推荐区块。
5. 最后执行构建与巡检自测，确认结果可作为新基线。

本轮改动

1. 资源巡检从正则匹配改为 Markdown Token 提取

原来的正则规则会把代码块里的函数调用、正则表达式片段误判为资源引用。

本轮把资源检测改为基于 Markdown Token 遍历，并补充对 HTML img / source 标签的处理，让巡检结果更接近真实缺失资源。

2. 新增资源治理试点范围

本轮在 remediationConfigs 中加入 issueType 字段，并把下面两处纳入 M12：

• 07四艺 / 音乐RE0学习
• 10其他 / wuxia/team/飞雪

这样治理页就可以把资源问题也作为本轮治理范围展示出来。

3. 修复三处真实资源引用问题

本轮修复了三类典型问题：

• 图片文件名多写扩展名
• 历史图片别名与真实文件名不一致
• 页面首图引用文件名错误

4. 治理页新增资源问题推荐入口

治理页新增“下一批推荐资源问题页”，让资源治理不再停留在底部明细，而是能直接形成下一轮候选范围。

自测记录

本轮自测执行：

• npm run docs:sync
• npm run build
• npm run docs:check

预期结果：

• 构建通过
• 巡检通过
• 资源缺失数量下降
• 本轮治理范围中的资源问题归零

结果

M12 完成后，自测结果为：

• Markdown 文档：1201
• 占位/空文件：29
• 缺少一级标题：408
• 缺失资源引用：4
• 重复标题：38

资源治理第一次进入里程碑视图，治理节奏从“只治理标题”推进到“开始治理资源”，同时资源巡检结果也更适合下一轮继续扩面。