Doc Image Maintainer

4. 改写文档引用

• 只改写真实图片引用，不改正文说明文本、代码块、示例代码字符串。
• 引用路径统一使用相对写法（如 ./imgs/asset-path-figure-01.png）。
• 单张图片默认使用 HTML <img> 形式，并统一添加 style="display: block; width: 80%; margin: 0 auto;"，保证居中展示与版式一致。
• 若存在上下连续的两张图片，优先改为网格布局容器包裹，例如：

<div style="display: grid; grid-template-columns: 0.5fr 1fr; gap: 16px; align-items: start;">
  <img src="./imgs/asset-path-figure-01.png" />
  <img src="./imgs/asset-path-figure-09.png" />
</div>

• grid-template-columns 的默认规则：
  • 两张图视觉宽度接近、信息密度接近时，优先使用 1fr 1fr。
  • 若左图明显更窄，或左图是局部截图、流程局部、说明性配图，而右图是主体内容时，使用 0.5fr 1fr。
  • 若两图比例存在差异但未达到明显主次关系，优先使用接近的简洁比例（如 0.6fr 0.4fr），避免随意使用难以复用的列宽值。
  • 选择列宽时以“最终阅读版式平衡”为准，不要求与原始图片像素宽度完全一致。
• 若文档明确使用并排对比、网格布局等容器包裹图片，则保留该布局。
• 若使用网格布局，不要在容器内的 <img> 上保留无用的 style（如 display: block; width: 80%; margin: 0 auto;），避免重复样式干扰布局。

5. 清理未引用图片

• 迁移与改写后，再次全量扫描 docs/src。
• 删除“未被任何文档引用”的图片文件。
• 删除前先确认不是代码示例文本误判（例如文中的 url(./image.png) 说明文本不算图片引用）。

6. 最终校验

• 确认不存在悬空引用（文档引用的文件不存在）。
• 确认目标 md 所在目录不再残留应迁移的根目录图片。
• 输出变更摘要：迁移、重命名、删除、引用更新条目。

执行约束

• 优先使用 rg 做搜索与校验。
• 仅在用户指定范围内改动，避免跨目录误操作。
• 删除操作前先完成引用改写与二次扫描，避免误删。
• 如有命名冲突、同名跨目录引用或来源不明确，先保守处理并明确说明假设。