فهرست منبع

feat: 门店空间索引规则与 zone 实景图资源纳入技能包

- 新增 assets/store-spatial-index/:10 张 zone 实景图 + 2 张 V4 俯瞰图 + 空间索引 JSON/HTML/MD + README
- 新增 references/store-spatial-index.md:Z01-Z09 可用区 / U01-U03 禁用区 / 常用映射 / V4 开放公共区关系 / 6 条空间锚定硬规则
- wan3-workflow.md 素材映射表新增 zone 实景图条目 + 坑4 指针
- SKILL.md / elements.md / script-template.md 接入 store-spatial-index 指针,沉淀背景逐段锚定、口播逐字红线、单字发音缺陷规避、插画内禁人物、生成超时续轮询等实战规则
zhengqi 1 هفته پیش
والد
کامیت
dc8cdc2f33
23فایلهای تغییر یافته به همراه559 افزوده شده و 1 حذف شده
  1. 6 1
      SKILL.md
  2. 5 0
      _user_meta.json
  3. 3 0
      assets/script-template.md
  4. BIN
      assets/store-spatial-index/00_俯瞰图_修订V4.png
  5. BIN
      assets/store-spatial-index/00_俯瞰图_修订_带布局编号V4.jpeg
  6. 13 0
      assets/store-spatial-index/README.md
  7. BIN
      assets/store-spatial-index/Z01_01_入口门厅_入口朝内_9x16.png
  8. BIN
      assets/store-spatial-index/Z01_02_入口门厅_品牌墙与小沙发_9x16.png
  9. BIN
      assets/store-spatial-index/Z02_01_产品展示柜_柜前斜视_9x16.png
  10. BIN
      assets/store-spatial-index/Z03_01_前台_顾客侧视角_9x16.png
  11. BIN
      assets/store-spatial-index/Z04_01_等候洽谈区_沙发与展示墙_9x16.png
  12. BIN
      assets/store-spatial-index/Z05_01_主走廊_后段朝梳妆区_9x16.png
  13. BIN
      assets/store-spatial-index/Z06_01_双床护理房A_房门朝内_9x16.png
  14. BIN
      assets/store-spatial-index/Z07_01_双床护理房B_房门朝窗帘_9x16.png
  15. BIN
      assets/store-spatial-index/Z08_01_单床仪器房C_房门朝内_9x16.png
  16. BIN
      assets/store-spatial-index/Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png
  17. 11 0
      assets/store-spatial-index/更新说明_V4.md
  18. 295 0
      assets/store-spatial-index/空间索引.json
  19. 2 0
      assets/store-spatial-index/门店店内空间索引.html
  20. 139 0
      assets/store-spatial-index/门店店内空间索引.md
  21. 2 0
      references/elements.md
  22. 73 0
      references/store-spatial-index.md
  23. 10 0
      references/wan3-workflow.md

+ 6 - 1
SKILL.md

@@ -46,6 +46,7 @@ agent_created: true
 - `references/elements.md` — 全部可参数化元素与可选项(含门店风格/插画风格/整体色调)。
 - `references/wan3-workflow.md` — 百炼 wan3 端点/鉴权/参考映射/单段 prompt 范式/LOGO 合成/不二次创作。
 - `references/asset-collection.md` — 固定 4 项素材包清单 + 自动生成门店3/插画2确认 + LOGO 合成 + 物料登记 + wan3 映射。
+- `references/store-spatial-index.md` — 门店空间索引与空间锚定硬规则(Z01–Z09 可用区 / U01–U03 禁用区 / 常用映射 / V4 开放公共区关系 / 6 条空间锚定硬规则);配套实景图在 `assets/store-spatial-index/`。
 - `assets/script-template.md` — 单段结构化 Markdown 脚本骨架(含物料清单与 wan3 请求段),填充后即为交付物。
 - `scripts/generate_video.py` — 解析素材(公网URL直传 / 本地图base64直传)→建任务→轮询→下载本地。
 - `scripts/config.json` — region / workspace_id / model / resolution / ratio / output_dir(密钥走环境变量)。
@@ -110,6 +111,7 @@ agent_created: true
 - **用户自带内容/口播** → 转换为口语化、适合口播的文案(自然亲和、带 `/` `//` 停顿符号、科普准确)。
 - **用户只给选题/知识点** → 技能生成口语化口播文案。
 - **30 秒硬卡循环**:按"30 秒 ≈ 90–110 字"估算字数;若 >110 字 → **反馈用户精简,等用户回精简版后重新估算**,循环直到 ≤110 字(对应 ≤30 秒,预留停顿余量、避免语速赶)才继续。绝不为凑时长拆分片段。
+  - ⚠️ **口播红线**:组装 prompt 时须内联完整「口播定本」作唯一台词依据,并显式禁止 TTS 据画面/主题自行补词(句间/句末幻觉加词,如"做好防晒"后补"干皮");prompt 其他文字(标题/表头/规格标注)一律不出声。详见 `wan3-workflow.md` 坑5。
 
 ### Step 6 — 确认口播文案 + 敏感词/合规检测(定稿后必跑)
 
@@ -133,6 +135,7 @@ agent_created: true
   3. 用户选定第 N 句 → 记录「插画起始句:第 N 句「原文」」写入脚本「插画插入点」字段(见 `assets/script-template.md` 第四节补)。
   4. 用户无偏好 → 系统按语义建议一个起始句(通常选「讲到核心知识点那句」),标注"已自动建议"并请用户最终确认,**不默认静默落定**。
 - 该插入点直接决定 Step 8 单段 Prompt 中"画面融入插画"的时机,必须显式写进 prompt。
+  - ⚠️ **插画禁人物红线**:生成插画参考图时必须显式要求"画面中严禁出现任何完整人物、人形轮廓、手势或人影"——否则插画里的人物会与口播真人并置成"两个主角"(见 `wan3-workflow.md` 坑7)。插画只画机理示意 / 物品 / 皮肤特写 / 光线氛围。
 
 ### Step 8 — 组装单段 30 秒脚本(编导分镜级)
 
@@ -144,6 +147,7 @@ agent_created: true
   2. **运镜组合**(元素 12):每条约 2–3 种手法按时间轴穿插(跟随 / 推近 / 拉远 / 横移 / 手持微晃),随机组合、不全程单一机位。
   3. **插画展示方式**(元素 26):在「插画插入点」处触发,仅用**局部**方式(圆形画中画 / 顶部或底部条状画中画 / 侧边 PiP)随机选用,**禁止全屏铺盖 / 人物画中画式全屏**(用户 2026-09-17 硬性规则);同一视频多次出现可轮换局部方式,不固化一种。
   4. **门店丰富元素**(元素 27):在门店场景里随机点缀 2–3 个道具 / 人物(前台 / 美容床 / 沙发 / 桌椅 / 其他店员虚化走过),增加景深与真实感。
+  5. **背景逐段锚定**(元素 22 / 门店空间索引):每个 Shot 必须绑定对应 zone 参考图的元素清单(如门厅:品牌墙 + 吊灯 + 白门 + 圆几绿植 + 白沙发;产品区:怡呵美发光字展柜 + 灯带层板 + 绿植),并在硬规则写"人物未走位时背景禁止漂移成其他房间";人物真实经过的过渡空间(如走廊)**必须传对应实景图**,仅靠俯瞰图 + 文字会脑补"幽灵硬件"(见 `wan3-workflow.md` 坑4 与 `references/store-spatial-index.md`,实景图在 `assets/store-spatial-index/`)。
 - 口播台词用 `{}` 圈出、逐句写进各 Shot 的「分镜内容」;在讲对口白前**加入语气/节奏指令**(见 `wan3-workflow.md` 第四节:疑问/转折处语调上扬、核心点重音与停顿、整体松弛有起伏、禁止机械平读),缓解 wan3 原生 TTS 语气偏平的问题;在「插画插入点」指定句处明确写"讲到[第 N 句:原文]时,画面以[某展示方式]融入插画风格的抽象可视化";音色用自然语言描述"随附音频作音色参考",**不写 Audio 1**。**⚠️ prompt 文本里绝不出现 `Image N`/`Audio N`**(会被 wan3 当对白念出,详见 `wan3-workflow.md` 第一节/第七节)。
 - 引用的是**确认后的生成物料**(仅内部对应 media 数组顺序,prompt 中不写 Image N/Audio N):人物完整形象照、门店内景照片(含 LOGO)、插画;LOGO 已在 Step 4 生成门店内景时落位,无需单独合成。
 
@@ -174,7 +178,8 @@ agent_created: true
 - **LOGO 必现**:在生成门店内景照片时以 `logo_3d` 为参考落位(Image 2),确保成片前台有怡呵美立体 LOGO。
 - **原生音视频**:口播写进 prompt 作对白,音色作 reference_audio,wan3 一次性生成画面+对白+口型+环境音。
 - **插画插入点确认**:插画与口播文案都确认后,必须请用户指定插画从口播哪一句开始融入,再组装 prompt(见 Step 7);不静默默认。
-- **编导分镜(不站桩)**:单段 Prompt 必须像专业编导覆盖四块——人物行为动线(按内容长短设计走动/坐/起/落座,不全程正对镜头)、运镜组合(2–3 种随机穿插)、插画展示方式(全屏/圆形PiP/条状PiP/侧边PiP 随机混用不固化)、门店丰富元素(前台/美容床/沙发/其他人物虚化走过随机点缀);详见 `wan3-workflow.md` 第四节与 `elements.md` 元素 12/25/26/27。
+- **编导分镜(不站桩)**:单段 Prompt 必须像专业编导覆盖五块——① 人物行为动线(按内容长短设计走动/坐/起/落座,不全程正对镜头)② 运镜组合(2–3 种随机穿插)③ 插画展示方式(圆形PiP/条状PiP/侧边PiP 随机混用不固化、禁全屏)④ 门店丰富元素(前台/美容床/沙发/其他人物虚化走过随机点缀)⑤ **背景逐段锚定**(每个 Shot 绑定对应 zone 参考图元素清单,详见 `wan3-workflow.md` 坑4 与 `references/store-spatial-index.md`);详见 `wan3-workflow.md` 第四节与 `elements.md` 元素 12/25/26/27。
+- **背景一致性硬约束**:人物未走位时背景禁止漂移成其他房间;人物真实经过的过渡空间(如走廊)必须传对应实景 reference_image(仅靠俯瞰图 + 文字会脑补"幽灵硬件",zone 实景图见 `assets/store-spatial-index/`);插画内容本身不得出现人物/人形(避免与真人并置成两个主角)。
 - **口型对齐**由 wan3 原生完成,脚本只保证口播文案与停顿完整。
 - **硬性禁令**优先级最高,必须写入脚本第七节,口播文字绝不转化为屏幕文字(LOGO 视觉露出除外)。
 - **真实质感**:避免卡通化、塑料皮肤、夸张嘴型、场景跳变、AI 痕迹过重。

+ 5 - 0
_user_meta.json

@@ -0,0 +1,5 @@
+{
+  "name": "beauty-talk-science-video-script",
+  "installedAt": 1789715860524,
+  "source": "userImport"
+}

+ 3 - 0
assets/script-template.md

@@ -142,6 +142,9 @@ Shot 6 [26-30s]:[结尾缓慢拉远收束,她保持站立、抬手手势收
 - 抽象画面禁止真实血液、伤口、恐怖皮肤、医学 UI、文字、箭头、图例。
 - 人物皮肤、脸部、颈部、手臂与服装表面禁止任何 Logo、文字、字母、数字、纹身字样、标签、水印(胸牌为指定样式,不含额外文字)。
 - 全片真实拍摄质感,不生成失真或 AI 痕迹过重画面。
+- **插画内禁止出现任何人物 / 人形轮廓 / 手势 / 人影**(红线,避免与口播真人并置成"两个主角";插画只画机理示意 / 物品 / 皮肤特写 / 光线氛围)。
+- **口播逐字红线**:口播 = 且仅为确认后的台词文本,逐字一字不差;prompt 其他文字(章节标题 / 表格表头 / 规格标注 / 结构说明)一律不出声;禁止增加任何字词(语气词、口头语、英文、总结句)或据画面/主题自行补词(如"做好防晒"后追"干皮")。
+- **背景一致性**:人物未走位时背景禁止漂移成其他房间;人物真实经过的过渡空间(如走廊)必须传对应实景 reference_image,仅靠俯瞰图 + 文字描述会脑补出"幽灵硬件"。
 
 ---
 

BIN
assets/store-spatial-index/00_俯瞰图_修订V4.png


BIN
assets/store-spatial-index/00_俯瞰图_修订_带布局编号V4.jpeg


+ 13 - 0
assets/store-spatial-index/README.md

@@ -0,0 +1,13 @@
+# 门店空间索引资源(技能内置)
+
+本目录是「门店内景」相关 wan3 视频生成的**图片权威来源**,与 `../../references/store-spatial-index.md`(规则)配套。
+
+## 目录内容
+- `00_俯瞰图_修订V4.png` / `00_俯瞰图_修订_带布局编号V4.jpeg` — V4 俯瞰图(区域关系索引,非素材)
+- `Z01_01` ~ `Z09_01`(共 10 张)— 9:16 实景图(1080×1920,无人物),用于按 zone 传入 wan3 作门店参考
+- `空间索引.json` / `门店店内空间索引.html` / `门店店内空间索引.md` / `更新说明_V4.md` — 逐机位索引与 V4 修订说明
+
+## 用法
+- 规则、可用区(Z01–Z09)、禁用区(U01–U03)、常用映射、V4 开放公共区关系、6 条空间锚定硬规则 → 见 `../../references/store-spatial-index.md`
+- wan3 工作流中如何选图与写 prompt → 见 `../../references/wan3-workflow.md` 第三节与第七节坑4
+- **U01–U03 严禁作为生成参考或动线终点传入。**

BIN
assets/store-spatial-index/Z01_01_入口门厅_入口朝内_9x16.png


BIN
assets/store-spatial-index/Z01_02_入口门厅_品牌墙与小沙发_9x16.png


BIN
assets/store-spatial-index/Z02_01_产品展示柜_柜前斜视_9x16.png


BIN
assets/store-spatial-index/Z03_01_前台_顾客侧视角_9x16.png


BIN
assets/store-spatial-index/Z04_01_等候洽谈区_沙发与展示墙_9x16.png


BIN
assets/store-spatial-index/Z05_01_主走廊_后段朝梳妆区_9x16.png


BIN
assets/store-spatial-index/Z06_01_双床护理房A_房门朝内_9x16.png


BIN
assets/store-spatial-index/Z07_01_双床护理房B_房门朝窗帘_9x16.png


BIN
assets/store-spatial-index/Z08_01_单床仪器房C_房门朝内_9x16.png


BIN
assets/store-spatial-index/Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png


+ 11 - 0
assets/store-spatial-index/更新说明_V4.md

@@ -0,0 +1,11 @@
+# 俯瞰图 V4 更新说明
+
+2026-09-18,依据用户确认修订前台与门厅的连接关系。
+
+用户确认:Z03 前台与 Z01 门厅小沙发之间没有分隔墙,两者可通过连续公共地面直接连通。V4 已去掉该处隔墙及墙垛;门厅、产品展示、前台、等候洽谈区属于相互连通的公共空间。
+
+沿用 V2 的前台与洽谈区开放连通关系,以及 V3 的沙发平行展柜、朝向电视的摆放。原图前台上方待确认区域不在本次开放范围内。
+
+已同步更新俯瞰图、HTML/Markdown/JSON 空间索引及资源包。本次更新俯瞰图与空间连接说明;原有实景图不是已校准的多视角三维场景,跨前台与门厅的连接机位应按 V4 开放关系补充或校准,不沿用旧图推断隔墙。
+
+使用内置 imagegen 局部编辑,完整提示词见“俯瞰图V4_修改提示词.txt”。更新前文件保存在资源目录外的历史版本文件夹。

+ 295 - 0
assets/store-spatial-index/空间索引.json

@@ -0,0 +1,295 @@
+{
+  "title": "凯里旗舰店店内空间索引",
+  "date": "2026-09-18",
+  "floorplan": "00_俯瞰图_修订V4.png",
+  "confirmed_zones": 9,
+  "scene_images": 10,
+  "pending_areas": [
+    {
+      "id": "U01",
+      "name": "前台旁房间",
+      "position": "图上部偏右,前台正上方的斜线填充区域。",
+      "reason": "只见门口及局部陈列,没有完整内部画面;用途、边界待确认。",
+      "x": 1110,
+      "y": 243
+    },
+    {
+      "id": "U02",
+      "name": "台阶后门内空间",
+      "position": "图左上,梳妆洗手区向上延伸的台阶及门后。",
+      "reason": "拍到了台阶和门,未拍摄门后内部,未生成内部实景图。",
+      "x": 212,
+      "y": 238
+    },
+    {
+      "id": "U03",
+      "name": "未拍摄范围",
+      "position": "图左下,主走廊下侧、双床房 B 左侧的大块斜线填充区。",
+      "reason": "边界、用途及房间数量均未知;这是未覆盖范围,不能当成一间已确认房间。",
+      "x": 268,
+      "y": 778
+    }
+  ],
+  "scenes": [
+    {
+      "zone": "Z01",
+      "view_id": "Z01.01",
+      "name": "入口门厅",
+      "original": "01_Z01_入口_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z01_01_入口门厅_入口朝内_9x16.png",
+      "position": "图右下入口及沿右侧向内延伸的门厅;右邻 Z02 产品柜,内端为品牌墙。",
+      "camera": "玻璃入口附近,朝门厅内端品牌墙。",
+      "anchors": "玻璃门把手、右侧产品柜、内端品牌墙、小沙发与茶几。",
+      "note": "Z01 的入口视角;与 Z01.02 属于同一门厅。",
+      "map_marker": {
+        "x": 1367,
+        "y": 810,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "1b6c1a5a752a06f01fd9ad953881718d676a6212d80c3b36970fb8a3da444dc2",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z01",
+      "view_id": "Z01.02",
+      "name": "品牌墙与门厅小沙发",
+      "original": "03_Z01B_品牌墙_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z01_02_入口门厅_品牌墙与小沙发_9x16.png",
+      "position": "图右上门厅尽头的“品牌墙/门厅小沙发”;位于入口正前方、Z02 产品柜上端。 与左侧 Z03 前台直接连通,中间无隔墙。",
+      "camera": "门厅内正看品牌墙与小沙发。",
+      "anchors": "品牌字、左侧关闭平板门、右侧小沙发、茶几。",
+      "note": "原文件中的 Z01B 统一归入 Z01,机位号为 02;不是独立房间。",
+      "map_marker": {
+        "x": 1340,
+        "y": 219,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "b7e22f45153c949fb78454a1c5a37ef2f1841730cb14de50db552e0e46549931",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z02",
+      "view_id": "Z02.01",
+      "name": "产品展示柜",
+      "original": "02_Z02_产品展示柜_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z02_01_产品展示柜_柜前斜视_9x16.png",
+      "position": "图最右侧沿墙纵向布置的产品柜;位于从入口朝内走时的右手边。",
+      "camera": "门厅通道左侧斜看展柜。",
+      "anchors": "连续发光展柜、下柜、远端品牌墙和小沙发。",
+      "note": "本编号对应门厅长展柜;洽谈区内的小展示架随 Z04 一并覆盖。",
+      "map_marker": {
+        "x": 1464,
+        "y": 466,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "ca443912bb9183866495ff3e73cafc5aab920324cd825716945551e7b913e649",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z03",
+      "view_id": "Z03.01",
+      "name": "前台",
+      "original": "04_Z03_前台_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z03_01_前台_顾客侧视角_9x16.png",
+      "position": "图中右部、主走廊上侧;在门厅左侧、双床房 A 右侧,图上方为 U01 待确认房间;与下方 Z04 洽谈区属于同一开放公共区。 与右侧 Z01 门厅小沙发之间无隔墙,直接开放连通。",
+      "camera": "顾客接近前台的一侧。",
+      "anchors": "木色前台、电脑、浅绿背柜、白色高脚凳、画面左侧走廊。",
+      "note": "前台旁门口在图中可见,不等于已覆盖 U01 房间内部。",
+      "map_marker": {
+        "x": 995,
+        "y": 320,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "a6f92337e171585a706b78a6147baa262526669e894c208d8971511a86dc4542",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z04",
+      "view_id": "Z04.01",
+      "name": "等候洽谈区",
+      "original": "06_Z04_洽谈区_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z04_01_等候洽谈区_沙发与展示墙_9x16.png",
+      "position": "图右下、入口左侧、主走廊下侧;位于双床房 B 右侧,与上方 Z03 前台共享开放公共区,之间无门、无隔墙。",
+      "camera": "从公共区斜看沙发区。",
+      "anchors": "沙发、茶几、展示墙、窗帘、电视、拖鞋消毒柜及饮水设备。",
+      "note": "本区是与前台连通的开放洽谈区,没有独立房门或分隔墙。展示架与服务设施随本图覆盖,无须分别计为房间。 Z04 等候洽谈区沙发移至洽谈区左侧产品展示柜旁,沙发长边与展示柜平行,背部朝展示柜并留有少量间距,座面朝向右侧电视;茶几位于沙发前方。间距为示意,尚无实测尺寸。",
+      "map_marker": {
+        "x": 1090,
+        "y": 565,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "dd1cfb0e0b4c3c791c19bdac00430e2f8b7c0f642f73995dee3bdbb9bfeccd6d",
+      "width": 1080,
+      "height": 1920,
+      "furniture_layout": {
+        "sofa_long_axis": "与本区左侧产品展示柜平行,俯瞰图中为上下方向",
+        "sofa_back": "朝本区左侧展示柜,保留少量间距",
+        "sofa_front": "朝本区右侧电视",
+        "coffee_table": "位于沙发前方、沙发与电视之间",
+        "clearance": "示意间距,未实测"
+      }
+    },
+    {
+      "zone": "Z05",
+      "view_id": "Z05.01",
+      "name": "主走廊",
+      "original": "05_Z05_走廊_9x16.png",
+      "source_directory": "空间实景主图_9x16_v1",
+      "file": "Z05_01_主走廊_后段朝梳妆区_9x16.png",
+      "position": "图中央横向通道,右接门厅与前区,向左通往 Z09 梳妆洗手区。",
+      "camera": "走廊后段,朝末端梳妆台;在俯瞰图中相当于朝左。",
+      "anchors": "两侧门框、玻璃、尽头木柜、背光镜、地垫。",
+      "note": "已覆盖走廊后段;没有独立的前段或反向机位。可见房门尚未与 A/B/C 逐一校准。",
+      "map_marker": {
+        "x": 875,
+        "y": 484,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "cdfbb74a6f1236349c2fb27d8f5484eb21bab8150d210f19f58db82d76437382",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z06",
+      "view_id": "Z06.01",
+      "name": "双床护理房 A",
+      "original": "07_Z06_双床护理房A_9x16.png",
+      "source_directory": "空间实景主图_9x16_第二批_v1",
+      "file": "Z06_01_双床护理房A_房门朝内_9x16.png",
+      "position": "图中上部、主走廊上侧;位于前台左侧、单床房 C 右侧。",
+      "camera": "房门朝两张床及背景墙。",
+      "anchors": "两张床、灯带壁龛、左侧仪器车、两床间通道。",
+      "note": "沿用原图示意位置;A/B 左右对应及具体门位仍待现场核对。",
+      "map_marker": {
+        "x": 774,
+        "y": 177,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "d102471906112f73366252108a6d0a8ecfc0e615842d8ea77aeab8f12aac32d9",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z07",
+      "view_id": "Z07.01",
+      "name": "双床护理房 B",
+      "original": "08_Z07_双床护理房B_9x16.png",
+      "source_directory": "空间实景主图_9x16_第二批_v1",
+      "file": "Z07_01_双床护理房B_房门朝窗帘_9x16.png",
+      "position": "图中下部、主走廊下侧;位于等候洽谈区左侧、房 A 的图示对侧。",
+      "camera": "房门朝两张床及窗帘。",
+      "anchors": "两张床、落地窗帘、右后方衣架、左侧小桌与椅子。",
+      "note": "沿用原图示意位置;A/B 左右对应及具体门位仍待现场核对。",
+      "map_marker": {
+        "x": 572,
+        "y": 576,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "576cbeb9a45cdabd38f9ac46ea3a73447326b64612b41207adcef689c0e127d2",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z08",
+      "view_id": "Z08.01",
+      "name": "单床仪器房 C",
+      "original": "09_Z08_单床仪器房C_9x16.png",
+      "source_directory": "空间实景主图_9x16_第二批_v1",
+      "file": "Z08_01_单床仪器房C_房门朝内_9x16.png",
+      "position": "图左上、主走廊上侧;位于房 A 左侧、梳妆洗手区右侧,靠走廊末端。",
+      "camera": "房门朝单张护理床。",
+      "anchors": "画面右侧单床、左侧仪器与推车、衣架、床头壁龛。",
+      "note": "房间存在与床数明确;图示轮廓、比例与具体门位不是测绘结论。",
+      "map_marker": {
+        "x": 450,
+        "y": 177,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "f93d748d75ee81f9bdf0e0912b0fa1d0ca01b0c0066f3cb3f39ece2225e0ee92",
+      "width": 1080,
+      "height": 1920
+    },
+    {
+      "zone": "Z09",
+      "view_id": "Z09.01",
+      "name": "梳妆洗手区",
+      "original": "10_Z09_梳妆洗手区_9x16.png",
+      "source_directory": "空间实景主图_9x16_第二批_v1",
+      "file": "Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png",
+      "position": "图最左端的走廊尽头;位于房 C 左侧,向图上方接台阶及 U02 门口。",
+      "camera": "木地板与瓷砖交界处,朝连续台面。",
+      "anchors": "左侧梳妆位、右侧双洗手盆、背光镜、木柜与下柜帘。",
+      "note": "梳妆与双盆在同一张主图内;镜中走廊为倒影。台阶后门内部未覆盖。",
+      "map_marker": {
+        "x": 215,
+        "y": 396,
+        "coordinate_system": "V4 俯瞰图 1536×1024 像素;仅用于索引标记"
+      },
+      "sha256": "12cbc25e5e66b5ae14943f77e9a408547eb9ffe06081a04814d7728924445f41",
+      "width": 1080,
+      "height": 1920
+    }
+  ],
+  "floorplan_basis": "V4:在 V3 已确认布局基础上,移除前台与门厅小沙发之间的隔墙,形成连续公共空间;沿用洽谈区无门无隔墙、沙发平行展柜并朝向电视的关系。图右为入口侧、图左为走廊末端;非测绘尺寸。",
+  "additional_unseen": "门厅品牌墙旁的关闭平板门可在实景图中看到,但原俯瞰图未单独标示;门后用途及其与 U01 的关系未知,不另推定房间。",
+  "floorplan_version": "V4",
+  "floorplan_sha256": "eefab71c2def99f6cb0267a02d6cb7cc33f88df9320cdaf6047533c8bc1b0052",
+  "user_confirmed_corrections": [
+    {
+      "date": "2026-09-18",
+      "zones": [
+        "Z03",
+        "Z04"
+      ],
+      "description": "用户确认:Z04 等候洽谈区没有独立房门,也没有与 Z03 前台分隔的墙体;两者属于同一个开放公共区,可经连续公共地面直接通行。"
+    },
+    {
+      "date": "2026-09-18",
+      "zones": [
+        "Z04"
+      ],
+      "description": "Z04 等候洽谈区沙发移至洽谈区左侧产品展示柜旁,沙发长边与展示柜平行,背部朝展示柜并留有少量间距,座面朝向右侧电视;茶几位于沙发前方。间距为示意,尚无实测尺寸。"
+    },
+    {
+      "date": "2026-09-18",
+      "zones": [
+        "Z01",
+        "Z03"
+      ],
+      "description": "用户确认:Z03 前台与 Z01 门厅小沙发之间没有分隔墙,两者可通过连续公共地面直接连通。V4 已去掉该处隔墙及墙垛;门厅、产品展示、前台、等候洽谈区属于相互连通的公共空间。"
+    }
+  ],
+  "shared_public_area": {
+    "zones": [
+      "Z01",
+      "Z02",
+      "Z03",
+      "Z04"
+    ],
+    "connecting_space": "入口门厅、产品展示柜前通道、前台、门厅小沙发和等候洽谈区由连续公共地面相互连通",
+    "dividing_wall": false,
+    "door_between_zones": false,
+    "explicit_connections": [
+      {
+        "from": "Z03",
+        "to": "Z01",
+        "description": "前台与门厅小沙发之间无隔墙,可直接连通"
+      },
+      {
+        "from": "Z03",
+        "to": "Z04",
+        "description": "前台与等候洽谈区之间无门、无隔墙"
+      }
+    ]
+  },
+  "cross_space_reference_note": "本次更新俯瞰图与空间连接说明;原有实景图不是已校准的多视角三维场景,跨前台与门厅的连接机位应按 V4 开放关系补充或校准,不沿用旧图推断隔墙。"
+}

تفاوت فایلی نمایش داده نمی شود زیرا این فایل بسیار بزرگ است
+ 2 - 0
assets/store-spatial-index/门店店内空间索引.html


+ 139 - 0
assets/store-spatial-index/门店店内空间索引.md

@@ -0,0 +1,139 @@
+# 凯里旗舰店 · 店内空间索引
+整理日期:2026-09-18。交付范围:当前已完成的 10 张空间实景设计主图及 V4 修订俯瞰图。
+## 本次公共区修订 · V4
+
+用户确认:Z03 前台与 Z01 门厅小沙发之间没有分隔墙,两者可通过连续公共地面直接连通。V4 已去掉该处隔墙及墙垛;门厅、产品展示、前台、等候洽谈区属于相互连通的公共空间。
+
+本次更新俯瞰图与空间连接说明;原有实景图不是已校准的多视角三维场景,跨前台与门厅的连接机位应按 V4 开放关系补充或校准,不沿用旧图推断隔墙。
+
+## 已确认的家具摆放 · V3
+
+Z04 等候洽谈区沙发移至洽谈区左侧产品展示柜旁,沙发长边与展示柜平行,背部朝展示柜并留有少量间距,座面朝向右侧电视;茶几位于沙发前方。间距为示意,尚无实测尺寸。
+
+## 已确认的开放公共区 · V2
+
+用户确认:Z04 等候洽谈区没有独立房门,也没有与 Z03 前台分隔的墙体;两者属于同一个开放公共区,可经连续公共地面直接通行。
+
+已移除俯瞰图中洽谈区朝公共通道的门框、隔墙及靠入口门厅的内部隔断。Z03、Z04 仍保留功能区编号,不再按两个封闭房间理解。
+
+## 核对结论
+**已确认的 9 个区域均有主图,共 10 张,没有遗漏已明确的区域。** Z01 入口门厅有入口、品牌墙两个机位,其余区域各一张。三间护理房共五张床,在对应主图中均已覆盖。
+**尚不能说全店所有内部空间都已做完:** 原俯瞰图标注的前台旁房间、台阶后门和未拍摄范围没有完整素材,列为 U01–U03 待补充。U03 不代表一间房。
+## 俯瞰图与编号
+[打开带可点击编号的索引页](门店店内空间索引.html) · [打开V4修订俯瞰图](00_俯瞰图_修订V4.png)
+原俯瞰图只有区域名称,本次沿用素材包 Z01–Z09 建立编号;HTML 索引页在 V4 修订俯瞰图上叠加可点击编号;Z03 前台与 Z04 洽谈区为同一开放公共区,二者之间无门、无隔墙。下文“上、下、左、右”均指俯瞰图画面,不代表地理南北。
+命名规则:`区域编号_机位序号_空间名称_视角_9x16.png`。例如 `Z06_01` 为双床护理房 A 的第 1 个机位。品牌墙旧编号 Z01B 统一为 `Z01_02`。
+## 空间—位置—实景图对应表
+| 位置编号/机位 | 空间 | 俯瞰图中的位置 | 对应实景图文件 |
+|---|---|---|---|
+| Z01.01 | 入口门厅 | 图右下入口及沿右侧向内延伸的门厅;右邻 Z02 产品柜,内端为品牌墙。 | [Z01_01_入口门厅_入口朝内_9x16.png](Z01_01_入口门厅_入口朝内_9x16.png) |
+| Z01.02 | 品牌墙与门厅小沙发 | 图右上门厅尽头的“品牌墙/门厅小沙发”;位于入口正前方、Z02 产品柜上端。 与左侧 Z03 前台直接连通,中间无隔墙。 | [Z01_02_入口门厅_品牌墙与小沙发_9x16.png](Z01_02_入口门厅_品牌墙与小沙发_9x16.png) |
+| Z02.01 | 产品展示柜 | 图最右侧沿墙纵向布置的产品柜;位于从入口朝内走时的右手边。 | [Z02_01_产品展示柜_柜前斜视_9x16.png](Z02_01_产品展示柜_柜前斜视_9x16.png) |
+| Z03.01 | 前台 | 图中右部、主走廊上侧;在门厅左侧、双床房 A 右侧,图上方为 U01 待确认房间;与下方 Z04 洽谈区属于同一开放公共区。 与右侧 Z01 门厅小沙发之间无隔墙,直接开放连通。 | [Z03_01_前台_顾客侧视角_9x16.png](Z03_01_前台_顾客侧视角_9x16.png) |
+| Z04.01 | 等候洽谈区 | 图右下、入口左侧、主走廊下侧;位于双床房 B 右侧,与上方 Z03 前台共享开放公共区,之间无门、无隔墙。 | [Z04_01_等候洽谈区_沙发与展示墙_9x16.png](Z04_01_等候洽谈区_沙发与展示墙_9x16.png) |
+| Z05.01 | 主走廊 | 图中央横向通道,右接门厅与前区,向左通往 Z09 梳妆洗手区。 | [Z05_01_主走廊_后段朝梳妆区_9x16.png](Z05_01_主走廊_后段朝梳妆区_9x16.png) |
+| Z06.01 | 双床护理房 A | 图中上部、主走廊上侧;位于前台左侧、单床房 C 右侧。 | [Z06_01_双床护理房A_房门朝内_9x16.png](Z06_01_双床护理房A_房门朝内_9x16.png) |
+| Z07.01 | 双床护理房 B | 图中下部、主走廊下侧;位于等候洽谈区左侧、房 A 的图示对侧。 | [Z07_01_双床护理房B_房门朝窗帘_9x16.png](Z07_01_双床护理房B_房门朝窗帘_9x16.png) |
+| Z08.01 | 单床仪器房 C | 图左上、主走廊上侧;位于房 A 左侧、梳妆洗手区右侧,靠走廊末端。 | [Z08_01_单床仪器房C_房门朝内_9x16.png](Z08_01_单床仪器房C_房门朝内_9x16.png) |
+| Z09.01 | 梳妆洗手区 | 图最左端的走廊尽头;位于房 C 左侧,向图上方接台阶及 U02 门口。 | [Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png](Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png) |
+
+## 待补充区域
+| 编号 | 区域 | 图上位置 | 未完成原因 |
+|---|---|---|---|
+| U01 | 前台旁房间 | 图上部偏右,前台正上方的斜线填充区域。 | 只见门口及局部陈列,没有完整内部画面;用途、边界待确认。 |
+| U02 | 台阶后门内空间 | 图左上,梳妆洗手区向上延伸的台阶及门后。 | 拍到了台阶和门,未拍摄门后内部,未生成内部实景图。 |
+| U03 | 未拍摄范围 | 图左下,主走廊下侧、双床房 B 左侧的大块斜线填充区。 | 边界、用途及房间数量均未知;这是未覆盖范围,不能当成一间已确认房间。 |
+
+门厅品牌墙旁的关闭平板门可在实景图中看到,但原俯瞰图未单独标示;门后用途及其与 U01 的关系未知,不另推定房间。
+
+## 机位与固定地标
+
+### Z01.01 · 入口门厅
+
+机位:玻璃入口附近,朝门厅内端品牌墙。
+
+固定地标:玻璃门把手、右侧产品柜、内端品牌墙、小沙发与茶几。
+
+说明:Z01 的入口视角;与 Z01.02 属于同一门厅。
+
+### Z01.02 · 品牌墙与门厅小沙发
+
+机位:门厅内正看品牌墙与小沙发。
+
+固定地标:品牌字、左侧关闭平板门、右侧小沙发、茶几。
+
+说明:原文件中的 Z01B 统一归入 Z01,机位号为 02;不是独立房间。
+
+### Z02.01 · 产品展示柜
+
+机位:门厅通道左侧斜看展柜。
+
+固定地标:连续发光展柜、下柜、远端品牌墙和小沙发。
+
+说明:本编号对应门厅长展柜;洽谈区内的小展示架随 Z04 一并覆盖。
+
+### Z03.01 · 前台
+
+机位:顾客接近前台的一侧。
+
+固定地标:木色前台、电脑、浅绿背柜、白色高脚凳、画面左侧走廊。
+
+说明:前台旁门口在图中可见,不等于已覆盖 U01 房间内部。
+
+### Z04.01 · 等候洽谈区
+
+机位:从公共区斜看沙发区。
+
+固定地标:沙发、茶几、展示墙、窗帘、电视、拖鞋消毒柜及饮水设备。
+
+说明:本区是与前台连通的开放洽谈区,没有独立房门或分隔墙。展示架与服务设施随本图覆盖,无须分别计为房间。 Z04 等候洽谈区沙发移至洽谈区左侧产品展示柜旁,沙发长边与展示柜平行,背部朝展示柜并留有少量间距,座面朝向右侧电视;茶几位于沙发前方。间距为示意,尚无实测尺寸。
+
+### Z05.01 · 主走廊
+
+机位:走廊后段,朝末端梳妆台;在俯瞰图中相当于朝左。
+
+固定地标:两侧门框、玻璃、尽头木柜、背光镜、地垫。
+
+说明:已覆盖走廊后段;没有独立的前段或反向机位。可见房门尚未与 A/B/C 逐一校准。
+
+### Z06.01 · 双床护理房 A
+
+机位:房门朝两张床及背景墙。
+
+固定地标:两张床、灯带壁龛、左侧仪器车、两床间通道。
+
+说明:沿用原图示意位置;A/B 左右对应及具体门位仍待现场核对。
+
+### Z07.01 · 双床护理房 B
+
+机位:房门朝两张床及窗帘。
+
+固定地标:两张床、落地窗帘、右后方衣架、左侧小桌与椅子。
+
+说明:沿用原图示意位置;A/B 左右对应及具体门位仍待现场核对。
+
+### Z08.01 · 单床仪器房 C
+
+机位:房门朝单张护理床。
+
+固定地标:画面右侧单床、左侧仪器与推车、衣架、床头壁龛。
+
+说明:房间存在与床数明确;图示轮廓、比例与具体门位不是测绘结论。
+
+### Z09.01 · 梳妆洗手区
+
+机位:木地板与瓷砖交界处,朝连续台面。
+
+固定地标:左侧梳妆位、右侧双洗手盆、背光镜、木柜与下柜帘。
+
+说明:梳妆与双盆在同一张主图内;镜中走廊为倒影。台阶后门内部未覆盖。
+
+## 使用边界
+- 10 张图片都是 1080×1920、9:16、无人物的生成设计参考图。本目录复制现有最终版,不重新生成画面。
+- V4 修订俯瞰图用于区域关系索引,具体材质、家具外观和当前镜头构图以实景图为准。它们尚不是经过多视角一致性校准的三维场景。
+- A/B 房间在俯瞰图中的左右对应、各房门与走廊图的匹配、空间尺寸与比例仍待核对。索引中保留原图位置,不将推断升级为实测事实。
+- 当前完成的是每个已确认区域至少一张主图;若要拍连续跨区域长镜头,还需要前段走廊、门口和转角等连接机位。
+- 向视频模型提供对应图片时,同时写出人物起点、经过的固定物体与终点。编号用来管理素材,不能替代上传图片。
+
+## 文件追溯
+原始两批文件均保留。本目录采用位置编号命名,旧文件名、来源目录、图片尺寸、SHA-256 校验值记录在 [空间索引.json](空间索引.json) 中。

+ 2 - 0
references/elements.md

@@ -153,6 +153,8 @@
   - 侧边画中画(画面一侧矩形 / 圆角区域嵌入插画)
 - **随机组合**:同一视频里插画出现多次时,可轮换不同局部展示方式(如圆形 PiP、二次条状 PiP),不要全部按一种方式来;与第三节「插画插入点」配合。
 - 说明:抽象可视化插画(Image 3/4)以这些**局部**方式融入单段画面,不切分段。
+- **内容红线(与硬性禁令呼应)**:插画**本身不得出现任何人物 / 人形轮廓 / 手势 / 人影**(只画机理示意 / 物品 / 皮肤特写 / 光线氛围),否则会与口播真人并置成"两个主角"(见 `wan3-workflow.md` 坑7)。
+- **推荐 PIP 默认规格**:220×330px 圆角矩形(圆角 24px、半透明描边),嵌于画面右上角(距右 30 / 距上 120px,约 720P 宽 30.5% / 高 25.8%);人物走位段可平移至右下角不挡脸;插画不得遮挡人物面部与底部安全区。
 
 ## 27. 门店丰富元素(Scene Ambience / 道具与群演,增加画面丰富性)
 - 默认:技能在门店场景里随机点缀 2–3 个丰富元素

+ 73 - 0
references/store-spatial-index.md

@@ -0,0 +1,73 @@
+# 门店空间索引与空间锚定规则(技能内置权威来源)
+
+> 本文档与 `assets/store-spatial-index/` 图片资源配套,是「门店内景」相关 wan3 生成的**唯一权威来源**。
+> 所有 zone 实景图、V4 俯瞰图、空间索引 JSON/HTML/MD 均内置于技能包,clone 即得、无需再依赖项目目录。
+> 在 wan3 工作流里如何引用这些图,见 `references/wan3-workflow.md` 第三节与坑4。
+
+## 0. 资源位置
+
+- 实景图与索引目录:技能 `assets/store-spatial-index/`
+  - `00_俯瞰图_修订V4.png`:V4 修订俯瞰图(区域关系索引,非素材)
+  - `00_俯瞰图_修订_带布局编号V4.jpeg`:带空间编号标注的俯瞰图
+  - `Z01_01` ~ `Z09_01` 共 10 张 9:16 实景图(1080×1920,无人物)
+  - `空间索引.json` / `门店店内空间索引.html` / `门店店内空间索引.md` / `更新说明_V4.md`:逐机位 `camera`/`anchors`/`map_marker` 索引与 V4 修订说明
+- 命名规则:`区域编号_机位序号_空间名称_视角_9x16.png`。例如 `Z06_01` 为双床护理房 A 的第 1 个机位。品牌墙旧编号 `Z01B` 已统一为 `Z01_02`,不是独立房间。
+
+## 1. 已确认可用区域(Z01–Z09)
+
+| 位置编号 | 空间 | 对应实景图文件 | 常用用途 |
+|---|---|---|---|
+| Z01.01 | 入口门厅 | `Z01_01_入口门厅_入口朝内_9x16.png` | 入口、玻璃门、产品柜 |
+| Z01.02 | 品牌墙与门厅小沙发 | `Z01_02_入口门厅_品牌墙与小沙发_9x16.png` | 扫镜头露出怡呵美品牌墙 |
+| Z02.01 | 产品展示柜 | `Z02_01_产品展示柜_柜前斜视_9x16.png` | 产品陈列讲解 |
+| Z03.01 | 前台 | `Z03_01_前台_顾客侧视角_9x16.png` | 前台桌前讲解 / 站定 |
+| Z04.01 | 等候洽谈区 | `Z04_01_等候洽谈区_沙发与展示墙_9x16.png` | 沙发/茶几/电视/窗帘/饮水设备 |
+| Z05.01 | 主走廊 | `Z05_01_主走廊_后段朝梳妆区_9x16.png` | 走位过渡 |
+| Z06.01 | 双床护理房 A | `Z06_01_双床护理房A_房门朝内_9x16.png` | 护理房 |
+| Z07.01 | 双床护理房 B | `Z07_01_双床护理房B_房门朝窗帘_9x16.png` | 护理房 |
+| Z08.01 | 单床仪器房 C | `Z08_01_单床仪器房C_房门朝内_9x16.png` | 仪器房 |
+| Z09.01 | 梳妆洗手区 | `Z09_01_梳妆洗手区_梳妆台与双盆_9x16.png` | 梳妆/洗手 |
+
+### 常用空间映射(写脚本选 zone 的速查)
+- 前台 = **Z03.01**;产品陈列架 = **Z02.01**(产品展示柜);主走廊 = **Z05.01**(走位过渡);品牌墙 = **Z01.02**(位于 Z02 上端);等候洽谈区 = **Z04.01**。
+- 空间可用范围已放开:所有已确认空间(Z01–Z09)均可用于动线,不再默认排除 Z04。若用户只说「换一条线路」而未指定,默认从 Z01–Z09 中设计明显不同于原线的新线路。
+
+### V4 开放公共区关系(务必遵守,避免生成「隔墙/关门」错误)
+- Z03 前台 与 Z01 门厅小沙发之间**无隔墙**,可通过连续公共地面直接连通。
+- Z04 等候洽谈区**无独立房门、无与 Z03 的隔墙**,与 Z03 前台同属一个开放公共区,可经连续公共地面直接通行。
+- 门厅、产品展示、前台、等候洽谈区属于相互连通的公共空间。
+- 不沿用旧图推断隔墙;跨前台与门厅的连接机位按 V4 开放关系理解。
+- 原俯瞰图标注的前台旁房间、台阶后门和未拍摄范围没有完整素材,列为 U01–U03 待补充(见下)。
+
+## 2. 待确认区域(U01–U03,**禁止使用**)
+
+| 编号 | 区域 | 说明 |
+|---|---|---|
+| U01 | 前台旁房间 | 只见门口及局部陈列,无完整内部画面;用途、边界待确认 |
+| U02 | 台阶后门内空间 | 拍到台阶和门,未拍摄门后内部 |
+| U03 | 未拍摄范围 | 边界、用途及房间数量均未知;这是未覆盖范围,**不能当成一间已确认房间** |
+
+**U01–U03 严禁作为生成参考或动线终点传入 wan3。** 门厅品牌墙旁的关闭平板门可在实景图看到,但门后用途及与 U01 的关系未知,不另推定房间。
+
+## 3. 空间锚定硬规则(wan3 生成必守,踩坑总结)
+
+1. **镜头真实经过的过渡空间必须传实景图**(如走廊走 Z05):俯瞰图 + 文字描述不能替代,否则模型会脑补、克隆出「幽灵硬件」(曾凭空多出第二个前台)。
+2. **参考图里出现的门必须显式声明状态**:关闭 / 仅作背景 / 禁止穿行。不声明则 wan3 会把门当动线通道(曾出现「穿门」错误)。
+3. **开放式空间要正面定性**:写「三面连通、不封闭、不是房间」,光列 anchors 不够。
+4. **硬件唯一性 + 反向禁令双写**:如「全店只有唯一一张木色前台桌,只存在于 Z03」+「禁止凭空新增或克隆家具/硬件」。
+5. **只传脚本实际出镜或途经的 zone 图**,未出镜的一律不传。
+6. 参考音频 ≤15s(用户音色 30s 需截取前 15s);媒体数实战 9 项(8 图 + 1 音频)可正常提交。
+
+## 4. 使用边界
+
+- 10 张实景图均为 1080×1920、9:16、无人物的生成设计参考图;V4 俯瞰图仅用于区域关系索引。
+- 这些图**尚不是多视角一致性校准的三维场景**:A/B 房左右对应、各房门与走廊图匹配、尺寸比例仍待核对。索引中保留原图位置,不把推断升级为实测事实。
+- 若要拍连续跨区域长镜头,还需要前段走廊、门口和转角等连接机位,现有素材不足以无缝拼接。
+- 向视频模型提供对应图片时,同时写出人物起点、经过的固定物体与终点;编号用来管理素材,**不能替代上传图片**。
+
+## 5. 在 wan3 工作流中如何引用
+
+- 从 `assets/store-spatial-index/` 选取脚本各 Shot 对应 zone 的实景图,作为 `reference_image` 传入(与「生成门店内景照片」二选一、实景优先)。
+- 每个 Shot 在 prompt 里**逐段锚定该 zone 的元素清单**(如门厅:品牌墙「YIHEMEI 你的水光肌肤管理师」+ 丝带吊灯 + 白门 + 圆几绿植 + 白沙发;产品区:怡呵美发光字展柜 + 灯带层板 + 绿植),并写「人物未走位时背景禁止漂移成其他房间」。
+- 人物真实经过的过渡空间(如走廊 Z05)**必须传对应实景图**,仅靠俯瞰图 + 文字会脑补「幽灵硬件」。
+- 详细工程要点与坑例见 `references/wan3-workflow.md` 第三节「门店空间实景图(zone 参考)」条目与第七节坑4。

+ 10 - 0
references/wan3-workflow.md

@@ -29,6 +29,7 @@
 |---|---|---|---|---|
 | 人物完整形象照 | **生成物料**:以 `character_5view` + `uniform_detail`(固定素材)为参考生成并确认(见 `asset-collection.md` 第二节) | `reference_image` | `Image 1` | 全片同脸/同发型/同年龄感/同制服;**胸牌样式与确认稿一致、不可变更** |
 | 门店内景照片(含 LOGO) | **生成物料**:以 `logo_3d`(固定素材)为 LOGO 参考生成含 LOGO 并确认(见第二节) | `reference_image` | `Image 2` | 前台墙面须出现怡呵美立体 LOGO |
+| 门店空间实景图(zone 参考,技能内置) | **技能内置资源**:`assets/store-spatial-index/` 下的 `Z0X_0Y_*.png`(10 张 9:16 实景图,区域/机位/可用-禁用区见 `references/store-spatial-index.md`) | `reference_image` | 自然语言描述 | 按脚本各 Shot 所在 zone 选取对应实景图传入;与「门店内景照片」二选一、**实景优先**;U01–U03 禁用;人物真实经过的过渡空间(如走廊 Z05)必须传对应图,只靠俯瞰图+文字会脑补「幽灵硬件」 |
 | 插画参考图 1/2 | 自动生成(抽象可视化风格启发) | `reference_image` | `Image 3` / `Image 4` | 无真人皮肤/血液/文字 |
 | 音色文件 | 公网 URL `config.brand_assets.voice_ref.url`(优先)或本地 `assets/brand/voice_ref.*`(兜底) | `reference_audio` | `Audio 1` | 单段 ≤15s;超长则裁剪一段代表音色 |
 | (生成输入,不提交)人物五视角图 / 制服细节图 / 立体 LOGO | 固定素材,仅用于生成 Image 1 / Image 2,本身不提交 wan3 | — | — | 锁死、不可被自动生成覆盖 |
@@ -139,3 +140,12 @@ python scripts/generate_video.py \
 - **坑3 · 多音字误读(如"定期"→"顶期")**:wan3 端到端 TTS 对多音字消歧不稳定,纯文本时好时坏;**拼音标注(如"定(dìng)期")反而会被整段念错(实测读成"定定妻"),不可用**。可用近义替换规避:把"定期"换成"订期"(同音 dìng、无歧义、语义贴),或"按周期"/"有规律地"。**提交前不要回改用户文案**,该替换本身就是防错手段。
 - **推荐流程 · 生成后 ASR 自查**:成片下载后用本地 ASR(funasr / faster-whisper,不外传素材)提取音频转文字,逐字核对:①片头是否乱读 ②时间数字/Shot序号是否被念出 ③多音字读音 ④片尾是否 padding 废话。先自查再交付,避免来回试错。详见技能 `scripts/` 下的 `extract_audio.py` + `asr_wordlevel.py` 用法(从 mp4 抽音频→逐词时间戳)。
 - **参考音频语义前置**:`reference_audio` 本是提取音色,但若样本本身带口播语义,可能被前置到片头。建议从音色源音频的**中段**裁一段(避开句首)作 ≤15s 样本。
+
+### 实测新增坑(2026-09-21 · 四季防晒 DDKP-013 系列实战)
+
+- **坑4 · 场景背景漂移(长镜头/走位段背景被换房间)**:wan3 在 25–30s 长镜头或人物走位段,会把已锚定的门店背景自行换成陌生房间(品牌墙、吊灯、门全部消失,沙发变样)。**解法**:在「总体描述」+ 每个 Shot 里**逐段锚定该 zone 的参考图元素清单**(例如门厅 Z01:品牌墙「YIHEMEI 你的水光肌肤管理师」+ 丝带吊灯 + 白门 + 圆几绿植 + 白沙发;产品区 Z02:怡呵美发光字展柜 + 灯带层板 + 绿植),并在硬规则里写"人物未走位时背景禁止漂移成其他房间"。**关键**:人物真实经过的过渡空间(如走廊 Z05)**必须传实景图**,只靠俯瞰图 + 文字描述不够,否则模型会脑补出"幽灵硬件/第二个前台"。**zone 实景图与 Z01–Z09 可用区 / U01–U03 禁用区 / V4 开放公共区关系 / 6 条空间锚定硬规则见 `references/store-spatial-index.md`,图片在 `assets/store-spatial-index/`,按 zone 文件名选取对应图传入。**
+- **坑5 · 口播幻觉加词(句间/句末自行补词)**:TTS 会在口播文本外自行补词/补句(如"做好防晒"后凭空补"干皮",或把 prompt 表格里的"插画持续""窗口拉满"等元文本当台词念出)。**解法**:① prompt 内联**完整「口播定本」**作唯一台词依据(不止是引用文件名);② 显式负面示例"尤其禁止在『X』之后追加『Y』类词;禁止根据画面/主题自行补词";③ 明确写"prompt 其他文字(章节标题 / 表格表头 / 规格标注 / 结构说明)一律不出声"。
+- **坑6 · 单字发音缺陷(非多音字也读错)**:参考音频只克隆音色、**不控制单字发音**,个别字会稳定读错(例:"晒"shài→shi)。与坑3(多音字)不同,这连拼音标注都救不了。**解法**:① **改字绕过(最快,推荐救急)**——把易错字换成近义/同音字且字数不变(例:末句"不是只有大太阳才需要**防晒的**"→"…需要**防护的**"),不动节奏/时长;② 重截参考音频基本无效(wan3 本就不控发音,且无原 30s 素材时不可行);③ **C 方案根治**:本账号百炼 **CosyVoice API 已验证可用**(返回参数错而非权限拒绝,克隆路径可走)——走"不传 reference_audio 提交 wan3 出静音成片 + 克隆用户音色合成正确发音配音 + ffmpeg 二次合成 + 对口型(lipsync)"。
+- **坑7 · 插画内出现人物(两个主角并置)**:PIP 插画里若出现任何人物/人形轮廓,会与口播真人并置成"两个女主角"。**解法**:红线——插画只画机理示意 / 物品 / 皮肤特写 / 光线氛围,**不得出现任何人物、人形轮廓、手势、人影**(生成插画的 prompt 必须显式写"画面中严禁出现任何完整人物或人物形象")。
+- **坑8 · 生成超时续轮询**:`scripts/generate_video.py` 默认 `poll timeout=1200s`,30s 视频偶发耗时 >20 分钟仍 `RUNNING` → 脚本因超时而 `RuntimeError` 退出,但**阿里云 task 并未失败**。**解法**:保留 stdout 回显的 `[轮询] task_id=...`,用脚本周期性 `GET {api_base}/api/v1/tasks/{task_id}` 续轮询;`status=SUCCEEDED` 后 `extract_video_url` + `download`,**不必重提任务**。
+- **补 · 本账号百炼云端 ASR 不可用**:`qwen3-asr-flash`(SDK / 兼容模式 / 原生端点,均 400)与 `paraformer-v2` 文件转写(403 "current user api does not support synchronous calls",账号未开通)全部拒绝。**音频核对只能走本地 ASR**(funasr / faster-whisper,不外传素材),见上方"推荐流程·生成后 ASR 自查"。

برخی فایل ها در این مقایسه diff نمایش داده نمی شوند زیرا تعداد فایل ها بسیار زیاد است