用 Claude Code 与 Codex 自动录制演示并精剪口播


核心命令与职责一览
| 命令 | 用途 | 生效方式 |
|---|---|---|
| oilstudio status | 检查应用运行状态、版本号与 Agent Skill 兼容性 | 只读查询,返回 JSON |
| oilstudio projects / import | 列出本机 .oilstudio 工程,或将已有录屏工程只读转换为新工程 | 不修改原工程文件 |
| oilstudio record sources / start / click / stop | 选定原生 Mac 窗口开始录制,申报点击轨迹生成平滑光标与自动缩放 | 需系统录屏权限与应用内录制开关 |
| oilstudio idle --submit | 自动剔除无口播演示中的等待空档,并按画面响应对齐点击缩放 | Agent 自录工程可直接生效,支持 ⌘Z |
| oilstudio context / plan validate / plan submit | 读取逐词转录与停顿草案,校验并提交剪辑、缩放、文字贴图与打码方案 | 默认进入应用审阅面板,逐条勾选确认 |
| oilstudio subtitles generate / apply | 生成初始字幕,校对错别字与专有名词,或翻译为英文字幕 | 校对直接生效并可一步撤销,支持 --plan 对齐剪后时间线 |
| oilstudio narration generate / export | 按字幕时间轴合成 AI 配音,导出 60 fps MP4、GIF 或 SRT 字幕文件 | 使用你在设置中自配的模型密钥 |
如何安装并连接你的 AI Agent?
最省心的方式是在 Oil Studio 菜单打开「设置 › AI Agent」点击「安装」:应用会自动安装 oilstudio 命令行与配套 Skill,并随应用升级保持同步。你也可以通过 Skills CLI 或 Homebrew 安装。
brew install --cask oil-oil/tap/oil-studio
npx skills add oil-oil/oil-studio-skill
oilstudio status一句话精剪口播录屏与校对字幕是怎么运行的?
当你对 Claude Code 或 Codex 说「用 oil-studio 剪掉刚录演示里的重说和口误,并把产品名改对」时,Agent 不会直接读写工程包内部文件,而是调用 oilstudio context 读取带字词时间戳的文字稿与停顿候选。
Agent 识别出语义重说、说到一半放弃的废句和口误后,先通过 oilstudio plan validate 校验时间边界,再通过 plan submit 发回 Oil Studio 界面。你可以在审阅面板逐条试听、取消勾选任意一刀,确认后画面、声音、字幕和自动缩放同步收紧。
- 字幕与剪辑一气呵成。subtitles apply 与 chapters apply 支持 --plan 参数,按待确认剪辑方案的成片时间线提前校验并排队,确认剪辑后自动对齐生效。
- 隐私区域预先遮盖。如果工程里已经给敏感信息打了码,Agent 请求单帧、分镜或文字识别时拿到的是已经打码后的画面,任何削弱已有打码的提案都必须经你在应用内手动确认。
如何让 Agent 自主操作原生 Mac 窗口录完一段产品演示?
开启系统屏幕录制权限与 Oil Studio 内的「允许 AI Agent 发起录制」后,Agent 可以用 oilstudio record prepare 将目标 Mac 窗口调整到标准尺寸(如 1280×800 居中),再用 record start 只录该窗口,不把桌面杂物或其他应用录进去。
操作期间,Agent 在每次点击前通过 record click 申报坐标:成片不会录进生硬的真实鼠标跳变,而是由 Oil Studio 渲染器按弹簧曲线重绘平滑光标与跟随点击推近,最后执行 oilstudio idle --submit 自动剪掉步骤之间的加载等待并导出 60 fps MP4。
适用范围与安全边界
- 不处理普通视频文件。oilstudio 专为包含多轨画面、光标坐标与点击元数据的 .oilstudio 录屏工程设计,不直接剪辑现成的普通 MP4 或 MOV 文件。
- 密钥只留在你的 Mac 上。Oil Studio 不内置收费云端账号,也不收取 AI 点数;API Key 仅保存在本机当前用户配置中,不会暴露给 Agent Skill 输出。
- 两道人工权限门禁。macOS 系统录屏授权与应用内 Agent 录制开关均只能由你本人点击开启,Agent 无法自行绕过;录制期间屏幕顶部常驻状态胶囊,随时可暂停或停止。
公开仓库与配套参考
以下开源仓库与专题页可公开核验 oilstudio 命令参数、JSON 输出格式与自动化演示效果:
- oil-studio-skill 开源仓库(GitHub)github.com
完整公开的 SKILL.md、oilstudio CLI 子命令定义与 Claude Code / Codex 调用契约。
- Homebrew Cask 官方安装源(GitHub)github.com
公开核验官网直装版公证版本号、下载地址与 SHA-256 校验值。
- AI Agent 自动录制与精剪交互专题studio.oiloil.org
在浏览器中直接体验一句话精剪口播与原生 Mac 窗口自主录制的完整过程。
常见问题
01使用 AI Agent 剪辑需要按分钟购买积分吗?
不需要。oilstudio 本地命令行包含在一次买断授权内,完全免费开放;外部 Agent 直接复用你自己的 Claude Code、Codex 或模型账号。
02Agent 误删了一句重要讲解怎么办?
剪辑提案默认先停留在 Oil Studio 审阅面板,你不点应用就不会改动原工程;应用后也可随时按 ⌘Z 一步撤销全部剪切、字幕与章节变更。
03Mac App Store 版本支持外部 AI Agent 吗?
外部命令行与 Agent 协作仅在官网直装版(及 Homebrew 安装版)提供;Mac App Store 版本受系统沙盒限制,不包含外部 CLI 接口。