ReaCut · 映刻
借助 REA 研究剪映 / CapCut，独立重实现的开源视频编辑器。
macOS 优先；仅开展授权范围内的研究，不复制剪映专有代码或素材。
完整视频编辑器的实现工作量很大，项目仍处于早期阶段。
欢迎贡献者一起完善功能、交互、跨平台支持、测试和文档。 参与贡献 →
简体中文 · English
快速开始 · 使用指南 · 本周功能计划 · 更新记录 · 参与贡献
ReaCut 将素材管理、多轨剪辑、字幕和视频导出放在一个熟悉的桌面工作区中。核心编辑流程在本地运行，无需账号或云服务。
项目使用 REA 辅助研究剪映的界面行为和本地项目格式，再以 Electron、React、TypeScript 和 FFmpeg 独立实现编辑器。REA 是开发研究工具，运行 ReaCut 不需要安装 REA、Ghidra 或剪映。
当前源码：v0.5.1，早期开发中。 包含插件按需启动修复及未发布的时间线编辑升级；此版本安装包尚未发布。macOS Apple Silicon 已验证；Windows / Linux 已提供构建配置，尚待实机验证。已发布的安装包见 v0.5.0 预览版 Release，也可按下方步骤从源码运行。下一阶段计划见 本周功能计划。
核心功能
| 能力 | 可以做什么 |
|---|---|
| 素材与源预览 | 导入视频、音频和图片，查看缩略图与波形；用 I/O 标记入出点，将选段加入时间线。 |
| 多轨剪辑 | 插入 / 覆盖 / 叠加入轨，画声关联移动和裁剪；拖拽、分割、复制、多选、吸附、锁轨及撤销重做。见 操作说明。 |
| 画面与声音 | 变换、裁剪、基础调色、色度抠像、矩形 / 椭圆蒙版、关键帧、音量、淡入淡出和常规变速。 |
| 文字与字幕 | SRT / 基础 WebVTT 导入、逐句编辑、批量替换、时间偏移、统一样式和 SRT 导出。 |
| 本地项目 | .reacut 保存、自动恢复、素材重新链接；收集项目素材为可搬移的文件夹。 |
| 视频导出 | 导出整条时间线、选中区间或自定义区间，支持 H.264 / AAC 编码的 MP4 与 MOV。 |
| 文字与效果库 | 16 款可编辑文字模板、16 款调色 / 动效预设、8 款转场，支持动态预览与一次撤销。 |
| 离线素材 | 内置 64 款原创贴纸、背景、标题底板与合成音效，以及 Noto Sans SC 中文字体。 |
| Codex 插件 | 在 Codex 右侧操作完整编辑器；读取项目、导入素材、批量编辑与撤销。 |
| 可选剪辑助手 | 连接已安装并登录的 Codex CLI / Claude Code，审阅编辑提案后应用，支持一次撤销。 |
完整支持范围与限制见 功能矩阵。
快速开始
方式一：独立 DMG 桌面版
下载 ReaCut 0.5.0 DMG（macOS Apple Silicon），打开后将应用拖入“应用程序”，直接启动即可剪辑。安装包自带 FFmpeg / FFprobe，不需要另外安装。当前为预览版，采用 ad-hoc 签名，尚未完成 Apple 公证。
方式二：作为 Codex 插件在右侧打开
先安装 ReaCut 0.5.0+ 和 Codex 桌面端，确保终端有 codex CLI 与 Python 3。下载 Codex 插件包，在解压目录或仓库目录运行：
sh scripts/install-plugin.sh
重连或新开 Codex 聊天，输入 “用 ReaCut 在右侧打开视频编辑器”。可直接在侧栏点击、拖动、输入、保存和导出，也可让 Codex 根据当前项目进行可撤销的批量剪辑。
插件复用本机编辑器；实时画面约 6 fps，文件选择使用系统对话框。应用不在“应用程序”目录时使用 --app /absolute/path/ReaCut.app。完整安装、操作方式与限制见 Codex 插件说明。
从源码运行
将仓库克隆或下载到本机后，在项目目录执行。需要：
- Node.js 26，或 Node.js 24.11+ 的 24.x 版本，以及 npm。
- FFmpeg 与 FFprobe；FFmpeg 需包含
libx264和 AAC 编码支持。
npm ci npm run dev
这会启动 Electron 桌面编辑器和本地 Vite 开发服务。媒体工具可放在 PATH 中，也可在应用设置中指定路径；配置方式见 媒体工具说明。
想先试用一个完整工程：
npm run demo
然后在 ReaCut 中打开 .demo/demo.reacut。它包含程序生成的原创画面、音乐、字幕与关键帧，详见 演示工程。
构建 macOS 安装包
在原生 macOS 主机上安装 Xcode 命令行工具，然后执行：
npm run dist:mac:installer
DMG 和 ZIP 输出到 release/。首次构建会下载并编译内置 FFmpeg / FFprobe；安装包用户无需再安装媒体工具。打开 DMG 后，将 ReaCut 拖入“应用程序”。
当前安装包采用本地 ad-hoc 签名，尚未完成 Apple 公证。平台验证与构建细节见 验证记录 和 媒体工具说明。
项目与数据
- 本地编辑：媒体处理、预览、项目保存和导出均在本机完成；普通项目引用本地素材，跨机器使用时可收集项目素材或重新链接。
- Codex 插件：媒体处理在本机运行；Codex 可接收工具读取的项目摘要、文字和显式截图。侧栏实时帧仅供界面使用。
- 可选助手：仅在用户发送消息时，向所选 CLI 服务发送文字和有限时间线摘要，不附带媒体文件。详情见 助手说明。
- 实验性剪映导入：支持已验证格式中的基础片段转换；复杂文字样式、特效与关键帧可能丢失，不支持写回剪映格式。版本范围见 互通说明。
云同步、SaaS、直接 API AI、自动语音字幕与 AI 人像抠像尚未实现。ReaCut 是独立项目，与剪映 / CapCut 无隶属关系。
开发
npm run check # 类型检查、单元测试与生产构建 npm run test:desktop # 构建并运行桌面基础工作流测试 npm run check:desktop # 完整桌面回归
更多专项测试、运行条件和已执行的验收结果见 验证记录。
src/components/ 编辑器界面
src/editor/ 状态管理、撤销重做与预览
src/core/ 项目模型、时间线、字幕与画面处理
electron/ 本地文件桥接、媒体处理与导出
scripts/ 素材、图标与安装包构建工具
tests/ 核心逻辑、媒体与桌面工作流测试
docs/ 用户文档、架构与研究记录
参与贡献
欢迎提交问题反馈、改进文档或发起 Pull Request。当前尤其欢迎 Windows / Linux 实机验证、大型项目性能优化，以及剪辑交互和无障碍改进。
- 报告问题时附上系统、ReaCut 版本、复现步骤与预期行为；媒体问题尽量提供可公开的最小样例。
- 较大的功能调整先通过 Issue 讨论范围，再提交聚焦的改动。
- 代码改动运行
npm run check；涉及桌面交互或导出时，补充对应的工作流验证，并在 PR 中说明结果。
请使用自有或可分发的素材，不提交私人项目、缓存、凭据或 .research/ 原始数据。
文档
| 面向 | 文档 |
|---|---|
| 使用与试用 | 使用指南 · 演示工程 · 剪辑助手 |
| 能力与进展 | 功能矩阵 · 更新记录 · 验证记录 |
| 开发与构建 | 架构 · 媒体工具 · 离线素材 |
| REA 研究与互通 | REA 研究记录 · 界面布局对照 · 草稿互通 |
许可证与致谢
ReaCut 自行编写的源码采用 MIT License。第三方组件保留各自许可：内置 FFmpeg / x264 使用 GPL，Noto Sans SC 使用 SIL OFL 1.1；对应声明、许可与媒体工具源码随包提供，见 第三方声明。
感谢 REA 及 Electron、React、FFmpeg、Zustand、Lucide、Noto 等开源项目。