M13 详细设计：剩余资源问题收口与示例语义修正

这份详细设计文档用于描述 M13 的核心设计：如何区分“真实缺图”和“示例代码被当成页面资源”这两类问题，并把剩余资源问题收口。

设计目标

M13 主要解决三个问题：

• 如何让示例代码只承担说明职责，不再参与页面资源解析
• 如何处理历史上已经找不到原图的页面
• 如何在资源问题收口后让治理视图回归更清晰的下一步重点

一、剩余问题分类设计

M12 之后剩余资源问题主要分成两类：

• 示例型资源问题
  • 02CSS相关/响应式布局/响应设计
  • 11Vue学习/vue2相关文档学习笔记/组件/6杂项/01编写可复用组件
• 历史缺图型资源问题
  • 03JavaScript/underscore源码/1笔记-核心方法

前者的问题本质不是图片缺失，而是 HTML 示例直接出现在正文中，被站点按真实标签渲染；后者则是历史博客迁移后图片资源没有一并保留。

二、示例表达修正设计

对于示例型页面，本轮采用统一方案：

• 把原本直接写在正文中的 HTML 片段包裹为代码块
• 保留原有讲解上下文
• 不再让示例内容被站点当作真正的 img 资源依赖

这样做的好处是：

• 页面语义更清楚
• 资源巡检结果更准确
• 读者更容易判断这里是在看代码示例，而不是实际页面输出

三、历史缺图收尾设计

对于 underscore 源码笔记中的两张缺失图片，本轮不再继续寻找外部原图，而是：

• 删除失效图片引用
• 增加简短文字说明，指出原位置原本用于辅助理解活动对象和闭包关系

这样可以保留讲解链路，同时避免页面持续依赖不存在的资源。

四、验收设计

本轮验收按下面顺序执行：

1. 运行 npm run docs:sync
2. 运行 npm run build
3. 运行 npm run docs:check
4. 检查治理页资源缺失是否归零
5. 确认新基线与巡检结果一致

通过标准：

• 构建成功
• 巡检成功
• missingAssetCount === 0
• 治理页资源问题区块能正确表达“已收口”