feat: update agreements and refine miniapp layouts and integrations

docs/tiangong-image-fields.md

@@ -0,0 +1,27 @@
+# 天宫列表与详情素材字段
+
+## 展示规则
+
+- 正式模式列表图沿用后端 `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 均保留。本次未自动提交、推送或部署后端。