Open-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.

文件	最后提交记录	最后更新时间
.github	chore(release): prepare v0.2.16	8 天前
assets	fix(publish): bind approval to the account, carry the Pinterest board, keep the publish record across moves Review on #188: 1. [P1] The publish identity now includes the endpoint and a stable account identity: sha256(baseUrl + account email) from GET /api/uploadposts/me, cached per key. An approval from account A is refused under account B (409 preview_mismatch), B's ledger entry is never reported as A's, and a key rotation of the same account keeps the id, so duplicate protection survives it. 2. [P2] pinterestBoardId flows through the tool schema, the browser tool, the parser (required with Pinterest), the preview, the approved identity and the multipart form (pinterest_board_id). 3. [P2] upload-post-publishes.json is in RELOCATED_ENTRIES. The relocation runs inside pausePublishing: refused while an upload is in flight, no upload is admitted while the root is copied, and none until the restart that makes the new root live (before it, writes would still go to the old root). 4. [P2] The render identity is a SHA-256 of its bytes instead of its mtime (cached per file version), so a MEDIA_DIR migration or a copy to a filesystem with coarse timestamps keeps the id. syncUploadDirectories also preserves the original timestamps. Tests: regressions for each case in upload-post.verify, data-dir.verify and publish-tools.verify.	12 天前
cli	fix(cli): render media from the active library	18 天前
config	feat(providers): add opt-in Fal.ai image and video generation Adds a curated Fal.ai catalog behind FAL_KEY, opt-in and inert until a key is set: image and video model pickers in Settings, per-model constraints in the submit_image / submit_video tool schemas, queue submission that persists the request ID before polling so a resume never pays for a second job, and an endpoint allow-list on the saved checkpoint. Rebased onto main by the maintainer: the key names moved to the split keystore-names module, the video unions and validator keep the OFox provider alongside fal, the Claude Code status argument is preserved in the vendor pane, the tool-schema asset was regenerated, and the Fal catalog note moved to its own component to keep settingsVendorPane.tsx within the 500-line gate. Full CI (lint, npm test, agent-skill contract, build, macOS export frame synchronization) passes on the rebased branch.	23 天前
desktop	feat(storage): make SQLite the sole project-store backend	10 天前
public	fix: harden imports and provider runtimes Serialize xAI OAuth lifecycle operations, reject stale sessions, and align Grok request contracts. Fix directory imports and Silero VAD state, bound imported document context, complete Russian Agent surfaces, and split oversized shared modules without changing their contracts. Shared paths: Agent prompts and execution errors, generation routes, media import, settings, and composer UI. Validation: npx tsc -b --force; npm run lint; npm run verify:affected (33); TEST_CONCURRENCY=4 npm test; npm run build; real DeepSeek Agent read_project/read_timeline calls in Chinese and Russian; Browser4 composer smoke with zero console warnings.	1 个月前
remotion	fix(render): decode GL transition inputs with the export's video decoder The macOS frame-sync job failed intermittently in its Windows-decoder step (3 of 9 recent runs): a "Rendering <Html5Video /> ..." delayRender on a transition frame never cleared, and the render failed after 598 s. GlTransition fed its two inputs from <Video> from 'remotion', which is <Html5Video>, whatever decoder the server picked. So every GLSL transition in a Windows server export, cross-dissolve included, still depended on Chrome's HTML5 seek next to the <OffthreadVideo> layers. #162 moved every other layer off that path. A seek that hangs there holds the export on that frame until the ten-minute budget runs out, the symptom #162 reported. When those inputs did not hang, they showed the wrong frames, on every platform. The GL pass draws in a layout effect. <Html5Video> seeks in a passive effect, which runs after it. So each render tab drew whatever its <video> showed before seeking, and only the first window frame a tab mounted was current. A split-screen transition rendered with 8 tabs got all 20 window frames wrong, with both the webcodecs and the offthread decoder. Frames 43-54 showed content from about 8 frames earlier. The first 8 showed the outgoing clip one source frame later than the Player. In a server render GlTransition now decodes both inputs with the export's decoder, as the clip layers under the window do. That is <OffthreadVideo> under 'offthread', with the trim that matches the Player and WebM alpha, and @remotion/media otherwise. A stable onVideoFrame (src/gl/capturedFrame.ts) copies each decoded frame and tags it with the frame it belongs to. The GL pass draws only once both inputs hold the current frame. The Player keeps its live <video> elements. Tests: - remotion/video-decoder-render.verify.mjs: a split-screen GLSL transition must show the Player's frame on both halves of every window frame, for each server decoder. With the old inputs it fails (frame 28 showed source frames [24, 0], not [28, 4]); it passes now. It runs in the macOS frame-sync job. - clipFxExport.offthread.verify.mjs passed 15 consecutive local runs; clipFxExport.verify.mjs, the preview, transition and decoder verifies, tsc -b and lint pass. - A transition whose outgoing handle runs past the source's last frame still renders with both decoders, frozen on that last frame. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	16 天前
scripts	fix(desktop): let the Windows build pass the shader-twin check The desktop workflow's Windows package job failed in prebuild: `node scripts/sync-shader-sources.mjs --check` called all 67 generated .frag.ts twins stale. On the Windows runner, relative() writes each twin's header path with backslashes, and Git for Windows' default core.autocrlf checks every shader and twin out with CRLF. The check compared bytes, so nothing matched the LF, "/"-joined twins committed from macOS. It joined prebuild on 2026-09-17 (ad388154), after the last desktop build, so no Windows installer has built since. The script now generates and compares the LF, "/"-joined form, as the server tool catalog check already does (3c2d33a8). On macOS and Linux it produces the same twins as before (0 of 67 rewritten). Tests: - scripts/shader-sources.verify.mjs rebuilds a CRLF checkout in a temp tree: current twins must pass, and an edited shader must still read as stale. It fails with the old script and passes now. - A real core.autocrlf=true clone fails the check with the old script and passes with the new one. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>	16 天前
server	Merge main and retain font and MCP regression checks	9 天前
shared	refactor: unify model policy, proposal commits, and export jobs Share browser and server request policy, preserve proposal concurrency recovery, and centralize render job validation and structured failures. Validated pretest, 193 main test segments, provider parity, typecheck, lint, and production build.	10 天前
skills	fix(mcp): preserve ownership when reusing active drafts	10 天前
src	fix(editor): serialize caption fonts and preserve backdrop borders	9 天前
.env.example	feat(publish): publish finished renders to social platforms via Upload-Post Adds publish_to_social / track_social_publish so the agent can post a completed render (the /media/uploads/ downloadUrl from track_export) to TikTok, Instagram, YouTube, LinkedIn, Facebook, X, Threads, Pinterest and Bluesky through Upload-Post. - Two steps by contract: without confirm the server only previews (file, profile, connected/missing platforms, title, privacy); confirm:true uploads. - request_id is derived from the file and the publish fields and doubles as the Idempotency-Key: re-sending an approved publish resumes it, a dropped connection never re-uploads. - File-backed multipart via openAsBlob and the shared outbound proxy, as sonilo-media does; YouTube defaults to private. - Settings → Enhanced tools → Social publishing (key + profile), key probe, en/it/ru strings, routing, execution policy (irreversible_external). - server/plugins/upload-post.verify.ts and src/agent/tools/publish-tools.verify.ts run against a local fake API and a mocked fetch; no network in the suite.	15 天前
.gitignore	feat(cli): ship occ as an installable command `npm run build:cli` bundles cli/main.ts into cli-dist/occ.mjs (esbuild, node ESM, node_modules external — the same reasoning as the desktop main build: Remotion, the MCP SDK and ffmpeg-static carry binaries and resolved paths that must stay real files on disk), and package.json declares it as the `occ` bin so `npm link` (or an install) puts the CLI on PATH instead of requiring `npm run occ --`. Also fixes a terminal-hygiene bug the bundle smoke exposed: `occ tools ls \| head` died with an unhandled EPIPE stack trace. stdout now exits quietly when the reader goes away first, like any shell tool. Shared paths touched: package.json gains a script and a bin entry, .gitignore gains cli-dist/, and cli/output.ts adds the EPIPE handler. No app module changes. Verification: the bundled CLI was exercised end to end against a throwaway profile — project new, tools ls, list_templates (235 templates), render --dry-run (h264 / 30 frames / mp4), where — and `occ tools ls \| head` now exits 0; tsc -b, lint (0 warnings), registration and gate coverage pass; cli/cli.verify.ts green.	27 天前
.mcp.json	Initial commit	2 个月前
.nvmrc	Initial commit	2 个月前
CHANGELOG.md	chore(release): prepare v0.2.16	8 天前
FAL.md	feat(providers): add opt-in Fal.ai image and video generation Adds a curated Fal.ai catalog behind FAL_KEY, opt-in and inert until a key is set: image and video model pickers in Settings, per-model constraints in the submit_image / submit_video tool schemas, queue submission that persists the request ID before polling so a resume never pays for a second job, and an endpoint allow-list on the saved checkpoint. Rebased onto main by the maintainer: the key names moved to the split keystore-names module, the video unions and validator keep the OFox provider alongside fal, the Claude Code status argument is preserved in the vendor pane, the tool-schema asset was regenerated, and the Fal catalog note moved to its own component to keep settingsVendorPane.tsx within the 500-line gate. Full CI (lint, npm test, agent-skill contract, build, macOS export frame synchronization) passes on the rebased branch.	23 天前
LICENSE	Initial commit	2 个月前
MACOS-RENDER-TUNING.md	docs: add one-worker comparisons and full-export timing	18 天前
README.md	docs: credit capcut-cli for JianYing draft export	9 天前
README_ZH.md	docs: credit capcut-cli for JianYing draft export	9 天前
dev-with-mcp.sh	feat(mcp): external agent connect UI + Codex model defaults - McpGuide: redesigned dialog with official client logos and one-click 'connect' buttons (Claude Code / Codex / Cursor / Antigravity) - server: POST /api/external-agent/connect-client writes client MCP configs (idempotent, atomic, token validation), with verification script - codex: seed system auth credentials into the isolated CODEX_HOME so the Codex CLI talks to OpenAI without 401 - model-selection: Codex official models expand into the composer picker; persisted preference wins over snapshot default; composer defaults to Codex (MCP backend) when no model was pinned; BytePlus/API models are hidden from the picker while Codex is available - composer: drop the Q&A (ask) mode option; show Codex logo in the corner model button - 404 handling: server run abandon/protocol/stream lifecycle no longer warn on stale runs after server restart - mcp.verify: await editor registration and raise notify timeout to 30s	1 个月前
index.html	Initial commit	2 个月前
package-lock.json	chore(release): prepare v0.2.16	8 天前
package.json	chore(release): prepare v0.2.16	8 天前
tsconfig.app.json	feat(media): add on-device music intelligence	2 个月前
tsconfig.json	Initial commit	2 个月前
tsconfig.node.json	feat(cli): add the occ command line for offline project work New `cli/` gives OpenChatCut a terminal client that works on the local project library without the app, a browser, or an MCP session: - reads use the same Project Store and migration chain as the app; - writes run through the existing offline edit session (server/external-agent/offline-runtime.ts), so they stay atomic, revision-checked, and snapshot a pre-edit version the app can restore; - the tool surface obeys isExternalServerDirectTool — the same whitelist MCP offline sessions use — and browser-backed tools are refused with a reason; - profile resolution mirrors the server (--data-dir, isolated dev profile), so the CLI can target the same library a dev server uses. Commands: project list\|show\|new, timeline show\|items, tools ls\|call, edit --ops, where. `occ where` reports the active library. Shared paths touched: package.json (+2 scripts, one command appended to test:serial) and tsconfig.node.json (cli/** added to the node project). No runtime module under src/, server/, or desktop/ changes, so users who never run `occ` see identical behavior. Verification: cli/cli.verify.ts drives the real entry point over a throwaway library in a child process (11 assertions: empty library, create, discard without --apply leaves the project byte-identical, --apply commits, the commit snapshots a pre-edit version, a batched --ops lands in one commit, a browser-backed tool is refused with exit 1, an unknown flag exits 2) and runs inside npm test. tsc -b, npm run lint (0 warnings), npm run build, verify-registration and verify-gate-coverage all pass; npm test is 180/180 green.	28 天前

OpenChatCut

简体中文 · English

开源 ChatCut 替代 · Agent-native · local-first AI 视频编辑器

让 Codex、Claude Code 和内置 Agent 直接读取、剪辑并导出可继续编辑的真实视频工程。官网：openchatcut.com

产品介绍 · 产品导览 · 快速开始 · Agent / MCP · 社区 · 赞助商 · 更新日志 · Star 趋势 · 参与贡献

Status Local First TypeScript React Remotion Electron MCP

OpenChatCut 编辑器总览：Agent 工作台、素材池、预览窗口与多轨时间线

_{从一句话到真实时间线：Agent、素材、预览、动态图形、转场、特效与多轨音频在同一个工程中协作。}

赞助商

OfoxAI：一个平台，连接文本、图像与视频 AI

OfoxAI 是统一的 AI API 平台，汇集文本、图像和视频模型，支持 Seedance、MiniMax（海螺）、Wan 等视频模型系列。从 AI 应用与智能体开发，到创意构思、图像生成和视频素材制作，通过一个平台选择适合的模型。探索 OfoxAI 模型与 API →

如果 OpenChatCut 对你有帮助，欢迎通过 Ko-fi 或爱发电支持项目持续开发。

OpenChatCut 是什么

OpenChatCut 是 开源 ChatCut 替代方案：把 对话式 Agent 和 专业时间线编辑 放在同一工作区的 AI 视频编辑器。独立开源（AGPL），与商业版 ChatCut 无隶属关系。

OpenChatCut = 本地视频工程 + 多轨时间线 + AI Agent + MCP + 可交付导出。

它不是只生成一段不可修改的视频。每次编辑都会落到真实工程中的轨道、片段、转场、字幕、特效和素材上；你可以继续手动调整，也可以撤销、重做、保存版本或交给另一个 Agent 接着完成。

它适合希望让 AI 真正参与剪辑流程、同时保留专业编辑控制权的创作者和开发者，而不是每次都从一个空白聊天框或不可修改的生成结果重新开始。

官网：https://openchatcut.com
开源 ChatCut 替代说明：https://openchatcut.com/zh/blog/open-source-chatcut-alternative
ChatCut 与 OpenChatCut 对比：https://openchatcut.com/zh/blog/chatcut-vs-openchatcut
🤖 Agent-native：内置 Agent 与外部 MCP Agent 共用同一套编辑工具。
🎞️ 真实时间线：多视频轨、多音频轨、转场、特效、LUT、缩放和关键帧。
📝 文字稿驱动：词级转写、删词剪辑、停顿处理、说话人和字幕联动。
✨ 生成与素材：图片、视频、语音、音乐、音效及在线素材检索。
🧩 MG 与 WebGL：动态图形模板、自定义 shader、视觉特效和转场。
👁️ 视觉几何：浏览器内人像分割与人脸安全区——字幕自动避开说话人、竖屏转换跟随主体、叠加图形自动放入空区。
📦 可交付导出：MP4、音频、字幕、FCPXML 和工程数据。
🖥️ Local-first：工程和素材优先保存在本机，密钥只进入服务端。

社区

加入 OpenChatCut 社区，交流使用心得、功能建议与开发进展：

加入 Discord
使用微信扫描下方二维码加入微信群。

OpenChatCut 微信社区二维码

产品导览

下面均为 OpenChatCut 中的真实工程与编辑状态，而不是静态界面稿。

_{本地工程管理 — 创建、导入、复制、导出并继续编辑多个真实工程。}	_{Agent 驱动的完整剪辑 — 生成音乐、调用工具并把转场、字幕与多轨素材写入时间线。}
_{Motion Graphics 与 Agent — 浏览动态图形模板，也可以让 Agent 生成并组合可继续编辑的 MG 片段。}	_{WebGL 视觉特效 — 像素化、双色调、鱼眼、万花筒、柔化与漏光等效果可直接应用到片段。}
_{镜头运动与缩放 — 推拉、慢推、快速缩放和缓动镜头效果与时间线协同工作。}	_{LUT 与色彩风格 — 使用统一参考画面实时比较相机转换与胶片风格。}

为什么是 OpenChatCut

传统编辑器擅长精细操作，一次性 AI 生成器擅长快速出片。OpenChatCut 把两者连成同一个可持续编辑的工程：

能力	传统时间线编辑器	一次性 AI 视频生成	OpenChatCut
精确到轨道和片段	✅	❌	✅
自然语言修改工程	❌	✅	✅
修改可检查、可撤销	✅	通常不可	✅
文字稿与画面联动	部分支持	❌	✅
Codex / Claude Code 直接操作	❌	❌	✅ MCP
内置 Agent 与外部 Agent 协作	❌	❌	✅ 同一工具面
本地工程与 BYOK	视产品而定	通常云端	✅

核心编辑循环：

描述目标 → Agent 读取工程 → 生成可验证编辑 → 写入时间线
         → 预览 / 调整 / 撤销 → 字幕与混音 → 导出

核心能力

领域	已实现能力
时间线	多轨、移动、裁剪、切分、波纹编辑、吸附、关键帧、标记、撤销与重做
视觉	WebGL 特效、LUT、色度键、缩放、转场、自定义 shader
音频	多音轨、音效、背景音乐、旁白录制、响度、自动闪避、人声隔离
文字稿	转写任务、词级编辑、停顿压缩、查找、说话人和片段视图
字幕	自动字幕、命名样式、翻译、时间线 overlay、SRT 导出
MG	内置动态图形模板、安全沙箱、自定义模板与视频化
AI 生成	图片、视频、语音、音乐和音效任务，支持进度追踪
素材	上传、文件夹、在线图片/视频/音频检索、Firecrawl 视觉素材兜底
导出	MP4、音频、字幕、FCPXML、工程导入导出、导出历史、硬件感知的 H.264 加速和资源感知的导出排队
发布	Agent 通过 Upload-Post 把成片发布到 TikTok、Instagram、YouTube、LinkedIn、Facebook、X、Threads、Pinterest、Bluesky，先预览、确认后才上传
Agent	内置对话 Agent、技能系统、提案式编辑、外部 Streamable HTTP MCP

社区资源库

OpenChatCut 社区资源库用于发现、安装和分享可复用的 MG 动画、音效、转场、特效、缩放和 LUT。

发现与安装

悬停视觉卡片查看完整变化，下载前可直接试听音频资源。
复制资源的安装 URL 到 OpenChatCut 扩展中心，或下载原始资源包。
在编辑器内浏览官网目录，并在本机管理已安装扩展。

贡献资源

打开贡献资源，选择资源分类。
上传资源与该分类要求的预览输入，网站会渲染用于公开展示的预览。
填写作者和许可证信息，提交审核；审核通过后公开上架。

可安装的视觉资源沿用编辑器的 openchatcut-plugin@1 格式与运行时校验。OpenChatCut 官方资源使用 MIT 许可证；社区投稿者在提交时选择许可证，发布卡片会显示作者与许可信息。

典型使用场景

口播与访谈精剪：转写音视频，按文字删除口误、停顿和冗余内容，再自动生成字幕。
多素材快速成片：导入视频、图片和音频，让 Agent 完成粗剪、转场、配乐和节奏调整。
短视频与社交内容：重构画幅，生成标题、字幕、旁白、音乐和视觉包装。
Motion Graphics：使用内置模板或让 Agent 生成可继续编辑的动态图形片段。
开发者自动化：通过 MCP 让 Codex、Claude Code 或其他兼容客户端读取并修改真实工程。

使用流程

创建工程并导入本地素材。
在时间线上手动剪辑，或直接描述想要的结果。
Agent 读取工程上下文并调用编辑工具。
检查提案、预览画面，再应用、调整或撤销。
完成字幕、音频、特效和色彩处理。
导出视频、音频、字幕、FCPXML 或完整工程。

快速开始

桌面安装包

从 GitHub Releases 下载最新的 macOS、Windows 与 Linux 构建。目前提供 Apple Silicon、Intel Mac 的 DMG、Windows x64 安装包，以及 Linux x64 AppImage。

这些仍是早期构建。macOS 安装包尚未签名和公证，首次启动时可能需要在系统设置中手动允许。

从源码运行

需要 Node.js 24.x 和 npm。package.json 会约束支持的 Node.js 范围，.nvmrc 可供 Node 版本管理器直接选择对应主版本。

在 Linux x64 上，npm install 还会从 NuGet 下载 ONNX Runtime 可选的 CUDA 组件（数百 MB）。只需 CPU 推理时，可改用 ONNXRUNTIME_NODE_INSTALL=skip npm install。

git clone https://github.com/0xsline/OpenChatCut.git
cd OpenChatCut
npm install
cp .env.example .env.local
npm run dev

打开：

http://localhost:5199

编辑器需要浏览器的安全上下文：请在运行 OpenChatCut 的电脑上通过 http://localhost 或 http://127.0.0.1 访问，或通过 HTTPS 提供服务。从其他设备以普通 HTTP 访问（局域网 IP 或反向代理）时，浏览器会禁用 Web Crypto、WebCodecs 和剪贴板，工程列表仍可打开，但编辑器会显示这一要求而不会进入。

.env.local 中只需填写你实际使用的模型或素材服务。没有配置的第三方能力会明确提示缺少对应 Key，不影响本地时间线编辑、内置素材和已配置的其他能力。

开发启动默认按 Git checkout/worktree 隔离。npm run dev 与 npm run desktop:dev 会把当前工作区的工程、导入素材、生成任务、凭据、设置和本机授权状态写入 ~/.openchatcut/dev-profiles/ 下的独立配置；只有明确需要旧版共享开发存储时，才使用 npm run dev:shared。

内置 Agent 登录方式

API Key：打开设置 → Agent 模型，选择厂商并保存 API Key 与模型；密钥始终留在服务端。
ChatGPT 订阅：先安装官方 Codex CLI 0.146.0 或更高版本，再进入设置 → Agent 模型 → OpenAI · Codex。可使用浏览器或设备代码登录、读取账号可用模型，并按模型选择推理强度（或保留模型默认值），再在聊天区的模型选择器中切换到 Codex。OpenChatCut 使用独立的 Codex 配置目录；凭据存储、令牌续期与退出均由官方 CLI 负责，OAuth 令牌不会暴露给浏览器。
Claude 订阅：OpenChatCut 不接收 Claude OAuth 凭据；请通过下文的本机 MCP 连接使用 Claude Code。内置 Agent 仍可通过 Anthropic API Key 使用 Claude。

内置 Agent 的模型循环始终在本机服务端运行。聊天、草稿和提案可跨页面刷新和本地服务重启保留。时间线修改仍通过活动编辑器中经过校验且可撤销的命令完成。

Agent 本地路径访问（高级）

桌面端 Agent 默认可以访问操作系统允许读取的任意本地目录，包括外接素材盘。browse_local_media 可浏览文件夹，按文件名、相对路径和媒体类型搜索，并分页返回结果，不会自动导入。Agent 选好素材后，可用 import_assets 批量导入最多 100 个路径，也可用 import_asset 导入单个路径、import_folder 导入整个文件夹。导入复用媒体探测和源文件引用流程，保留原文件，并跳过媒体池及同一批次中的重复内容。TXT、Markdown、DOCX、PDF 等文稿请作为对话附件添加。这些工具仅在桌面应用中可用。

需要限制目录范围时，可在 .env.local 中填写英文逗号分隔的绝对路径，例如 AGENT_IMPORT_ROOTS=/Volumes/Media,D:\Projects；留空表示默认放行。手动设置的范围同时适用于浏览和导入。源码运行会读取仓库根目录的文件；桌面安装包会从 Electron 用户数据目录读取：macOS 为 ~/Library/Application Support/OpenChatCut/，Windows 为 %APPDATA%\OpenChatCut\，Linux 为 $XDG_CONFIG_HOME/OpenChatCut/（通常是 ~/.config/OpenChatCut/）。修改后请重启应用。

本地 H.264 导出会在 macOS 上优先使用 VideoToolbox，在兼容的 Windows 设备上优先使用 NVENC，失败时自动回退软件编码。可用 OPENCHATCUT_RENDER_CONCURRENCY 和 OPENCHATCUT_MAX_ACTIVE_EXPORTS 调整渲染并发及重型导出上限，用 OPENCHATCUT_DISABLE_HARDWARE_ENCODING 关闭硬件编码，或用 OPENCHATCUT_H264_ENCODER 覆盖 FFmpeg 侧的编码器选择；详见 .env.example。

桌面端开发

npm run desktop:dev

桌面端使用 Electron 壳层和同一套内嵌服务，Web 开发版与桌面版共享工程、Agent、生成和导出逻辑。

项目状态

OpenChatCut 目前处于积极开发阶段，编辑器、工程格式和 Agent 工具仍会持续迭代。预构建的 macOS、Windows 与 Linux 安装包已发布到 GitHub Releases；开发和排障时，从源码运行仍是最透明的方式。

基础时间线、本地工程、内置素材和手动编辑不依赖云服务。AI 模型、在线素材、生成、转写等联网能力只在你配置对应服务后启用。

在 Codex / Claude Code 中使用

安装单入口 OpenChatCut Agent Skill：

npx skills add 0xsline/OpenChatCut

然后对 Agent 说“设置 OpenChatCut”。安装的路由 Skill 会注册本地 MCP 连接，并按需加载编辑器内置的 26 个专项 Skill，避免技能列表出现大量入口。

自定义技能存放在用户可见目录，与 ~/.codex/skills / ~/.claude/skills 布局一致：

~/.openchatcut/skills/<slug>/SKILL.md     （Windows: %USERPROFILE%\.openchatcut\skills\...）

让 Agent 执行 manage_skill create（或使用内置的“技能创作器”工作流），它会把 SKILL.md 写到该目录——可直接编辑、复制分享。手动放入 SKILL.md 到该目录即可被 Agent 使用；在聊天的 / 命令或创作模式选择器中选中某个工作流，下一条消息就会按它执行。

OpenChatCut 暴露 Streamable HTTP MCP：

http://localhost:5199/api/external-mcp/mcp

仓库根目录的 .mcp.json 已包含本地连接。使用时间线工具前，先运行 OpenChatCut 并打开目标工程；工程列表、创建和定位工具不要求编辑器保持打开。

Codex App/CLI 与 Claude Code 使用同一套会话流程：

调用 begin_edit_session，保存返回的 editSessionId，并将 approvalMode 设为 manual（默认）或 auto。
后续每个工程读取/编辑工具都传入该 id；所有修改只进入隔离草稿。
草稿完成后调用 review_edit_session。
manual 模式下，在已打开的 OpenChatCut 工程内审阅、预览、勾选并应用或拒绝提案；auto 模式下，review_edit_session 会立即应用完整草稿。客户端可轮询 get_edit_session 获取 applied、rejected 或 discarded 状态。

Codex 或 Claude 内的授权决定客户端能否调用工具。只有 manual 会话需要 OpenChatCut 工程内审批；auto 会话会明确跳过该审批。两种模式应用的操作都会原子提交为一个撤销节点。如果 auto 会话已过期，它会直接返回错误而不会降级为人工审批；请丢弃后重新创建会话。会话只暴露可安全进入草稿的工程读取/编辑工具。生成、导出、删除工程及其他会立即产生副作用的工具不在会话中开放，因为拒绝提案时无法回滚这些副作用。

Codex

在 Codex 配置中加入：

[mcp_servers.openchatcut]
url = "http://localhost:5199/api/external-mcp/mcp"

Claude Code

claude mcp add --transport http openchatcut \
  http://localhost:5199/api/external-mcp/mcp

然后可以直接对 Agent 描述编辑任务：

启动一个 OpenChatCut 编辑会话，读取草稿，在第二条音频轨的 8 秒处添加划盘音效，
并给相邻视频添加故障转场。提交草稿供审阅，等待我在 OpenChatCut 内应用后，
再报告修改已经生效。

外部 Agent 调用的仍是编辑器内部同一套工具和 EditorCore 命令，不存在两套互相漂移的工程格式；外部草稿准备期间不会修改正式时间线。

Qoder

Qoder 同样支持一键接入：指南里的「连接」按钮会把端点和 Bearer 令牌写进 Qoder 自己的设置文件，已有的其它设置和 MCP 服务保持不变。

~/.qoder/settings.json        （国际版）
~/.qoder-cn/settings.json     （国内版；已安装时一并写入）

{
  "mcpServers": {
    "openchatcut": {
      "type": "http",
      "url": "http://localhost:5199/api/external-mcp/mcp",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}

写入后重启 Qoder 生效。

千问办公

千问办公的自定义 MCP 保存在应用内部的连接器里，没有可供写入的配置文件，因此这一步无法一键完成：在指南中点「千问办公」卡片的「复制配置」，再到千问办公的连接器 → 自定义 MCP → 添加中粘贴并保存：

{
  "mcpServers": {
    "openchatcut": {
      "type": "streamable-http",
      "url": "http://localhost:5199/api/external-mcp/mcp",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}

MCP 访问保护

自行暴露 MCP 入口时可配置：

OPENCHATCUT_MCP_TOKEN=your-token
OPENCHATCUT_EDITOR_URL=https://your-editor.example.com

客户端使用 Authorization: Bearer <token>。当前桥接面按单机单用户设计，不作为多租户服务。

架构

OpenChatCut 运行时架构：Agent、MCP、EditorCore、本地存储、预览与渲染导出

_{同一套 Agent 工具和 EditorCore 命令连接内置 Agent、外部 MCP、真实时间线、本地数据与交付导出。}

层	技术
前端	React 19、TypeScript 6、Vite 8
编辑核心	不可变时间线状态、命令层、提案式应用
Agent	Vercel AI SDK 7（Anthropic、OpenAI、Gemini、Kimi、Qwen、GLM、DeepSeek、MiniMax、小米 MiMo、Mistral、xAI Grok（API Key 或 SuperGrok/X Premium+ 订阅登录）、OpenRouter、OrcaRouter、OFox、Requesty、Cheaper Inference 与兼容接口）、Agent Skills、MCP SDK
预览与视觉	Remotion Player、WebGL / GLSL
服务端	Vite / Electron 双宿主插件、服务端密钥仓
持久化	`~/.openchatcut` 下的本机共享工程库、IndexedDB 缓存、可配置本地素材目录、可选 Cloudflare R2
桌面端	Electron 43
导出	Remotion、FFmpeg、FCPXML、SRT

目录速览

目录	职责
`src/editor/`	时间线状态与命令，保持 UI 和 LLM 无关
`src/agent/`	Agent 装配、工具、技能、进度和设置
`src/library/`	MG、音效、转场、特效、LUT 等资源库 UI
`src/transcript/`	转写、词级编辑和文字稿 UI
`src/captions/`	字幕模型、样式、控制和预览层
`src/gl/`	WebGL 特效、转场与 shader runtime
`src/generate/`	图片、视频、语音、音乐和音效生成客户端
`src/persist/`	工程、聊天、版本和媒体持久化
`server/plugins/`	生成、转写、素材、导出和存储服务
`desktop/`	Electron 主进程与内嵌服务
`remotion/`	无头渲染和导出管线

数据与隐私

工程、聊天记录和版本数据保存在 ~/.openchatcut 下的本机共享工程库中；IndexedDB 用于浏览器端缓存和旧数据迁移。
用户媒体保存在本地素材目录，可自行备份和迁移。
AI 请求是否离开本机，取决于你配置的模型、生成或素材服务。
未配置的云端能力不会影响本地时间线和已有素材编辑。
对外开放 MCP 时，应配置 Bearer Token，并限制编辑器入口的网络范围。

安全模型

密钥只进入服务端配置；浏览器端禁止使用 VITE_ 暴露供应商密钥。
LLM 输出、插件包、模板代码和用户输入都在信任边界处校验。
MG 与 shader 代码进入受限沙箱，恶意模板由专门检查脚本拦截。
Agent 只经 EditorCore 命令改工程，编辑可追踪、可撤销。
MCP 默认绑定本机；公网入口支持 Bearer Token。
本地素材目录和 R2 凭据由服务端管理，不写入工程 JSON。

Fal.ai 图像与视频生成

Fal.ai 是可选的生成服务，提供明确的图像与视频模型目录。在 设置 → AI 生成 → 生图或生视频 → Fal.ai 中配置。支持的模型、服务端密钥配置、免费验证和扩展方式见 Fal.ai 使用指南。

开发与验证

# 类型检查与生产构建
npm run build

# 核心回归检查
npm test

# 静态检查
npm run lint

修改 Agent、时间线、预览或导出后，至少运行：

npx tsc -b --force
npm test
npm run build

技术基础

OpenChatCut 基于以下核心项目与规范构建：

项目 / 规范	在 OpenChatCut 中的作用
ChatCut-Inc/agent-plugin	Agent Skills 的改造基础。OpenChatCut 基于该插件的技能结构与工作流，针对本地编辑器、存储、MCP 和工具架构进行了适配。详见 Agent Skills 来源说明。
Remotion	React 视频预览、合成与服务端渲染的核心基础。
Model Context Protocol	Codex、Claude Code 等外部 Agent 访问工程与时间线工具的协议基础。
Vercel AI SDK	内置 Agent 的多厂商模型流式响应与工具调用基础。
tt-a1i/archify	README 运行时架构图的定义、校验与 SVG 生成工具。

剪映 / CapCut 草稿导出由 capcut-cli 提供支持。

这里列出的是项目的主要技术基础，不替代各依赖、字体和内置二进制随附的许可证。完整 JavaScript 依赖版本见 package-lock.json，字体授权见 assets/fonts/LICENSES.md。

更新日志

重要变更见中英双语的 CHANGELOG.md，所有已发布安装包与源码包见 GitHub Releases。

Star 趋势

许可证

OpenChatCut 采用 GNU Affero General Public License v3.0 或更高版本。第三方组件与资产仍分别受其自身许可证约束。

贡献

从 main 创建分支。
非平凡逻辑附带一个可运行检查。
提交前运行 npm test、npm run lint 和 npm run build。
发起 Pull Request，并附上涉及 UI 或视频行为的截图/验收证据。

问题与功能建议请使用 GitHub Issues。

项目介绍