Confluence 嵌入：宏宽度、主题背景与附件版本会让同一张 JPG 在不同皮肤下判若两图
`confluence-visio-jpg` 面向在页面正文插入架构或流程预览。Confluence 会对图片做响应式缩放并套用主题背景色，白底 JPG 在深色主题下可能刺眼或出现假「白边」。应在沙箱空间用与实际站点相同的主题皮肤预览，并在页面旁用文字写清「图示仅作示意，以 .vsdx 附件为准」避免读者把压缩伪影当成真实拓扑差异。
Confluence 操作说明：先量编辑器列宽与主题色，再导出匹配宽度 JPG，最后上传附件并记录页面版本号
- 在测试页插入与生产相同布局的宏，量出内容区可用像素；按该宽度导出 JPG，避免上传超大图仅靠前端缩放浪费带宽且放大块效应。
- 分别在默认主题与深色主题下全页截图对比；若深色模式不可接受，为深色主题单独导出灰底 JPG 或使用附件链接切换两套资源。
- 将 .vsdx 作为受控附件与 JPG 同事上传，页面变更说明里写清两个文件的版本标签；审计评论应引用页面修订号而非聊天截图。
VSDX 转 JPG（Confluence）常见问题：响应式缩放、深浅主题、附件成对与页面修订追溯
插入后图片被强制缩到很窄文字全糊，是上传分辨率问题还是宏模板列宽问题，如何快速定位责任侧？
通常是宽度不匹配：按列宽导出或改用可点击放大链接；必要时拆成两张上下排列的中等宽度图而非单张超宽全景。
导出 PDF 或 HTML 时嵌入的 JPG 模糊，与在线阅读不一致，如何对齐？
导出链路可能二次压缩，需在导出流水线使用与线上一致的原图 URL 或提高嵌入 DPI；验证应以实际导出物为准而非编辑预览。
页面历史里 JPG 被覆盖但附件名相同，读者如何知道看过哪一版，变更摘要应强制包含哪些哈希或构建号？
上传新文件应 bump 附件版本或改名含日期哈希，并在页面顶部「变更摘要」写明；禁止无说明覆盖同名附件。
宏懒加载导致首屏占位闪烁影响阅读体验，是否应降低 JPG 体积还是拆分首屏小图与高清分层加载？
可在不牺牲关键可读前提下适度降质量，或使用渐进式加载占位；若仍闪烁，评估拆分首屏小图与全文高清图分层。
跨空间复制页面时图片链接仍指向旧空间引发权限错误，发布 checklist 应如何强制巡检附件迁移与相对引用？
复制后批量检查附件是否随页迁移，或使用相对页面附件引用；在发布 checklist 增加「跨空间链接巡检」项。