适用版本：TinyTale 小程序 3.0.0 / TinyTale 配置插件 2.1.2。
图片为空、显示错误占位图
先单独打开图片地址，确认文件存在且可访问，再检查 HTTPS、重定向、微信合法域名、防盗链和存储权限。文章、头像、友链图标、轮播和图库可能来自不同域名，应检查实际失败地址。
图片占位配置只影响显示，不会修复原图。随机封面接口也不能替代文章中失效的图片地址。
图库瀑布流高度不正确
核对图片尺寸记录与原图是否一致。如果原图更换后仍沿用旧地址，可检查媒体缓存状态并重新解析尺寸。外部图片尺寸解析还受 TinyTale 媒体缓存允许域名控制。
此允许名单与微信合法域名分别生效。把域名加入服务端解析名单后，仍需确保手机可以加载图片。详见媒体缓存。
正文与网页效果不同
小程序使用 mp-html 及项目主题渲染常见 HTML。网页脚本、依赖 DOM 的组件和主题专属功能可能无法直接复现。先用普通段落、图片、表格和代码块构造最小示例，再逐步加回复杂内容。
代码高亮或主题修改未生效时，确认改的是工作区源文件，并已重新构建 mp-html。不要直接修改生成目录后期待下次构建保留。
评论入口不见了
检查 TinyTale 评论开关、文章评论状态、Halo 评论设置及匿名评论策略。游客不能评论时先确认是否需要登录，不要仅检查前端按钮。
评论已提交却不公开时，核对审核状态和私密评论设置。验证码错误需刷新后重新填写；受限文章中评论成功却未解锁，还要检查阅读凭证与服务端规则。
评论弹层闪烁或键盘不弹出
源码日志记录过“空内容校验 → 关闭弹层 → 再次打开输入”的真机问题。请使用目标微信版本和实际设备验证，并记录手机系统、微信版本、是否游客、验证码是否开启以及重开步骤。
当前文档按源码整理，未替代真机回归。如果遇到此问题，可先退出文章再进入确认是否恢复，并将可重复的步骤反馈；不要把模拟器表现作为已修复的证明。
分享或海报不完整
检查文章标题、封面、图片实际地址和当前小程序 AppID，确认分享来自正式构建。外部图片下载失败、域名限制或内容字段为空都可能影响海报。记录受影响的具体文章和设备，先使用普通图片文章对比。
受限文章始终无法阅读时，参考Tools 集成，确认文章策略、专用令牌和当前账号，避免直接改为无条件全文接口。