cerevox 2.9.1 → 2.9.2

package/dist/mcp/servers/prompts/actions/storyboard_optimization.md

@@ -19,7 +19,100 @@
 **重要：** 必须按以下顺序进行优化：
 1. **先优化 `video_prompt`**：完善镜头语言、动作描述、情绪表达等动态内容
 2. **再反推优化 `start_frame`**：确保 `start_frame` 呈现的画面是 `video_prompt` 的初始状态
-3. **保持逻辑一致性**：`start_frame` 必须是 `video_prompt` 描述动作的起始画面  
+3. **保持逻辑一致性**：`start_frame` 必须是 `video_prompt` 描述动作的起始画面
+
+### 🚨 **关键规则：start_frame 必须为动作初始态**
+**⚠️ 极其重要：** `start_frame` 必须设置为 `video_prompt` 中所有动作的**起始状态**，绝不能是动作的结束状态，否则会锁死动画效果！
+
+**具体要求：**
+- 如果 `video_prompt` 描述"人物睁眼"动作 → `start_frame` 必须是**闭眼状态**
+- 如果 `video_prompt` 描述"人物出拳"动作 → `start_frame` 必须是**收拳状态**
+- 如果 `video_prompt` 描述"花朵绽放"动作 → `start_frame` 必须是**花苞状态**
+- 如果 `video_prompt` 描述"光芒扩散"动作 → `start_frame` 必须是**光点聚集状态**
+
+**错误示例：**
+❌ `video_prompt`: "女娲缓缓睁开双眼" + `start_frame`: "女娲双眼明亮有神地凝视前方"
+✅ `video_prompt`: "女娲缓缓睁开双眼" + `start_frame`: "女娲双眼轻闭，面容宁静"
+
+**典型错误案例：动作锁死问题**
+❌ **错误的 start_frame**：
+```
+二次元日漫风格的史诗级激烈战斗场景，特效全开。Saber高速冲刺，圣剑发出耀眼金色光芒，面部专注勇敢，眼神锐利如刀，金色长发在疾风中飞舞，蓝色铠甲和白色斗篷在高速移动中猎猎作响。Lancer迎战，长枪横扫产生风压，红色眼眸燃烧兴奋战意，嘴角狂野笑容，深蓝色战斗服紧贴身体。校园操场地面因魔法力量龟裂，剑光与枪芒交错产生强烈金蓝色光影效果。
+```
+**问题分析：** 这种描述包含了"高速冲刺"、"长枪横扫"、"剑光与枪芒交错"等激烈动作，会导致动画锁死！
+
+✅ **正确的优化方案**：
+- **start_frame**：二次元日漫风格，校园操场背景。Saber持剑静立，圣剑收于身侧，神情专注，金色长发自然垂落。Lancer握枪对峙，长枪指向地面，红色眼眸凝视，表情严肃。两人保持战斗准备姿态，空气中弥漫紧张气息。
+- **video_prompt**：Saber突然高速冲刺，圣剑发出耀眼金色光芒，金发在疾风中飞舞。Lancer迎战，长枪横扫产生风压，两人激烈交锋，剑光与枪芒交错产生强烈光影效果，地面因魔法力量龟裂。
+
+**核心原理：** `start_frame` 是动画的第一帧，`video_prompt` 描述从这一帧开始的运动过程。只有正确设置初始状态，AI 才能生成流畅的动画效果。
+
+---
+
+## 🎯 关键规则：多主体场景构图规范
+
+> ⚠️ **重要提醒**：当场景中存在多个主体（人物/角色）时，必须在 `start_frame` 中详细描述各主体的站位关系和相机位置，确保构图清晰可执行。
+
+### 📐 多主体站位描述要求
+
+**必须明确的要素：**
+1. **主体数量与身份**：明确说明有几个主体，各自的身份/角色
+2. **空间位置关系**：使用方位词描述各主体的相对位置
+3. **距离与层次**：说明前景、中景、后景的主体分布
+4. **朝向与姿态**：描述各主体面向的方向和基本姿态
+5. **相机位置与角度**：明确镜头的拍摄位置、角度和取景范围
+
+### 📝 标准描述模板
+
+**✅ 正确示例（双人对峙场景）：**
+```
+中景镜头，相机位于两人正前方略偏右的位置，平视角度。画面左侧站立Saber，身体微微侧向右方，持剑手自然垂于身侧，面部朝向画面右侧的对手。画面右侧站立Lancer，身体正面朝向左方，长枪斜指地面，双眼凝视左侧的Saber。两人相距约3米，中间是空旷的校园操场地面。背景是远山和夕阳，整体构图呈对称平衡状态。
+```
+
+**✅ 正确示例（多人群像场景）：**
+```
+广角镜头，相机位于场景前方高处俯拍。画面中央是主角A，面向镜头站立。左前方是角色B，侧身面向主角A。右后方是角色C，背对镜头望向远方。最远处背景中有角色D和E，呈小群体站立状态。整个构图呈扇形分布，主角A位于视觉焦点，其他角色围绕形成层次感。
+```
+
+**❌ 错误示例（描述模糊）：**
+```
+几个人站在那里，准备开始战斗。
+```
+
+### 🎬 相机位置描述规范
+
+**必须包含的信息：**
+- **镜头类型**：特写/近景/中景/远景/广角等
+- **拍摄角度**：平视/俯拍/仰拍/侧拍等
+- **相机位置**：相对于主体的具体方位
+- **取景范围**：画面边界和主体在画面中的位置
+
+**示例：**
+- "中景镜头，相机位于主角正前方2米处，略微仰拍"
+- "广角远景，相机位于场景左侧高处，俯瞰整个战场"
+- "特写镜头，相机贴近主角右侧，捕捉面部表情"
+
+---
+
+### ✅ 校验与融合规则（必须执行）
+在每个场景的优化中，请执行以下“字段融合校验”，确保可落地：
+
+1) 将 stage_atmosphere 全量融入 start_frame：
+- 必须覆盖以下子项：style、characters（含外观/情绪/服饰/是否使用参考图）、stage_environment、lighting、mood、camera。
+- 要求：start_frame 的画面描述中逐一显性体现这些元素，不可遗漏或模糊。
+
+2) 将“运镜 camera + 必要元素”融入 video_prompt：
+- 将 stage_atmosphere.camera 的镜头类型、角度、运动路径与节奏明确写入 video_prompt。
+- 同时融合与运镜强相关的关键道具/环境动态/光效/角色动作节拍等“必要元素”，用于指导动画生成。
+
+3) 一致性检查（必过清单）：
+- start_frame 中的风格、环境、光影、情绪与 stage_atmosphere 一一对应。
+- video_prompt 的镜头运动与 start_frame 的构图/走位不冲突，且细化到时间顺序与动作节拍。
+- 若 stage_atmosphere 中的元素存在矛盾，以用户要求的风格统一性为优先进行协调并在描述中消除冲突。
+
+4) 覆盖提示（机读友好）：
+- 若发现某子项缺失，请在 start_frame/video_prompt 中主动补齐并保持整体风格一致。
+- 不改变 JSON 结构，仅在文本内容中完成融合与细化。
 
 ---
 
@@ -115,4 +208,70 @@
 **目标：** 确认优化结果符合预期，准备后续任务。
 
 1. 总结优化结果，确认所有场景均符合影视分镜逻辑。
-2. 调用 `retrieve-rules-context` 召回上下文后继续执行其他任务。
+2. 调用 `retrieve-rules-context` 召回上下文，之后使用更新后的 story_board.json 内容继续执行其他任务。
+
+---
+
+# 🎞️ 附录：运镜与电影节奏指南
+
+## 一、节奏的核心：镜头速度 × 情绪波动
+节奏感的本质是“镜头运动速度 + 情绪波动频率”。
+- **慢镜头（缓推/定机）**：让观众沉浸，营造宁静与神圣感。  
+- **快镜头（急推/切换）**：制造紧张与冲突感。  
+- **动静结合（呼吸节奏）**：在情绪起伏间创造“呼吸感”。  
+
+🎯 *镜头速度即观众呼吸节奏。*  
+慢 → 沉浸；快 → 紧张；动静交替 → 富于韵律。
+
+---
+
+## 二、镜头语言的三层节奏结构
+1. **镜内节奏**：角色动作、背景元素（风、火、水流）形成内在律动。  
+2. **镜间节奏**：镜头长度、角度切换构成“视觉拍点”。  
+3. **段落节奏**：镜头节奏呼应剧情情绪曲线（起 → 承 → 转 → 合）。  
+
+例：《女娲补天》节奏线：  
+宁静（慢推）→ 灾难（快切）→ 修补（静止）→ 重生（慢退）。
+
+---
+
+## 三、五种典型节奏运镜套路
+| 名称 | 镜头组合 | 节奏逻辑 | 用途 |
+|------|-----------|-----------|------|
+| 缓推沉浸式 | 全景→中景→特写 | 情绪渐深 | 抒情、神圣时刻 |
+| 快切冲击式 | 中景↔特写交替 | 节奏急促 | 战斗、灾难 |
+| 旋转升华式 | 环绕→拉升→俯瞰 | 节奏递进 | 英雄觉醒 |
+| 静动反差式 | 定镜→突发运动 | 节奏反转 | 神迹降临 |
+| 呼吸延迟式 | 缓推→停顿→缓退 | 节奏收放 | 顿悟、收尾 |
+
+---
+
+## 四、光影与运镜节奏的配合
+光线与镜头运动需节奏一致：  
+- **慢推镜头**：光线渐变、体积光增强 → 营造神圣。  
+- **快速变焦**：闪光或逆光爆点 → 强调冲击。  
+- **缓退镜头**：光由强转柔 → 平静收尾。  
+- **环绕镜头**：光晕随镜移动 → 营造梦幻空间感。  
+
+> ✨例：女娲举起五彩石时，低角度缓推 + 环绕 + 光晕扩散 → “升华 → 神圣 → 平静”。
+
+---
+
+## 五、节奏编排公式
+> 🎵 节奏 = （镜头时长 × 运动速度 × 情绪强度） ÷ 场景密度
+
+设计流程：  
+1. 确定每幕情感强度（0–100）。  
+2. 分配镜头时长（短=紧张，长=放松）。  
+3. 调整运动速度（快=推张力，慢=沉浸）。  
+
+例：  
+- 灾难段：3秒 × 高速推拉 × 强对比光 → 紧张。  
+- 修补段：8秒 × 缓慢环绕 × 柔光渐变 → 宁静。  
+
+---
+
+## 六、总结口诀
+> **“慢推引情绪，快切造冲突，旋转升高潮，定格留余韵。”**  
+
+节奏不是音乐，而是**镜头的呼吸与观众的心跳**。

package/dist/mcp/servers/prompts/zerocut-core.md

@@ -20,10 +20,11 @@
   * 务必保证 draft_content.json 中的字幕与 story_board.json 中的字幕内容完全一致
   * 如生成配音
     * 务必保证 story_board.json 中的 voice_id 与配音音色准确匹配，如果是配音前通过搜索选择的音色ID，务必在 story_board.json 中及时更新
-    * 务必保证生成配音(tts)的文本内容与 story_board.json 中的文本内容完全一致，如需调整内容，请同时更新 story_board 中的内容
-  * 生成分镜图片素材时，应严格遵循 story_board.json 中的 start_frame、end_frame（如有） 描述
-  * 生成分镜视频素材时，应严格遵循 story_board.json 中的 video_prompt 描述
+    * 务必保证生成配音(tts)的文本内容与 story_board.json 中 script（或dialog） 字段的文本内容完全一致，如需调整内容，请同时更新 story_board 中的内容
+  * 生成分镜图片素材时，应严格遵循 story_board.json 中的 start_frame、end_frame（如有） 字段描述
+  * 生成分镜视频素材时，应严格遵循 story_board.json 中的 video_prompt 字段描述
 5. 质量保证（‼️ 极其重要！！）
+  * 若用户需求中明确包含“自动优化分镜”，则必须在创建 story_board.json 后立即调用 `do-storyboard-optimization` 工具优化 story_board.json
   * is_continuous 为 true 的场景，必须采用连续分镜
 
 ## 标准工作流程

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cerevox",
-  "version": "2.9.1",
+  "version": "2.9.2",
   "description": "TypeScript SDK for browser automation and secure command execution in highly available and scalable micro computer environments",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",