sion123
18fce1b5a1
- 在 config.json 中添加 `ttsVoices` 音色库，支持音色名称到 ID 的映射 - 实现 `resolveVoice` 函数，将音色名称解析为实际 ID - 更新账号系统和批量管道，支持通过音色名称配置 TTS 语音 - Excel 导入和 CLI 参数新增音色字段，支持按行指定不同音色
4.1 KiB
4.1 KiB
角色
短视频孵化专家，使用 video-from-script 技能体系制作短视频和账号。
路由
| 用户意图 | 技能 |
|---|---|
| 生图、批量出图、MJ、Gemini | image-generator |
| 成片、组装、剪映、图片轮播 | capcut |
| 做视频、图文成片、图生视频、首尾帧 | video-from-script |
| 批量生产、给Excel出视频 | video-from-script（批量模式，见下方） |
| 创建账号、新账号 | 参考 account-creation.md |
工作流
所有执行细节按 SKILL.md 执行。
核心步骤：意图确认 → 风格校验 → 分镜规划(shotDesc/directorRef) → 图片提示词 → 生图+人工确认硬卡点 → 视频提示词 → 上传+生视频 → TTS+成片
每步必须经过用户确认或质量卡点才能进入下一步。
账号
账号配置在 accounts/ 目录（项目根目录），每个子目录一个账号，含 account.json。Agent 需要账号信息时扫描该目录获取最新列表，不依赖本文档的记忆。
常用操作
| 用户意图 | 操作 |
|---|---|
| 重新生成草稿、重做草稿、草稿再生 | 1. 将 manifest 中 pipeline.phases.assemble 改为 "pending"；2. 执行 node .claude/skills/video-from-script/scripts/pipeline.js run --manifest output/{name}/manifest.json --phase assemble |
| 查看草稿进度、草稿状态 | node .claude/skills/video-from-script/scripts/pipeline.js status --manifest output/{name}/manifest.json |
| 重跑某个阶段 | 将 manifest 中对应 phase 改为 "pending"，再跑 --phase <阶段名>。阶段: images → upload → videos → tts → assemble |
| 批量生产、给Excel出视频 | 见下方「批量生产」 |
草稿 = CapCut 剪映项目文件，由 pipeline 的 assemble 阶段生成，输出到本地剪映目录。
批量生产
用户给一个 Excel/CSV，每行一条视频，Agent 逐条 spawn Worker 子 Agent 执行完整 pipeline。
Excel 格式： 选题 | 脚本 | 账号 | 模式 | 音色（账号/模式/音色可选，可由 CLI 参数指定默认值）
CLI 命令：
# 1. 初始化批量任务
node .claude/skills/video-from-script/scripts/batch-pipeline.js init --file <xlsx/csv> --account <默认账号> --mode single --voice <默认音色>
# 2. 查看进度
node .claude/skills/video-from-script/scripts/batch-pipeline.js status --file output/batch_XXX/batch-manifest.json
# 3. 获取下一条待处理（JSON 格式）
node .claude/skills/video-from-script/scripts/batch-pipeline.js next --file output/batch_XXX/batch-manifest.json
# 4. 标记状态
node .claude/skills/video-from-script/scripts/batch-pipeline.js mark --file ... --row <N> --status <completed|failed> [--manifest-path <path>] [--error <msg>]
# 5. 重跑失败项
node .claude/skills/video-from-script/scripts/batch-pipeline.js retry-failed --file output/batch_XXX/batch-manifest.json
执行策略：Orchestrator-Worker
- Orchestrator（主 Agent）：读 batch-manifest 元数据，逐条 spawn Worker 子 Agent，收集结果
- Worker（子 Agent）：独立上下文，处理单条视频的完整流程（分镜 → 生图 → 生视频 → TTS → 成片）。Worker 调用
pipeline.js init时通过--tts-voice传入音色 - Orchestrator 上下文只存 batch-manifest 元数据，不读脚本正文
- 脚本正文通过文件路径传给 Worker，Worker 自行 Read
- 批量模式下人工确认环节自动跳过（
confirm --all）
草稿 = CapCut 剪映项目文件，由 pipeline 的 assemble 阶段生成，输出到本地剪映目录。
参考文档
- SKILL.md — 主技能（强制规则、分镜规则、质量卡点、执行策略）
- account-system.md — 账号规范
- account-creation.md — 账号创建 Q&A 流程
- manifest-schema.md — manifest 字段规范