chengfeng-visual

1# 画面（分镜）
2 
3**这是一件事，不是流程的一段。** 用户什么时候喊它就什么时候做，改完剪辑可以回来再做。
4 
5前提只有两个：**账本和字幕已经存在**（层按字幕屏放、时间从账本算）。
6 
7```text
8需要   edit-list.json、transcript.json、subtitles.json
9产出   visuals.json + modules/<序号-名字>/index.html
10```
11 
12干完就停，**不指挥用户下一步**。
13 
14先读取并执行 [业务 Skill 的阶段合同](../../references/business-workflow-contract.md)。
15模块写法的硬规矩见 [模块契约](references/visual-module-contract.md)，
16判断规则见 [画面判断](references/visual-judgment.md)。
17 
18## 0. 就绪
19 
20先执行 [检查更新](../chengfeng-check-updates/SKILL.md) 的「就绪检查」——skills 是否
21最新、Runtime 是否配套；**插件根**也在那里定位（本文命令里的 `<插件根>` 都代入
22那个字面路径）。只有「就绪」才继续；「需新会话」或「停」按它的处置执行
23（含「禁止自制替代界面」禁令），业务 Skill 不自带环境逻辑。
24 
25若就绪结果为 `runtime.kind=desktop-managed`，直接复用桌面 App 已安装的稳定 CLI 与
26同一 `launchd/windows-task` 服务；不要解析 Electron 路径、另装依赖或起第二个
27Runtime。
28 
29## 命令
30 
31```bash
32node "<插件根>/scripts/ensure-running.cjs" --json
33node "<插件根>/scripts/videocut-cli.cjs" visual get   <project> --json
34node "<插件根>/scripts/videocut-cli.cjs" visual frame <project> --cues sub-0004,sub-0005 --count 12 --out <dir> --json
35node "<插件根>/scripts/videocut-cli.cjs" visual add   <project> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
36node "<插件根>/scripts/videocut-cli.cjs" visual remove <project> --id vis-0001 --json
37```
38 
39`ensure-running` 必须先证明 canonical 5190 属于当前平台的托管服务；失败就透传并
40停止，不回退 foreground 或自选端口。
41 
42层绑**字幕屏**（`--cues`），产品自己换算成词 id——层永远不可能绑上没人说的词，
43剪辑变了层自己跟着挪。**不存秒数。**
44 
45## 四步，一步不跳
46 
47```text
48① 文字定任务    读 subtitles.json，按语义分段，每段回答：
49               教程/演示/证明，还是概念/逻辑/过渡？
50…