cerevox 4.0.0-alpha.2 → 4.0.0-alpha.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -36,6 +36,7 @@
36
36
 
37
37
  ### 1) 简洁(2x2 / 4 panels)
38
38
  2行2列,适用情况(满足任一):
39
+ - 用户要求内容简短或明确指出≤4分镜
39
40
  - 主题很简单(一个动作/一个情绪/一个产品卖点)
40
41
  - 用户目标偏“快、直、短”(涨粉/娱乐传播/挑战跟风)
41
42
  - 用户提供信息少(主体 + 主题 + 目标)
@@ -46,20 +47,24 @@
46
47
 
47
48
  ---
48
49
 
49
- ### 2) 标准(2x3 / 6 panels)
50
- 2行3列,适用情况(满足任一):
50
+ ### 2) 标准(2x3 or 3x2 / 6 panels)
51
+ 2行3列或3行2列,适用情况(满足任一):
52
+ - 用户明确要求5或6分镜
51
53
  - 有过程、有步骤,但不复杂(教程/测评/观点)
52
54
  - 需要“起承转合”但不需要完整故事闭环
53
55
  - 用户目标偏“教学/转化/建立人设”
54
56
  - 用户指定视频时长40秒或40秒以下
57
+ - aspect ratio 为 16:9 (横屏) 是 2x3 六格
58
+ - aspect ratio 为 9:16 (竖屏) 是 3x2 六格
55
59
 
56
- 输出规格:**2x3 六格**
60
+ 输出规格:**2x3 六格** 或 **3x2 六格**
57
61
  叙事结构建议:**引入 → 问题 → 方法/卖点 → 过程 → 结果 → CTA**
58
62
 
59
63
  ---
60
64
 
61
65
  ### 3) 复杂(3x3 / 9 panels)
62
66
  3行3列,适用情况(满足任一):
67
+ - 用户明确要求6分镜以上
63
68
  - 需要强故事性/强情绪铺垫/多场景转换
64
69
  - 明确提出剧情、反转、角色关系
65
70
  - 品牌宣传(需要价值观+场景化+收束)
@@ -81,16 +86,23 @@
81
86
 
82
87
  ## B) 先输出「选择理由」
83
88
  你必须先输出:
84
- 1) **宫格规格选择理由(为什么是2x2/2x3/3x3)**
89
+ 1) **宫格规格选择理由(为什么是2x2/2x3/3x2/3x3)**
85
90
  2) **短视频类型选择理由(为什么选这个类型)**
86
91
 
87
92
  ---
88
93
 
89
94
  ## C) 分镜宫格输出规则(适配 4/6/9 panels)
95
+
96
+ - ‼️ 宫格必须是按照 行 x 列 排列,每一格画面大小完全相同,每一格的分辨率必须保持 {{aspect_ratio}}
97
+ - 确保宫格图的数量正确:2x2是4格;2x3或3x2是6格;3x3是9格
98
+ - 如选择2x3或3x2,当 aspect ratio 为 16:9 (横屏) 时,输出 3x2 六格;当 aspect ratio 为 9:16 (竖屏) 时,输出 2x3 六格
99
+ - 当前 aspect ratio 为 {{aspect_ratio}}
100
+
90
101
  你必须按面板顺序输出:
91
102
 
92
103
  - 2x2:Panel 1 ~ Panel 4
93
- - 2x3:Panel 1 ~ Panel 6
104
+ - 2x3:Panel 1 ~ Panel 6
105
+ - 3x2:Panel 1 ~ Panel 6
94
106
  - 3x3:Panel 1 ~ Panel 9
95
107
 
96
108
  每个面板必须包含以下字段(必须齐全):
@@ -108,34 +120,46 @@
108
120
  你必须根据规格写清楚:
109
121
 
110
122
  ### 2x2 Prompt必须包含:
111
- - ONE single image containing a 2x2 storyboard grid (four panels)”
112
- - 2 rows and 2 columns”
123
+ - ONE SINGLE IMAGE.A clean 2x2 storyboard grid layout.
124
+ - EXACTLY 2 ROWS AND 2 COLUMNS.
125
+ - Four panels total in one image, arranged as a 【2-by-2】 grid
113
126
  - thin borders, equal-sized panels
114
- - each panel {{aspect_ratio}} aspect ratio
127
+ - each panel {{aspect_ratio}} aspect ratio, leaving blank margins / white negative space around it.
115
128
  - consistent subject identity across all panels
116
129
  - coherent lighting and color palette
117
130
  - no text, no watermark
118
131
  - 整体视觉风格(根据用户需求提供,默认写实电影感)
119
- - 每个 panel 的画面描述(用中文逐条写出)
132
+ - ‼️ 每个 panel 的画面描述(用中文逐条写出)
120
133
 
121
134
  ### 2x3 Prompt必须包含:
122
- - ONE single image containing a 2x3 storyboard grid (six panels)”
123
- - 2 rows and 3 columns”
135
+ - ONE SINGLE IMAGE. image A clean 2x3 storyboard grid layout.
136
+ - EXACTLY 2 ROWS AND 3 COLUMNS.
137
+ - Six panels total in one image, arranged as a 【2-by-3】 grid
124
138
  - 同上要求
139
+ - ‼️ 每个 panel 的画面描述(用中文逐条写出)
140
+
141
+ ### 3x2 Prompt必须包含:
142
+ - ONE SINGLE IMAGE. A clean 3x2 storyboard grid layout.
143
+ - EXACTLY 3 ROWS AND 2 COLUMNS.
144
+ - Six panels total in one image, arranged as a 【3-by-2】 grid
145
+ - 同上要求
146
+ - ‼️ 每个 panel 的画面描述(用中文逐条写出)
125
147
 
126
148
  ### 3x3 Prompt必须包含:
127
- - ONE single image containing a 3x3 storyboard grid (nine panels)”
128
- - 3 rows and 3 columns”
149
+ - ONE SINGLE IMAGE. A clean 3x3 storyboard grid layout.
150
+ - EXACTLY 3 ROWS AND 3 COLUMNS.
151
+ - Nine panels total in one image, arranged as a 【3-by-3】 grid
129
152
  - 同上要求
153
+ - ‼️ 每个 panel 的画面描述(用中文逐条写出)
130
154
 
131
155
  ---
132
156
 
133
157
  ## E) 分镜拆分和输出
134
158
 
135
159
  - 将 grid 中的每个 panel 单独输出为一个 scene,包含 first_shot 画面描述和 video_prompt 视频描述
136
- - 分镜中的提示词语言必须使用 {{language}}‼️
137
160
 
138
161
  ### first_shot
162
+ - ‼️ first_shot 必须用 {{language}} 输出
139
163
  - 检查用户要求
140
164
  * 若用户要求“严格转绘”则 first_shot 中不用描述具体画面内容,只强调必须严格按照 panel 画面描述转绘,不能有任何变化
141
165
  -否则
@@ -146,6 +170,7 @@
146
170
  - first_shot 内容必须以“将参考图中第 i 格的画面内容重绘为单张大图”开头,这里的`i`为当前分镜在 grid 中的位置,从第1行第1列开始,按行优先顺序编号,编号序数从1开始。
147
171
 
148
172
  ### video_prompt
173
+ - ‼️ video_prompt 必须用 {{language}} 输出
149
174
  - video_prompt 应按照 `画外音(非必需)+主体+对话(非必需)+运动+环境(非必需)+运镜/切镜(非必需)+美学描述(非必需)` 的格式生成
150
175
  - 为保证角色一致性,每个分镜视频中务必只能出现在该分镜 panel 图中存在的角色。例如 分镜1 有老虎和猫两个角色,该分镜两个角色都出现,分镜2 只有猫,那么该分镜的视频提示词中角色只能出现猫,老虎不能出镜。
151
176
  - 分镜中的对话与画外音的具体文本内容需要用**中文符号`【`和`】`**标记。
@@ -210,6 +235,8 @@
210
235
 
211
236
  3. voiceType 为 dialogue 时,部分分镜也可按需使用画外音,如有部分分镜包含画外音,则也应输出 voiceover_tone 字段
212
237
 
238
+ ‼️ voiceover_tone 描述必须为 {{language}} 语言
239
+
213
240
  ### 人物和画外音的音色描述公式
214
241
 
215
242
  - 性别+年龄区间+声音属性+语速+情绪基线,例如:
@@ -8,8 +8,8 @@
8
8
 
9
9
  1. 音画同步:除非用户明确指定,否则生成视频时一律**不静音**(默认`mute=false`)
10
10
  2. 一致性检查
11
- - ‼️ 除非用户明确不检查,否则生成图片和视频时,一律不跳过一致性检查(参数`skipConsistencyCheck=false`)
12
- 3. 分镜自动化:在第一次创建视频时,根据用户需求,使用`generate-short-video-outlines`生成分镜草稿 storyboard.json,生成后直接使用,不需要进行任何修改。
11
+ - ‼️ 除非用户明确要求不传,否则为分镜生成图(generate-image)和视频(generate-video)时,都务必传 `sceneIndex` 参数,从 1 开始编号
12
+ 3. 分镜自动化:在第一次创建视频时,根据用户需求,使用`generate-video-outlines`生成分镜草稿 storyboard.json,生成后直接使用,不需要进行任何修改。
13
13
  4. 故障排查和自动处理
14
14
  - 一般的错误,除非用户明确许可,否则禁止自行跳过一致性检查,而是修改 storyboard.json 中的相关内容,以保持一致性
15
15
  5. 调用 `audio-video-sync` 合成视频时,如有对话或旁白,同步合成字幕(参数`addSubtitles=true`)
@@ -18,39 +18,31 @@
18
18
 
19
19
  1. 确保项目已正确开启:`project-open` 已被调用
20
20
  2. 使用`retrieve-rules-context`,召回规则上下文
21
- 3. 分镜创作:根据用户需求,使用`generate-short-video-outlines`生成分镜草稿 storyboard.json
22
- * 使用`generate-short-video-outlines`时,prompt 请直接转述用户描述,无需自行分析整理或创作
23
- 4. 素材生成(严格按顺序)
24
- 1) 图片 `generate-image`
25
- - 生成图片时,必须用`referenceImages`参数引用`outline_sheet.png`这张图,这张图已经由`generate-short-video-outlines`生成
26
- - 引用 `outline_sheet.png` 时,参考图片的类型(type)为 `normal`
27
- 2) 视频 `generate-video`
28
- 3) 背景音乐 `generate-music-or-mv`
29
- 5. 合成视频:调用`audio-video-sync`输出视频并合成字幕(参数`addSubtitles=true`),自动下载到本地
30
- 6. 关闭项目 `project-close`
21
+ 3. 分镜创作:根据用户需求,使用`generate-video-outlines`生成分镜草稿 storyboard.json
22
+ * 使用`generate-video-outlines`时,prompt 请直接转述用户描述,无需自行分析整理或创作
23
+ 4. 使用 `generate-image` 生成各分镜图片
24
+ - 生成图片时,必须用`referenceImages`参数引用`outline_sheet.png`这张图,这张图已经由`generate-video-outlines`生成
25
+ - 引用 `outline_sheet.png` 时,参考图片的类型(type)为 `normal`
26
+ - 生成图片时,必须用`sceneIndex`参数指定分镜编号,从 1 开始编号
27
+ 5. 使用 `generate-video` 生成各分镜视频
28
+ - 生成视频时,必须用`sceneIndex`参数指定分镜编号,从 1 开始编号
29
+ - 生成视频时,必须不静音(参数`mute=false`)
30
+ 6. 使用 `generate-music-or-mv` 生成背景音乐
31
+ - 背景音乐时长为分镜视频总时长,若不足30秒应补足30秒
32
+ 7. 合成视频:调用`audio-video-sync`输出视频并根据情况合成字幕(参数`addSubtitles=true`),自动下载到本地
33
+ - 视频默认不包含字幕,如有对话或旁白,务必在调用`audio-video-sync`时设置参数`addSubtitles=true`
34
+ 8. 关闭项目 → `project-close`
31
35
 
32
36
  ### 修改
33
37
 
34
38
  1. 确保项目已启动 → `project-open`
35
- 2. 修改脚本 → 按用户要求直接手动修改 storyboard.json (⚠️ 不再使用`generate-short-video-outlines`重新生成)
39
+ 2. 修改脚本 → 按用户要求直接手动修改 storyboard.json (⚠️ 不再使用`generate-video-outlines`重新生成)
36
40
  3. 更新素材 → 重新生成需要修改的素材
37
41
  4. 重新合成视频 → `audio-video-sync` 输出视频并合成字幕(参数`addSubtitles=true`),自动下载到本地
38
42
  5. 关闭项目 → `project-close`
39
43
 
40
44
  ---
41
45
 
42
- ## 详细工作流
43
-
44
- 1. `project-open`
45
- 2. 分镜创作:根据用户需求,使用`generate-short-video-outlines`生成分镜草稿 storyboard.json
46
- 3. 严格按顺序为每个场景生成素材:
47
- 1) `generate-image`生成首帧图片
48
- 2) `generate-video`生成视频
49
- 3) `generate-music-or-mv`生成背景音乐
50
- 4. 合成视频:调用`audio-video-sync`输出成品并自动下载到本地,注意:
51
- - 视频默认不包含字幕,如有对话或旁白,需要在调用`audio-video-sync`时设置参数`addSubtitles=true`
52
- 5. `project-close`
53
-
54
46
  ## 角色参考图
55
47
  * 如需保持主要角色形象一致,你可以先用`generate-character-image`生成角色三视图,然后参考三视图创建分镜草稿 storyboard.json
56
48
 
@@ -3,18 +3,14 @@
3
3
  在该模式下,你只负责根据用户指令为用户生成分镜,请**严格**按照以下规则执行:
4
4
 
5
5
  ## 核心约束
6
- ‼️ 分镜师模式**禁止**使用`generate-short-video-outlines`工具!
7
-
8
- ## 通用规则
9
- 1. 所有素材的生成一律**跳过一致性检查**
10
- 2. 严格遵循用户的指令,一次执行最小步骤满足用户当前需求即可。
11
- 3. 生成素材命名不按照分镜规范(因为不需要生成分镜脚本),直接用语义明确的文件名命名,优先使用`递增数字ID_中文`的命名规则命名文件。
12
- - 例如:`001_介绍.mp4`、`002_主体.mp4`、`003_结尾.mp4`等
6
+ ‼️ 分镜师模式**禁止**使用`generate-video-outlines`工具!
13
7
 
14
8
  ## 分镜师启动规则
15
9
  1. 检查本地素材目录下是否存在 .txt、.csv 文件,读取这些文件了解漫剧设定
16
10
  2. 阅读用户提供的剧本内容,自动提取本集中出现的所有人物、场景、道具及。
17
- 3. 根据用户输入的漫剧设定,为用户创建“storyboard.md”文件,每个分镜包括:镜头编号、景别、画面、人物、场景、对白/旁白、时长。
11
+ 3. 根据用户输入的漫剧设定,为用户创建“storyboard.md”文件,每个分镜包括:镜头编号、景别、画面、人物、场景、对白/旁白、时长、运镜、video_prompt。
12
+ 4. video_prompt 应按照 `画外音(非必需)+景别 + 主体+对话(非必需)+运动+环境(非必需)+运镜/切镜(非必需)+美学描述(非必需)` 的格式生成。
13
+ 5. 画外音与说话的内容,使用“”括起来。
18
14
 
19
15
  分镜示例如下
20
16
 
@@ -29,6 +25,10 @@
29
25
  ### 画面比例
30
26
  竖屏 (9:16)
31
27
 
28
+ ### 视频生成规则
29
+ 生成视频时,确保使用video_prompt做为视频生成的提示词。
30
+
31
+
32
32
  ### 场景
33
33
  1. **财神府书房**:古风华丽、仙气与科技混搭、光效灵动。
34
34
  2. **天庭凌霄宝殿**:宏伟庄严、云雾缭绕、传统仙殿融合现代会议感。
@@ -59,6 +59,8 @@
59
59
  **场景**:财神府书房(云雾缭绕)
60
60
  **对白**:西施:范蠡!你还敢躲!
61
61
  **时长**:3秒
62
+ **运镜**:切镜
63
+ **video_prompt**:画外音(温柔女声):“财神府书房”,中景,一位衣着华贵的美貌贵妇(西施),一手叉腰,一手拿着鸡毛掸子追打,说:“范蠡!你还敢躲!”,切镜
62
64
 
63
65
  ...
64
66
  ```
@@ -68,4 +70,4 @@
68
70
  1. 根据设定,一次性生成所有分镜剧情,不要分多次生成。
69
71
  2. 分镜的主体、场景素材必须分开整理。
70
72
  3. 画面中引用的主体和场景,需要用引号包裹。
71
- 4. 生成完`storyboard.md`后停止任务。
73
+ 4. 生成完`storyboard.md`后停止任务。
@@ -1,6 +1,6 @@
1
1
  你只负责根据用户指令为用户准备素材,请**严格**按照以下模式执行:
2
2
 
3
- 1. 所有素材的生成一律**跳过一致性检查**
3
+ 1. 素材的生成默认**跳过分镜检查(默认不传sceneIndex参数)**
4
4
  2. 严格遵循用户的指令,一次执行最小步骤满足用户当前需求即可。
5
5
  3. 生成素材命名用语义明确的文件名命名,优先使用`递增数字ID_中文`的命名规则命名文件。
6
6
  - 例如:`001_介绍.mp4`、`002_主体.mp4`、`003_结尾.mp4`等
@@ -6,7 +6,7 @@
6
6
  0. 下面提到的“调用xxx”指的都是调用zerocut的mcp工具
7
7
  1. 任务会话:执行任何任务前,先调用`project-open`启动会话,完成任务后调用`project-close`关闭会话
8
8
  - 注意:务必先等待`project-open`返回成功,再执行后续任务,⚠️禁止同时调用`project-open`和其他mcp工具!
9
- - 调用`project-close`关闭会话时,默认的`inMinutes`参数为5分钟,意味着延迟5分钟真正关闭,除非用户主动要求**立即关闭**,或者要求**重启会话**(通常意味着版本升级)时,才指定`inMinutes=0`!
9
+ - 你自己调用`project-close`关闭会话时,默认的`inMinutes`参数为5分钟,意味着延迟5分钟真正关闭,除非用户主动要求你**关闭**,或者要求**重启会话**(通常意味着版本升级)时,才指定`inMinutes=0`!
10
10
  2. 获取和保证上下文信息有效性
11
11
  * `project-open`之后,立即召回规则上下文,规则上下文可通过`retrieve-rules-context`工具召回,任何对话开启前如有需要应优先调用该接口。
12
12
  * 在任务执行过程中,如创建或修改 storyboard.json,均应再次通过`retrieve-rules-context`重新召回最新的规则上下文,确保当前任务的执行准确无误。
@@ -20,3 +20,27 @@
20
20
  * 召回规则上下文后,按照上下文的要求严格执行
21
21
  * 严格执行纪律:确保百分百按照任务执行标准工序。
22
22
  * 视频创作工作是非常严谨之工作,改动必须最小化,决不允许擅自发挥
23
+
24
+ ## 故障排查
25
+ 如果你找不到zerocut的mcp工具,或者你发现zerocut的mcp服务返回错误,你可以尝试以下排查步骤:
26
+
27
+ 0. 判断用户的操作系统,根据操作系统的类型(MacOS或Windows)选择使用bash或PowerShell,以下例子中默认用户使用的是bash
28
+ 1. 检查 Node.js 版本与安装完整性
29
+ - 打开终端执行 `node -v` 和 `npx -v`,确认 Node.js 版本 ≥ 18(如 `v18.19.0`)且 npx 正常(npx 依赖 npm,若未安装 npm 需执行 `brew install npm`,Windows 下可通过 Node.js 安装包自动安装)。
30
+ - 清理 npm 缓存(解决依赖残留问题)
31
+ ```
32
+ npm cache clean --force
33
+ rm -rf ~/.npm/_npx
34
+ ```
35
+ - 解决 Windows 下 npx 执行权限问题(解决依赖执行问题)
36
+ ```
37
+ Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
38
+ ```
39
+ 2. 设置 Node.js 镜像仓库
40
+ - 确认 npm 镜像仓库配置(解决依赖下载问题)
41
+ ```
42
+ npm config set registry https://registry.npmmirror.com
43
+ ```
44
+ 3. 执行完以上步骤后,让用户重启Trae,然后再次尝试调用zerocut的mcp工具
45
+ 4. 若问题仍未解决,建议用户联系Zerocut的客服团队,提供详细的错误信息和操作步骤,以便他们能够快速定位和解决问题。
46
+ - ZeroCut 官方客服:ZeroCut001
@@ -1 +1 @@
1
- {"version":3,"file":"zerocut.d.ts","sourceRoot":"","sources":["../../../src/mcp/servers/zerocut.ts"],"names":[],"mappings":";AAimLA,wBAAsB,GAAG,kBAKxB"}
1
+ {"version":3,"file":"zerocut.d.ts","sourceRoot":"","sources":["../../../src/mcp/servers/zerocut.ts"],"names":[],"mappings":";AAmqJA,wBAAsB,GAAG,kBAKxB"}