feat: update agreements and refine miniapp layouts and integrations

docs/deity-card-style.md

@@ -0,0 +1,10 @@
+# 我的天宫：绑定卡片样式恢复
+
+- 正式模式和显式Demo共用 `binding-gold-card` 金色卡片、挂饰、固定比例图片框、守护天数条和底部关闭按钮。不再为正式模式提前返回简化的紫色信息弹窗。
+- 正式卡片神仙图片取已有 GET `/api/tiangong/items` 的 `iconUrl`；守护天数取 `days`；持有关系显示为“持有记录：holdingId”，不冒充NFC唯一ID。
+- 正式模式不展示DEMO编号、Mock标记、示例解绑额度、模拟确认绑定或模拟解绑菜单。真实绑定／解绑仍未在此组件接入；本次不新增写接口、不改持有状态。
+- 图片为空或加载失败时保留卡片和图片框，显示明确提示，不以本地原型图冒充后端图片。Demo继续使用原有素材和模拟分支。
+
+验收：登录后进入“我的→我的天宫→点击已绑定神仙”，应看到金色卡片、对应图片、真实守护天数及关闭按钮，不出现演示编号或模拟解绑。375×812与320×568演示布局已检查，关闭按钮可用；真实模式的数据与权限分支由组件测试验证。
+
+112项前端测试、TypeScript、H5／微信构建、13个微信原生WXSS检查通过。未自动提交、推送或部署后端。效果参考截图（演示数据）：`/private/tmp/hera-restored-gold-card.png`。

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 均保留。本次未自动提交、推送或部署后端。

docs/tiangong-invitation-layout.md

@@ -0,0 +1,28 @@
+# 请神页面布局调整（2026-10-20）
+
+本次仅调整 `src/pages/tiangong-detail/index.scss` 的请神布局，不修改后端、业务流程或接口。
+
+- 祥云山水背景与神像区域改为随可用高度伸展，取消固定场景高度；底部介绍区结束后不再保留大片空白。
+- 参考用户图片，使用通栏浅绿色名称栏、米黄色介绍区和居中的浅绿渐变「请神」按钮。
+- 长屏由场景填满；小屏、长介绍自然滚动，保留底部安全区；神像保持等比例显示。
+- 敬神页仍使用原场景、供桌和操作栏，不展示介绍。
+
+## 验收
+
+1. 开发者工具编译 `dist`，登录后进入天宫，选择未绑定神仙的请神页。
+2. 检查名称栏水平铺满、介绍排版完整、请神按钮居中，底部没有额外的大块留白。
+3. 切换小屏和长屏机型：小屏可向下滚动看到完整介绍和按钮，长屏背景撑满，不横向溢出。
+4. 点击请神仍沿用原流程；返回已绑定神仙的敬神页，供桌与按钮保持原样且没有介绍。
+
+## 边界与差异
+
+- 使用已有祥云山水素材，不将参考截图整张铺入页面；名称采用金棕色以保持浅绿底上的可读性。
+- 正式环境图片仍取 `iconDetailUrl`，介绍仍取 `description`，本次没有新增接口或文案。
+- 本地 `?avatarDemo=1` 是独立 Mock 演示，不建立真实供奉关系；演示页附加提示文字属于 Mock 边界说明，正式页面没有这些说明。
+- 演示素材中禄星介绍与名称不一致的问题仍明确提示待确认，本次未自行更改。
+
+## 验证
+
+类型检查、H5 和微信构建、原生 WXSS 编译检查通过；新增 `scripts/invitationLayout.test.cjs` 两项通过，防止恢复固定高度或影响敬神布局。浏览器通过显式 Demo 验证小屏、常规长屏与更长屏及原有弹窗，不代表正式后端绑定已联调。
+
+最终全量测试为 118 项、116 通过、2 失败：执行期间出现本次范围外的个人信息页安全区改动，`avatarEntry.test.cjs` 的旧测试替身未提供 `getSystemInfoSync` 且依赖固定 Hook 下标，导致两项头像入口测试失败。本次保留这些页面改动，未修改头像逻辑或掩盖失败。

docs/wechat-customer-service.md

@@ -0,0 +1,24 @@
+# 微信客服接入
+
+## 已配置
+
+- 企业ID：`wwf8bbe2cad2e9e84b`。
+- 官方客服链接：`https://work.weixin.qq.com/kfid/kfc5a57c84cb0feb2fd`。
+- 统一入口：`src/services/customerService.ts`。这两个参数为公开入口信息，不是企业Secret或访问令牌。
+- “我的→联系我们”和首页／元素未绑定提示中的“联系我们”共用该入口。
+
+小程序点击时直接调用 `Taro.openCustomerServiceChat({corpId, extInfo: {url}})`，不先等待网络请求，保留微信要求的用户点击上下文。不跳转项目里的模拟聊天页，不发送用户资料或自动发送聊天消息，不连接自建聊天后端。
+
+H5仅提示“请在微信小程序中联系客服”；不支持的微信版本提示更新；接口失败提示重试；用户取消不报错。连续点击去重，完成或失败后可再次点击。不配置企业Secret，不开启API消息接管或消息回调。
+
+## 管理员配置及真机验收
+
+1. 在微信公众平台的小程序后台，确认客服设置已绑定上述企业ID；企业微信中确认该客服账号已启用并添加接待人员。
+2. 微信开发者工具导入项目，重新编译当前 `dist`，再使用微信真机预览或体验版测试。H5提示正常不代表官方客服已可用。
+3. “我的→联系我们”：预期进入对应微信客服会话。人工发送一条测试消息，企业微信接待人员应能收到并回复。
+4. 未绑定神仙时，在首页或“我的元素”的绑定提示点击“联系我们”：应进入同一个官方客服，不弹“入口待配置”，不进入模拟聊天页。
+5. 如提示打开失败，先检查企业ID关联、客服链接及账号启用状态，再检查微信版本和主体资质是否满足后台要求。不要把Secret或密码发到聊天。
+
+## 边界
+
+本次只接入官方客服入口，无新增HTTP业务接口，不修改后端或企业微信管理后台，不购买服务、不自动向客服发送消息。真实客服可用性需管理员配置和真机验收，本地测试不替代该验收。前一条被中断的8张神仙图片压缩上传及数据库更新，本次未执行。