装好工具，
开始第一条作品。

安装前，确认这四件事。

应用最低支持 macOS 13；首次安装建议使用 macOS 15 或更新系统，以符合当前 Homebrew 的官方支持范围。macOS 13/14 上已有可用依赖的环境需另行确认。本次仅提供 Apple Silicon 安装包。程序为本地签名预览版，尚未使用 Apple Developer ID 公证。若系统阻止打开，请先核对下载来源和 SHA-256 校验值，并保留系统提示；不要删除旧工程来处理安装问题。

准备入口：Homebrew 官方网站 ↗ · Codex 官方网站 ↗

首次安装

1. 从官网下载区下载完整 ZIP，并解压到可读写目录。不要直接在压缩包预览里运行安装器。
2. 双击解压目录中的 安装_口播工坊.command。安装器准备独立 Python 环境、锁定版本依赖和 FFmpeg；根据网络情况，首次准备需要一些时间。
3. 安装器完成后，打开 ~/Applications/口播工坊/口播工坊.app。程序旁边的组件目录请一起保留。
4. 重新打开 Codex，让三个配套技能进入可用列表。剪口播使用 $talkcut-editing；人物关键帧和字幕复刻有独立技能。

剪第一条视频

1. 准备一段口播原片。如果需要教学展示，把可用的教学切片或图片放在清楚命名的素材目录里。
2. 打开口播工坊，在 Codex 中给出原片路径和剪辑要求。需要指定保留内容、教学素材、字幕偏好时，一起说明。
3. Codex 调用剪辑技能，读取素材和话术，校对内容，编排字幕、音效与画面。预览后继续提出具体修改。
4. 验收成片的文字、画面、声音与完整表达，再领取导出作品。工程与历史成片分别保留。

口播工坊提供具体媒体处理能力；Codex 负责理解素材并作出剪辑选择。示例要求是开始方式，实际方案仍要根据话术和素材安排。

一次准备多个素材文件夹

1. 进入口播工坊「批量剪辑」，点击「多选素材文件夹」。按住 ⌘ 或 ⇧ 选择多个文件夹，也可分批追加。
2. 一个文件夹对应一条作品。同一文件夹内的多个原片按自然数字顺序合剪，展开清单核对文件数量和顺序。
3. 选择同时处理数量，默认 2 个对话，可选 1–4 个。填写本批共同要求后，点击「创建 N 个对话并开始剪辑」。
4. 在列表查看进度与待处理问题。需要补充信息或授权时处理对应任务，完成后显示成片；单条失败可以单独继续。

多个对话共用当前账号额度。对话数量和本机渲染资源是两个调度层次；素材时长、人物处理、机器负载都会影响完成时间，更多并行对话不等于成片等比例加速。

更新已有版本

先完成或停止剪辑任务并退出口播工坊，再运行新安装器。安装器保留已有工程、素材、历史成片及工作区位置，并在安装目录的 更新备份 中保留旧程序与模板备份。

同 ID 的发布模板会更新；自定义新 ID 保留；已删除模板不自动恢复。确认新版本正常后，再按自己的需求整理备份。

历史视频需要修改时，使用「基于此版返工」创建派生工程。旧记录没有完整工程快照时，只能打开现有工程，无法保证精确恢复到当时版本。

素材、账号与当前导出说明

官网提供介绍和安装包，不接收剪辑素材。媒体处理和渲染在你的 Mac 上完成；使用 Codex 时，输入和工具调用遵循当前账号和服务设置。请保持源文件所在的磁盘连接，确保工作区有足够空间。

教学插片从使用者导入的素材中选择。没有合适素材时，应调整编排；产品不承诺凭空生成对应的真实教学记录。

当前成片提示文案

此发布版针对推广口播配置了三行固定提示，新成片导出时会自动叠加：

非K12校外培训
剧情为演绎情节
推广内容为数字内容平台

提示覆盖成片时长；字幕模板预览、透明人物中间文件不叠加。编排正文与插片时需给底部提示留出空间。已有历史成片和原片不会批量覆盖。

遇到问题，先定位到这一步。