# chengfeng-videocut

给 Codex 用的中文口播剪辑 Marketplace 插件。

Plugin 根入口、两个业务入口和两个支持入口组成；共同规则是内部 reference，不占用户 Skill：

```text Plugin 根名 -> 安装与 UI 群组名，不是同名 Skill 剪口播 -> source_cut.mp4 + subtitles.srt 口播成片 -> final.mp4 + verification.json 上报 Bug -> 脱敏草稿 -> 用户确认 -> GitHub Issue URL 检查更新 -> Marketplace 快照 -> 来源证明 -> 用户确认 -> 复读版本 共同规则 -> references/，不注册为 Skill ```

插件不复制剪辑产品本体。两个业务 Skill 负责判断和编排，确定性动作由 `chengfeng-videocut` Runtime 的 CLI / API 执行；只有进入人工审核阶段且 Studio 能力匹配时才打开界面。Bug 支持 Skill 不安装 Runtime、不启动 Studio，也不改项目。

## 安装

当前公开 Plugin P 是 `0.5.1`；发布后将由 Bootstrap manifest 固定其不可变 40-hex commit。直接使用 Codex Marketplace 安装：

```bash codex plugin marketplace add Agentchengfeng/chengfeng-videocut-skills --ref 36fc88de3c11866140ef3183bfc12873f9e13e52 codex plugin add chengfeng-videocut@chengfeng-videocut ```

Bootstrap 仍只调用官方 `plugin marketplace add --ref <40hex>` 与 `plugin add`，随后做只读回查；它不复制 Skill 文件，也不会安装、升级、启动或修改 Product Runtime。每个 Bootstrap B 都在 manifest 中固定不可变 Plugin commit P。npm 的 GitHub git-spec 在已验证环境中不能稳定启动，因此不把 `npx github:...` 作为对外稳定安装承诺。

已安装后可用以下命令诊断身份（均不安装 Runtime）：

```bash codex plugin marketplace list --json codex plugin list --json ```

安装插件后，第一次使用任一业务 Skill 时会先检测产品 Runtime：

```text doctor | +-- ready --------------------> 继续当前 Skill | +-- missing | | | +--> 提示一句安装状态 | +--> GitHub Release | +--> SHA-256 校验 | +--> 安装后 doctor | +--> 继续当前 Skill | +-- unhealthy / failed -------> 停止；不覆盖；不打开 Studio ```

Runtime 默认安装到：

```text ~/.chengfeng-videocut ```

Plugin 0.5.1 的产品合同仍固定为 `v0.2.0` Release、Runtime 0.2.0+ EDL 与用户级常驻 service 能力，以及 Studio 的三个顶层视图与 `managedTimelineEditing=true`。首次安装会从这个精确 Release 下载 `install.sh` 和 `SHA256SUMS.txt`，先验证安装器，再让安装器读取同一个 Release 的产品包；不使用会漂移的 `latest`。Release 不存在、资产不全、哈希不匹配或已有 Runtime 不兼容时均停止，不覆盖现有安装，也不回退 v0.1.1。

每个业务流程在第一次产品 API 前、每次人工审核恢复前都会执行共享 `ensure-running`：

```text Skill -> Product service ensure -> launchd service ready -> 继续当前流程 |