OpenCut 开源视频编辑器贡献指南：2 小时合入你的第一个 PR-平芜编程栈

OpenCut 开源视频编辑器贡献指南：2 小时合入你的第一个 PR

【免费下载链接】OpenCutThe open-source CapCut alternative项目地址: https://gitcode.com/GitHub_Trending/ap/OpenCut

OpenCut 是一个免费的开源视频编辑器，定位是 CapCut 的开源替代品，目前正在从 Rust 核心出发重写 Web、桌面和移动端。这篇指南按参与角色告诉你：哪里能下手、第一次贡献怎么走最短路径、你的 PR 会被怎么验收，看完就能动手，不用猜。

找到你的参与位置：会写代码和不写代码的两条路

先说清楚现状，免得你抱着成熟大项目的预期进场：OpenCut 处于重写阶段。Web 编辑器是 React + TanStack Start 的脚手架（apps/web/src/routes/ 里还是占位页面），API 是跑在 Cloudflare Workers 上的 Elysia 服务，桌面壳是用 GPUI 写的 Rust 程序（apps/desktop/README.md 里标注了"目前只是个能打开的窗口"）。这个阶段的规律是：小而具体的改动能合入，大而全的功能做快了反而会被打回。

会写代码的人：三个真实可动的模块

Web 编辑器页面：apps/web/src/routes/ 下editor.tsx现在只有一句 "Coming soon"。给它补一个最小可用的编辑器布局（预览区 + 时间线占位），是项目当前真实需要的事，不是刷存在感。路由文件很小，改完moon run web:dev起本地服务立刻能看到效果。
UI 组件层：apps/web/src/components/ui/ 已有一套 shadcn 风格的组件（dialog、popover、resizable、tabs 等）。补一个缺失状态的组件、修正某个组件的暗色模式细节、加一个交互测试（测试命令是bun run test，跑在 Vitest 上），都是边界清晰的小改动。
API 端点：apps/api/src/index.ts 目前只有/health和/echo两个端点。照现有写法加一个带 zod 校验的端点，改动控制在单文件内，reviewer 看得快。

不写代码也能上手：文档、复现与体验建议

文档修正：README.md、apps/desktop/README.md 和 changelog/ 里找错别字、命令写错的地方、过时描述。桌面版 README 列了 Linux 依赖包清单，逐条核对一遍就有活干——这类 PR 是最容易先合入的。
测试反馈：本地把编辑器跑起来，把 issue 列表里的问题复现一遍，补上操作系统、浏览器版本、完整复现步骤和截图。维护者排查一个 bug 的时间成本很高，一份干净的复现报告比半拉代码更值钱。
UI 与交互建议：对照 CapCut 的使用习惯，在 issue 里提出具体的交互请求——时间线操作手感、快捷键布局、导出选项粒度。写得越具体（"在哪、现在怎样、应该怎样"），越容易被排进计划。

第一次贡献最短路径：克隆、改一处、提 PR

先给一句实话：README.md 明确写着架构还在设计、团队还没准备好接收大规模外部 PR。所以下面这条路径既是练手也是实际路线——文档和明确的小问题最可能合入；代码类改动先在 issue 里确认，再动手。

克隆仓库：

git clone https://gitcode.com/GitHub_Trending/ap/OpenCut cd OpenCut

装工具链。项目用 proto 锁定全仓库版本（.prototools 里钉死了 moon 2.3.3 / bun 1.3.11 / rust 1.97.0），按 README 的说明装好 proto 后执行：

proto use

本地起 Web 编辑器，确认环境没问题：

moon run web:dev

浏览器打开 localhost:5173 能看到页面即可。

挑一处最小的改动（比如 README 里的一个拼写错误），提交并推送：

git checkout -b fix/typo-in-readme git commit -am "docs: fix typo in README" git push -u origin fix/typo-in-readme

然后在仓库网页界面创建 Pull Request。到这里，"克隆 → 改一处 → 提 PR"的完整闭环已经走完，剩下的交给验收流程。

你的 PR 会被怎样验收：五条 reviewer 检查清单

一个 PR 只干一件事。重写期的 diff 越小越好审，混了"顺手重构"的 PR 大概率被要求拆掉再提。
两条语言链路都能构建。TypeScript 侧跑moon run web:build，Rust 侧跑moon run desktop:check（任务都定义在各应用的 moon.yml 里，CI 也按这套跑）。
遵守项目既有约定。版本号以.prototools为准，任务体系走 moon，不擅自引入新依赖、新构建工具；web 端类型检查配置在 apps/web/tsconfig.json。
PR 描述能独立验收。写清楚：对应哪个 issue、改了什么、为什么、reviewer 怎么验证（命令或截图）。描述读完能直接 merge，才合格。
别抢跑架构级决策。README 的 Status 里列了 Editor API、插件系统、MCP server、Headless 渲染这些在途设计——围绕它们抢先实现的"大功能"，方向没定就写，基本会被整体打回。