参与OpenChatCut开发Verify验证测试体系与贡献规范开发者完整指南【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCut参与 OpenChatCut 开发核心是理解它的 Verify 验证测试体系。OpenChatCut 是一款开源、本地优先的对话式 AI 视频编辑器拥有专业多轨时间线、Agent Skills 与 MCP 集成。它没有采用 Jest/Vitest 等传统测试框架而是自研了一套以文件为单元的 verify 测试体系——仓库中有 600 多个*.verify.ts文件每一个都是一个可直接运行的小程序。本文带你完整掌握这套体系与贡献规范。OpenChatCut 是什么OpenChatCut 的定位是开源版 ChatCut你用自然语言聊天AI Agent 直接在你的多轨时间线上剪辑视频。渲染基于 Remotion桌面端基于 Electron。对贡献者而言它最大的特点是——质量门禁全靠 verify 文件从吸附算法到导出管线每一处核心逻辑旁都躺着一个同名 verify 文件。先 clone 仓库并装好环境git clone https://gitcode.com/gh_mirrors/op/OpenChatCut cd OpenChatCut npm ci⚠️ 注意 package.json 要求Node 2424 25版本不对大部分命令都会跑不起来。Verify 体系的三层结构理解 package.json 中的脚本链就理解了整个测试体系层级命令作用日常增量npm run verify:affected只跑与 git 改动文件相关的 verify秒级反馈完整门禁npm test顺序执行 pretest → 全量 test:serial → posttestCI 发布门禁GitHub ActionsPR 与 v* tag 上运行 lint test build1️⃣ 增量验证循环每日开发主力scripts/run-affected-verifies.mjs 会读取 git 改动按精确同名优先、就近目录兜底的策略选出相关 verify 并行执行。三个关键设计值得学习无法确定覆盖范围的改动如 package.json、config/、shared/ 等共享层会直接拒绝增量运行强制走完整门禁每个 verify 的启动命令不是猜测的npx tsx而是从 package.json 脚本中读回来的规范命令避免漂移纯文档改动README、CHANGELOG 等会直接跳过提示无受影响 verify。2️⃣ 全量门禁npm testtest:serial是一条用串起来的长命令链package.json而 scripts/run-tests.mjs 会把它拆分成独立子进程并行执行——每个 verify 使用独立的 HOME/临时目录进程间零共享状态。默认并发为 4内存充足的机器可用TEST_CONCURRENCY8 npm test提速。此外还有分工明确的分组脚本如 package.json 的pretest30 个分组 verify、verify:editor、verify:captions、verify:mcp等方便按模块单独排查。3️⃣ 特殊执行器 scripts/run-check.mjs个别 verify 的 import 链包含 Vite 专属的?raw/.fragGLSL 着色器导入裸 tsx 解析不了。这类文件用node scripts/run-check.mjs check 文件执行它用 esbuild 把本地源文件打成单文件 ESM 后直接运行而依赖包仍由 node 自行解析——这个取舍在 源码注释 里写得很清楚。如何为改动编写 verify 文件以 src/editor/snap.verify.ts 为例一个标准 verify 文件长这样与源码同目录、同基名后缀为.verify.tsReact 组件为.verify.tsx直接 import 被测模块用node:assert/strict断言注释写清验证什么规则、为什么顶部注明运行方式npx tsx src/editor/snap.verify.ts。编写完成后必须做两件事把文件按名字注册到 package.json 的test:serial链或对应verify:*分组中确认文件已被 git 跟踪.gitignore会排除部分目录未跟踪的文件在 CI 上会 MODULE_NOT_FOUND。三道守护守护的自动检查这是本体系最精彩的部分——测试系统本身也被测试。注册完整性scripts/verify-registration.verify.mjs 断言每个被 git 跟踪的 verify 文件都注册在 npm 脚本里。历史上曾有 55 个 verify 文件写了但从未运行其中包括数据丢失 bug 的回归测试。若某文件确实无法无人值守运行需要真实凭据、硬件或人工必须加入EXCLUDED并写明理由。门禁覆盖率scripts/verify-gate-coverage.verify.mjs 反向检查磁盘上的每个 verify 文件都出现在npm test展开后的命令链中且没有白名单——真正的例外应该被删除或修复而不是被豁免。它还顺带守护 CI 工作流断言 ci.yml 在 PR 上触发、macOS 渲染门禁不可选。版本表单同步scripts/issue-template-version.verify.mjs 把 bug 报告表单中的版本下拉框与 package.json 的 version 绑定防止发版时忘记更新表单导致 triage 信号失真。贡献规范速查清单在提 PR 之前对照这份清单过一遍✅ 每个源码文件 ≤500 行——由 verify-gate-coverage 强制检查超标就按职责拆分✅ 新逻辑必须附 verify 文件并注册进 package.json 脚本链✅ 本地跑通npm run verify:affected提交前跑npm run lint npm test npm run build✅ 文案改动跑npm run verify:i18n含 scripts/check-i18n.mjs 多语言覆盖检查✅ 发版时同步更新 issue 表单的版本下拉框否则issue-template-version.verify会挂✅ PR 会自动触发 CIlint、verify 全量、生产构建构建失败的 PR 会被门禁拦截。结语OpenChatCut 的 Verify 体系哲学很朴素没被运行的测试不是测试而是同意现状的文件。增量验证秒级反馈日常开发全量门禁守护发布质量再用一组测试的测试防止体系本身腐化。如果你正在寻找一个有成熟质量文化的开源 AI 视频编辑器练手从给它写第一个 verify 文件开始就是最好的切入点。【免费下载链接】OpenChatCutOpen-source, local-first conversational AI video editor with a professional multi-track timeline, Agent Skills, MCP integration, and Remotion rendering.项目地址: https://gitcode.com/gh_mirrors/op/OpenChatCut创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考