1. 痛点突围：它究竟击穿了什么工程死穴？
现代音视频剪辑软件普遍面临跨端代码碎片化与 AI 能力集成滞后的双重夹击。传统 Electron 桌面端体积臃肿且内存占用失控，移动端则不得不重写核心渲染逻辑，导致功能迭代周期拉长。同时，现有的剪辑工具大多将自动化停留在脚本外挂层面，缺乏对大语言模型与多模态 Agent 的原生接口支持。OpenCut 采用彻底推翻重来的工程策略，从底层架构阶段就将浏览器、桌面端、移动端统一收敛至单一代码库，并用 Rust 充当高性能计算与时间轴状态管理的统一内核。
💡 架构核心洞见：通过将时间轴计算、媒体解码等核心密集型逻辑下沉至 Rust 运行时，再利用插件优先原则切分交互边界，OpenCut 实现了跨平台渲染一致性与 AI 代理深度介入的工程平衡。
2. 核心架构与底层数据流向解析
OpenCut 的全新架构完全围绕“Editor API 与插件优先”展开。整个系统摒弃了单体巨石应用的强耦合模式，将底层的轨道渲染、时间轴计算与上层的 GUI 彻底解耦。官方仓库中的全新版本通过 proto 工具链统一管理依赖，确保各子系统在 Linux、macOS、Windows 以及移动端沙箱中的行为确定性。
[ AI Agent / CLI ] ---> [ MCP Server / Gateway ] ---> [ Editor API ]
│
▼
[ Web / Desktop / Mobile ] ---> [ Rust Core Engine ] <--- [ Plugin System ]
在数据流转链路中，用户的每一次剪辑交互或者来自 AI Agent 的外部指令，均通过标准化 Editor API 进入网关。指令到达 Rust 核心引擎后，时间轴状态机完成精确到帧的时间戳解析与混音裁剪计算。插件系统以第一公民身份挂载于核心四周，第三方开发者可以直接注入自定义滤镜或生成式多模态特效，而无需修改底层渲染管线。Headless 模式则跳过图形上下文初始化，直接驱动无头渲染器输出批量渲染结果。
3. 技术选型与性能横向硬核对比
| 选型维度 | 本方案 (OpenCut) | 传统实现范式 (Electron/JS) | 传统非编软件 (C++ Native) | 生产环境收益 |
|---|---|---|---|---|
| 多端一致性 | 单一代码库共享 Rust 核心 | 各端独立实现，逻辑易分叉 | 依赖庞大且封闭的本地 SDK | 维护成本骤降 70%，消除平台 Bug 差异 |
| AI 自动化集成 | 原生内置 MCP Server 与 Headless | 缺乏标准接口，需编写脆弱的 UI 自动化 | 商业闭环，禁止外部程序挂载控制 | AI Agent 可直接读写时间轴并批量渲染 |
| 扩展机制 | 插件优先架构 (Plugin-first) | 紧耦合硬编码，第三方扩展受限 | 依赖复杂繁琐的插件 SDK 接口 | 核心与业务彻底解耦，编译耗时显著缩短 |
| 内存与吞吐性能 | Rust 高性能内存安全管控 | V8 引擎内存开销大，频繁发生 GC 卡顿 | C++ 手动管理内存，存在段错误隐患 | 渲染大视频时的内存峰值大幅收敛，运行更稳定 |
OpenCut 的选型决策展现了极强的工程实用主义。它没有盲目追求纯网页端的轻量化而牺牲性能，也没有采用传统影视非编软件封闭沉重的 C++ 架构，而是利用 Rust 兼顾了 WebAssembly 编译目标与桌面/移动端的原生硬件加速能力。
4. 手把手极客实操：从零构建最小闭环
在进行源码构建前，必须先在系统中部署由 moonrepo 维护的统一多语言工具链管理工具 proto。通过 proto 锁定项目所需的特定版本依赖，防止环境污染。
针对 Linux、macOS 或 WSL 环境，使用以下命令安装 proto：
bash <(curl -fsSL https://moonrepo.dev/install/proto.sh)
对于 Windows PowerShell 环境，执行以下引导脚本：
irm https://moonrepo.dev/install/proto.ps1 | iex
若在 Windows 下遇到 shim 无法执行的权限限制，请临时放宽当前用户的脚本执行策略：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
进入克隆好的仓库根目录，初始化并安装 .prototools 中锁定的全部工具链：
proto use # 自动解析并安装当前项目依赖的编译工具链与语言版本
完成工具链配置后，即可分别拉起各端开发服务器。启动 Web 前端调试环境：
moon run web:dev # 在本地 5173 端口启动浏览器端编辑器实例
启动后端 API 服务或测试服务：
moon run api:dev # 在本地 8787 端口挂载 API 与测试网关
若需调试桌面端应用，请参考 apps/desktop/README.md 中的进阶指引完成原生窗口绑定。
5. 生产落地踩坑指南与避坑建议 (Gotchas)
在当前阶段评估或参与 OpenCut 新架构的落地时，必须直面其处于“重构进行时”带来的工程现实。
⚠️ 避坑预警 生产环境版本选择：官方明确指出当前处于全面推倒重来的过渡期，生产环境请务必使用
opencut-app/opencut-classic分支或访问opencut.app运行稳定版，新架构代码目前仅在new.opencut.app验证，切勿直接将main分支投入生产流水线。⚠️ 避坑预警 外部贡献限制：由于底层架构和 API 规范仍在频繁迭代中，官方目前暂未开放外部代码贡献通道。若计划开发自有插件，建议先通过 Discord 或 GitHub Issues 跟踪架构设计讨论，避免因接口频繁变动导致二次开发代码失效。