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/OpenChatCutOpenChatCut 是一款开源、本地优先的对话式 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 linkbuild:cli会把 CLI 打包到cli-dist/occ.mjsnpm 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 --applyclip是片段引用解析规则见 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 # 只渲染一个区间关键参数参数说明--resolution480p/720p/1080p/4k--codech264/vp8/prores/mp3/wav--from/--to帧号或4s这类时间写法--dry-run只输出渲染计划不真正渲染--quiet关闭进度输出建议先跑--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 换成了终端。全局参数速查参数作用--project id\|前缀\|名称指定目标工程缺省为最近更新的工程--data-dir path切换到另一个 OpenChatCut 项目库--json输出机器可读 JSON方便接入脚本--help查看完整帮助配合--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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考