@gitruck/cli 1.3.15 → 1.3.17

package/skills/gtrk-vlog-docu/SKILL.md

@@ -15,7 +15,7 @@ description: Vlog 纪实类一站式成片图纸——纪实 Vlog 是散文的
 
 明确脚本的取材由语义与实际画面证据主导；泛高光发现只是探索素材的一种工具，其分数不能覆盖脚本意图。下方云端 describe 示例仅在当前 Agent 无法完成时直接使用；有视觉能力时先 prepare/review，交接由 Agent 完成，不让用户填逐帧表格。
 
-把**一批现场素材**变成**一条纪实成片工程**：素材理解 → 选档写稿 → 检查点①一次拍板 → 同期声骨架 + 旁白配音 + B-roll + 字幕层 + BGM 全自动 → 客户端出片。
+把**一批现场素材**变成**一条纪实成片工程**：素材理解 → 选档写稿 → 检查点①一次拍板 → 同期声骨架 + 旁白配音 + B-roll + 字幕 + 合成包装 + 字卡 + BGM 全自动 → 客户端出片。
 
 > **定位**：structure 级组合图纸，不新增命令，只编排既有原子零件。零件参数以各自 skill（`gtrk-transcript` / `gtrk-matrix` / `gtrk-splitter` / `gtrk-mg`）与 `--help` 为准，**本图纸引用不复制**；编排次序、检查点、配方参数以本图纸为准。**CLI 是手，你是脑。**
 >
@@ -62,7 +62,7 @@ gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素
 
 **MUST NOT 下载二创源片 / 主体素材**：素材从哪来归用户（版权责任边界）。平台授权素材（素材矩阵的 BGM / 空镜）可按其签名直链落地；这条例外不适用于源片与主体画面素材。
 
-> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，这些段里的字幕会按版式重排；不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
 
 ### 1.1 配比档位识别（本类型独有的第一决策）
 
@@ -80,6 +80,8 @@ gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素
 
 ## 二、全链总览（快速成片）
 
+**主链**（位次照公约 §二⁗「画面三层」，正本 `production-order`，本图纸不另述）：拆分（含版式窗口）→ B-roll 底轨 → 全局抽帧检查 → 字幕 → 合成（精剪包装，含旁白段与幕间的满屏卡）→ `gtrk mg`（字卡等叠层）→ 交付；BGM 不受顺序约束。
+
 ```
 ① 理解        transcript 抽听定档 + matrix index/describe 建素材索引
 ② 立神        ★【多轮对话·必问】与创作者访谈找出那根线，问够为止（§3.2）
@@ -88,13 +90,14 @@ gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素
 ⑤ 检查点①    【必停】神 · 配比档 · 稿件 · 画幅 · 音色 · BGM · 字幕样式（§四）
 ⑥ 配音        gtrk tool audio_tts_clone（仅旁白段，★ 分段合成）
 ⑦ 拼主轨      gtrk project compose（分段清单 → live 段引用原片区间 + narration 段落位）
-⑧ 拆分派单    gtrk split：live 段=A_ROLL/真人出镜|口播继续；narration 段=FILM_BROLL|MG/旁白主导
+⑧ 拆分派单    gtrk split：live 段=A_ROLL/真人出镜|口播继续；narration 段=FILM_BROLL/旁白主导，要整幅排版的写满屏卡（零槽位版式窗口带 bg、beat 派 A_ROLL）；版式窗口进 layouts
 ⑨ B-roll      matrix --local --dirs → describe → lay（只铺 narration 段空档）
-⑩ 字幕层      吐槽/观察/进度/梗卡进 MG 派单（§六）→ mg lint → mg --project
-⑪ BGM         gtrk audio lay --volume 0.1 --beat-align（-20dB 口径）
-⑫ 字幕        gtrk subtitle lay --style <拍板样式>
-⑫′ 精剪包装   交棒 /gtrk-composite（公约 §三⁵：auto ≤ 25% → 复核 → 构建机检 → 铺轨烘焙，不停）
-⑬ 交付        客户端打开工程出片
+⑩ 抽帧检查    对底轨终态抽帧看主体与明暗（位次 ④；快速成片不另停）
+⑪ 字幕        gtrk subtitle lay --style <拍板样式>
+⑫ 精剪包装    交棒 /gtrk-composite（公约 §三⁵：取拆分稿的版式窗口 --mode split → 复核 → 构建机检 → 铺轨烘焙，不停；幕间进度/梗卡等满屏卡随这一步做）
+⑬ 字卡        吐槽/观察/信息卡（叠层）进 MG 派单（§六）→ gtrk mg status 看 todo → mg lint → mg --project
+⑭ BGM         gtrk audio lay --volume 0.1 --beat-align（-20dB 口径；不受顺序约束）
+⑮ 交付        客户端打开工程出片
 ```
 
 **快速成片的「免打扰」只覆盖 ⑥ 之后的执行环节**：①–⑤ 沿用已有创作意图，补问必要信息并保留检查点①，MUST NOT 因为用户选了快速成片就跳过立神对话自行拍板——那是把创作者的片子做成 agent 的片子。用户要精修按 §七 逐步停。
@@ -232,7 +235,7 @@ HKRR 四维（缺哪补哪）：
 
 分段旁白铺完后，使用 `gtrk patch set --clip <旁白片段ID> --audio-track <首条旁白轨的track_index> --project <工程目录>` 将同一讲述者的各段收进同一条旁白轨，保持原时间位置；同期声与 BGM 各自独立。重铺旁白后也要归轨，不能把“一段一轨”的阶梯布局作为交付。目标时间段已有片段时先检查重叠，不强行合并。
 
-大场景或活动转换处用简短 MG 交代叙事关系（如从游览转到参与体验），不按每个镜头机械加字卡，不杜撰日期/地点。手写 GSAP 颗粒须在 template 内先声明 gsap.min.js，再创建并注册 paused 时间线；静态 lint 通过不等于预览可见，交付前还应检查客户端播放环境内的入场与驻留。
+大场景或活动转换处用一张简短的满屏卡交代叙事关系（如从游览转到参与体验）——它整幅盖住画面，归版（公约 §二⁗）：写成零槽位版式窗口（`zero_slot: true` 并给 `bg`，窗口底下的 beat 派 `A_ROLL`；2–5 秒的短卡不告时长），随精剪包装做成满屏卡、本机烘焙出片；要和现场画面同屏排的开带槽位的版式窗口交合成；不按每个镜头机械加字卡，不杜撰日期/地点。字卡（叠层）手写 GSAP 颗粒须在 template 内先声明 gsap.min.js，再创建并注册 paused 时间线；静态 lint 通过不等于预览可见，交付前还应检查客户端播放环境内的入场与驻留。
 
 ```bash
 # ① 理解与定档（抽听 1-2 条代表素材；live 段的 in/out 时码后面全从这份转写里读）
@@ -264,8 +267,11 @@ gtrk project compose --list <分段清单.json> --out <新工程目录> --canvas
 gtrk split --project "<工程目录>" --json          # 投影拿句表
 # 你写 split/visual-split.json：
 #   live 段      → lane:"A_ROLL"，base_track:"真人出镜"（出镜）或 "口播继续"（画面切走声音继续），无 handoff
-#   narration 段 → lane:"FILM_BROLL" 或 "MG"，base_track:"旁白主导"，handoff 按 lane 分型
-#   字幕层/字卡  → aux_layers type:"overlay"（进 dispatch.mg）
+#   narration 段 → lane:"FILM_BROLL"，base_track:"旁白主导"，handoff 按 lane 分型；
+#                  旁白段要整幅排版（没有画面可配）：写满屏卡——beat 派 A_ROLL，再挂零槽位版式窗口
+#                  （layouts[] 里 zero_slot:true + bg），不派满屏 MG（透明颗粒下面是黑底，满屏卡随合成本机烘焙）
+#   字卡（叠层） → aux_layers type:"overlay"，handoff 带 visual_job + duration_hint（进 dispatch.mg）
+#   版式窗口     → 顶层 layouts[]：现场画面与旁白信息同屏重排、多画对照的段（判定不做写 layouts: [] + layout_note）
 gtrk split "<拆分稿>" --project "<工程目录>" --json
 
 # ⑨ B-roll（★ 只铺 narration 段空档，live 段 MUST NOT 覆盖）
@@ -273,23 +279,25 @@ gtrk matrix --project "<工程目录>" --local --dirs "<素材夹>" --lay 0 --js
 gtrk matrix describe --plan "<工程目录>/split/broll-plan.json" --yes --json
 gtrk matrix lay --project "<工程目录>" --mark-weight 0.3 --gap-fill fast --json
 
-# ⑩ 字幕层字卡（§六 规约）
+# ⑩ 抽帧检查（位次 ④）：底轨铺完，对底轨终态抽帧（gtrk client frame --at <轨秒> --project "<工程目录>"），快速成片不另停
+
+# ⑪ 字幕
+gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --json
+
+# ⑫ 精剪包装：见下方引注
+
+# ⑬ 字卡（§六 规约；先 gtrk mg status 看 todo，被合成接管的不产）
 gtrk mg lint "<工程目录>/mg/<composition_id>.html" --dispatch "<工程目录>/split/dispatch.json"
 gtrk mg --project "<工程目录>" --json
 
-# ⑪ BGM（-20dB = 线性 0.10）
+# ⑭ BGM（-20dB = 线性 0.10；不受顺序约束）
 # --beat-align 的高潮点取自 split.beats 的 narrative / container_stage（升华段 → 容器转折 → 回扣段）；
 # 拆分稿没带这两个字段 ⇒ 落 0.75×全片兜底档，**CLI 会明示那是猜的**。不接受就用 --climax <轨秒> 指定。
 # 两侧都够长时零平铺（恰好 1 个 clip）；不够长才按小节线平铺补齐、接缝吸附 downbeat。
 gtrk audio lay --project "<工程目录>" --file "<bgm>" --volume 0.1 --beat-align --json
-
-# ⑫ 字幕
-gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --json
-
-# ⑫′ 精剪包装：见下方引注
 ```
 
-> **⑫′ 精剪包装**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片 auto ≤ 25% → 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。现场段有真人出镜时按讲者口径编排，旁白段按「没有讲者」口径只用 B-roll 与排版。
+> **⑫ 精剪包装**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片取拆分稿的版式窗口 `--mode split`（拆分稿没有 `layouts` 键才 `auto` ≤ 25%）→ 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。现场段有真人出镜时按讲者口径编排，旁白段按「没有讲者」口径只用 B-roll 与排版。
 
 > **停顿太长时**：自训音色加 `--fragment-interval 0.2`（合成时就对）；云引擎音色**不支持**该参数（传了会报错，不会静默忽略），改在合成后跑 `gtrk audio tighten --project <工程>` 收紧句间停顿（纯本地零计费；只压跨句界的停顿，句内换气与原声引用段不动）。
 
@@ -299,18 +307,18 @@ gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --js
 - `--mark-weight 0.3` / `--gap-fill fast` / 句界吸附 0.7：同旅拍图纸口径；
 - 素材不二用、黑片叠底、层序由 lay 内建，MUST NOT 绕过。
 
-## 六、字幕层规约（本类型的第二解说轨）
+## 六、字卡规约（本类型的第二解说轨）
 
-**字幕层不是被动烧字幕，而是承载人格与信息的第二条解说轨。** 无语音段可由它承接信息。四类字卡进 MG 派单：
+**字卡不是被动烧上去的字幕（字幕是 ⑪ `gtrk subtitle lay` 那条轨），而是承载人格与信息的第二条解说轨。** 无语音段可由它承接信息。四类字卡按公约 §二⁗「画面三层」各归各层——叠层进 MG 派单，整幅的写成满屏卡（零槽位版式窗口）：
 
-| 类 | 用途 | 样本形态 | 挂点 |
-|---|---|---|---|
-| **吐槽字幕** | 补心声、造笑点 | 「你怎么一直拍着我」「常规操作~」 | 现场段的反应瞬间 |
-| **观察字卡** | 补信息、点特色 | 「宿舍楼特色：外卖挂铁门」 | 空镜段 |
-| **信息卡** | 攻略数字（收藏钩） | 「田七炖鸡 ¥22」「停车 15 元/3 小时」 | 站点段 |
-| **进度/梗卡** | 节奏引擎、互动钩 | 「挑战完成进度:50% 评论区已追加物品」「没动静啊」 | 幕间黑屏 |
+| 类 | 用途 | 样本形态 | 挂点 | 归层与派法 |
+|---|---|---|---|---|
+| **吐槽字卡** | 补心声、造笑点 | 「你怎么一直拍着我」「常规操作~」 | 现场段的反应瞬间 | 叠：overlay aux，`statement` |
+| **观察字卡** | 补信息、点特色 | 「宿舍楼特色：外卖挂铁门」 | 空镜段 | 叠：overlay aux，`statement` |
+| **信息卡** | 攻略数字（收藏钩） | 「田七炖鸡 ¥22」「停车 15 元/3 小时」 | 站点段 | 叠：一颗一个数（`data`）；一张价目表并排多项就归版 |
+| **进度/梗卡** | 节奏引擎、互动钩 | 「挑战完成进度:50% 评论区已追加物品」「没动静啊」 | 幕间黑屏 | 版（整幅）：满屏卡——零槽位版式窗口（`zero_slot: true` + `bg`，beat 派 `A_ROLL`），随精剪包装做 |
 
-**工艺**：严格按 `contracts/gsap-emit-v1.md` 颗粒骨架（`<template>` 包裹 / `gsap.timeline({paused:true})` / `__timelines` 注册 / 无随机无时钟 / 本地 vendor GSAP）；入场 1–1.5s → 定格驻留到坑位末尾（禁全局渐隐）；**产前对挂点抽 1 帧**看底轨明暗与主体位置。
+**产法**照 `/gtrk-mg` 的「按 `visual_job` 路由」（`statement` 档文字模板在候选集里），同片字卡同一套风格（公约 §三）。**手写颗粒时的工艺**：严格按 `contracts/gsap-emit-v1.md` 颗粒骨架（`<template>` 包裹 / `gsap.timeline({paused:true})` / `__timelines` 注册 / 无随机无时钟 / 本地 vendor GSAP）；入场 1–1.5s → 定格驻留到坑位末尾（禁全局渐隐）；**产前对挂点抽 1 帧**看底轨明暗与主体位置。
 
 **快速成片禁留白**：字卡按规约先斩后奏直接产好叠上，用户不满意在客户端删。
 
@@ -323,17 +331,17 @@ gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --js
 | **立神** | 神一句话 + 类型 + 候选备选 | **随时可推翻重立**（创作者想通了、或看稿后发现不对） | 神变=全变：重走选材→写稿→⑥以后全链；**如实告知代价再动**，别默默重跑 |
 | 定档 | 配比判定 + 现场段清单 | 用户改档 | 从写稿重来（档变=稿全变） |
 | 写稿 | 旁白稿 vN | 用户改意见 | 改稿后从 ④ 重跑（TTS 变=时码变） |
-| 拆分 | split/view.json + 拆分稿 | 改 beat/lane | `gtrk split <稿> --project` 重落 |
+| 拆分 | split/view.json + 拆分稿（含版式窗口） | 改 beat/lane/窗口 | `gtrk split <稿> --project` 重落 |
 | B-roll | broll-plan.json | 编辑 plan（删/换/pinned） | `gtrk matrix lay`（零检索零计费） |
+| 字幕 | cve 字幕 lane | 换样式/颜色 | `gtrk subtitle lay` 重跑幂等（已有合成颗粒的那几颗变「需重渲」，按合成 skill 重跑） |
+| 精剪包装 | `composite/plan.md` + 合成颗粒 | 审窗口、看静帧（合成 skill 两个检查点） | `/gtrk-composite` `review` / `build --only` / `lay --only` |
 | 字卡 | mg/*.html | 改颗粒 HTML | `gtrk mg --project --only <beatId>` |
 | BGM/旁白音 | audio_track | 换文件/音量/offset | `gtrk audio lay` 同源幂等替换 |
-| 字幕 | cve 字幕 lane | 换样式/颜色 | `gtrk subtitle lay` 重跑幂等 |
-| 精剪包装 | `composite/plan.md` + 合成颗粒 | 审窗口、看静帧（合成 skill 两个检查点） | `/gtrk-composite` `review` / `build --only` / `lay --only` |
 
 ## 八、交付与出片
 
-- **成片出口 = 客户端**（打开 `gtrk/project.gtrk`）：多轨合成（同期声+旁白+BGM 三源混音、字卡 overlay）只有客户端出片链完整支持；
-- **`gtrk render` 仅主轨快照预览**，不合成 overlay，MUST NOT 当成片交付；
+- **成片出口 = 客户端**（打开 `gtrk/project.gtrk`）：同期声+旁白+BGM 三源混音、B-roll、字卡、合成与字幕，客户端出片链全都带；
+- **`gtrk render` 不带字幕轨**：它会合成 B-roll 叠加轨、字卡颗粒（未命中缓存的颗粒云渲**计费**，先报预估等确认；`--no-particles` 零计费出无颗粒版）与合成段（本机烘焙），但客户端字幕轨不进成片——要带字幕交付走客户端导出；
 - **云渲必拒**：含本地素材的工程提交云渲会被拒（`local_broll_cloud_render_rejected`），如实告知；
 - 交付话术：报产物目录 + 客户端打开指引 + 各环节实耗；把悔棋通道讲清楚（候选轨小眼睛、字卡可删、三条音轨音量可终调、字幕可整轨换样式）。**特别提示用户去客户端调三源混音比例**——纪实类的成败很大程度在同期声与旁白的响度平衡上。
 

package/skills/gtrk-voiceover/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: gtrk-voiceover
-description: 通用配音视频创作图纸（配音链快速成片预设）——写好的稿子（或让 AI 代写）→ 配音 → 自动配画面 → 字卡/BGM/字幕 → 客户端可出片工程。适用素材为叙事服务、无自带时序的题材：知识科普、情感电台、观点输出、带货文案、盘点合集。当用户想「拿这篇稿子出条片 / 帮我写稿配音做成视频 / 科普视频 / 情感文案视频 / 把文字变成视频」时使用本图纸。素材自带时间线的解说类（旅拍/影视/游戏/探店）走 gtrk-narration，别用本图纸硬套。
+description: 通用配音视频创作图纸（配音链快速成片预设）——写好的稿子（或让 AI 代写）→ 配音 → 自动配画面 → 字幕/合成包装/字卡/BGM → 客户端可出片工程。适用素材为叙事服务、无自带时序的题材：知识科普、情感电台、观点输出、带货文案、盘点合集。当用户想「拿这篇稿子出条片 / 帮我写稿配音做成视频 / 科普视频 / 情感文案视频 / 把文字变成视频」时使用本图纸。素材自带时间线的解说类（旅拍/影视/游戏/探店）走 gtrk-narration，别用本图纸硬套。
 ---
 
 # gtrk-voiceover（通用配音 · 配音链快速成片预设）
 
-把**一段文字**（你写的或 AI 代写的）变成**一条配好画面的成片工程**：稿 → 检查点①一次拍板 → 配音 → 建工程 → 配画面 → 字卡 → BGM → 字幕 → 客户端出片。
+把**一段文字**（你写的或 AI 代写的）变成**一条配好画面的成片工程**：稿 → 检查点①一次拍板 → 配音 → 建工程 → 配画面 → 字幕 → 精剪包装 → 字卡 → BGM → 客户端出片。
 
 > **定位**：配音链的快速成片预设（structure 级图纸，不新增命令）。**素材为叙事服务**——
 > 画面是插画，纯语义匹配，无时序义务；素材自带时间线的题材（旅拍/影视/游戏/探店）按判据
@@ -28,12 +28,15 @@ description: 通用配音视频创作图纸（配音链快速成片预设）—
 
 一张表一次问完；**未经检查点①确认 MUST NOT 发起 TTS 计费动作**。
 
-> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，这些段里的字幕会按版式重排；不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
 
 > **推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。
 
 ## 二、快速成片编排
 
+**主链**（位次照公约 §二⁗「画面三层」，正本 `production-order`，本图纸不另述）：拆分（含版式窗口）→ 配画面（B-roll / AI 片段底轨）→ 全局抽帧检查 → 字幕 → 合成（精剪包装，含满屏卡）→ `gtrk mg`（字卡等叠层）→ 交付；BGM 不受顺序约束。
+配音片没有讲者、也没有底画面兜底：旁白段要整幅排版的（标题牌、数据卡、纯排版的并置面板）写成**满屏卡**——零槽位版式窗口（`zero_slot: true`，带 `bg`，窗口底下的 beat 派 `A_ROLL`），随精剪包装一起做、本机烘焙出片，**不再派满屏 MG**；多画并置、对照、要看清的配图开带槽位的版式窗口交合成；字卡归叠，一颗点出一个对象，叠在 B-roll 上（底下没画面的段别派叠层，那段是满屏卡）。
+
 ```bash
 # ①② 写稿（三段式通用框架层 + 文风铁律自校验）→ 产前六秒方案（公约 §三⁗：基于稿件首段改写钩子文案三候选 + 画面层建议 + 字卡节奏，只改开口不改事实）→ 检查点①拍板
 gtrk matrix material "<情绪 调性 检索词>" --scope audio --top-k 5 --json   # BGM 候选附试听
@@ -46,31 +49,36 @@ gtrk matrix material "<情绪 调性 检索词>" --scope audio --top-k 5 --json
 gtrk tool audio_tts_clone --text-file <稿.txt> --speaker <voice_id> --json
 gtrk project init --tts-task <TTS任务id> --canvas <WxH> --no-open --json
 
-# ④ 拆分派单 → 配画面（纯语义：平台库走云端检索，本地夹加 --local --dirs）
+# ④ 拆分派单（含版式窗口 layouts；判定不做写 layouts: [] + layout_note）→ 配画面（纯语义：平台库走云端检索，本地夹加 --local --dirs）
 gtrk split --project "<工程>" --json && gtrk split "<拆分稿>" --project "<工程>" --json
 gtrk matrix --project "<工程>" [--local --dirs "<素材夹>"] --lay 0 --json
 gtrk matrix describe --plan "<工程>/split/broll-plan.json" --yes --json
 gtrk matrix lay --project "<工程>" --mark-weight 0.3 --gap-fill fast --json
+#   派了 AI_DRAMA 的 beat：/gtrk-ai-drama 产分镜稿 → 外部出片 → 标准导出包回填（没有标准包的平台才手动回铺）
+gtrk ai-drama lay --project "<工程>" --desk-project <项目id> --json
 
-# ⑤⑥⑦ 字卡 → BGM → 字幕
+# ⑤ 全局抽帧检查（位次 ④）：底轨落齐后对字卡挂点与版式窗口抽帧（gtrk client frame --at <轨秒>），快速成片不另停
+# ⑥ 字幕
+gtrk subtitle lay --project "<工程>" --style <样式> --color <色> --json
+# ⑦ 精剪包装：见下方引注
+# ⑧ 字卡（叠层；先 gtrk mg status 看 todo，被合成接管的不产；满屏卡已在 ⑦ 随合成做完）
 gtrk mg --project "<工程>" --json
+# ⑨ BGM（不受顺序约束）
 # --beat-align 的高潮点取自 split.beats 的 narrative / container_stage（升华段 → 容器转折 → 回扣段）；
 # 拆分稿没带这两个字段 ⇒ 落 0.75×全片兜底档，**CLI 会明示那是猜的**。不接受就用 --climax <轨秒> 指定。
 # 两侧都够长时零平铺（恰好 1 个 clip）；不够长才按小节线平铺补齐、接缝吸附 downbeat。
 gtrk audio lay --project "<工程>" --file "<bgm>" --volume 0.1 --beat-align --json
-gtrk subtitle lay --project "<工程>" --style <样式> --color <色> --json
-# 精剪包装：见下方引注
 ```
 
-> **精剪包装（字幕之后、出片之前）**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片 auto ≤ 25% → 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。配音片没有讲者，合成只用 B-roll 与排版。
+> **⑦ 精剪包装（字幕之后、字卡之前）**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片取拆分稿的版式窗口 `--mode split`（拆分稿没有 `layouts` 键才 `auto` ≤ 25%）→ 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。配音片没有讲者，合成只用 B-roll 与排版；满屏卡（零槽位窗口）随这一步做。用户说了不要合成包装时，没有底画面的旁白段别留黑场：拆分时改派 B-roll（或问一句满屏卡要不要留）。
 
 > **停顿太长时**：自训音色加 `--fragment-interval 0.2`（合成时就对）；云引擎音色**不支持**该参数（传了会报错，不会静默忽略），改在合成后跑 `gtrk audio tighten --project <工程>` 收紧句间停顿（纯本地零计费；只压跨句界的停顿，句内换气与原声引用段不动）。
 
-配方口径（mark-weight 0.3 / BGM 0.10 宁低勿高 / gap-fill fast / 句界吸附缺省）与旅拍图纸 §五 同源，引用不复制。派单车道按内容走（FILM_BROLL 为主，可派 MG / AI 情景动画——AI 情景动画描述稿走 `/gtrk-ai-drama`，外部平台出片手动回铺）。
+配方口径（mark-weight 0.3 / BGM 0.10 宁低勿高 / gap-fill fast / 句界吸附缺省）与旅拍图纸 §五 同源，引用不复制。派单车道按内容走（FILM_BROLL 为主，可派 MG / AI 情景动画——AI 情景动画描述稿走 `/gtrk-ai-drama`，外部平台出片后 `gtrk ai-drama lay` 回填，没有标准导出包的平台才手动回铺）。
 
 ## 三、检查点①（必停一次）
 
-稿件全文 + **前六秒方案**（公约 §三⁗ 执行文本，引用不复制：钩子文案三候选各一行 + 画面层 A_ROLL / MG 字卡 / 拼贴或 AI 片段三选一 + 字卡节奏；只改开口方式、MUST NOT 改动用户的事实与数据；答「开场照原样」= 零动作、后续不再提；先给自持方案，再一句轻提「要更多变体也可以看第三方钩子 skill」，推荐面 §三‴ 的 `hook` 场景、不列名）+ 画幅 + 音色（试听）+ BGM（试听）+ 字幕样式，一屏给齐一次拍板。改稿在这站改到满意——配音之前全部免费。拍了 MG 字卡 ⇒ §二 ④ 拆分稿里开场 beat 的 MG `handoff.theme` 写 `"opening-hook｜屏字：<拍板文案>"`；拍了拼贴或 AI 片段 ⇒ 开场 beat 派 AI_DRAMA；拍了 A_ROLL ⇒ 开场不派辅助层。
+稿件全文 + **前六秒方案**（公约 §三⁗ 执行文本，引用不复制：钩子文案三候选各一行 + 画面层 A_ROLL / MG 字卡 / 拼贴或 AI 片段三选一 + 字卡节奏；只改开口方式、MUST NOT 改动用户的事实与数据；答「开场照原样」= 零动作、后续不再提；先给自持方案，再一句轻提「要更多变体也可以看第三方钩子 skill」，推荐面 §三‴ 的 `hook` 场景、不列名）+ 画幅 + 音色（试听）+ BGM（试听）+ 字幕样式，一屏给齐一次拍板。改稿在这站改到满意——配音之前全部免费。拍了 MG 字卡 ⇒ 配音片开场没有底画面，这张字卡就是满屏卡：§二 ④ 拆分稿开一个盖住开场 beat 的零槽位版式窗口（`zero_slot: true`、`theme` 写 `"opening-hook｜屏字：<拍板文案>"`、给 `bg`，开场 beat 派 `A_ROLL`），由精剪包装来做；拍了拼贴 ⇒ §二 ④ 拆分稿开一个盖住开场 beat 的**版式窗口**（开场 beat 照派 FILM_BROLL 取素材，`visual_brief` 写怎么拼），由精剪包装来做；拍了 AI 片段 ⇒ 开场 beat 派 `AI_DRAMA`；拍了 A_ROLL ⇒ 开场不派辅助层。
 
 ## 四、MG 风格（公约 §三 执行文本）
 
@@ -81,7 +89,7 @@ gtrk subtitle lay --project "<工程>" --style <样式> --color <色> --json
 | 模式 | 停点 |
 |---|---|
 | **快速成片**（默认） | 开工五问 → 检查点①（必停一次）→ 一杆到底（含精剪包装，合成静帧随交付一次给） |
-| **逐步推进** | 每步停等确认（稿 / 拆分稿 / 候选画面 / 字卡 / BGM / 字幕逐项 / 精剪包装按合成 skill 两个检查点） |
+| **逐步推进** | 每步停等确认（稿 / 拆分稿含版式窗口 / 候选画面 / 抽帧检查 / 字幕 / 精剪包装按合成 skill 两个检查点 / 字卡 / BGM 逐项） |
 
 ## 六、计费与排错