OpenChatCut occ命令行工具实战：不打开应用，管理、剪辑并渲染全部项目的完整指南

OpenChatCut occ命令行工具实战：不打开应用，管理、剪辑并渲染全部项目的完整指南

【免费下载链接】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 是一款开源、本地优先的对话式 AI 视频编辑器，而它的occ命令行工具让你无需启动图形界面，就能在终端里完成项目管理、片段剪辑、视频渲染和剪映草稿导出的全部工作。本文以新手视角介绍 occ 命令行工具的实战用法：如何安装 occ、如何一行命令新建工程、如何移动裁剪片段，以及如何把项目直接渲染成 MP4。

为什么需要 occ 命令行

传统视频剪辑依赖图形界面，但很多场景其实只需要“批量”和“自动化”：

• 📁 想一次性列出所有工程、检查时间轴状态；
• ✂️ 想批量移动、裁剪、分割或删除片段；
• 🎬 想把保存好的工程直接渲染成视频文件，跳过所有界面操作；
• 🤖 想通过脚本或 AI Agent 无头（headless）操作视频项目。

occ正是为此而生：它直接操作本地项目库，不需要打开应用、浏览器或 MCP 会话；写操作走与应用完全相同的离线编辑会话契约，每次提交都原子化，并保留可回滚的版本快照。入口实现在 cli/main.ts，完整命令路由见 cli/router.ts。

如何安装 occ 命令行工具

occ 从源码构建，要求 Node.js 版本 24（见 package.json 的 engines 配置）。只需两步：

npm run build:cli npm link

build:cli会把 CLI 打包到cli-dist/occ.mjs，npm link之后occ命令就挂到了你的 PATH 上。启动器 cli/occ.mjs 会零依赖地通过 tsx 加载真正的入口，所以任何目录下都能直接执行occ。

不确定支持什么命令时，随时运行occ --help查看全部用法。

项目管理：一行命令列出、查看与新建工程

列出全部项目

occ project list # 活动项目 occ project list --all # 包含已删除项目

输出是一张表格：ID、名称、更新时间、状态。项目解析逻辑在 cli/commands/project.ts。

查看工程详情

occ project show 我的工程 # 支持完整 ID、唯一前缀或唯一名称 occ project show --doc # 输出完整工程文档 JSON

会列出每条时间轴的帧率、尺寸、片段数、时长和轨道概要，方便快速判断哪个时间轴是活跃的（带*号）。

命令行新建工程

occ project new "我的短视频" --size 1080x1920 --fps 30

--size接受宽x高格式，竖屏 9:16 项目一行搞定，创建逻辑见 cli/commands/project.ts。

命令行剪辑片段：移动、裁剪、分割、删除、复制

这是 occ 最实用的部分。所有写操作默认只预览不生效，加上--apply才真正提交；提交走与应用同一套版本校验，事后可以在应用的历史版本里撤销。

# 移动片段到指定轨道和起始位置（支持 4s 这类时间写法） occ item move <clip> --track 1 --start 4s --apply # 裁剪片段，带淡入淡出，并让后续片段前移填补空隙 occ item trim <clip> --start 30 --duration 2s --fade-in 0.5 --fade-out 0.5 --ripple --apply # 在 8 秒处分割片段 occ item split <clip> --at 8s --apply # 删除 / 复制片段 occ item rm <clip> --ripple --apply occ item dup <clip> --apply

<clip>是片段引用，解析规则见 cli/clip-ref.ts。注意--ripple：删除或裁剪后让后续片段自动前移，不留黑场，这是命令行批量剪辑的常用技巧。

命令行渲染视频：occ render 实战

不打开应用直接把工程渲染成文件，这是 occ 的杀手锏：

occ render --out cut.mp4 # 使用当前活跃时间轴 occ render 我的工程 --out out.mp4 --resolution 1080p --fps 30 occ render --out out.mov --codec prores # ProRes 母版 occ render --out audio.mp3 --format audio # 只导出音频 occ render --out part.mp4 --from 4s --to 10s # 只渲染一个区间

关键参数：

建议先跑--dry-run看看计划（编码、总帧数、时长），确认无误再正式渲染。渲染复用服务端同一套导出管线和 Remotion 渲染器，只是省掉了 HTTP 与浏览器，实现见 cli/commands/render.ts。

导出剪映草稿：occ export jianying

做剪映二创的用户可以直接把 OpenChatCut 工程导出为剪映草稿，无需打开应用：

occ export jianying 我的工程 --draft-name 草稿A occ export jianying --out-dir ~/Desktop/drafts

调用 Agent 无头工具：tools 与 edit 命令

occ 还能直接调用 OpenChatCut Agent 的编辑工具，实现脚本化剪辑：

occ tools ls # 列出可用的无头工具 occ tools ls --all --json # 查看全部工具及参数 occ tools call set_aspect_ratio --args '{"ratio":"9:16"}' --apply

也可以一次性提交多步操作：

occ edit --ops '[{"tool":"set_aspect_ratio","args":{"ratio":"9:16"}}]' --apply

写操作同样是必须加--apply才落盘，不加时草稿会被直接丢弃，项目保持原样（见 cli/main.ts 的 Writes 说明）。这与仓库内 AI Agent 技能包 skills/openchatcut/SKILL.md 描述的编辑会话流程一致，区别只是入口从 MCP 换成了终端。

全局参数速查

配合--json输出，你可以轻松把 occ 接进自己的自动化流程：脚本列出所有工程 → 批量渲染 → 归档命名。

小结

occ 命令行工具把 OpenChatCut 的核心能力搬进了终端：

• ✅occ project— 列出、查看、新建工程
• ✅occ item— 移动、裁剪、分割、删除、复制片段
• ✅occ render— 480p 到 4k 直接渲染成文件
• ✅occ export jianying— 导出剪映草稿
• ✅occ tools/occ edit— 无头调用 Agent 编辑工具

所有写操作都加--apply、可回滚、与应用共用版本校验，命令行改完打开应用照样能继续编辑和撤销。更多版本背景可参考 CHANGELOG.md，源码集中在 cli/ 目录，命令实现分别在 cli/commands/project.ts、cli/commands/item.ts、cli/commands/render.ts。

【免费下载链接】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