各常用页预埋板块清单(神山秘境·波波 v3-c-takeover)

配套代码:miniprogram-v3/detail-render/normalize.ts(通用模块渲染器)、miniprogram-v3/utils/detail-config.ts(配置契约 + 白名单)。
生成日期:2026-09-29。目的:把"常用页常用板块"提前在代码包登记好,A 端只管启停/排序/加实例,等 A 端做好后手动控制,不重提审。

一、预埋策略边界(铁律,来自 gpt6 咨询)

  1. 纯 A 端配置只能编排「代码包已登记的类型」:启停(enable)、排序(modules 顺序)、加同类型实例(写新 id)。
  2. 不能凭配置生成本文件未登记的新结构——那仍需改代码包 + 重新提审。
  3. 默认关的功能也必须视觉验收:在开发者工具/体验版临时 enable:true 真机验渲染,不能只靠"不显示"蒙混。
  4. 分包不是审核隔离区(只解包体、不解资质);权限 scope / 类目资质型功能不能靠默认关绕过。

二、代码包已登记类型(白名单)

「已登记」= detail-config.ts 的 DetailModuleType 并集;其中 BODY_TYPES(真实可被动态渲染) = intro/includes/leader/redeem/gallery/video/notice,hero 由页面单独渲染不入循环。provenance/visit/rooms/booking 仅在 item/hotel 默认配置里出现,尚未接入动态渲染器(item/hotel 仍是写死块,迁移待办)。

类型数据来源需新 scope默认态是否已被动态渲染说明
hero页面顶层 title/cover否常显页面单独处理沉浸式头图
intro真实接口 description 兜底 A 端文案否开✅ product简介
includes真实接口 includes否开✅ product套餐包含
leader真实接口 leader否关✅ product领队同行(默认关,铁律)
redeemA 端文案否开✅ product到店核销说明
galleryA 端 content.images否(<image> 内建)关(预埋)✅ product实景图集
videoA 端 content.videoUrl否(<video> 内建)关(预埋)✅ product视频介绍
noticeA 端 content.text否关(预埋)✅ product须知/公告
provenanceA 端文案否开❌ item 待迁移风物印记
visitA 端文案否开❌ item 待迁移到店看实物
roomsA 端/后端房型否开❌ hotel 待迁移房型
bookingA 端否开❌ hotel 待迁移预约

三、各常用页候选板块(按页)

首页(home)

在地(local)

风物(shop → item-detail)

我的(profile)

三详情页(product / item / hotel)


四、安全 vs 谨慎标注


五、上线后控制方式(A 端如何开关)


六、视觉验收 checklist(gpt6 9 项,开 flag 真机验)

在开发者工具/体验版临时把 leader/gallery/video/notice 设为 enable:true 后逐项核对:

  1. 窄屏(iPhone SE 375)与常规屏(iPhone 12 390)下 gallery 3 列不溢出、不压底栏。
  2. 长标题(>20 字)hero 不截断、不顶破 statusBar。
  3. 多图(>9 张)gallery 滚动无卡顿。
  4. 空态兜底:intro 空 / includes 空 / leader 空 → 整块 wx:if 隐藏,无空白占位、无"undefined"。
  5. setData 体积:单页 renderModules < 50KB(图片只传 CDN URL,不塞 base64)。
  6. token 一致性:所有卡片用 --color-* / --radius-* / accent-bar 统一,无裸色。
  7. 视频 <video> 控件可用、封面无黑块、不自动播放。
  8. 模块顺序与 A 端 modules 配置一致(非代码写死顺序)。
  9. 分享卡片 onShareAppMessage / onShareTimeline 取真实 cover / title。

七、当前进度