qiaomu-cut

说一句话，生成完整视频工程：从素材收集、分镜规划、字幕、转场、动效到渲染和质检，全部自动编排。

适用场景

• 影视台词混剪 / 英语学习视频
• 60 秒科普或启蒙视频（如挖掘机英语启蒙）
• 人物传记 / 历史档案短片
• 3Blue1Brown 风格的数学 / 科学解释视频
• 产品发布视频（融合网页动效）
• 小红书 / 抖音竖屏卡点短视频
• 口播精剪 / 播客切片
• 更多（见内置工作流）

核心能力

1. 将一句话需求转换为 QiaoCut IR 中间表示，包含时长、比例、受众、风格、分镜、素材策略。
2. 自动搜索、生成或整理素材：33 台词（影视片段）、ClipSeek（免费素材）、Pexels / Pixabay、本地文件、ListenHub（图片 / 视频 / TTS / 音乐）、AI 图片生成等。
3. 设计专业镜头：推拉摇移、匹配剪辑、J/L cut、字幕跟随、标题卡、动态图形。
4. 支持多渲染引擎：ffmpeg-full、HTML、Manim 等。
5. 提供 preview / standard / final 三档渲染，先快速迭代再出成片，并自动执行对应技术校验。
6. 输出最终视频、contact sheet、素材清单（assets-manifest.json）、授权报告（license-report.md）、渲染质量报告等。

工作方式

1. 你提供一句视频需求。
2. 系统生成 QiaoCut IR 并选择最合适的工作流。
3. 根据 IR 收集或生成素材，同时记录每项素材的来源和许可状态。
4. 组装项目时间线，支持三层双语字幕、品牌片头片尾模板、多轨混音。
5. 使用 ffmpeg 等引擎按所选档位渲染，并进行技术校验。
6. 输出视频及相关文件，项目可随时调整并重新渲染。

你需要提供

• 清晰的视频需求（主题、时长、风格、平台等）。
• 运行环境（见注意事项）。
• 使用 33 台词时需要本机安装并登录 33 台词 App 及 33tc CLI；使用 ListenHub 生成时需要账号或 API Key。

你会获得

• 最终视频文件（.mp4），可选 contact sheet。
• QiaoCut IR 文件、素材清单、授权报告、渲染质量报告。
• 完整的可复现项目，便于后续修改与重新渲染。

使用示例

检查本机环境：

node ~/.agents/skills/qiaomu-cut/scripts/qcut.js doctor --json

制作一个 60 秒挖掘机英语启蒙视频：

# 生成计划
node scripts/qcut.js plan "做一个60秒挖掘机英语启蒙视频" --workflow stock-story --json

# 创建项目
node scripts/qcut.js scaffold ./excavator-video --brief "做一个60秒挖掘机英语启蒙视频" --json

# （编辑 timeline.json 后）快速预览
node scripts/qcut.js render ./excavator-video --profile preview --json

# 确认内容后生成最终版
node scripts/qcut.js render ./excavator-video --profile final --json

通过 33 台词搜索影视片段：

node scripts/qcut.js 33tc search "dig deeper" --limit 8 --json

生成 ASS 双语字幕：

node scripts/qcut.js ass captions.json --output subtitles.ass

渲染并输出 contact sheet：

node scripts/qcut.js render ./my-project --profile final --json

渲染档位

内置工作流

素材来源

• 33 台词：影视台词搜索与片段剪辑；需本机安装并登录 33 台词 App，并单独安装获得授权的 33tc CLI。
• ClipSeek：免费素材搜索聚合，最终仍需到原站（Pexels / Pixabay 等）确认下载与许可。
• Pexels / Pixabay：通过 ClipSeek 结果回到原站确认。
• 本地文件：用户提供的素材优先，不会覆盖原文件。
• AI 生成：封面、插画、背景、缺口 B-roll、SVG / 网页视觉等。
• ListenHub / MarsWave：图片、短视频镜头、TTS、Voice、多角色播客、音乐。
• 信息源：人物、公司、事件类视频必须记录引用来源。

注意事项

运行环境

• Node.js 18+（使用 ListenHub 需要 Node.js 20+）
• 推荐 macOS 并安装 Homebrew
• ffmpeg-full（包含 libass、drawtext、overlay、loudnorm 等支持）
  • 安装：~/.agents/skills/qiaomu-cut/scripts/bootstrap_macos.sh --install
  • 可设置 QIAOMU_FFMPEG 环境变量指向自定义路径
• 可选：33 台词 App 与 33tc CLI；ListenHub 账号 / API Key；GitHub CLI；AI 图片生成工具（由当前 agent 环境提供）

安全与限制

• 不会删除或覆盖你的原始素材。
• API key 不会出现在命令、日志、任务 capture、manifest 或 Git 仓库中；终端输出会清洗凭证。
• 远端生成可能产生积分费用，始终需要显式 --yes 确认；上传本地素材需额外 --allow-upload。
• 除非原站许可明确记载，否则不会声称素材“可商用”。
• AI 生成素材标记为 ai_generated，不会伪装成实拍或档案照片。
• 影视台词片段默认按学习、评论、研究或已获授权处理，公开传播需自行确认版权。
• 不会将计划状态描述为已完成渲染。

平台支持

环境变量

常见问题