cerevox 4.0.0-alpha.3 → 4.0.0-alpha.31
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.
- package/dist/core/ai.d.ts +18 -2
- package/dist/core/ai.d.ts.map +1 -1
- package/dist/core/ai.js +108 -37
- package/dist/core/ai.js.map +1 -1
- package/dist/mcp/servers/prompts/.DS_Store +0 -0
- package/dist/mcp/servers/prompts/outlines-backup.md +21 -14
- package/dist/mcp/servers/prompts/skills//344/270/200/351/224/256/346/210/220/347/211/207.md +18 -26
- package/dist/mcp/servers/prompts/skills//345/210/206/351/225/234/345/270/210.md +11 -9
- package/dist/mcp/servers/prompts/skills//347/264/240/346/235/220/345/210/233/344/275/234/357/274/210/351/200/232/347/224/250/357/274/211.md +1 -1
- package/dist/mcp/servers/prompts/skills//350/247/206/351/242/221/345/244/215/345/210/273.md +122 -0
- package/dist/mcp/servers/prompts/zerocut-core.md +25 -1
- package/dist/mcp/servers/zerocut.d.ts.map +1 -1
- package/dist/mcp/servers/zerocut.js +250 -200
- package/dist/mcp/servers/zerocut.js.map +1 -1
- package/dist/utils/videokit.d.ts +4 -4
- package/package.json +1 -1
- /package/dist/mcp/servers/prompts/{zerocut-core-web.md → zerocut-core-web-old.md} +0 -0
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# 视频复刻
|
|
2
|
+
|
|
3
|
+
你参考用户素材视频,分析并拆解其中的分镜,包括运镜、光影、动作、台词等,同时,避免同质化素材产生
|
|
4
|
+
|
|
5
|
+
## 详细步骤
|
|
6
|
+
|
|
7
|
+
‼️ 请严格按照详细步骤执行任务!
|
|
8
|
+
|
|
9
|
+
0. 确保项目已正确开启:`project-open` 已被调用
|
|
10
|
+
1. 使用`retrieve-rules-context`,召回规则上下文
|
|
11
|
+
2. 使用`media-analyzer`分析参考视频,拆解视频中的**每一段分镜**信息,包括时间轴、景别、主体、运镜、光影、动作、台词等
|
|
12
|
+
* 将分析内容保存到素材目录(materials)下的`video_analysis.md`文件中
|
|
13
|
+
3. 将视频分镜信息结合用户的需求,将主体内容替换为用户指定的主体,台词替换为用户指定的台词,其他部分按要求酌情替换
|
|
14
|
+
* 若用户提供了若干素材图片,使用`media-analyzer`分析参考图片内容,以备后续分镜中使用
|
|
15
|
+
* 若用户仅文字描述,优先通过网络搜索搜索相关图片,然后用`generate-image`生成参考图片,以备后续分镜中使用
|
|
16
|
+
4. 将分析内容结合用户需求,创作分镜文档`storyboard.md`,基本设定根据用户需求和参考视频确定
|
|
17
|
+
* storyboard.md 要依照`video_analysis.md`文件中拆解的分镜信息,每个分镜对应一个分镜脚本
|
|
18
|
+
* 分镜的基本设定要根据用户需求和参考视频确定,包括风格、画面比例、视频生成规则、背景音乐、参考主体等
|
|
19
|
+
5. 根据 `storyboard.md` 使用 `generate-video-by-ref` 为每个分镜生成分镜视频,type 只能为 pro
|
|
20
|
+
* 使用 pro 模型生成视频,参数 type 设为 pro
|
|
21
|
+
* 不使用 referenceVideo 参数(不用传参考视频)
|
|
22
|
+
* 分镜中使用到的参考主体必须作为 referenceImages 参数
|
|
23
|
+
* 分镜视频duration参数设为0(自适应)
|
|
24
|
+
* 分镜视频提示词严格对应每个分镜的video_prompt
|
|
25
|
+
* 分镜视频要包含声音,将mute参数设为false
|
|
26
|
+
6. 使用 `generate-music-or-mv` 生成背景音乐
|
|
27
|
+
- 背景音乐时长为分镜视频总时长,若不足30秒应补足30秒
|
|
28
|
+
7. 合成视频:调用`audio-video-sync`输出视频并根据情况合成字幕(参数`addSubtitles=true`),自动下载到本地
|
|
29
|
+
- 视频默认不包含字幕,如有对话或旁白,务必在调用`audio-video-sync`时设置参数`addSubtitles=true`
|
|
30
|
+
|
|
31
|
+
## 要求
|
|
32
|
+
|
|
33
|
+
### 一致性
|
|
34
|
+
|
|
35
|
+
1. 音画同步:除非用户明确指定,否则生成视频时一律**不静音**(默认`mute=false`)
|
|
36
|
+
2. video_prompt 必须按照`画外音(非必需)+景别 + 主体+对话(非必需)+运动+环境(非必需)+运镜/切镜(非必需)+美学描述(非必需)` 的顺序撰写。
|
|
37
|
+
3. 画外音与说话的内容,使用“”括起来
|
|
38
|
+
4. 分镜中使用到的参考主体,必须在`storyboard.md`文件中**有名称**,并在`video_prompt`中使用主体名称引用
|
|
39
|
+
|
|
40
|
+
### Storyboard 格式
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
## 基本设定
|
|
44
|
+
|
|
45
|
+
### 风格
|
|
46
|
+
商业广告写实风格,色彩鲜明饱满,角色设计线条流畅
|
|
47
|
+
|
|
48
|
+
### 画面比例
|
|
49
|
+
竖屏 (9:16)
|
|
50
|
+
|
|
51
|
+
### 视频生成规则
|
|
52
|
+
生成视频时,确保使用video_prompt做为视频生成的提示词
|
|
53
|
+
视频生成统一使用 pro 模型
|
|
54
|
+
|
|
55
|
+
### 背景音乐
|
|
56
|
+
<根据视频内容风格设计背景音乐,确保与视频内容相符>
|
|
57
|
+
|
|
58
|
+
## 参考主体
|
|
59
|
+
1. MAC口红.png
|
|
60
|
+
* 名称:MAC口红
|
|
61
|
+
* 描述:一支暗红色哑光口红
|
|
62
|
+
2. 女模特.png
|
|
63
|
+
* 名称:女模特
|
|
64
|
+
* 描述:一名穿着黑色风衣的女模特
|
|
65
|
+
|
|
66
|
+
## 分镜脚本
|
|
67
|
+
|
|
68
|
+
一共1~5个分镜,每个分镜可以有1~4个镜头,最终**镜头数量**必须和video_analysis.md文件中的镜头对应
|
|
69
|
+
|
|
70
|
+
### 参考内容
|
|
71
|
+
- 一共参考了{n}个镜头
|
|
72
|
+
- 参考要点为:{参考video_analysis.md文件中的镜头内容和详细信息}
|
|
73
|
+
- 一致性检查:
|
|
74
|
+
1. 确保分镜`video_prompt`内容通过**参考主体**的名称正确引用参考主体
|
|
75
|
+
- 例如:女模特从桌面上拿起一支MAC口红
|
|
76
|
+
2. 确保分镜中镜头总数和参考的video_analysis.md文件中的镜头总数一致
|
|
77
|
+
|
|
78
|
+
以下是详细分镜信息:
|
|
79
|
+
|
|
80
|
+
### 分镜1
|
|
81
|
+
**初始景别**:中景
|
|
82
|
+
**首帧画面**:一支MAC口红放在一张有高级感的黑色餐桌上
|
|
83
|
+
**旁白台词**:“这是我的MAC口红,我很喜欢它”
|
|
84
|
+
**video_prompt**:画外音:“这是我的MAC口红,我很喜欢它”\n\n镜头1:大特写:一只手从桌子上轻轻拿起一支MAC口红,切镜至镜头2: 女模特中景,女模特将口红拿到眼前,露出惊喜的表情
|
|
85
|
+
|
|
86
|
+
### 分镜2
|
|
87
|
+
**初始景别**:<景别>
|
|
88
|
+
**首帧画面**:<首帧画面提示词>
|
|
89
|
+
**旁白台词**:<旁白台词>
|
|
90
|
+
**video_prompt**:<video_prompt 内容>
|
|
91
|
+
|
|
92
|
+
...
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### video_prompt 要求
|
|
96
|
+
|
|
97
|
+
video_prompt 应按照 `画外音(非必需)+{镜头1:景别+主体+对话+运动+环境+运镜/切镜+镜头2(非必需):景别+主体+对话+运动+环境+运镜/切镜+镜头3(非必需):景别+主体+对话+运动+环境+运镜/切镜+镜头4(非必需):景别+主体+对话+运动+环境+运镜/切镜}+美学描述(非必需)` 的格式生成
|
|
98
|
+
* 每个分镜可生成 1~4 个镜头,你可以运用专业的导演技巧设计镜头切换,注意多镜头中运用“回镜”(即最后一个镜头切换回镜头1的景别画面)来强化观众认知。
|
|
99
|
+
* 每个镜头必须包含 景别+主体+对话+运动+环境+运镜/切镜 这6个元素中的一个或多个
|
|
100
|
+
* 第1个镜头可省略景别,以免与首帧图片的景别矛盾
|
|
101
|
+
* 必须统一美学描述,不能每个镜头都有不同的美学描述
|
|
102
|
+
* 镜头切换的格式为:`切镜至镜头i`,这里的`i`为镜头编号,从1开始。
|
|
103
|
+
|
|
104
|
+
### 🎵 背景音乐生成指导(Background Music Prompting)
|
|
105
|
+
|
|
106
|
+
1. **节奏匹配(Rhythm Matching)**
|
|
107
|
+
背景音乐应与动画的节奏结构保持一致:
|
|
108
|
+
- 在**冲击阶段**使用节奏鲜明、动态感强的音乐(如鼓点、强拍、电子或交响元素)。
|
|
109
|
+
- 在**延续阶段**过渡为节奏更平缓、情绪延展的旋律,以呼应视觉连贯性
|
|
110
|
+
|
|
111
|
+
2. **情绪映射(Emotion Mapping)**
|
|
112
|
+
根据动画内容的核心情绪选择音乐类型:
|
|
113
|
+
- 激昂 / 紧张:电子、摇滚、打击乐为主。
|
|
114
|
+
- 温馨 / 治愈:钢琴、弦乐、原声吉他为主。
|
|
115
|
+
- 神秘 / 未来感:合成器、氛围音效、空灵配器为主。
|
|
116
|
+
|
|
117
|
+
3. **动态衔接(Dynamic Transition)**
|
|
118
|
+
音乐在两个分镜阶段交接处应保持**低动态或渐弱衔接(fade transition)**,避免节奏突变导致听觉违和
|
|
119
|
+
|
|
120
|
+
4. **声音空间与节奏强度(Spatial & Intensity Control)**
|
|
121
|
+
- 冲击阶段可使用更靠前的音像定位(前景感强),突出动作冲击力
|
|
122
|
+
- 延续阶段应降低音量层次,营造空间延展感和情绪余韵
|
|
@@ -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
|
-
-
|
|
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":";
|
|
1
|
+
{"version":3,"file":"zerocut.d.ts","sourceRoot":"","sources":["../../../src/mcp/servers/zerocut.ts"],"names":[],"mappings":";AAouJA,wBAAsB,GAAG,kBAKxB"}
|