核心功能与定位
QCut Toolkit 是一套面向视频创作者和开发者的统一媒体工作流工具集，通过六个高度协同的子技能覆盖从项目初始化到最终输出的完整生产链路。其核心设计哲学是"先组织、后处理、再生成"——确保每个步骤都有清晰的输入结构和可预期的输出位置。
六大子技能分工：
| 子技能 | 核心职责 | 典型场景 |
|--------|---------|---------|
| `native-cli` | 项目结构管理、编辑器原生命令 | 初始化项目、整理素材、执行编辑器操作 |
| `ffmpeg-skill` | 媒体转码与处理 | 格式转换、压缩、裁剪、字幕烧录、GIF生成 |
| `ai-content-pipeline` | AI 内容生成与分析 | 文生图/视频、数字人、语音转写、视频分析 |
| `seedance` | 视频提示词工程 | 即梦/Seedance 工作流、短视频/广告脚本 |
| `qcut-mcp-preview-test` | MCP 预览调试 | 切换预览模式、iframe 渲染排错 |
| `pr-comments` | 代码审查处理 | 导出PR评论、批量修复反馈 |
显著优点
1. 流水线化设计：强制性的执行顺序（组织→处理→生成→控制→整理）避免常见的工作流混乱
2. 标准化目录结构：统一的 input/output/config/media/generated 布局，跨项目可迁移
3. AI 原生集成：直接调用 FLUX、Veo 3、Sora 2、OmniHuman 等前沿模型，非简单的 API 包装
4. 双模预览支持：传统视频预览与 MCP App 模式无缝切换，适配 Claude Desktop 生态
5. 中文场景优化：seedance 子技能专为字节跳动即梦平台设计，支持中文提示词工程
潜在局限与风险
| 维度 | 具体表现 |
|------|---------|
| **生态依赖** | 深度绑定 QCut 编辑器原生 CLI，脱离该环境后 `native-cli` 和 `editor:*` 命令失效 |
| **模型可用性** | AI 子技能依赖外部服务（Gemini 3 Pro、Veo 3 等），存在配额、区域限制或政策变更风险 |
| **MCP 实验性** | `qcut-mcp-preview-test` 涉及 iframe srcDoc 和 IPC 通信，属较新的协议层，稳定性待验证 |
| **无沙箱隔离** | FFmpeg 和文件操作直接作用于本地文件系统，误操作可能导致数据丢失 |
| **PR 评论局限** | `pr-comments` 仅处理 GitHub 生态，不支持 GitLab、Bitbucket 等平台 |
适合人群
- 短视频创作者：需要批量处理素材、生成封面、即梦平台出图
- AI 视频实验者：探索 Sora/Veo/Kling 等多模型流水线组合
- QCut 编辑器用户：希望通过 CLI 自动化编辑器工作流
- MCP 开发者：调试 Claude Desktop 的媒体应用预览模式
- 开源维护者：需要批量处理 CodeRabbit/Gemini 的自动化代码审查
常规风险提示
- 破坏性操作确认：
organize-project会重排文件结构，ffmpeg覆盖输出需显式确认 - API 成本意识：AI 内容生成涉及多模型调用，建议设置预算上限
- 临时文件清理：
media/generated/和output/可能累积大量数据，需定期归档 - MCP 安全边界：
mcp:app-html事件接收任意 HTML，需确保来源可信
版本演进建议
当前技能集功能密集但文档分散于六个子目录，建议未来版本：
1. 提供统一的配置层（如 qcut.yaml）替代分散的参数传递
2. 增加 dry-run 模式预览多步骤工作流
3. 补充子技能健康检查（模型可用性、FFmpeg 版本、GitHub Token 权限）