cerevox 4.35.0 → 4.37.0

package/dist/mcp/servers/prompts/skills//346/227/247/344/270/200/351/224/256/346/210/220/347/211/207.md

@@ -0,0 +1,103 @@
+---
+name: 一键成片
+description: 当用户要求创作某个主题的通用视频时，使用该技能，通过Zerocut MCP工具，根据用户需求创作多个分镜并合成通用视频
+---
+## 标准流水线
+
+### 全局配置和注意事项
+
+1. 音画同步：除非用户明确指定，否则生成视频时一律**不静音**（默认`silent=false`）
+2. 一致性检查
+  - ‼️ 除非用户明确要求不传，否则为分镜生成图(generate-image)和视频(generate-video)时，都务必传 `sceneIndex` 参数，从 1 开始编号
+3. 分镜自动化：在第一次创建视频时，根据用户需求，使用`generate-video-outlines`生成分镜草稿 storyboard.json，生成后直接使用，不需要进行任何修改。
+4. 故障排查和自动处理
+  - 一般的错误，除非用户明确许可，否则禁止自行跳过一致性检查，而是修改 storyboard.json 中的相关内容，以保持一致性
+5. 优先用 `audio-video-sync` 工具而**不是** `run-ffmpeg-command` 工具合成视频
+6. 调用 `audio-video-sync` 合成视频时，如有对话或旁白，同步合成字幕(参数`addSubtitles=true`)
+7. 在执行任务的过程中，任何工具返回`Not enough credits`错误时，必须暂停任务，等待用户充值后由用户手动触发继续执行
+
+### 新建
+
+1. 确保项目已正确开启：`project-open` 已被调用
+2. 使用`retrieve-rules-context`，召回规则上下文
+3. 分镜创作：根据用户需求，使用`generate-video-outlines`生成分镜草稿 storyboard.json
+  * 使用`generate-video-outlines`时，prompt 请直接转述用户描述，无需自行分析整理或创作
+4. 使用  `generate-image` 生成各分镜图片
+  - 生成图片时，除非用户人为指定，否则优先使用`seedream-5l`模型
+  - 生成图片时，必须用`referenceImages`参数引用`outline_sheet.png`这张图，这张图已经由`generate-video-outlines`生成
+  - 引用 `outline_sheet.png` 时，参考图片的类型(type)为 `normal`
+  - 生成图片时，必须用`sceneIndex`参数指定分镜编号，从 1 开始编号
+5. 使用  `generate-video` 生成各分镜视频
+  - 生成视频时，必须用`sceneIndex`参数指定分镜编号，从 1 开始编号
+  - 生成视频时，一律采用**首帧图生视频**（即参考图的 type 为 `first_frame`）
+  - 生成视频时，必须带声音（参数`silent=false`）
+  - 如分镜有旁白(narration)，生成视频时必须带旁白（参数`narration={text, tone, voice_id}`）
+6. 使用 `generate-music` 生成背景音乐
+  - 背景音乐时长为分镜视频总时长，若不足30秒应补足30秒
+7. 合成视频：调用`audio-video-sync`输出视频并根据情况合成字幕(参数`addSubtitles=true`)，自动下载到本地
+  - 视频如有对话或旁白，务必在调用`audio-video-sync`时设置参数`addSubtitles=true`，否则无需设置
+8. 关闭项目 → `project-close`
+
+### 修改
+
+1. 确保项目已启动 → `project-open`
+2. 修改脚本 → 按用户要求直接手动修改 storyboard.json （⚠️ 不再使用`generate-video-outlines`重新生成）
+3. 更新素材 → 重新生成需要修改的素材
+4. 重新合成视频 → `audio-video-sync` 输出视频并合成字幕(参数`addSubtitles=true`)，自动下载到本地
+5. 关闭项目 → `project-close`
+
+---
+
+## 主体参考图
+* 如需保持主体形象一致，你可以先用`generate-image`生成主体参考三视图，然后参考三视图创建分镜草稿 storyboard.json
+
+---
+
+## 质量建议
+
+### materials 资源命名规范
+
+- 场景素材：`sc01_first_frame.png`、`sc01_motion.mp4`、`sc01_vo.mp3`
+- 通用素材：`main_bgm_60s.mp3`
+- 合成视频：`<主题名>.v<版本>.mp4`
+
+### 工作流管理
+* 规划先行：先分析制定执行计划
+* 工作流顺序：规划→搜索→分镜→图片→视频→BGM→合成视频
+* 视频生成策略：
+  - 先使用`generate-image`生成首帧图片
+  - 再使用`generate-video`生成动态视频
+* 统一命名：`scXX_*`、`main_bgm_*`、`*_vo.*`
+* 时长控制：单镜头3-16s
+
+### 图生视频技巧
+* 运动导向：提示词=主体运动+背景变化+镜头运动
+* 特征定位：突出主体特征(老人、戴墨镜的女人)便于识别
+* 环境一致性：确保场景间环境元素一致
+  - 时间：保持时间段一致(白天、夜晚)，避免无故突变
+  - 天气：保持天气状况一致(晴天、雨天)
+  - 地点：场景转换符合空间逻辑
+  - 光线：保持光源方向和强度一致
+
+### BGM 音量控制
+* 音量：默认BGM音量控制为-15db（`audioVolume=0.177`），通过设置`audio-video-async`的`audioVolume`参数可以调整BGM音量。
+
+---
+
+## 规划与搜索规则
+
+### 需求分析
+- 理解核心需求：明确视频主题、目标受众、预期效果
+- 确定视频类型：科普解说、产品介绍、故事叙述等
+- 分析技术要求：视频时长、画幅比例、风格偏好
+- 识别素材需求：需要的图片、视频、音频素材
+
+### 搜索内容
+- 特定领域知识、热点话题、视觉参考、事实验证
+
+---
+
+## 故障排查
+
+* `generate-video` 失败且失败原因是内容相关（如包含敏感信息）
+  - **禁止**轻易重新生成 outline，应手动编辑 `storyboard.json` 中的 video_prompt 删除或修改可能的敏感信息后重试；若还是失败，停下来询问用户如何处理

package/dist/mcp/servers/zerocut.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zerocut.d.ts","sourceRoot":"","sources":["../../../src/mcp/servers/zerocut.ts"],"names":[],"mappings":";AAumGA,wBAAsB,GAAG,kBAKxB"}
+{"version":3,"file":"zerocut.d.ts","sourceRoot":"","sources":["../../../src/mcp/servers/zerocut.ts"],"names":[],"mappings":";AAwmGA,wBAAsB,GAAG,kBAKxB"}

package/dist/mcp/servers/zerocut.js

@@ -1042,143 +1042,180 @@ server.registerTool('generate-image', {
         return createErrorResponse(error, 'generate-image');
     }
 });
-server.registerTool('generate-video-outlines', {
-    title: 'Generate Video Outlines',
-    description: `根据用户描述生成短视频的大纲；执行本工具会自动创建两个文件，一个是storyboard.json，一个是outline_sheet.png，前者是分镜设置，后者是分镜宫格图，其中outline_sheet.png生成于materials目录下，storyboard.json生成于materials的上级目录。`,
-    inputSchema: {
-        prompt: zod_1.z
-            .string()
-            .describe('⚠️你只须如实转述用户需求中有关分镜大纲的内容以及分镜数量和横竖屏设置，忽略其他无关内容，无需自行分析整理或加工，本工具会智能创作；'),
-        voiceType: zod_1.z
-            .enum(['slient', 'voiceover', 'dialogue'])
-            .optional()
-            .default('voiceover')
-            .describe(`语音类型，枚举：
-- slient：视频只有BGM和音效，无任何语音
-- voiceover：视频只有画外音，无任何对话
-- dialogue：视频既有画外音，也有对话`),
-        language: zod_1.z.string().optional().default('中文').describe('语言'),
-        referenceImages: zod_1.z.array(zod_1.z.object({
-            name: zod_1.z.string().describe('图片名称，人物名、图片背景名或物品名'),
-            fileName: zod_1.z.string().describe('Reference image file name'),
-        })),
-        orientation: zod_1.z
-            .enum(['portrait', 'landscape'])
-            .optional()
-            .default('portrait')
-            .describe('视频方向，枚举：竖屏（portrait）、横屏（landscape）'),
-        model: zod_1.z
-            .enum([
-            'seedance-1.5-pro',
-            'vidu',
-            'viduq2',
-            'vidu-turbo',
-            'vidu-pro',
-            'kling',
-            'wan-flash',
-        ])
-            .default('seedance-1.5-pro')
-            .describe('除非用户主动提出使用其他模型，否则一律用seedance-1.5-pro模型'),
-    },
-}, async ({ prompt, voiceType, language, referenceImages, orientation, model }, context) => {
-    try {
-        // 验证session状态
-        const currentSession = await validateSession('generate-video-outlines');
-        let progress = 0;
-        const ai = currentSession.ai;
-        let images;
-        if (referenceImages) {
-            images = await Promise.all(referenceImages.map(async (image) => await getMaterialUri(currentSession, image.fileName, {
-                fileSizeLimit: 10,
-            })));
-        }
-        const res = await ai.generateShortVideoOutlines({
-            prompt,
-            voiceType,
-            language,
-            images,
-            videoModel: model,
-            aspectRatio: orientation === 'portrait' ? '9:16' : '16:9',
-            onProgress: async (metaData) => {
-                try {
-                    await sendProgress(context, ++progress, undefined, JSON.stringify(metaData));
-                }
-                catch (progressError) {
-                    console.warn('Failed to send progress update:', progressError);
-                }
-            },
-        });
-        if (!res) {
-            throw new Error('Failed to generate short video outlines: no response from AI service');
-        }
-        if (res.taskUrl) {
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: '该任务正在运行中，它是异步任务，且执行时间较长，你应立即调用工具 wait-for-task-finish (saveFileName=outline_sheet.png) 来等待任务结束，如 wait-for-task-finish 工具调用超时，你应立即再次重新调用直到任务结束。',
-                            taskUrl: res.taskUrl,
-                        }),
-                    },
-                ],
-            };
-        }
-        else if (res.url) {
-            const url = res.url;
-            const { savedTo } = await saveMaterial(currentSession, url, 'outline_sheet.png');
-            const { scenes, video_type, voice_type, voiceover_tone, voice_id, bgm_prompt, video_model, } = res.data || {};
-            const seed = (0, seed_1.getRandomSeed)();
-            const storyboard = {
-                orientation,
-                video_type,
-                outline_sheet: savedTo,
-                bgm_prompt,
-                voice_type,
-                scenes: scenes.map((scene) => {
-                    return {
-                        ...scene,
-                        narration_tone: voiceover_tone,
-                        narration_voice_id: voice_id,
-                        use_video_model: video_model,
-                        seed,
-                    };
-                }),
-            };
-            const saveLocalPath = (0, node_path_1.resolve)(projectLocalDir, 'storyboard.json');
-            await (0, promises_1.writeFile)(saveLocalPath, JSON.stringify(storyboard, null, 2));
-            return {
-                content: [
-                    {
-                        type: 'text',
-                        text: JSON.stringify({
-                            success: true,
-                            message: '视频大纲生成成功',
-                            storyboard,
-                        }),
-                    },
-                ],
-            };
-        }
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: JSON.stringify({
-                        success: false,
-                        error: 'No image URL returned from AI service',
-                        response: res,
-                        timestamp: new Date().toISOString(),
-                    }),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        return createErrorResponse(error, 'generate-video-outlines');
-    }
-});
+// server.registerTool(
+//   'generate-video-outlines',
+//   {
+//     title: 'Generate Video Outlines',
+//     description: `根据用户描述生成短视频的大纲；执行本工具会自动创建两个文件，一个是storyboard.json，一个是outline_sheet.png，前者是分镜设置，后者是分镜宫格图，其中outline_sheet.png生成于materials目录下，storyboard.json生成于materials的上级目录。`,
+//     inputSchema: {
+//       prompt: z
+//         .string()
+//         .describe(
+//           '⚠️你只须如实转述用户需求中有关分镜大纲的内容以及分镜数量和横竖屏设置，忽略其他无关内容，无需自行分析整理或加工，本工具会智能创作；'
+//         ),
+//       voiceType: z
+//         .enum(['slient', 'voiceover', 'dialogue'])
+//         .optional()
+//         .default('voiceover')
+//         .describe(
+//           `语音类型，枚举：
+// - slient：视频只有BGM和音效，无任何语音
+// - voiceover：视频只有画外音，无任何对话
+// - dialogue：视频既有画外音，也有对话`
+//         ),
+//       language: z.string().optional().default('中文').describe('语言'),
+//       referenceImages: z.array(
+//         z.object({
+//           name: z.string().describe('图片名称，人物名、图片背景名或物品名'),
+//           fileName: z.string().describe('Reference image file name'),
+//         })
+//       ),
+//       orientation: z
+//         .enum(['portrait', 'landscape'])
+//         .optional()
+//         .default('portrait')
+//         .describe('视频方向，枚举：竖屏（portrait）、横屏（landscape）'),
+//       model: z
+//         .enum([
+//           'seedance-1.5-pro',
+//           'vidu',
+//           'viduq2',
+//           'vidu-turbo',
+//           'vidu-pro',
+//           'kling',
+//           'wan-flash',
+//         ])
+//         .default('seedance-1.5-pro')
+//         .describe(
+//           '除非用户主动提出使用其他模型，否则一律用seedance-1.5-pro模型'
+//         ),
+//     },
+//   },
+//   async (
+//     { prompt, voiceType, language, referenceImages, orientation, model },
+//     context
+//   ) => {
+//     try {
+//       // 验证session状态
+//       const currentSession = await validateSession('generate-video-outlines');
+//       let progress = 0;
+//       const ai = currentSession.ai;
+//       let images;
+//       if (referenceImages) {
+//         images = await Promise.all(
+//           referenceImages.map(
+//             async image =>
+//               await getMaterialUri(currentSession, image.fileName, {
+//                 fileSizeLimit: 10,
+//               })
+//           )
+//         );
+//       }
+//       const res = await ai.generateShortVideoOutlines({
+//         prompt,
+//         voiceType,
+//         language,
+//         images,
+//         videoModel: model as any,
+//         aspectRatio: orientation === 'portrait' ? '9:16' : '16:9',
+//         onProgress: async metaData => {
+//           try {
+//             await sendProgress(
+//               context,
+//               ++progress,
+//               undefined,
+//               JSON.stringify(metaData)
+//             );
+//           } catch (progressError) {
+//             console.warn('Failed to send progress update:', progressError);
+//           }
+//         },
+//       });
+//       if (!res) {
+//         throw new Error(
+//           'Failed to generate short video outlines: no response from AI service'
+//         );
+//       }
+//       if (res.taskUrl) {
+//         return {
+//           content: [
+//             {
+//               type: 'text' as const,
+//               text: JSON.stringify({
+//                 success: true,
+//                 message:
+//                   '该任务正在运行中，它是异步任务，且执行时间较长，你应立即调用工具 wait-for-task-finish (saveFileName=outline_sheet.png) 来等待任务结束，如 wait-for-task-finish 工具调用超时，你应立即再次重新调用直到任务结束。',
+//                 taskUrl: res.taskUrl,
+//               }),
+//             },
+//           ],
+//         };
+//       } else if (res.url) {
+//         const url = res.url;
+//         const { savedTo } = await saveMaterial(
+//           currentSession,
+//           url,
+//           'outline_sheet.png'
+//         );
+//         const {
+//           scenes,
+//           video_type,
+//           voice_type,
+//           voiceover_tone,
+//           voice_id,
+//           bgm_prompt,
+//           video_model,
+//         } = res.data || {};
+//         const seed = getRandomSeed();
+//         const storyboard = {
+//           orientation,
+//           video_type,
+//           outline_sheet: savedTo,
+//           bgm_prompt,
+//           voice_type,
+//           scenes: scenes.map((scene: any) => {
+//             return {
+//               ...scene,
+//               narration_tone: voiceover_tone,
+//               narration_voice_id: voice_id,
+//               use_video_model: video_model,
+//               seed,
+//             };
+//           }),
+//         };
+//         const saveLocalPath = resolve(projectLocalDir, 'storyboard.json');
+//         await writeFile(saveLocalPath, JSON.stringify(storyboard, null, 2));
+//         return {
+//           content: [
+//             {
+//               type: 'text' as const,
+//               text: JSON.stringify({
+//                 success: true,
+//                 message: '视频大纲生成成功',
+//                 storyboard,
+//               }),
+//             },
+//           ],
+//         };
+//       }
+//       return {
+//         content: [
+//           {
+//             type: 'text' as const,
+//             text: JSON.stringify({
+//               success: false,
+//               error: 'No image URL returned from AI service',
+//               response: res,
+//               timestamp: new Date().toISOString(),
+//             }),
+//           },
+//         ],
+//       };
+//     } catch (error) {
+//       return createErrorResponse(error, 'generate-video-outlines');
+//     }
+//   }
+// );
 server.registerTool('generate-music', {
     title: '创作音乐（Music）',
     description: '生成音乐，包括 BGM 和 歌曲',
@@ -1381,7 +1418,7 @@ server.registerTool('text-to-speech', {
 });
 server.registerTool('generate-video', {
     title: 'Generate Video',
-    description: `首帧图和首尾帧生视频工具`,
+    description: `全能参考视频创作工具`,
     inputSchema: {
         prompt: zod_1.z
             .string()
@@ -1416,6 +1453,7 @@ server.registerTool('generate-video', {
             'vidu-pro',
             'viduq3',
             'viduq3-turbo',
+            'viduq3-pro',
             'kling',
             'kling-v3',
             'wan',
@@ -1917,7 +1955,7 @@ server.registerTool('audio-video-sync', {
         audioVolume: zod_1.z
             .number()
             .optional()
-            .default(0.177) // -15db
+            .default(0.316) // -10db
             .describe('0.0 to 2.0.'),
         videoAudioVolume: zod_1.z
             .number()