AI Edit Studio

AI Edit Studio — Director 0.10

一款本地优先的视频编辑器，面向创作者、游戏开发者及其 Agent。同一套引擎为用户提供专业时间线，也为 Agent 提供相同的 59 个工具（MCP、HTTP/OpenAPI、CLI）。你的素材始终留在本机；原始文件只会被读取。

此前名为 Game Trailer Studio。现有项目、存储路径、GAME_TRAILER_STUDIO_* 设置和 Start-Game-Trailer-Studio.* 脚本仍可正常使用。本 README 的荷兰语历史版本见 docs/README.nl.md。

功能

0.10 新增 — 音乐引擎

• 为你的剪辑创作音乐（Audio 选项卡 → Compose music，或 studio_music）：从六种风格（流行 Drop、Trap、House、Lo-fi、Synthwave、电影预告片）中选择一款，在这台电脑上用合成乐器创作原创曲目——无需采样、无需联网，免费使用。曲目时长与剪辑完全一致，Drop 会精准落在剪辑点（或名为 drop 的标记）上，并在最后一帧以最终重击收尾。同一种子 = 同一首曲目，New variation = 新的旋律与律动。节拍网格精准无误，因此 Snap cuts to beat 会使用真实节拍。可选分轨（鼓、贝斯、音乐、音效）。
• 随时一键选择自己的音乐（Choose…），包括使用 Suno、Udio 等创作的曲目。
• 使用自己的 ElevenLabs 密钥在线生成（可选）：只会发送文本提示词和时长。
• 修复：可能占满磁盘的音效轨道、FFmpeg 4.x 无法读取的滤镜脚本、被拉伸的历史卡片、被裁切的右侧面板选项卡、开始屏幕上的工具数量，以及忽略时间线文本的审阅提示。

0.9 新增 — 润色优化

• 画面 — LUT（六种内置风格或自定义 .cube，可调强度）、逐镜头自动匹配色彩与摄像机，以及抖动画面的稳定处理（两遍 vid.stab，只测量一次）。
• 声音 — 按小节线剪切音乐，使其恰好在剪辑结束时收尾；修复嗡鸣、咔嗒声、削波和噪声；统一镜头音量；本地生成音效（whoosh、hit、pop、riser…）；用于混音的分轨；让停顿加速播放，而不是直接剪掉。
• 访谈视频 — 在强调处缩放或缓慢推近；在提及名称的位置插入 B-roll；添加进度条和订阅/链接弹窗。
• 工作流 — 对多个项目执行同一操作，并将两个版本并排合成为一段视频。

0.8 新增 — 长篇剪辑

• 分段、缓存渲染 — 长篇剪辑会渲染为已完成的分段；修复后只需重新渲染发生变化的部分，最后再用一个简短步骤混合声音。只渲染一个部分（I/O 范围）即可检查修复效果。
• 帧级精准剪辑 — 修复了镜头较多时剪辑点（以及字幕、旁白和音乐）逐渐后移的问题，以及 0.5–0.7 版本中可能导致镜头略微提前开始的入点错误。请重新渲染旧版导出文件。
• 大纲 — 以镜头为锚点的章节：移动、删除或调整整个章节的色彩；章节会成为 YouTube 章节。
• 搜索素材 — 查找说过的内容（支持容错拼写）、标签、标记和精彩片段；一键插入。
• 适配时长 — 45 → 30 分钟，或 3:12 → 2:59：优先处理停顿、填充词、最弱的句子和镜头。
• 脚本 → 粗剪、音频同步 + 多机位（画面跟随说话者）、固定到镜头的审阅备注、重型素材的代理文件，以及交接至 Premiere/Resolve/Avid（EDL）、Final Cut/Resolve（FCPXML）、OTIO、CSV 镜头列表和 YouTube 章节。所有功能都在全新的 Long 选项卡中提供，也可通过 Agent 工具使用。

0.7 新增

• 动态字幕 — 卡拉 OK、弹跳、标记高亮或逐词显示；与转录文本中的词语精准对齐， 使用 libass 按照你的品牌色和字体渲染；可在编辑器中实时预览。
• 片段查找器 — 长视频 → 最佳的独立片段（按句子对齐），每个片段生成一个可直接使用的项目，并将渲染任务加入队列。
• 图层 — 在剪辑上方添加 B-roll 插播和画中画；主音轨会继续播放。
• 声音与动态 — 每个镜头都可进行 J/L 剪辑、在节拍上推近缩放、设置阶梯式变速和定格画面。
• 专业音频 — 人声增强（降噪、增强临场感、去齿音）和母带响度目标（默认 −14 LUFS）。
• 面向 Agent — 渲染质检（LUFS、峰值、黑屏/冻结画面、静音）、渲染队列、长轮询 studio_wait、实时 SSE 事件 和配方（一次调用即可执行多步工作流）。

0.6 新功能

• ✦ 导演模式 — 选择平台（TikTok、Reels、Shorts、信息流、YouTube、预告片、视频博客、电影），即可获得剪辑成片：删除冷场和黑屏，从三个候选中选出最强开场钩子，添加转场、节拍同步、语音字幕、自动修正问题、竖屏重构，并生成适用于该平台的渲染版本。还可选择创建 A/B 项目，使用其他开场钩子。
• 按文本剪辑 — 本地语音识别（whisper.cpp，可选的一次性安装），然后在转录文本中删除词语、填充词和长停顿，搜索短语，或根据选定段落制作纸上剪辑。字幕会自动跟随。
• 智能重构 — 对于 9:16、1:1 和 4:5，裁剪区域会按镜头跟随测得的运动，并在主体移动时平移。
• 发布包 — 从最清晰、高能的画面生成带标题的缩略图和封面、干净静帧、SRT/VTT、YouTube 章节，以及适用于各平台的标题/描述/话题标签草稿。绝不会发布任何内容。
• 品牌套件 — 标志（位置/尺寸/不透明度）、颜色、字体、片头和片尾、CTA 和话题标签；点击一次或调用一次即可应用。

面向剪辑师（打开 http://127.0.0.1:32146/；界面支持英语或荷兰语，可在右上角切换）

• 时间线，包含标记、V1（胶片缩略图 + 能量条）、A1（测量波形）、音乐（节拍网格）和文本轨道。拖动以重新排序，拖动边缘以波纹修剪，Alt+拖动以滑移，使用刀片工具和吸附功能。
• NLE 快捷键：Space、J/K/L、I/O、S（剪切）、Q/W（修剪到播放头）、Delete（波纹删除）、Alt+←/→、M、N、V/B、Ctrl+Z/S、Ctrl+Enter、?。
• 逐镜头设置：速度、增益、裁剪/缩放/焦点、Ken Burns（缩放 → 在结尾缩放）、镜像、转场（叠化、淡入黑场/白场、擦除、滑动、圆形、像素化、径向）、色彩（亮度、对比度、饱和度、色温、锐化、降噪）。
• 屏幕文字：标题卡、下三分之一字幕、大号社交媒体文字和带淡入淡出的备注。基于你的 SRT 并按源视频时间定位的字幕，会跟随每次剪切。提供三种字幕样式。
• 音乐：节拍检测、按节拍吸附剪切、音乐起始偏移、在语音下方自动降低音量。
• 实时质量检查：评分、开场钩子强度、跳切、闪光镜头、黑帧、字幕速度、偏离节拍的剪切——支持一键修复。
• 模板（Shorts 开场钩子、游戏预告片、YouTube 预告、开发日志、电影风格、信息流帖子）和与你的 Agent 共享的命名样式。
• 历史记录，显示每次修订的作者、“更改了什么？”以及可还原且不破坏原内容的版本。Agent 的编辑会实时显示。
• 导出：1080p/1440p/4K、9:16、1:1、4:5（在模糊背景上显示完整画面，或使用你的裁剪结果），以及 ≤ 16 MiB 的 WhatsApp 版本。
• 长视频：最长 20 分钟，200 个镜头，24 个素材源（每个最长 2 h）。静态图片（PNG/JPG/WebP）也可作为素材源。

面向 Agent — 请参阅 AGENTS.md；Claude、Cursor、OpenAI Codex、OpenAI API、n8n 等的设置说明见 docs/INTEGRATIONS.md，修复方法见 TROUBLESHOOTING.md。

入口	接入方式
Claude Code 插件	/plugin marketplace add <this folder> → /plugin install ai-edit-studio@ai-edit-studio（工具 + 工作流技能 + video-director Agent）
OpenAI Codex	node cli.mjs codex-setup（或使用 plugins/ai-edit-studio 中的 Codex 插件）——工具 + 相同的技能
OpenAI API	examples/openai/（Responses API、Agents SDK）；GET /api/agent/tools?format=openai
MCP（stdio）	claude mcp add ai-edit-studio -- node mcp.mjs
HTTP	GET /api/agent/tools、POST /api/agent/call、POST /api/agent/tools/{name}
OpenAPI 3.1	GET /api/openapi.json
CLI	node cli.mjs studio <tool> --request file.json [--wait]

从素材到成片，只需调用一次：studio_auto_edit。基于文本编辑：studio_transcribe、studio_transcript、 studio_text_edit。此外还有 studio_reframe、studio_publish_pack、studio_brand。原子化的 studio_edit 可按稳定的剪辑片段 ID 批量操作（支持 dryRun）；使用 studio_timeline + studio_storyboard 查看剪辑，使用 studio_review 获取可由机器应用的修正，还支持节拍、精彩片段、样式、字幕导入、 历史记录／差异／恢复、复制和渲染。Agent 的每项更改都会生成一个修订版本，并记录 Agent 名称。

安装和启动（Windows 测试版）

使用 npm（需要 Node 20+ 和 FFmpeg）：

npm install -g ai-edit-studio
ai-edit-studio install      # data folder + connects Claude Code, Codex, Claude Desktop and Cursor
ai-edit-studio serve        # starts the editor on http://127.0.0.1:32146

作为 Agent 的 MCP 服务，无需预先安装任何内容：claude mcp add ai-edit-studio -- npx -y ai-edit-studio mcp （同一条命令也适用于 Cursor、Claude Desktop 和 Codex 配置）。注册表名称：io.github.laaielichter/ai-edit-studio。

**使用下载的 zip：**解压后，双击 Install-AI-Edit-Studio.cmd（macOS/Linux：./install.sh）， 然后按照 INSTALL.md 操作。该程序会设置数据文件夹，并一次性连接 Claude Code、OpenAI Codex、Claude Desktop 和 Cursor。

从源代码安装：

要求：Node 20+，以及包含 libx264 的 FFmpeg 版本（已在 Windows 上使用 FFmpeg 9.0.1、在 Linux 上使用 6.1 测试；如可用，则使用 NVENC）。

# double-click Start-Game-Trailer-Studio.vbs  (hidden server, opens the browser)
# or:
npm start
node cli.mjs doctor      # checks FFmpeg, encoder, storage and the (optional) speech engine
node cli.mjs speech-setup --model base   # optional: local speech recognition (whisper.cpp + model, ~200 MB)

程序会在 PATH、应用程序或数据文件夹下的 tools/ffmpeg/bin 中查找 FFmpeg/ffprobe，也可通过 FFMPEG_PATH / FFPROBE_PATH 指定。

**存储。**项目和渲染文件会保存在数据文件夹中：即安装程序中选择的文件夹；若未选择，则 Windows 上为 Documents\AI Edit Studio，macOS/Linux 上为应用程序旁的 .studio-data。如需选择其他文件夹：

./Start-Game-Trailer-Studio.ps1 -DataRoot 'D:\AI-Edit-Studio'
# or set GAME_TRAILER_STUDIO_DATA_ROOT=<absolute folder>

服务仅绑定到 127.0.0.1:32146（可通过 GAME_TRAILER_STUDIO_PORT 更改）。旧版采集控制台位于 /legacy.html。

局限说明

• 语音识别仅在本地运行，且需要安装可选的 whisper.cpp（或自行提供转录文本）。不支持人脸 跟踪（重新构图会跟随测量到的运动），不支持生成式视频，也不支持上传或发布。
• 能量、钩子、精彩片段和 Director 模式使用运动、响度、场景变化、节拍和词语进行分析——不理解故事或审美。 发布包中的帖子文本仅根据你自己的标题、简介和行动号召生成草稿。
• 浏览器预览只能近似呈现画面、色彩、文本和转场；最终结果以 FFmpeg 渲染为准。 浏览器无法播放的格式（例如部分 MKV/HEVC）仍可正常编辑；请查看渲染后的预览。
• 输出为 SDR / H.264；4K 是 Lanczos 升频，并非 AI 细节增强。
• 目前处于测试阶段：尚未经过众多外部用户验证。欢迎通过 GitHub issue 报告错误。

开发

node --test                                   # unit tests
node tools/verify-beta.mjs <new-dir-under-data-root>
node tools/verify-director.mjs <new-dir-under-data-root>
node tools/verify-director-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>
node tools/verify-director06.mjs <new-dir-under-data-root> [port]
node tools/verify-director06-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>
node tools/verify-director07.mjs <new-dir-under-data-root> [port]
node tools/verify-director07-ui.mjs <playwright/index.mjs> <chrome> <new-dir> <analysed-project-id>

许可证

MIT——详见 LICENSE。欢迎提交问题和拉取请求；提交前请运行 node --test。

更新日志 · 隐私 · 第三方声明 · Agent 指南（荷兰语）