列表缩略图：小格子里的主标题与关键节点仍须可辨，不能默认「点开再看」，要为二次采样与圆角裁切预留安全边
`thumbnail-visio-vsdx-jpg` 面向文档库、工单系统或门户卡片上的极小预览。缩略算法往往再采样一次，导致本来就细的发丝线在格子尺寸下直接消失。应在 Visio 预先加粗主路径、提高关键数字字号，并避免把整张架构缩进 120px 方格仍要求读出每个端口名。导出 JPG 时按「缩略最长边 × 2～3 倍安全余量」给像素，终验以列表页真实渲染为准而非桌面单独打开。
缩略图操作说明：先截一张目标 UI 空卡片量像素，再导出并回填列表沙箱目测评判可读阈值
- 在产品设计稿或线上环境量出缩略容器宽高与圆角裁切，换算成导出最长边并预留 CDN/WebP 转码损耗；挑选信息最满的 .vsdx 页面试转，确认主标题在缩略尺度仍占可视面积足够比例。
- 将 JPG 填入真实列表或 Storybook 沙箱，分别在视网膜与非视网膜屏观察；若仅大图清晰而格子糊，应提高导出分辨率或简化图形层级，而不是抱怨用户不点开。
- 缩略与高清大图若需并存，文件名或路径应区分 `@1x/@2x` 或哈希后缀，并在 manifest 标注同一 .vsdx 源，避免运营误把低清缩略当成唯一对外资产。
VSDX 转 JPG（缩略图）常见问题：列表二次采样、主路径淹没、圆角裁切与多分辨率并存
同一 JPG 在列表里糊成一片，点进详情又清晰，这是缩略生成链问题还是我们导出像素压根不够？
多数是两者叠加：先提高源图最长边给缩略链路留余量，再让前端确认是否用了过度激进的压缩或固定高度裁剪；终验必须以列表像素为准。
卡片使用圆形或圆角遮罩，关键标签被切掉，应在 Visio 重新留白还是改 UI 组件？
优先在 Visio 为缩略安全区预留边距并居中主图形；若改 UI 周期更长，至少导出带统一出血的版本供组件裁切。
深色主题下列表底是深灰，白底 JPG 缩略刺眼，如何减少视觉噪音又不改站点全局主题？
为深色模式单独导出铺深灰底的 JPG 或提供主题字段映射；强行白底贴深 UI 会造成对比刺眼且显得不专业。
缩略与高清两套资源增加存储成本，团队想只保留一份，怎样决策才不会牺牲列表体验又避免详情页体积失控？
若列表与详情共用同一 URL，应取「列表可读」的更高像素并接受详情略大；若 CDN 支持自适应，可只存一份高质量由边缘动态出多档，但需验证缓存键策略。
批量生成上千缩略，个别源图极复杂导致体积异常大拖慢首屏，如何用 manifest 标记重图并配合 CDN 分层与懒加载单点治理？
对超密图单独降质量或拆分子图输出；manifest 标记 `heavy` 行供 CDN 分层缓存与懒加载，避免整批被最慢文件绑架 SLA。