hera-web/docs/tiangong-image-fields.md

天宫列表与详情素材字段

展示规则

• 正式模式列表图沿用后端 iconUrl（数据库 icon_url）。未绑定仍按现有 opacity: .2 淡化，不改灰度；已绑定正常显示。
• 详情主神像与祈愿／回向弹窗神像使用 iconDetailUrl（数据库 icon_detail_url），不再使用本地原型神像，也不使用列表缩略图顶替。
• 介绍使用 description，仅在未恭请神仙的请神页显示并保留换行；已绑定的敬神页不展示介绍，也不展示“暂无介绍”占位。
• 详情图缺失显示“详情图片暂未配置”；加载失败显示“详情图片加载失败”；空介绍显示“暂无介绍”。不补写神仙介绍。
• 显式 preview=1／avatarDemo=1 仍为独立 Mock，只使用原型素材，不用于验证真实后端字段。

接口

继续复用 JWT 接口 GET /api/tiangong/items，不新增请求，不调用尚未接入的独立详情接口。该接口同时返回 iconUrl、iconDetailUrl、description、active 及持有关系和统计。后端现有代码已查询并返回这些字段、解析存储地址，本次未修改后端或执行SQL。

开发者工具验收

1. 导入项目并重新编译，使用真实账号登录，不使用H5演示参数。
2. 天宫列表：已绑定显示原图，未绑定仍显示同一图片的20%透明度效果。
3. 查看 Network 中 GET /api/tiangong/items 返回的三个字段。进入对应神仙详情，主神像应对应 iconDetailUrl；未恭请的请神页介绍与 description 一致，不能显示另一份本地原型介绍。
4. 已绑定神仙进入敬神页，不应显示介绍或介绍占位；上香等按钮正常显示。打开祈愿／回向弹窗，弹窗神像也对应详情图，不能换回本地图片。
5. 服务端未配置图片／介绍时按上述提示展示；图片不可访问时显示加载失败。返回列表不改变未绑定图片效果。

验证与边界

108项前端测试、TypeScript、H5／微信构建、13个微信原生WXSS编译检查通过。测试覆盖请神页显示介绍、敬神页不显示介绍或占位、详情与弹窗、字段缺失及加载失败、更新及账号切换。微信产物2,022,607 bytes，低于2MiB。

本机浏览器真实模式停在登录入口，尚未通过真实账号验证远程图片和介绍；未绕过登录、未修改远程数据。后端已有的未提交改动、本机 project.config.json 均保留。本次未自动提交、推送或部署后端。