chengfeng-cut

1# 剪口播
2 
3从一条视频到**一份人工复核过的删词账本（Cuts + EDL）**，不碰媒体文件。七步一线：
4 
5```text
60  就绪     引用「检查更新」的就绪检查（本 Skill 不带环境逻辑）
71  建档     真实视频 → 云端逐词转录 → 产品建项目 → 起服务 → 读回状态
82  修字     词典把字改对（通用一本 + 用户一本）→ 出修字表
93  删词     读偏好与规则 → 五轮扫描，每轮只找一类，只记行
104  汇总     删词汇总表 + 重复句子表 → 按表自读校验
115  审核     全量提交 → 两张表呈给用户 → 打开 Studio 亲自复核
126  复盘交棒  对比提案与终版 → 归档三抽屉 → 报告四件事
13```
14 
15**不切媒体**：账本改一次是几十毫秒，切一次是一个不可撤销的文件。到本 Skill 结束，
16磁盘上没有任何新视频。Skill 做语义判断与编排；产品 Runtime 是项目、Cuts 和
17Studio 状态的唯一写入者。
18 
19**用户只在三处说话**：同源项目选继续还是重来（仅剪过时）、Studio 复核、完成确认。
20其余一律单向汇报，不停下等回复。**每步的完成判据是它的产出物**：没出表，不算完成。
21 
22先读取并执行 [业务 Skill 的阶段合同](../../references/business-workflow-contract.md)。
23本文步骤与合同阶段的对应：1=preflight+Product state readback，5=proposal+Product CAS，
24审核=project-level review binding。合同后三个阶段（确认、执行、验收）属于导出 Skill。
25 
26各条规矩的事故来历在 [事故簿](references/lessons.md)——规矩在正文，故事在那边。
27 
28## 0. 就绪
29 
30先执行 [检查更新](../chengfeng-check-updates/SKILL.md) 的「就绪检查」——skills 是否
31最新、Runtime 是否配套；**插件根**也在那里定位（本文命令里的 `<插件根>` 都代入
32那个字面路径）。只有拿到「就绪」才继续；「需新会话」或「停」都按它的处置执行
33（含「禁止自制替代界面」禁令）。
34 
35若就绪结果为 `runtime.kind=desktop-managed`，它与 CLI 安装共用同一稳定入口和
36`launchd/windows-task` 服务，直接继续；不要查找 Electron 安装目录、另装 Bun /
37FFmpeg，或启动第二个 Runtime。
38 
39## 1. 建档：真实输入 → 转录 → 产品建项目
40 
41**干什么**：把用户的本地真实视频和云端逐词稿交给产品，原子建档，起服务，读回状态。
42 
43```bash
44# 云端逐词转录（生成任务目录内的 transcript 候选）之后：
45node "<插件根>/scripts/videocut-cli.cjs" project create "<项目目录>" --video "<任务目录内的视频文件>" --transcript "<任务目录内的逐词稿>" --json
46 
47node "<插件根>/scripts/ensure-running.cjs" --json          # 产品声明式确保常驻服务（5190）
48…