Wiki 与在线文档：正文栏宽、导出 PDF 与打印会把 JPG 再压一遍，插图要在「最窄阅读宽」下仍可读
`wiki-visio-jpg` 面向运维 Runbook、架构说明与内嵌教程。Wiki 常把图片限制在内容列宽并在导出 PDF 时二次压缩，老 .vsd 导出的宽图会被缩小到难以辨认端口编号。应按内容列像素导出匹配宽度，或为「网页 / PDF」准备两档；同时在页面旁用文字写清「图示为 JPG 预览，以附件 .vsd 为准」避免读者把压缩伪影当成真实拓扑差异。
Wiki 插图操作说明：先量编辑器内容区宽度与深浅主题背景，再导出匹配宽度 JPG，最后在 PDF 导出样稿中复核
- 在沙箱页插入与实际生产相同宏或模板，量出可用像素；按该宽度从 .vsd 导出，避免上传超大图仅靠前端缩放浪费带宽并放大块效应。
- 分别在默认主题与深色主题全页查看；若深色模式刺眼，为深色主题单独导出灰底 JPG 或使用附件 PNG 作为替代。
- 页面变更记录中写清插图文件名、哈希与对应 .vsd 版本；审计评论应引用页面修订号而非聊天截图，防止插图更新后评论仍指向旧视觉。
VSD 转 JPG（Wiki）常见问题：列宽匹配、PDF 二次压缩、深浅主题、修订追溯与附件成对
在线阅读尚可，导出 PDF 后插图明显发糊，应优先怀疑 Wiki 导出链二次压缩还是源 JPG 分辨率本身不足？
在导出样稿中量嵌入图有效分辨率；若链路再压缩，应提高源最长边或关闭导出器的过度 JPEG 重编码；验证必须以 PDF 为准而非仅编辑器预览。
页面历史里同名插图被静默覆盖，读者如何知道看过哪一版，变更摘要与附件元数据应强制包含哪些字段？
上传新文件应 bump 附件版本或改名含日期哈希，并在页面顶部变更摘要写明；禁止无说明覆盖同名插图。
内网 CDN 长缓存导致「文章已更新图仍是旧的」，对象键版本片段与网关刷新策略应如何联动配合才不靠人工清缓存？
为每次发布使用含版本片段的新对象键或在网关刷新；HTML 与插图缓存策略需联动 bump，避免只更新文本不更新 URL 引发误解。
打印友好模式去掉背景色后 JPG 对比下降，应单独提供打印版插图还是在源 Visio 统一提高对比与线宽？
可在打印 CSS 触发时换用高对比副本，或在源图采用不靠背景色区分的关键路径编号；单一低对比图在白纸打印上易失败。
跨空间复制页面时图片链接仍指向旧空间引发权限错误，发布 checklist 应如何强制巡检？
复制后批量检查附件是否随页迁移或使用相对引用；在发布 checklist 增加跨空间链接与媒体权限巡检项。