# HANDOFF — MiniMax H3 Combat Motion Chain

> **文件名称：** `handoff_combat.md`  
> **用途：** 将本次 ChatGPT 对话中的 Combat Prompt 设计、全部版本演进、角色设定、动作机制、镜头语言、已确定需求、当前 V5 成果及下一步 Codex 开发建议移交给 Codex。  
> **当前稳定版本：** **V5 — 20 秒、6 镜头、2D Anime / 3D CGI 两套、徒手拳脚格斗、环境破坏、香港动作电影式环境利用**。  
> **当前状态：** 用户已明确表示 V3、V4 的效果满意，随后要求 V5 延长至 20 秒并加入周边建筑破坏、多镜头、成龙式动作设计；V5 两套提示词已在对话中输出，**尚未提供 V5 生成视频做验收**。  
> **注意：** 本文件是对话交接材料，不应声称已实际测试或验证 H3 能精确执行所有动作、时码或结构破坏。

---

## 1. 交接摘要（给 Codex 先读）

用户正在建立一套面向 **MiniMax H3 视频生成**的 `Combat Motion Chain` 英文提示词设计体系。目标是用两张参考角色图创作高质量、动作连续、碰撞明确、镜头流畅的战斗视频，并逐版本升级。交接时最重要的约束：

1. **双风格并行**：始终输出两个独立且完整的 Prompt：`2D Traditional Anime` 和 `3D CGI Animation`。不能把两种风格混成一段。
2. **当前人物已换成徒手格斗家**：此前 Jianxin / Zhizhixiong 红衣剑客与紫衣武者的刀剑设定已经废弃，不要继承刀剑、剑气、火焰兵器或武器碰撞。
3. **人物身份以两张原始参考图为最高依据**；紫衣男子为 Subject 1，黑背心红裤男子为 Subject 2。Subject 2 的金属护腕是原图服饰，应保留，**不是拳击手套**。
4. **H3 固定结构**：`subject_definitions`、`summary`、`retention_analysis`、`detailed_description`、`overall_soundscape`、`non_diegetic_music`。每版可附约束组，但不能只输出空泛关键词。
5. **V5 当前目标**：20 秒、6 个镜头，match-on-action 剪辑、No Combat Reset、Adaptive Combat、建筑/周边环境逐步破坏、1.0x 实时播放、Zero Idle。
6. **核心动力学规则**：`Every attack creates a reaction. Every reaction creates the next attack. No movement exists independently.`
7. **电影动作设计**：借鉴成龙式经典香港动作电影的**动作编排原则**，包括利用桌椅/建筑躲闪、失衡后的巧妙恢复、借力打力、动作因果、清楚的空间方位、可读的表演；**不能改变参考人物面容变成演员本人**。
8. **输出与继续开发**：Codex 可据此维护可编辑的 prompt 模板、角色设定、动作段落、镜头规划与校验器，并逐次依据生成结果优化。

---

## 2. 对话完整演进路线（Q&A / 决策记录）

### 阶段 0：最初的刀剑对战 Prompt

用户给定的原始英文 Prompt（当时的角色和风格）：

```text
(Style: 3D CGI animation / 2D traditional anime) Masterpiece, high quality, cinematic lighting.
Subject: A fierce battle sequence featuring two characters based on the reference images—a red-clad swordsman (Jianxin) and a purple-robed warrior (Zhizhixiong).
Action: The camera begins with a dynamic low-angle tracking shot. The swordsman in red dashes forward with a long sword, leaving a glowing trail, while the warrior in purple stands firm and executes a sweeping counter-attack with a flaming effect. They clash in the center of the frame, creating a shockwave of energy and sparks. The camera rapidly orbits around them as the fiery battle intensifies, concluding with the red-clad swordsman landing gracefully while the purple warrior points his weapon forward, both facing the camera.
Environment: Dramatic background with embers floating in the air, high contrast lighting.
```

**当时发现的设计缺陷：** 只有冲刺、碰撞、绕拍、定格站姿，缺少真正的连续攻防、格挡后的反击、受力与移动衔接。

### 阶段 1：用户提供五大动作设计法则（原始要求）

用户设定助手为熟悉《疾速追杀》《谍影重重》和80年代香港动作片的动作指导及 AI 视频 Prompt 专家，要求：

1. **时间轴微观拆解**：10 秒可按 `[00:00–00:03]`、`[00:03–00:06]`、`[00:06–00:10]` 设计；2–3 秒出现明确动能交接。
2. **Zero Idle（动能连贯闭环）**：上一个动作的受击、失衡、撞墙、闪避，必须转化为下一招的起始动量，禁止「打一下→停顿→摆架势」。
3. **生物力学具体动词**：使用 `forearm check`、`elbow strike`、`low calf kick`、`palm strike`、`wrist-trap` 等具体动作，不以 `fight` 或 `kungfu` 代替编排。
4. **防生成误判**：`bare hands`、`no gloves`、`1.0x real-time speed`、`zero slow-motion`；刀剑时期的 `bare hands` 需理解为不用额外拳套，而非武器消失。
5. **声音与镜头协同**：镜头按动量运动；拳脚、石头、木板、布料、呼吸等声音贴合材质和实际事件。

用户指定六部分输出格式：

```text
subject_definitions:
summary:
retention_analysis:
detailed_description:
overall_soundscape:
non_diegetic_music:
```

### 阶段 2：V1 — 两套 10 秒刀剑版本

**用户提问：**「我要两个场景，2d anime & 3d cgi animation, 开始优化」  
**确定内容：** 首次产出两个完整版：

- 2D Anime：手绘、cel shading、smear/impact frames、剑气、快节奏运动。
- 3D CGI：PBR、真实惯性、接触力、布料/火焰/地面反馈。

两者均明确 Attack → Block/Parry → Counterattack → Evasion → Collision；避免无因果的光效和突然切位。

### 阶段 3：V2 — 12 秒，Combat Motion Chain

**用户提问：**「这两套2d & 3d 我都觉得不错，现在加入最终优化方向，12s」  
**处理：** 两套均延长 12 秒，划分 4 个 3 秒阶段：

| 时段 | 当时刀剑版内容 |
|---|---|
| 00–03s | 冲刺、上斩、格挡 |
| 03–06s | 横扫、闪避、反击 |
| 06–09s | 三次近身武器接触、逼退、追击 |
| 09–12s | 大碰撞、双方恢复、再次攻击 |

新增机制：

- **Attack–Defense Dependency**：攻防之间必须有因果。
- **Contact Point Precision**：接触点、方向、回弹清晰。
- **Spatial Combat Lock**：角色/武器/方位不跳变。
- **Effect Follows Action**：特效服从动作，不能替代真实武器/肢体接触。

主链：

```text
Acceleration → Attack → Contact → Deflection → Counterattack
→ Evasion → Repositioning → Final Collision → Recovery → Next Attack
```

### 阶段 4：V3 — 明确针对 MiniMax H3 优化

**用户提问：**「帮我优化成适合minimax h3 的提示词」  
**处理：** 将两套 V2 适配 H3 的六节英文格式。坚持可解析角色身份、清楚四阶段时轴、镜头按动作移动、环境声写入 `overall_soundscape`。当时 V3 使用**四个 Shot，可以 cut**；该阶段得到用户满意确认。

### 阶段 5：V4 — 12 秒一镜到底

**用户提问：**「两套v3 都很满意，现在进入两套v4」  
**处理：** 两套升级为 `Single Continuous Shot`：

- `ONE continuous 12-second camera take`。
- 不允许 cuts / hidden edits / camera teleportation。
- `Continuous Camera Path`、`Combat State Persistence`、`Weapon Trajectory Lock`（刀剑阶段）、`Momentum Handoff`。
- 四个 3 秒阶段只是 **动作时间窗口，不再是切镜指令**。
- 镜头：Low Angle Tracking → Lateral Curve → Low Evasion Tracking → Medium-Wide Side Tracking → Controlled Orbit → Continued Tracking。

### 阶段 6：决定性需求变化 — 用参考图改成拳脚格斗

**用户上传两张图片，要求：**「现在我把之前拿刀的角色改成拳击腿法的角色，请帮我改动v4的两套提示词」

角色图（此对话可见的文件名）：

- 图 1 / Subject 1：`Muscular Martial Hero in Purple and Lavender(1).png`
- 图 2 / Subject 2：`Roaring Red Warpaint Warrior-3.png`

**重要：后续版本全部以这两位为主体；刀剑人物设定作废。**

徒手格斗新主链：

```text
Footwork → Hip Rotation → Shoulder Drive → Strike → Contact
→ Body Reaction → Defensive Redirection → Counterattack → Recovery → Next Strike
```

动作从刀剑改为 `straight punch`、`hook`、`uppercut`、`forearm block/parry`、`head slip`、`low roundhouse kick`、`knee strike`、`elbow strike`、`spinning back kick`、`shin check`。

V4-A 动漫版保留夸张撞击帧和空气压缩特效；V4-B 3D 版强调支撑脚、髋部、肩部、重心、肌肉受力、接触后重心重新分配。两个版本都是 **12秒一镜到底**。

### 阶段 7：当前 V5 — 20 秒、多镜头、建筑破坏、香港动作编排

**用户提问（最新完整创作要求）：**「这次的效果不错，把提示词升级成 v5, 做成20s 画面，加入周边建筑的破坏效果，加入多镜头效果，加入成龙的动作设计效果」

已输出两套英文完整版：

- **V5-A**：`2D Traditional Anime — 20s Multi-Shot Adaptive Combat & Destruction`
- **V5-B**：`3D CGI Animation — 20s Multi-Shot Physical Combat & Environmental Destruction`

**确定规格：20s、6个Shot、match-on-action、保留两张角色图、赤手空拳、周边建筑逐级破坏、成龙式创意环境互动、1.0x、zero slow-mo、zero idle。**

V5 引入 `Observe → Anticipate → Evade → Redirect → Counterattack → Environmental Interaction → Structural Damage → Momentum Recovery → Next Attack`。

**当前尚无用户提供的 V5 实际生成视频或失败案例。Codex 后续不能把预期表现当作测试结论。**

---

## 3. 人物设定与图片资产（必须锁定）

### Subject 1 — Purple Martial Artist

**图像：** `Muscular Martial Hero in Purple and Lavender(1).png`

- 厚实蓬松的黑色中长层次发型、浓眉、干净下巴、严肃冷静表情。
- 高度肌肉化、结实手臂。
- 紫色无袖贴身上衣，浅粉紫色/淡紫色有光泽长裤，深色腰带，黑色长靴。
- 双手赤手空拳，无拳套、无手带，无新添加的兵器。
- 角色倾向：迅速的直拳、短勾拳、外侧前臂格挡、侧闪、低扫腿、转身后踢、快速脚步，善于观察肩/髋/脚步先兆，以预判、闪避与环境借力反击。
- 风格表演：冷静、灵活、敏捷、聪明、精准；**不能因为他较灵活就强制他一定获胜**。

### Subject 2 — Red-Trousered Heavy Warrior

**图像：** `Roaring Red Warpaint Warrior-3.png`

- 极其魁梧的上身，黑色直立短发、两侧短剃，浓黑胡须，面部明显红色竖向纹路，愤怒咆哮表情（动态表情可变化，但身份与纹路须保留）。
- 黑色无袖背心、深红/亮红有光泽长裤、黑腰带、黑色厚重系带战靴。
- **原图有金属前臂装饰 / 护腕，必须保留，不得误判成拳击手套，不得删除**。
- 赤手空拳，无拳套，无兵器。
- 角色倾向：强力直拳、重勾拳、短肘击、上顶膝击、低踢、前冲压迫与高重量打击。
- 风格表演：强势、凶悍、压迫感、爆发力；同时可以合理格挡和迅速调整重心。

### 图片优先级规则

```text
Reference Image 1 → <Subject 1> → 紫衣格斗家
Reference Image 2 → <Subject 2> → 黑衣红裤狂战士

REFERENCE IMAGE IDENTITY > prompt's generic appearance language
```

保持：脸、发型、肌肉比例、服装、鞋子、装饰、颜色、肢体数量。禁止：互换人物、双人融合、角色复制、换服装、突然出现手套/武器、额外角色。

**交接资产提示：** 此 `.md` 是文字文件，不内嵌原始参考图。到 Codex 时请将两张 PNG 一并置于 `assets/references/` 或自行更改路径。用户已在这轮会话上传两张图片，但离线交接时不能假设 Codex 自动看到聊天中的图片。

---

## 4. 统一动作设计原则（V5 已确定）

### 4.1 原始 5 条规则

1. **Micro-Timeline**：按明确时间窗安排动作；每次时间推进都应有明确动作或动能转换。
2. **Zero Idle**：禁止「完成招式→站立停顿→摆架势→再攻击」。
3. **Specific Biomechanics**：写清重心、支撑脚、髋部、肩部、手臂、膝盖、踢腿轨迹，不用只写 `fight`。
4. **Generation Guardrails**：`bare hands`、`no gloves`、`no weapons`、`1.0x real-time speed`、`zero slow motion`，保留 Subject 2 原有金属护腕。
5. **Sound/Camera Alignment**：镜头运动与角色动量对应；音效与材质、碰撞、破坏事件同步。

### 4.2 V2–V4 加入的规则

6. **Attack–Defense Dependency**：攻击引起格挡、躲避或身体后退；该反应再引发下一招。
7. **Contact Point Precision**：拳对前臂、胫骨对大腿、靴底对护臂、肩膀对墙面等必须有清晰可见的接触点。
8. **Spatial Combat Lock**：角色左右、方向、相互距离、建筑相对方位跨镜保持。
9. **Effect Follows Action**：impact flash、灰尘、石屑、碎木必须由可见动作产生；不得用特效代替拳脚接触。
10. **Continuous Camera Path（V4 专属）**：一镜到底时不得剪辑、跳机位。
11. **Combat State Persistence**：上段动作终点 = 下段动作起点；身体/脚步/重心状态不重置。
12. **Trajectory Lock**：手脚轨迹和攻击方向可辨认。
13. **Momentum Handoff**：防守与受击反馈直接转换为下一招。

### 4.3 V5 新增的自适应与环境规则

14. **Predictive Defense**：通过肩、髋、支撑脚的提前变化来预判，而不是等击中才反应。
15. **Adaptive Counterattack**：根据对手被偏转的身体重心选择下一招。
16. **Environment as Combat Partner**：桌子、石柱、墙、木框、木梁不只是背景；可用于躲闪、跨越、误击、借力。
17. **Persistent Destruction**：前面被打裂的柱子/墙不能在下一个镜头自愈。
18. **Match-on-Action Editing**：6 个 shot 可以 cut，但切点是同一个动作的中途延续，不得重复起手、重置人物方位或动作。
19. **Structural Causality**：建筑破坏需可见接触和结构支撑关系。屋檐/瓦片掉落要因为支撑木柱破坏，不能无缘无故坍塌。
20. **Action Readability**：复杂环境破坏不能遮蔽关键拳脚接触，保持两人完整可辨。

主总控语句：

```text
Every attack changes the opponent's physical state.
Every defensive reaction creates a new tactical opportunity.
Every environmental collision changes the battlefield.
All subsequent actions must adapt to those changes.

Every attack creates a reaction.
Every reaction creates the next attack.
No movement exists independently.
```

---

## 5. V5 20秒六镜头主线（两个风格共享）

| Shot | 时间 | 人物连续动作 | 周边建筑反应 | 镜头 | 接续逻辑 |
|---|---|---|---|---|---|
| 1 | 00:00–00:03 | 紫衣冲刺左直拳；红裤侧闪重右勾；紫衣下潜 | 红裤拳误击石柱，石柱碎裂掉灰 | low-angle tracking | 紫衣利用敌方手臂伸出空档启动低扫腿 |
| 2 | 00:03–00:06 | 紫衣右低扫腿击中外侧大腿；红裤前压右膝；紫衣前臂挡膝并后撤翻过桌子 | 红裤肩/前臂撞碎木桌 | medium-wide side tracking | 紫衣在桌子另一边落地转体进入反击 |
| 3 | 00:06–00:09 | 紫衣左勾→红裤防；红裤右勾→紫衣下潜；紫衣右上勾→红裤防；红裤左肘→紫衣侧闪；紫衣回旋踢中护臂 | 红裤肘误击石墙，墙面剥落 | medium close combat | 红裤被踢后退，下一镜从后退接上 |
| 4 | 00:09–00:12 | 红裤蹬地前冲直拳；紫衣借低木框侧向弹跳躲避；紫衣落地身体横踢；红裤护臂拦截 | 红裤拳打裂木框，木板断落 | wide tracking | 护臂格挡让红裤身体旋转进入下一招 |
| 5 | 00:12–00:16 | 红裤重右勾；紫衣躲闪、左勾、挡膝、低扫；红裤抬胫格挡后肩部冲撞；紫衣转向引导 | 红裤肩膀撞到弱化石墙，局部倒塌 | medium-wide dynamic orbit | 红裤拨开墙体碎片转身，紫衣追击 |
| 6 | 00:16–00:20 | 红裤右直拳；紫衣前臂偏转→右勾；红裤格挡→膝击；紫衣侧闪转身后踢击中护臂 | 红裤后退撞裂已有损伤的支撑柱，连带小段屋顶/瓦片坍落 | wide-to-medium tracking | 两人闪避掉落物，立即重新交锋；末帧仍在下一招起始 |

### 重要时序补充

- 用户明确要求 **多镜头**；V5 不应继承 V4 的 `no cuts` 规则。应写 **exactly 6 shots connected by match-on-action**。
- `00:03 / 00:06 / 00:09 / 00:12 / 00:16` 是 cut 点，镜头前后同一动作连贯。
- 最终 `00:20` **不是静止 victory pose**，要保留下一轮低扫腿与抬腿防守启动。
- 20 秒安排多次细微碰撞和多种建筑事件，**模型不一定能逐一精确实现**；生成后可优先评估角色一致性、战斗连贯性和主要破坏因果。

---

## 6. 六部分 MiniMax H3 Prompt 约定

两套 Prompt 均采用以下顺序和信息职责：

```text
subject_definitions:
  <Subject 1> is ... Reference Image 1 ... bare fists ...
  <Subject 2> is ... Reference Image 2 ... metal forearm accessories ...

summary:
  [Reference-based Video Generation]
  Create a 20-second ...
  6 shots, match-on-action, 1.0x, zero idle...

retention_analysis:
  Preserve identities, colors, clothes, body proportions,
  hand anatomy, and original accessories across shots.

detailed_description:
  [Shot 1 — 00:00.000 to 00:03.000]
  ...
  [Shot 2 — 00:03.000 to 00:06.000]
  ...
  [Shot 3 — 00:06.000 to 00:09.000]
  ...
  [Shot 4 — 00:09.000 to 00:12.000]
  ...
  [Shot 5 — 00:12.000 to 00:16.000]
  ...
  [Shot 6 — 00:16.000 to 00:20.000]
  ...

overall_soundscape:
  Punch / forearm / shin / knee / boots / stone / wood / roof / breath.
  Sound synchronized to visible contacts.

non_diegetic_music:
  N/A

MULTI-SHOT CAMERA REQUIREMENTS:
  Match on action; preserve screen direction and geography.

ADAPTIVE / PHYSICAL COMBAT REQUIREMENTS:
  Predict, evade, counter; leg/hip/shoulder-driven action.

ENVIRONMENTAL DESTRUCTION / PHYSICS REQUIREMENTS:
  Contact-caused damage; persistent state; gravity; no arbitrary explosion.
```

**参考图索引注意：** 本次聊天里使用的是 `Reference Image 1` 和 `Reference Image 2`，不是自动可用的 `@P1/@P2`。如果 Codex 通过不同 H3 接口调用，应把参考图标记映射到实际 API 的图像槽位，不能擅自假设相关语法。

---

## 7. V5-A — 2D Traditional Anime 的完整创作规格

### 7.1 风格、角色与运动

```text
Create a 20-second masterpiece-quality traditional 2D Japanese
anime martial arts combat sequence between the purple-shirted
martial artist and the massive red-trousered warrior.

Premium hand-drawn animation, sharp cel shading, expressive
keyframes, dynamic perspective distortion, controlled smear
frames, brief impact frames, hand-painted debris, readable
character silhouettes, and inventive Hong Kong action cinema
physical storytelling.

Both fighters use bare fists, elbows, knees, and legs exclusively.
No weapons, no boxing gloves, no supernatural projectiles.
Raw 1.0x speed. Zero slow motion. Zero idle pauses.
Exactly six shots, linked with match-on-action editing.
```

### 7.2 六镜头细化（2D 动漫版）

**Shot 1 / 0–3s — Stone Column**  
破败石头庭院；石柱支撑木屋檐。低角度跟进。紫衣先冲刺出快速左直拳；红裤观察肩部后侧闪并转腰抡右重勾；紫衣下潜，拳头误击石柱。**明确 fist-to-stone contact**，动漫闪白、柱身裂纹、石屑飞出；紫衣借对手手臂伸出后空当转髋，准备扫腿。

**Shot 2 / 3–6s — Low Kick, Knee, Table**  
切镜卡在转髋中段；紫衣右低扫踢外侧大腿，红裤支撑腿下沉后立即向前右膝顶；紫衣双前臂封住膝击，后移至木桌，单手支撑在桌沿向侧方翻越；红裤冲撞误击木桌，木板断裂、木屑飞散；紫衣落地转身继续攻击。

**Shot 3 / 6–9s — Close Combat, Wall**  
切镜接落地旋转；左勾击中红裤护臂、红裤右勾反击、紫衣下潜、紫衣紧凑右上勾撞防守、红裤短左肘、紫衣旋身避开。红裤肘部误击石墙，墙皮碎裂、灰尘喷出；紫衣顺势侧身回旋踢，红裤双前臂挡踢，受力后退。

**Shot 4 / 9–12s — Wooden Frame**  
广角接红裤后退；红裤踩稳后强势冲锋直拳。紫衣观察肩部启动，侧身向低木框，一脚短促蹬框侧向腾挪；红裤拳头砸碎木架，碎木下坠；紫衣落地身体横踢，红裤紧凑前臂挡住，将受力转为身体旋转。

**Shot 5 / 12–16s — Partial Wall Collapse**  
切镜接红裤旋身；重勾拳、紫衣侧闪反左勾、红裤前臂挡、红裤起膝、紫衣双臂防守、紫衣低扫、红裤抬胫格挡；红裤转为冲肩，紫衣侧转并引导其撞上受损墙段。**肩部撞墙后局部坍落**；碎石和灰尘连贯；红裤拨开墙体掉落物重新追击。

**Shot 6 / 16–20s — Support Column and Roof**  
广角穿过漂浮灰尘，旧损伤全都可见；红裤前冲右直拳，紫衣前臂偏转、接右勾，红裤挡、起膝，紫衣侧闪利用旋转做后踢，踢中红裤双前臂；红裤后退撞到**先前有损伤的**木柱，支撑断裂导致局部瓦屋顶掉落。两人躲避掉落的梁瓦，再重新面对面接续低扫/抬胫防守。末帧动作仍在继续。

### 7.3 2D 的约束优先级

1. 脸、衣服、体型、动作阅读性优先于大爆炸特效。
2. Anime impact frame 是**瞬时插帧/强调**，不得扩展为慢动作段落。
3. 允许夸张透视、瞬间冲击闪白、快速运动残影，但接触位置不能被遮挡。
4. 破坏可适当夸张，但起因仍需清楚：拳/肘/肩/身体对建筑的撞击。
5. 不要生成武器、火焰兵器、远程能量攻击。

---

## 8. V5-B — 3D CGI Animation 的完整创作规格

### 8.1 风格、材质与物理

```text
Create a continuous 20-second premium cinematic 3D CGI
hand-to-hand combat sequence, divided into six connected shots.

Physically based rendering, realistic skin, muscle response,
cloth and hair dynamics, believable joint mechanics, foot-ground
friction, body-weight transfer, directional recoil, physically
motivated destruction, cinematic global illumination and
volumetric atmospheric lighting.

The fighters use bare hands, elbows, knees, and legs only.
Subject 2 retains the original metallic forearm accessories.
No weapons, no gloves, no slow motion, no random teleportation.
```

### 8.2 六镜头细化（3D 物理版）

**Shot 1 / 0–3s**：紫衣蹬后脚冲刺出左直拳；红裤从紫衣肩部转动预判并侧闪，以髋/肩驱动右重勾；紫衣下潜让右勾撞石柱。碰撞明确，有拳头制动/手臂回弹，石柱局部开裂、落石、灰尘。紫衣转至暴露侧开启低踢。

**Shot 2 / 3–6s**：切镜接踢腿延伸；胫骨接触大腿，红裤腿/髋受力弯曲，接右膝顶；紫衣双前臂承受、后撤至桌沿，手掌承重做短侧向 vault，腿越过桌面；红裤肩/前臂打碎桌面，碎木沿冲击方向散落，紫衣另一侧落地转身。

**Shot 3 / 6–9s**：近距离拳肘；左勾打护臂、右勾来袭紫衣低头、紫衣右上勾触及红裤护挡，红裤左肘误击石墙，局部墙皮脱落；紫衣回转横扫踢击红裤双前臂，红裤后退。重点：肉体与护挡受力，石灰石碎片按重力掉落。

**Shot 4 / 9–12s**：广角，红裤脚踩实地面前冲直拳，紫衣借矮木架踏脚/侧跃改变移动方向；红裤拳头击裂木架，碎片沿力的方向散落，紫衣落地侧向踢身，红裤前臂格挡，并将受力引入后续旋转反击。

**Shot 5 / 12–16s**：大范围相对方位一致的旋转跟拍；重右勾、紫衣侧闪短左勾、红裤前臂挡、红裤膝击、紫衣防、紫衣低扫、红裤 shin check、红裤肩撞前冲；紫衣侧移并轻度引导红裤撞弱化石墙。红裤肩对墙接触明确，墙体局部按撞击点断裂掉落，红裤不突然传送或摔倒重置。

**Shot 6 / 16–20s**：上段灰尘和损坏继续存在；红裤右直拳、紫衣外侧前臂 parry、紫衣右勾、红裤挡、红裤起膝、紫衣侧闪后旋身 back kick；踢中红裤双臂护挡，红裤脚滑并撞击已有损坏支撑木柱；柱断导致小区域梁瓦坠落。两人立即躲避并开始新一轮低扫腿和抬胫 check。绝不站着摆姿势。

### 8.3 3D 必须满足的运动与场景物理

- 直拳：rear foot drive → hip/torso rotation → shoulder drive → arm extension → impact/evasion → recovery。
- 低踢：supporting-foot pivot → hip rotation → shin trajectory → thigh impact → leg recoil → reposition。
- 后踢：head/shoulders initiate turn → hips rotate → kicking leg extends → guard impact → controlled recovery。
- 防御：block/parry 有可见的臂部受力，不是拳头凭空停住。
- 环境破坏：碰撞部位与裂纹部位一致，木板断裂后位置可追踪，掉落物遵守重力。
- 建筑局部坍塌优先，避免整栋建筑在没有足够支撑破坏时无理由倒塌。
- 多镜头中**服装、皮肤、面纹、金属护腕、角色身高体积**不漂移。
- `1.0x real-time speed` 不等于动作缓慢；速度来自真实角色高频动作，不是调节播放速度。

---

## 9. V5 的负面约束（全局复制即可）

```text
No weapons.
No swords.
No knives.
No boxing gloves.
No hand wraps unless clearly present in the reference.
Preserve Subject 2's original metallic forearm accessories.
No extra fighters.
No character swapping.
No costume changes.
No additional limbs or deformed joints.
No unexplained teleportation.
No floating feet.
No disconnected attack animations.
No arbitrary movement resets across shots.
No slow motion.
No freeze-frame ending.
No stationary victory pose.
No random energy blasts or supernatural projectiles.
No destruction without identifiable physical impact.
No building repair between shots.
No debris that permanently obscures the fighters.
No camera spinning without relation to combat momentum.
No excessive motion blur that hides strike contact.
```

**注意 H3 实际提示词长度与模型约束：** 当前 V5 两版都属于高密度、长文本编排。如果生成视频压缩、忽略事件、重复同一动作，后续应保留整体因果链而降低每个 3 秒镜头中的动作数量，优先保留每镜头的 1–2 次清晰打击 + 1 个环境互动。这是**待验证的优化建议**，不是已证实的模型能力边界。

---

## 10. 对话中用户已经认可和不能随意推翻的决定

- 用户原先认可 2D/3D 两套分离的 10 秒战斗提示词。
- 用户要求、认可将其升级为 12 秒的 V2 Combat Motion Chain。
- 用户明确说 **「两套v3 都很满意」**，说明 H3 六部分结构与分段动作风格可保留。
- 用户明确要求进入 V4 一镜到底，之后换成两名拳脚格斗家。
- 用户评价新的 V4 徒手格斗效果 **「这次的效果不错」**。
- 用户要求 V5 **20 秒 / 多镜头 / 周边建筑破坏 / 成龙动作设计效果**；该方向当前是最新基线。
- 因此下一次优化应 **在 V5 基线上迭代**，不要无故回到刀剑、12 秒、一镜到底或取消场景破坏。

---

## 11. 建议 Codex 项目结构（建议，不是已存在的代码）

以下仅为交接时可采用的开发规划，**当前对话没有提供实际项目代码、API 密钥或既有 repository 结构**。Codex 应先扫描用户实际工作区，再决定是否采用：

```text
combat-motion-chain/
├─ README.md
├─ handoff_combat.md
├─ assets/
│  └─ references/
│     ├─ subject_1_purple.png
│     └─ subject_2_red.png
├─ config/
│  ├─ characters.json
│  ├─ combat_rules.json
│  └─ camera_presets.json
├─ prompts/
│  ├─ v4/
│  │  ├─ anime_12s_one_take.txt
│  │  └─ cgi_12s_one_take.txt
│  └─ v5/
│     ├─ anime_20s_multishot.txt
│     └─ cgi_20s_multishot.txt
├─ scenes/
│  └─ v5_timeline.json
├─ scripts/
│  └─ validate_prompt.py
└─ evaluations/
   └─ generation_review_template.md
```

推荐数据结构：

```json
{
  "project": "MiniMax H3 Combat Motion Chain",
  "version": "V5",
  "duration_seconds": 20,
  "variants": ["2D_TRADITIONAL_ANIME", "3D_CGI_ANIMATION"],
  "subject_1": {
    "reference_image": "assets/references/subject_1_purple.png",
    "role": "agile_martial_artist",
    "bare_hands": true
  },
  "subject_2": {
    "reference_image": "assets/references/subject_2_red.png",
    "role": "heavy_martial_artist",
    "bare_hands": true,
    "preserve_metal_forearm_accessories": true
  },
  "style": {
    "playback_speed": "1.0x",
    "slow_motion": false,
    "weapons": false,
    "zero_idle": true,
    "number_of_shots": 6,
    "match_on_action": true,
    "environmental_destruction": true
  },
  "shot_windows": [[0, 3], [3, 6], [6, 9], [9, 12], [12, 16], [16, 20]]
}
```

### 建议校验功能

1. **Schema 检查**：六部分字段都存在，6 Shot 时码覆盖 0–20 秒、无间隙或重叠。
2. **角色检查**：两位角色引用映射一致；禁止误加手套、武器；Subject 2 保留护腕。
3. **版本检查**：V4 的 `one take/no cuts` 不得污染 V5 的 `six-shot/match-on-action`。
4. **镜头连续性检查**：上个 Shot 的最后一个动作与下个 Shot 的第一个动作必须具有接续关系。
5. **场景持久性检查**：损坏柱、桌、墙、木框、梁、屋顶不可恢复完整。
6. **声效检查**：拳头、腿、身体、石、木、屋顶对应具体时间和事件。
7. **物理与节奏检查**：1.0x/zero idle/zero slow-mo，避免不可能的身体位移与无接触碰撞。
8. **双风格检查**：Anime 与 CGI 的视觉描述和物理描述不串台。

---

## 12. 人工评估生成结果的建议表

建议生成视频后逐项记录，作为后续 V5.1/V6 优化输入：

| 检查项 | 要观察什么 | 建议分值 |
|---|---|---|
| Identity Consistency | 两人脸/体型/服装不变，红裤脸上纹路及护腕保留 | 0–5 |
| Combat Continuity | 动作不重置、不停顿、没有突然新姿势 | 0–5 |
| Strike Contact | 拳头/小腿/护臂碰撞有实际接触与后坐力 | 0–5 |
| Footwork & Biomechanics | 支撑腿/髋部/重心可理解 | 0–5 |
| Camera Match-on-Action | 6 镜头剪辑时方向和动作衔接 | 0–5 |
| Adaptive Combat | 有观察动作前兆、提前闪躲、合理反击 | 0–5 |
| Environmental Storytelling | 环境用于位移、闪避、误击，而非无端炸毁 | 0–5 |
| Destruction Causality | 每一次破坏有明确碰撞原因 | 0–5 |
| Persistent Damage | 后续镜头建筑残损持续存在 | 0–5 |
| Timing & Speed | 20 秒内尽可能按时序演出、无慢动作 | 0–5 |

分数和视频问题应记录原始生成结果，不能只凭 Prompt 文字给高分。

---

## 13. 优先级、取舍与已知风险

**强制优先级建议：**

1. 人物身份/服装/手部正确。
2. 对手之间有清楚的攻防因果。
3. 关键拳脚接触与受力可见。
4. 镜头之间有连续空间关系。
5. 环境互动合理且破坏持续。
6. 动画风格、火花/灰尘、破坏规模细节。

**已知创作风险（未实际验证）：**

- 20 秒同时塞入 6 次镜头切换、多招格斗、多个建筑破坏事件，H3 可能省略或重排部分事件。
- 特别密集的三秒窗口容易变成快速随机拳击，导致动作因果不清楚。
- 纯文本 `exactly six shots`、`1.0x` 等是目标，不是 API 层强制保障。
- 多镜头容易出现镜头反打时左右方位变更，需要明确空间地图和 match-on-action。
- 角色原本手姿不同（紫衣握拳，红裤张手咆哮），生成战斗时允许自然改变手势，但不能改变人物身份或删除护腕。
- 以「成龙动作设计」为目标应聚焦灵活的道具运用和失衡恢复，不应变成真人换脸或模仿演员身份。
- 废墟中的柱、梁、墙相对位置必须固定，否则被撞毁的建筑会在下个镜头出现不同地点。

---

## 14. Codex 下一轮可执行任务（开发建议）

**任务 1 — 先查现有工程**  
扫描工作区，列出已有 prompt、图片、H3 API 调用、UI、测试脚本。不创建重复目录，不覆盖用户现有成果。

**任务 2 — 保存可维护的 V5 两套 Prompt**  
把 2D/3D 的人物段落、summary、retention、6-shot choreography、声效与约束保存为单独文件；支持单独修改某一镜头。若要求完全一致文本，以本聊天中的最后两份 V5 英文提示词为权威正文，本 handoff 的第 7、8 节提供结构化、忠实的细节复述。

**任务 3 — 将角色/场景独立配置**  
角色外观和服饰从 Prompt 正文抽取为共享可复用的 `characters.json`，镜头时轴/破坏状态放入独立 JSON。

**任务 4 — 建立 Prompt Compiler**  
由 `style + subjects + shot plan + sound + constraints` 组合出 H3 六段结构英文 Prompt；支持 2D/3D 两个风格模板。

**任务 5 — 加入校验器**  
检查错误时码、缺漏 Shot、混用「no cuts」和「six shots」、刀剑词汇遗留、人物互换、装备错误、建筑自愈。

**任务 6 — 评估反馈闭环**  
允许导入生成的视频观察笔记（如某秒动作失败），按 Shot 分析 `attack / reaction / environment / camera / identity` 出问题的位置，并局部重写对应 Prompt，而不是无条件整段推翻。

**任务 7 — V5.1 / V6 可选增强**  
加入镜头起止状态（Start/End State）、简易俯视场地地图、破坏状态注册表、动作预算、碰撞事件图；这些是下一步建议，**不是当前 V5 已实现的功能**。

---

## 15. 可以直接交给 Codex 的开发提示词

```text
你现在负责继续开发“MiniMax H3 Combat Motion Chain”提示词系统。
请先完整阅读 handoff_combat.md，并扫描当前工作区所有已有文件。

项目最新基线是 V5：两名上传参考图人物，赤手空拳，20秒，6镜头，
有创意的经典香港动作片式环境利用、物理攻防因果、周边建筑渐进破坏，
输出独立的 2D Traditional Anime 和 3D CGI Animation 两套英文 MiniMax H3 Prompt。

必须保留：
- 图1紫衣肌肉格斗家、图2黑背心红裤格斗家；不得交换。
- 图2的金属护腕必须保留；双方不使用拳击手套或武器。
- 1.0x 实时速度、Zero Idle、No Slow Motion。
- Attack → Reaction → Counterattack 的动能闭环。
- 6 Shot: [0,3], [3,6], [6,9], [9,12], [12,16], [16,20]。
- Match-on-action 剪辑，不能错误地强制 V5 一镜到底。
- 建筑破坏来自可见碰撞，并且损伤跨镜头持续。
- 两套风格分别保持 2D 手绘动画 / 3D CGI 视觉一致。
- MiniMax H3 六段结构：subject_definitions, summary, retention_analysis,
  detailed_description, overall_soundscape, non_diegetic_music。

请先：
1. 汇报现有工程结构与可以复用的文件。
2. 整理 V5 的 6 Shot 分镜数据结构及角色/环境配置。
3. 设计并实现可复用的双风格 Prompt Compiler / Validator（若工程已有同类功能则扩展）。
4. 生成两份可直接复制给 H3 的完整英文 Prompt。
5. 给出校验结果、测试方法和未验证问题清单。

不要声称已运行任何未实际运行的 H3 生成；不要虚构 API 行为。
不要把原来的刀剑、红衣剑客、紫袍持剑武者设定带回 V5。
保留现有文件与版本历史，任何破坏性修改先备份。
```

---

## 16. 状态清单：已确定 / 未确定

### 已确定

- ✅ 两个风格：2D Traditional Anime / 3D CGI Animation。
- ✅ 当前两名拳脚角色与其原图身份设定。
- ✅ H3 六段 Prompt 格式。
- ✅ V5 时长 20 秒，多镜头共 6 Shot。
- ✅ 无刀剑、无拳套，保留红裤男金属护腕。
- ✅ Zero Idle、1.0x、Zero Slow Motion、攻防动能闭环。
- ✅ 借助周边建筑、木桌、柱、墙、木框、屋顶产生连锁打斗与破坏。
- ✅ Match-on-action、damage persistence。
- ✅ 用户对 V3、V4 的正向反馈。

### 尚未确定／尚未验证

- ⬜ 用户使用的具体 MiniMax H3 API 版本、参数结构、实际生成调用代码。
- ⬜ 本机工作区和 Codex 项目既有目录。
- ⬜ V5 实际输出视频及各 Shot 的合格率。
- ⬜ H3 对 20 秒/6 镜头的实际一致性执行程度。
- ⬜ 是否需要 V5 下一轮提供机器可读 Shot JSON 与项目 GUI。

---

## 17. 最终交接结论

**Combat Motion Chain 的演进不是简单“更多动作和特效”，而是由动作因果转向战斗者之间的自适应决策、环境互动和镜头连续性。**

当前版本应被视为：

> **MiniMax H3 Combat Motion Chain V5 — 20s Multi-Shot Adaptive Unarmed Combat & Persistent Environmental Destruction, delivered as two independent 2D Anime and 3D CGI prompt variants.**

Codex 下一轮工作的关键不是重新写一个普通格斗故事，而是把本文件里的**角色锁定、动作事件链、镜头状态、建筑损伤持久性、声音同步和双风格输出**转成可维护、可检查、可迭代的系统。
