内容
# ForgeFrame -- 工作坊视频大脑
适用于教程视频创作者的本地优先的Claude Code插件。使用AI驱动的技能、88种MCP工具和全面的视频编辑手册，计划、编辑和发布工作坊视频。
---
## 视频编辑手册
**视频编辑新手？** 本手册是从零到发布视频的完整指南，涵盖Kdenlive、制作概念和ForgeFrame自动化。
[**阅读手册**](docs/video-editing-guide/README.md)
| 部分 | 章节 | 您将学习的内容 |
|------|----------|------------------|
| **基础** | 第0-2章 | ForgeFrame设置、制作流程、学习路径 |
| **前期制作** | 第3-4章 | 大纲、脚本、拍摄计划、拍摄清单 |
| **制作** | 第5章 | 相机设置、灯光、音频、VFR预防 |
| **后期制作** | 第6-12章 | Kdenlive编辑、过渡、色彩、音频、节奏、特效 |
| **交付** | 第13-16章 | 导出、质量控制自动化、YouTube发布、社交剪辑 |
| **参考** | 第17-20章 | 故障排除、硬件、技能目录、资源 |
包括[工作流速查表](docs/video-editing-guide/appendix-a-workflow-cheatsheet.md)、[Kdenlive快捷键](docs/video-editing-guide/appendix-b-kdenlive-shortcuts.md)和[术语表](docs/video-editing-guide/appendix-c-glossary.md)。
---
## 17种Claude Code技能
### 前期制作
| 技能 | 功能 |
|-------|-------------|
| `/ff-init` | 初始化ForgeFrame环境，包含保险库结构和配置 |
| `/ff-new-project` | 从脑图创建一个完整的项目（工作空间 + 大纲 + 脚本 + 拍摄计划） |
| `/ff-video-idea-to-outline` | 从脑图创建结构化教程大纲 |
| `/ff-tutorial-script` | 包含钩子、材料、步骤、错误和结论的完整脚本 |
| `/ff-shot-plan` | 涵盖7类（A卷、俯瞰、特写、测量、插入、华丽、拾取）的制作拍摄清单 |
| `/ff-capture-prep` | 拍摄前检查清单：相机设置、音频、灯光、优化的拍摄顺序 |
| `/ff-broll-whisperer` | 根据转录分析提供B卷建议（5种拍摄类型类别） |
| `/ff-obsidian-video-note` | 创建/更新带有章节安全同步的Obsidian项目笔记 |
### 后期制作
| 技能 | 功能 |
|-------|-------------|
| `/ff-auto-editor` | 从剪辑 + 脚本组装第一个Kdenlive项目 |
| `/ff-rough-cut-review` | 从转录 + 标记提供节奏和结构反馈 |
| `/ff-pacing-meter` | 分段能量分析：WPM、语音密度、能量下降 |
| `/ff-voiceover-fixer` | 确定漫无边际的部分并进行紧凑的重写 |
| `/ff-audio-cleanup` | 全面的语音处理流程：降噪 → EQ → 压缩 → 归一化 → 限制 |
| `/ff-pattern-brain` | 提取材料、测量、步骤用于MYOG叠加层 + 可打印笔记 |
### 发布
| 技能 | 功能 |
|-------|-------------|
| `/ff-publish` | YouTube元数据包：标题、描述、标签、章节、摘要 |
| `/ff-social-clips` | 为Shorts/Reels提取高亮剪辑，附带平台特定帖子 |
| `/ff-youtube-analytics` | 获取并分析YouTube频道数据，附带参与度洞察 |
## 88种MCP工具
| 类别 | 工具 | 数量 |
|----------|-------|-------|
| **工作空间** | create, status, snapshot_list, snapshot_restore | 4 |
| **媒体** | ingest, list_assets, proxy_generate, check_vfr, transcode_cfr | 5 |
| **转录** | generate, export | 2 |
| **标记** | auto_generate, list | 2 |
| **剪辑** | label, search, insert, remove, move, split, trim, ripple_delete, speed | 9 |
| **时间线** | build_review, build_selects | 2 |
| **项目** | create_working_copy, validate, summary, setup_profile, match_source, archive | 6 |
| **过渡** | apply, apply_at, apply_between | 3 |
| **合成** | composite_pip, composite_wipe | 2 |
| **特效** | effect_add, effect_list_common | 2 |
| **色彩** | color_analyze, color_apply_lut | 2 |
| **音频** | fade, normalize, compress, denoise, enhance, enhance_all, analyze | 7 |
| **音轨** | add, mute, visibility, gap_insert | 4 |
| **字幕** | generate, export | 2 |
| **渲染** | preview, final, list_profiles, status | 4 |
| **质量控制** | qc_check | 1 |
| **组装** | plan, build | 2 |
| **分析** | broll_suggest, pacing_analyze, pattern_extract, replay_generate, title_cards_generate, voiceover_extract_segments | 6 |
| **B卷库** | index, search, tag, stats | 4 |
| **社交** | find_clips, generate_package, clip_post | 3 |
| **发布** | bundle, description, titles, tags, summary, note | 6 |
| **YouTube** | fetch_channel, fetch_video, analyze, save_to_vault | 4 |
| **ForgeFrame** | init, status, project_new, project_list | 4 |
| **服务器** | ping | 1 |
## 安装
### 作为Claude Code插件（推荐）
```bash
# 添加ForgeFrame市场
/plugin marketplace add Caleb68864/ForgeFrame
# 安装工作坊视频大脑
/plugin install workshop-video-brain@forgeframe
```
这将为您提供所有17种技能，并自动启动MCP服务器。
### 手动设置
```bash
git clone https://github.com/Caleb68864/ForgeFrame.git
cd ForgeFrame
uv sync
```
### 先决条件
- Python 3.12+
- [uv](https://docs.astral.sh/uv/) 包管理器
- FFmpeg（视频处理所需）
- [faster-whisper](https://github.com/SYSTRAN/faster-whisper)（转录所需）
- Kdenlive（推荐用于时间线编辑）
## 快速入门
### 1. 设置ForgeFrame
```
/ff-init
```
### 2. 计划视频
```
/ff-new-project "我想制作一个关于制作榫头接榫的教程"
```
这将创建一个工作空间，包含大纲、脚本、拍摄计划和拍摄清单。
### 3. 拍摄和导入
```
/ff-capture-prep # 获取您的拍摄前检查清单
# ... 拍摄您的教程 ...
wvb media ingest ./workspace/ # 扫描、代理、转录、检测静默
```
### 4. 编辑
```
/ff-auto-editor # 组装第一个剪辑
/ff-rough-cut-review # 获取结构反馈
/ff-pacing-meter # 查找慢速部分
/ff-audio-cleanup # 润色音频
```
### 5. 导出和发布
```
wvb render final ./workspace/ --profile youtube-1080p
wvb qc-check ./renders/output.mp4 # 自动质量检查
/ff-publish # 生成YouTube元数据
/ff-social-clips # 提取Shorts/Reels的剪辑
```
## 流水线功能
| 功能 | 功能描述 |
|---------|-------------|
| **转录** | 使用faster-whisper进行本地STT，支持SRT/JSON/text导出 |
| **自动标记** | 14种标记类别 + 短语检测 + 重复检测 |
| **剪辑标签** | 根据内容自动标记剪辑（教程步骤、说话头像、B卷等） |
| **审查时间线** | Kdenlive中基于最佳猜测的排名审查 |
| **选择时间线** | 高置信度片段的过滤时间线 |
| **重播生成器** | 带有交叉淡入淡出的高亮剪辑 |
| **色彩分析** | 色彩空间检测、HDR标记、LUT应用 |
| **质量控制自动化** | 黑帧、静默、响度、剪辑、文件大小检查 |
| **VFR检测** | 扫描VFR并自动转码为CFR |
| **渲染配置文件** | YouTube 1080p/4K、Vimeo HQ、Master ProRes/DNxHR |
| **合成** | 画中画预设 + 擦除/溶解过渡 |
| **特效** | 通用特效插入 + 精选参考列表 |
| **项目存档** | 流式tar.gz/zip工作空间打包 |
| **Obsidian同步** | 章节安全笔记更新，带有frontmatter合并 |
| **快照** | 复制优先安全 - 永远不会触及原件 |
## 技术栈
| 层 | 技术 |
|-------|-----------|
| MCP服务器 | [FastMCP](https://github.com/jlowin/fastmcp) |
| 数据模型 | [Pydantic v2](https://docs.pydantic.dev/) |
| 命令行界面 | [Click](https://click.palletsprojects.com/) |
| 模板引擎 | [Jinja2](https://jinja.palletsprojects.com/) |
| 视频处理 | FFmpeg / ffprobe |
| 转录 | faster-whisper |
| 构建/依赖 | [uv](https://docs.astral.sh/uv/) + hatchling |
## 文档
- [**视频编辑手册**](docs/video-editing-guide/README.md) -- 20章指南，从零到发布视频
- [ForgeFrame技能参考](docs/video-editing-guide/19-forgeframe-skill-reference.md) -- 完整的技能 + 工具目录
- [工作流速查表](docs/video-editing-guide/appendix-a-workflow-cheatsheet.md) -- 一页技能链
- [使用Kdenlive测试](docs/testing-with-kdenlive.md) -- 分步测试指南
- [开发者设置](docs/developer-setup.md) -- 开发环境设置
- [架构决策](docs/adr/) -- 关键设计选择的ADR
## 测试
```bash
uv run pytest tests/ -v # 2,189 tests
```
## 许可证
MIT -- 请参阅 [LICENSE](LICENSE)。
