核心用法
QCut Toolkit 是面向视频创作者和开发者的统一媒体工作流入口，采用主从架构设计：主技能负责任务解析与路由调度，六大子技能各司其职形成完整生产管线。
标准工作流顺序：native-cli（项目初始化/文件整理）→ ffmpeg-skill（转码/剪辑/压缩）→ ai-content-pipeline（AI生成/分析）→ seedance（视频提示词工程）→ native-cli editor:*（回写剪辑器）。
子技能能力矩阵
| 子技能 | 核心能力 | 典型场景 |
|--------|---------|---------|
| native-cli | 项目结构初始化、文件按扩展名自动归类、编辑器原生命令（timeline/import/export/diagnostic） | 新工程 setup、批量整理素材 |
| ffmpeg-skill | 格式转换、CRF压缩、scale缩放、ss/t裁剪、字幕烧录、GIF生成、HLS/DASH流媒体、复杂 filtergraph | 格式兼容处理、码率优化、多平台适配 |
| ai-content-pipeline | FLUX/Imagen 4/GPT Image 文生图；Veo 3/Sora 2/Kling 图生视频；OmniHuman/Fabric 数字人；Scribe v2 转录；Gemini 3 Pro 视频分析 | AI辅助创作、语音字幕、智能分析 |
| seedance | 即梦/Seedance 2.0 中文提示词工程、短剧/广告/电影级模板、多模态视频描述 | 字节系视频模型优化、中文场景 |
| qcut-mcp-preview-test | MCP App 模式切换、iframe srcDoc 渲染验证、`mcp:app-html` 与 `/api/claude/mcp/app` 调试 | MCP 媒体应用开发调试 |
| pr-comments | GitHub PR 评论导出、CodeRabbit/Gemini 评审批量处理、文件级评论聚类、线序重排 | 自动化代码审查后处理 |
项目结构规范
所有子技能统一使用 Documents/QCut/Projects/{project-name}/ 目录结构，包含 input/（多类型素材）、output/（成品）、config/（配置）、media/generated/（AI生成内容），确保跨技能数据流转的一致性。
显著优点
1. 管线化设计：明确的分阶段路由逻辑（Organize→Process→Generate→Prompt→Control→Organize），避免技能调用混乱
2. 统一入口：用户无需记忆六个独立技能，通过自然语言描述即可自动路由到合适子技能
3. 链式执行支持：内置多步骤工作流示例（如"剪辑后生成缩略图"自动拆解为 ffmpeg-skill → ai-content-pipeline）
4. 中文场景优化：seedance 子技能专为即梦/Seedance 2.0 设计，提供中文提示词模板
5. MCP 原生集成：qcut-mcp-preview-test 支持 Claude MCP 媒体应用的预览调试
潜在缺点与局限性
1. 外部依赖重：ffmpeg-skill 依赖本地 FFmpeg 安装，ai-content-pipeline 依赖外部 AI 服务 API 密钥
2. 无内置错误恢复：文档未提及断点续传或失败重试机制，长链路任务中断需手动恢复
3. 编辑器耦合：native-cli 的 editor:* 命令依赖 QCut 编辑器原生协议，第三方剪辑软件不兼容
4. 平台锁定风险：seedance 针对字节跳动模型优化，迁移至其他视频模型需重新工程化提示词
5. MCP 调试门槛：qcut-mcp-preview-test 涉及 iframe IPC 和 HTTP 端点调试，需要开发者具备前端工程经验
适合人群
- 独立视频创作者：需要 AI 辅助生成素材 + 传统剪辑混用的 hybrid workflow
- MCN 内容团队：批量处理多平台适配（横屏/竖屏、不同码率）和 AI 批量生成
- AI 视频应用开发者：构建基于 Claude MCP 的媒体预览工具
- 开源项目维护者：需要自动化处理 PR 代码审查反馈
常规风险
- 文件覆盖风险：
organize-project和输出阶段未明确提示冲突处理策略，建议在$ARGUMENTS中显式确认覆盖操作 - API 成本失控：ai-content-pipeline 涉及多模态生成（视频/图像），高并发调用易产生意外账单
- 版权合规：AI 生成内容的商用边界需用户自行确认，工具本身不提供合规检查
- 路径遍历：项目路径基于
Documents/QCut/Projects/，跨盘符或网络路径的兼容性未验证