适用版本：TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
图片使用涉及存储策略、附件分组、图库分组和访问域名。先区分这几个概念，再排查上传或展示问题。
配置上传
先在 Halo 附件管理中确认所需存储策略有效，尝试从后台上传一张测试图片并打开其访问地址。再进入 TinyTale 基础设置，选择“储存策略”和需要的“上传的分组”。
随后使用有管理权限的账号在小程序上传。账号需要具备附件以及对应内容的管理权限，详见管理员与发布权限。
文件上传成功与创建图库记录是两个步骤。附件里出现图片，不代表图库记录一定创建成功。
缩略图与原图
图库发布会记录可取得的图片尺寸，优先使用附件提供的缩略图；条件满足时也会尝试上传压缩封面。缩略图处理失败时可回退原图。图片列表与原图预览可能请求不同地址，应分别验证。
外部图片尺寸
进入 TinyTale 的“媒体缓存”设置。默认允许读取 Halo 自身域名的图片尺寸；使用对象存储、CDN 或其他外部图片时，在“外部图片域名白名单”填入可信域名。
images.example.com
*.cdn.example.com
可按行或逗号分隔，支持通配子域名，仅允许 80/443 端口。这里填写域名规则，不是上传微信密钥，也不是微信公众平台的合法域名配置。
白名单决定服务端是否允许读取尺寸。即使小程序能显示一张外部图片，服务端也可能因未加入白名单而无法提取其尺寸。
刷新媒体尺寸
在媒体缓存面板点击“刷新媒体尺寸”，查看运行状态、处理数量和失败数量。该操作读取图片文件头并缓存宽高，不修改原始图库或瞬间内容；换图后可以再次刷新以更新旧尺寸。
如果刷新失败，优先核对原图 URL、外部域名白名单、证书、网络可达性和图片是否为受支持的有效图片。不要把“缓存刷新成功”理解为所有图片都成功，仍需查看失败统计。
快速验证
分别完成后台上传、小程序上传、列表显示和原图预览。若只有微信端失败，优先检查合法域名与真机网络；若服务端尺寸刷新失败，检查服务端白名单及源站访问。
完整排查见显示问题。