cerevox 1.4.8 → 1.4.10

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

@@ -105,7 +105,7 @@ projects/<id>/
 
 ### 场景类型规则
 
-- **常规场景**：包含`start_frame`和`video_prompt`字段，使用`generate-image` + `generate-video`工作流
+- 常规场景：包含`start_frame`和`video_prompt`字段，使用`generate-image` + `generate-video`工作流
 
 ### story_board.json 示例
 
@@ -217,14 +217,14 @@ VideoProject支持转场滤镜，在`timeline.tracks[].clips[]`中配置`transit
 
 ### 重要规范
 
-1. **默认策略**：默认不启用转场滤镜，除非用户明确指定或要求
-2. **复杂转场**：使用前先调用`get-video-project-schema`获取完整转场类型
-3. **时间轴独立性**：
+1. 默认策略：默认不启用转场滤镜，除非用户明确指定或要求
+2. 复杂转场：使用前先调用`get-video-project-schema`获取完整转场类型
+3. 时间轴独立性：
    - 转场滤镜仅影响视觉过渡效果，不会改变音视频的实际时间轴
    - 配音、字幕、BGM的时间轴保持完全独立，不受转场滤镜影响
    - 音视频对齐基于原始素材时长，转场效果为视觉叠加层
-4. **时间轴计算**：系统自动处理转场期间的时间轴对齐，无需手动调整
-5. **Schema遵循**：必须严格遵守VideoProject JSON Schema规范
+4. 时间轴计算：系统自动处理转场期间的时间轴对齐，无需手动调整
+5. Schema遵循：必须严格遵守VideoProject JSON Schema规范
 
 ## 字幕字体规范
 
@@ -333,11 +333,12 @@ VideoProject支持转场滤镜，在`timeline.tracks[].clips[]`中配置`transit
      - 6秒内：zoom类型(zoom_in, zoom_out)
      - 6秒以上：pan类型(pan_left, pan_right, pan_up, pan_down)
 5. `generate-bgm`生成背景音乐
-6. 生成字幕：
-   - 字幕文本必须与 story_board.json 中每个场景的 script 字段完全一致
-   - 字幕时间轴必须与对应的 TTS 配音文件精确同步
-   - 确保文字内容、语音内容、字幕显示三者完全对应
-7. 创建`draft_content.json`
+6. 创建`draft_content.json`
+7. 检查`draft_content.json`中必须包含字幕（除非用户明确拒绝）：
+   - 字幕文本严格一致性：字幕内容必须与 story_board.json 中每个场景的 script 字段完全一致
+   - 允许的调整：可以将长句拆分成多个短句以提高可读性
+   - 严格禁止：擅自增加、删除或修改任何文字内容
+   - 时间轴同步：字幕时间轴必须与对应的视频精确同步
 8. `compile-and-run`渲染
 9. `download-outputs` → `zerocut-project-close`
 
@@ -359,21 +360,22 @@ VideoProject支持转场滤镜，在`timeline.tracks[].clips[]`中配置`transit
 * 备选方案：视频生成失败时使用`generate-video-kenburns`
 * 时间轴计算规则：
   - 视频时长为整秒：clip的durationMs必须是1000的倍数
-  - **时间轴以视频为准**：基于整秒计算，而非配音精确毫秒数
+  - 时间轴以视频为准：基于整秒计算，而非配音精确毫秒数
   - 配音时长用于确定视频时长：配音7008ms→视频8000ms
-  - **转场滤镜独立性**：转场效果不影响音视频时间轴对齐，音频和字幕保持原始时间同步
-* **音频修改后的时间同步**：
+  - 转场滤镜独立性：转场效果不影响音视频时间轴对齐，音频和字幕保持原始时间同步
+* 音频修改后的时间同步：
   - 🚨 **重要**：用户修改声音后，如新音频时长发生变化，视频必须重新与声音时间同步
   - 重新计算视频时长：新配音时长→向上取整到秒→更新视频durationMs
   - 同步更新draft_content.json中所有相关的时间轴参数
-* **draft_content.json时间轴原则**：
+* draft_content.json时间轴原则：
   - 🎯 **核心原则**：tracks时间轴一律以视频为准
   - 音频track必须对齐视频时间轴，不能以音频原始时长为准
   - 字幕track必须对齐视频时间轴，确保显示时间与视频同步
   - 所有clip的startMs、durationMs都基于视频时间轴计算
-* **字幕生成与同步**：
-  - 除非用户明确指定不要字幕，否则必须为所有场景生成字幕
-  - 字幕文本严格对应 story_board.json 中的 script 字段内容
+* 字幕强制生成与同步：
+  - 除非用户明确指定不要字幕，否则 draft_content.json 中必须包含字幕（subtitles 数组）
+  - 文本严格一致性：字幕内容必须与 story_board.json 中的 script 字段逐字对应
+  - 拆分规则：允许将长句拆分成短句，但禁止增减任何文字
   - 字幕时间轴与 TTS 配音精确同步，与视频时间轴对齐(整秒)
   - 字幕显示时间不受转场滤镜影响，保持与音频同步
 * 转场滤镜策略：除非用户明确要求，否则默认不使用转场滤镜，保持简洁的剪切过渡
@@ -400,9 +402,9 @@ VideoProject支持转场滤镜，在`timeline.tracks[].clips[]`中配置`transit
 
 ## 🚨 音视频不同步问题（优先排查）
 
-**症状**：视频播放时音频与画面不匹配，字幕显示时间错误
+症状：视频播放时音频与画面不匹配，字幕显示时间错误
 
-**排查步骤**：
+### 排查步骤：
 1. **检查时间轴基准**：
    - 确认draft_content.json中所有tracks的时间轴都以视频为准
    - 验证音频track的durationMs是否与对应视频clip一致
@@ -424,8 +426,8 @@ VideoProject支持转场滤镜，在`timeline.tracks[].clips[]`中配置`transit
    - 检查是否有重叠或间隙的时间段
 
 ## 其他常见问题
-* **渲染失败**：检查VideoProject路径、素材、参数
-* **素材未同步**：用`list-project-files`核对
-* **沙箱中断**：重新调用`zerocut-project-open`
-* **字幕显示异常**：检查字体文件路径和字幕文件格式
-* **转场效果异常**：验证transitionIn/Out的durationMs设置
+* 渲染失败：检查VideoProject路径、素材、参数
+* 素材未同步：用`list-project-files`核对
+* 沙箱中断：重新调用`zerocut-project-open`
+* 字幕显示异常：检查字体文件路径和字幕文件格式
+* 转场效果异常：验证transitionIn/Out的durationMs设置

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cerevox",
-  "version": "1.4.8",
+  "version": "1.4.10",
   "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",