@gitruck/cli 1.3.6 → 1.3.8

package/skills/gtrk-talking-head/SKILL.md

@@ -5,7 +5,7 @@ description: 通用口播视频创作图纸（口播链）——把一条或一
 
 # gtrk-talking-head（通用口播 · 组合成片图纸）
 
-把**真人出镜的口播毛片**（一条或一组）变成**完整包装的可出片工程**：双轨换声 → 拼段 → 粗剪 → 检查点① → 拆分 → B-roll → 字卡 → BGM → 字幕 →（可选）合成 → 客户端出片。
+把**真人出镜的口播毛片**（一条或一组）变成**完整包装的可出片工程**：双轨换声 → 拼段 → 粗剪 → 检查点① → 拆分 → B-roll → 字卡 → BGM → 字幕 → 精剪包装（合成）→ 客户端出片。
 
 > **定位**：第四张 **structure 级组合图纸**。本图纸自身不新增命令，只编排零件（audio align / oralcut / split / matrix / mg / audio lay / subtitle lay——其中对轨零件 `gtrk audio align` 与本图纸同批交付）。零件参数细节以各自 skill（`/gtrk-oralcut`、`/gtrk-splitter`、`/gtrk-matrix`、`/gtrk-mg`）与 `--help` 为准，**本图纸引用不复制**；编排次序、检查点、双轨与多段规约以本图纸为准。**CLI 是手，你是脑。**
 
@@ -35,6 +35,8 @@ description: 通用口播视频创作图纸（口播链）——把一条或一
 
 > **推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。
 
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+
 ## 二、双轨收音：对轨 → 换轨（本图纸最大的新东西）
 
 真实口播几乎都是**双轨收音**：相机内录只是参考声，领夹麦/录音笔的外录才是成片要用的。而粗剪链吃的是视频文件里的音轨 ⇒ **先把外录换进去，转写和成片就都是外录声**。
@@ -151,7 +153,7 @@ gtrk oralcut "<inputs/…_full.mp4>" --lang zh-CN [--script 稿.txt] [--preset c
 ```
 gtrk split（投影 → 你写拆分稿 → 落地）→ gtrk matrix（按⑤走或跳过）
 → 全局抽帧检查构图 → gtrk mg（字卡，§六风格）→ gtrk audio lay（BGM，-20dB 口径）
-→ gtrk subtitle lay（检查点①拍板样式）→（可选）合成 → 客户端打开出片
+→ gtrk subtitle lay（检查点①拍板样式）→ 精剪包装（§五′）→ 客户端打开出片
 ```
 
 拆分稿写完自查两条：
@@ -159,13 +161,13 @@ gtrk split（投影 → 你写拆分稿 → 落地）→ gtrk matrix（按⑤走
 - **字卡要产颗粒的，aux 必须用 `type:"overlay"` + handoff（含 duration_hint）**——`quote-card` 等
   前七类 aux 只是语义标注、**不产派单**；需要颗粒的字卡必须用 `type:"overlay"` + handoff。
 
-### 五′、合成（可选，字幕之后）
+### 五′、精剪包装（字幕之后、出片之前）
 
-字幕上完、出片之前，可以把一些时间窗做成**合成**（一段时间内的整个画面由一颗代码颗粒接管：逐句换画面、对照并排、并列卡片、字幕排版，讲者与 B-roll 作为槽位画进去）。既有步骤的顺序不变，这一步只加在最后：
+字幕上完、出片之前，把适合的时间窗做成**合成**（一段时间内的整个画面由一颗代码颗粒接管：逐句换画面、对照并排、并列卡片、字幕排版，讲者与 B-roll 作为槽位画进去）。既有步骤的顺序不变，这一步加在最后：
 
-- **快速成片缺省不做**；开工问询也不为它加问题。用户提到「包装 / 合成 / 画中画拼贴 / 逐句换画面」时，问一次要不要做。
-- 要做就**交棒 `/gtrk-composite`**，由它管入口（整片铺满 / AI 判定 / 指定区间）与两个检查点；本图纸不复述它的规则。
-- ⚠️ 合成颗粒出片靠本机烘焙（`/gtrk-composite` 的「出片：烘焙」一节）：首次要装烘焙浏览器（约 110 MB，征得同意再装）；某颗烘焙失败时导出该段按粗剪出画——用户要交付成片时先说清。
+- 交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片 auto ≤ 25% → 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。
+- 用户中途说「整片做一下合成」「11 秒到 32 秒做一个」时，入口按 `/gtrk-composite` 的三选一走，不受快速成片口径限制。
+- ⚠️ 合成颗粒出片靠本机烘焙（`/gtrk-composite` 的「出片：烘焙」一节）；某颗烘焙失败时导出该段按粗剪出画——回执里点名。
 
 ## 六、MG 风格：内容驱动的临场泛化（成片型图纸通用条款）
 
@@ -190,8 +192,8 @@ gtrk split（投影 → 你写拆分稿 → 落地）→ gtrk matrix（按⑤走
 
 | 模式 | 停点 |
 |---|---|
-| **快速成片** | 开工五问 → 检查点①（§四，必停一次）→ 一杆到底（含 SOP 既有的「B-roll 铺完抽帧检查」，归入快速语义不再单独打扰用户） |
-| **逐步推进模式** | 每步停：对齐/拼段确认 → 粗剪回执 → 拆分稿 → B-roll 候选 → 字卡 → BGM/字幕逐项确认 |
+| **快速成片** | 开工五问 → 检查点①（§四，必停一次）→ 一杆到底（含 SOP 既有的「B-roll 铺完抽帧检查」与精剪包装，归入快速语义不再单独打扰用户；合成静帧随交付一次给） |
+| **逐步推进模式** | 每步停：对齐/拼段确认 → 粗剪回执 → 拆分稿 → B-roll 候选 → 字卡 → BGM/字幕逐项确认 → 精剪包装（合成 skill 两个检查点） |
 
 双轨低置信度兜底（§二）在两种模式下都会停——那是数据正确性问题，不归模式管。
 

package/skills/gtrk-tools/SKILL.md

@@ -16,7 +16,7 @@ description: gtrk 单点工具与媒体转换能力的调用向导，覆盖 `gtr
 | 工具名 | 触发语（用户可能怎么说） | 输入要求 | 产物形态 | 计费 | 可用状态 |
 |---|---|---|---|---|---|
 | `image_move` | 「把这张图做成运镜视频 / 让图动起来 / 图转视频 / 往右推镜 / 拉远」 | 单张图片；可选 `--motion` 指定 26 种运镜之一（见下文枚举表） | 运镜视频 | 运行前实时查询 | 已上线 |
-| `image_matting` | 「给图片抠像 / 抠出主体 / 去背景 / 出透明 png」 | 单张图片 | 透明背景 png | 运行前实时查询 | 已上线 |
+| `image_matting` | 「给图片抠像 / 抠出主体 / 去背景 / 出透明 png」 | 单张图片（带 EXIF 方向的手机照片自动摆正后上传） | 透明背景 png | 运行前实时查询 | 已上线 |
 | `image_blackborder_remove` | 「图片去黑边 / 裁掉四周黑边 / 保留有效画面」 | 单张本地图片 | 去黑边图片 | 运行前实时查询 | 已上线 |
 | `image_canvas_adapt` | 「图片比例转换 / 调整画布尺寸 / 转成矩形或方形裁剪」 | 单张本地图片；模式只支持 `normal` / `rectangle` / `square` | 比例适配图片 | 运行前实时查询 | 已上线 |
 | `image_purify` | 「清理我有权处理的图片水印 / 去掉 Logo 或叠加元素 / 图片净化 / 按我圈的框去掉台标」 | 单张本地图片（仅处理你有权处理的素材）；可选按框直接去除 | 净化图片 | 运行前实时查询 | 已上线 |

package/skills/gtrk-transcript/SKILL.md

@@ -17,8 +17,8 @@ description: 将用户本地视频或音频（自备配音）转成一个飞书
 
 ## 硬边界
 
-> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：唯一 Markdown 产物写入 CLI 返回的 `output` 路径（缺省=源文件同目录）或用户指定的 `--out`；引用媒体用原路径，不复制到 agent 工作目录；临时文件放系统 temp，用完即删。
-> 交付物 MUST NOT 先写 agent 自有目录再拷进工程；中转本身即违规，体积不是豁免理由。
+> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：唯一 Markdown 产物写入 CLI 返回的 `output` 路径（缺省=源文件同目录）或用户指定的 `--out`；引用媒体用原路径，不复制到 agent 工作目录；临时文件放系统 temp，用完即删。
+> 交付物 MUST NOT 先写 agent 自有目录再拷进工程；中转本身即违规，体积不是豁免理由。
 
 - 只接收用户电脑上已存在的视频/音频文件；遇到 URL、平台视频 ID 或“帮我下载后转写”时，要求用户先提供本地文件，不代为抓取。
 - CLI 在本地抽取/转码 16 kHz 单声道音频，只上传音频衍生物；原视频/原音频文件不得上传。
@@ -32,7 +32,7 @@ description: 将用户本地视频或音频（自备配音）转成一个飞书
 
 2. **先判用途，再决定带不带 `--json`。这一步 MUST NOT 跳过，也 MUST NOT 无脑恒带。**
 
-   `--json` 不是单纯的输出格式开关，**它决定服务端用哪个引擎**：
+   `--json` 不是单纯的输出格式开关，**它决定服务端用哪个引擎**：
 
    | 用途 | 命令 | 落腿 |
    |---|---|---|
@@ -49,7 +49,7 @@ description: 将用户本地视频或音频（自备配音）转成一个飞书
 
    可选参数：`--out <file>`、`--lang zh-CN`、`--ffmpeg-path <dir>`、`--reupload`。
 
-   > 🔴 **恒带 `--json` 会把只想要文字稿的请求也送进厂商字级腿**，且 Markdown 不消费 `words[]`。**拿不准就不带**：真需要字级时，消费方（`split` / `subtitle`）
+   > 🔴 **恒带 `--json` 会把只想要文字稿的请求也送进厂商字级腿**，且 Markdown 不消费 `words[]`。**拿不准就不带**：真需要字级时，消费方（`split` / `subtitle`）
    > 会明确报错要 `words[]`，那时补跑一次即可；反过来多付的钱收不回来。
    > 用户明确说「要建工程 / 要拆分 / 要字幕」才算「喂工程」；只说「转个文字稿」不算。
 

package/skills/gtrk-transcript/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "视频转文字稿"
-  short_description: "将本地视频整理为带总结与时间戳的单一 Markdown"
-  default_prompt: "Use $gtrk-transcript to turn my local video into one Markdown transcript with an Agent-written summary."
+interface:
+  display_name: "视频转文字稿"
+  short_description: "将本地视频整理为带总结与时间戳的单一 Markdown"
+  default_prompt: "Use $gtrk-transcript to turn my local video into one Markdown transcript with an Agent-written summary."

package/skills/gtrk-travel-recap/SKILL.md

@@ -45,6 +45,8 @@ description: 旅拍解说一站式成片图纸——输入一个旅拍素材文
 
 > **推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。
 
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+
 ## 一′、素材适配闸（写稿前必过）
 
 > 本闸判的是题材，与「有无自带时序」正交。剧情短片、摆拍表演和单一室内场景不能直接套用旅拍要素层。
@@ -88,6 +90,7 @@ description: 旅拍解说一站式成片图纸——输入一个旅拍素材文
 ⑨ MG 字卡     按 §六 轻量规约产颗粒 → mg lint → gtrk mg --project
 ⑩ BGM        gtrk audio lay --volume 0.1 --beat-align（-20dB 口径）
 ⑪ 字幕        gtrk subtitle lay --style <检查点①拍板样式>（用户没选用 default）
+⑪′ 精剪包装   交棒 /gtrk-composite（公约 §三⁵：auto ≤ 25% → 复核 → 构建机检 → 铺轨烘焙，不停）
 ⑫ 交付        客户端打开工程出片（gtrk render 仅主轨快照预览，见 §八）
 ```
 
@@ -298,8 +301,12 @@ gtrk audio lay --project "<工程目录>" --file "<bgm>" --volume 0.1 --beat-ali
 
 # ⑪ 字幕（样式/颜色 = 检查点①拍板值；用户没选用 default/雅黑；零计费——拆行走云端 subtitle_line_split 0 积分留痕，离线可加 --offline 用本地拆窗、重跑幂等替换）
 gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --json
+
+# ⑪′ 精剪包装：见下方引注
 ```
 
+> **⑪′ 精剪包装**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片 auto ≤ 25% → 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。旅拍主画面多是素材本身，按「没有讲者」口径只用 B-roll 与排版。
+
 > **停顿太长时**：自训音色加 `--fragment-interval 0.2`（合成时就对）；云引擎音色**不支持**该参数（传了会报错，不会静默忽略），改在合成后跑 `gtrk audio tighten --project <工程>` 收紧句间停顿（纯本地零计费；只压跨句界的停顿，句内换气与原声引用段不动）。
 
 **配方级参数口径**：
@@ -352,6 +359,7 @@ gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --js
 | 字卡 | mg/*.html | 改颗粒 HTML | `gtrk mg --project --only <beatId>` 单颗重铺 |
 | BGM | audio_track | 换歌/换音量 | `gtrk audio lay` 同文件幂等替换 |
 | 字幕 | cve 字幕 lane | 换样式/颜色 | `gtrk subtitle lay --style/--color` 重跑幂等替换（手加 text 不受影响）；逐条微调在客户端 |
+| 精剪包装 | `composite/plan.md` + 合成颗粒 | 不要某颗 / 补一段 | 客户端关合成轨可见或删那一颗；补做走 `/gtrk-composite` 指定区间（`plan --range`） |
 
 改口播轨后 matrix/mg 消费侧自带现场重投影，无需回跑 split。
 

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

@@ -62,6 +62,8 @@ gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素
 
 **MUST NOT 执行任何网络下载**：素材从哪来归用户（版权责任边界）。
 
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+
 ### 1.1 配比档位识别（本类型独有的第一决策）
 
 先听素材里有没有可用的同期声，再定档——**档位决定写多少稿、TTS 花多少钱、成片什么质感**：
@@ -91,6 +93,7 @@ gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素
 ⑩ 字幕层      吐槽/观察/进度/梗卡进 MG 派单（§六）→ mg lint → mg --project
 ⑪ BGM         gtrk audio lay --volume 0.1 --beat-align（-20dB 口径）
 ⑫ 字幕        gtrk subtitle lay --style <拍板样式>
+⑫′ 精剪包装   交棒 /gtrk-composite（公约 §三⁵：auto ≤ 25% → 复核 → 构建机检 → 铺轨烘焙，不停）
 ⑬ 交付        客户端打开工程出片
 ```
 
@@ -282,8 +285,12 @@ gtrk audio lay --project "<工程目录>" --file "<bgm>" --volume 0.1 --beat-ali
 
 # ⑫ 字幕
 gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --json
+
+# ⑫′ 精剪包装：见下方引注
 ```
 
+> **⑫′ 精剪包装**：交棒 `/gtrk-composite` 做**精剪包装**（公约 §三⁵：快速成片 auto ≤ 25% → 逐窗口复核 → 构建机检 → 铺轨烘焙，不停；回执列「做了 / 建议了没做 / 烘焙结果」；逐步推进按合成 skill 两个检查点停；开工时用户说了不要就跳过）。现场段有真人出镜时按讲者口径编排，旁白段按「没有讲者」口径只用 B-roll 与排版。
+
 > **停顿太长时**：自训音色加 `--fragment-interval 0.2`（合成时就对）；云引擎音色**不支持**该参数（传了会报错，不会静默忽略），改在合成后跑 `gtrk audio tighten --project <工程>` 收紧句间停顿（纯本地零计费；只压跨句界的停顿，句内换气与原声引用段不动）。
 
 **配方级参数口径**：
@@ -321,6 +328,7 @@ gtrk subtitle lay --project "<工程目录>" --style default --color 雅黑 --js
 | 字卡 | 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` |
 
 ## 八、交付与出片
 

package/skills/gtrk-voiceover/SKILL.md

@@ -28,6 +28,8 @@ description: 通用配音视频创作图纸（配音链快速成片预设）—
 
 一张表一次问完；**未经检查点①确认 MUST NOT 发起 TTS 计费动作**。
 
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
+
 > **推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。
 
 ## 二、快速成片编排
@@ -57,8 +59,11 @@ gtrk mg --project "<工程>" --json
 # 两侧都够长时零平铺（恰好 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 与排版。
+
 > **停顿太长时**：自训音色加 `--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`，外部平台出片手动回铺）。
@@ -75,8 +80,8 @@ gtrk subtitle lay --project "<工程>" --style <样式> --color <色> --json
 
 | 模式 | 停点 |
 |---|---|
-| **快速成片**（默认） | 开工五问 → 检查点①（必停一次）→ 一杆到底 |
-| **逐步推进** | 每步停等确认（稿 / 拆分稿 / 候选画面 / 字卡 / BGM / 字幕逐项） |
+| **快速成片**（默认） | 开工五问 → 检查点①（必停一次）→ 一杆到底（含精剪包装，合成静帧随交付一次给） |
+| **逐步推进** | 每步停等确认（稿 / 拆分稿 / 候选画面 / 字卡 / BGM / 字幕逐项 / 精剪包装按合成 skill 两个检查点） |
 
 ## 六、计费与排错