chengfeng-export

1# 导出（成片）
2 
3**这是链条最后一段，也是整个产品里唯一一个真正画出像素的地方。**
4 
5在它之前全部是标注：账本记「播哪些词」，字幕记「屏上写什么」，画面记「盖什么层」，
6预览把这三样实时拼给人看，**不落盘**。导出把它们烧成一个文件。
7 
8```text
9需要   edit-list.json（必须）、subtitles.json、visuals.json + modules/
10产出   成片.mp4
11```
12 
13前提工具：机器上有 **Google Chrome**（用来把字幕和动画画成图）。桌面安装来源的
14FFmpeg / FFprobe 已随 App 进入 Product 受管目录；纯 CLI 安装仍要求系统
15`ffmpeg ≥ 6`。缺 Chrome 会明确报错，不要试图绕过——没有它就没有字幕层和动画层。
16 
17先读取并执行 [业务 Skill 的阶段合同](../../references/business-workflow-contract.md)
18里的「结论等级」一节。**导出不进剪辑状态机**：它不改任何项目文件、不做 CAS 写入、
19不推进 stage，产出是一个新文件，重跑一次就覆盖。所以它不需要确认卡。
20 
21## 0. 就绪
22 
23先执行 [检查更新](../chengfeng-check-updates/SKILL.md) 的「就绪检查」——skills 是否
24最新、Runtime 是否配套；**插件根**也在那里定位（本文命令里的 `<插件根>` 都代入
25那个字面路径）。只有「就绪」才继续；「需新会话」或「停」按它的处置执行
26（含「禁止自制替代界面」禁令），业务 Skill 不自带环境逻辑。
27 
28若就绪结果为 `runtime.kind=desktop-managed`，直接复用桌面 App 已安装的稳定 CLI、
29媒体工具与同一 `launchd/windows-task` 服务；不要解析 Electron 路径、另装
30FFmpeg/Bun 或起第二个 Runtime。
31 
32## 命令
33 
34```bash
35node "<插件根>/scripts/ensure-running.cjs" --json
36node "<插件根>/scripts/videocut-cli.cjs" export <project> --dry-run --json          # 先看计划，不编码
37node "<插件根>/scripts/videocut-cli.cjs" export <project> --json                    # 出成片（默认 2 倍、源帧率）
38node "<插件根>/scripts/videocut-cli.cjs" export <project> --out /path/成片.mp4 --json
39node "<插件根>/scripts/videocut-cli.cjs" export <project> --scale 1 --json          # 只要源尺寸
40node "<插件根>/scripts/videocut-cli.cjs" export <project> --keep-work --json        # 留下中间片和逐帧 PNG，供排查
41```
42 
43`ensure-running` 身份不匹配、端口冲突或服务不健康时立即停止；不允许用 foreground
44临时顶替后继续导出。
45 
46## 两步，别只跑第二步
47 
48```text
49…