@gitruck/cli 1.3.4 → 1.3.5

package/skills/gtrk-cover/references/prompt-templates.md

@@ -1,119 +1,119 @@
-# 文生图 Prompt 模板（框架版）
-
-**铁律**：
-- **不**在 Prompt 里要求生图模型渲染中文字。汉字由**阶段二的 H5 工作台**贴字（用户用浏览器交互完成），图里**只留"气息性的软留白"**——不必做硬留白约束。
-- 总是输出**英文主版 + 中文辅版**两套。
-- 三种尺寸（16:9 / 4:3 / 3:4）**各出一套**，构图差异显式化：
-  - **16:9**：横版，主体居中，两侧有气息的空间
-  - **4:3**：横版饱满，主体可以顶到三边，对角留气口
-  - **3:4**：竖版，主体在中段，上下舒展，便于"上下分飞"排字
-- 每套 Prompt 各占一段，不要三尺寸塞一个段落。
-- 每套都塞满"风格锚点 + 色板 + 材质"三件套，不要只写主体。
-
-**风格注入槽位**：框架对审美零预设，风格三件套里的「风格」与「材质」是两个注入槽位，值由**栏目封面风格资产**供给；无资产时用中性默认值。
-
-| 槽位 | 含义 | 中性默认值 | 栏目资产供值示例（示例、非默认） |
-|---|---|---|---|
-| 【风格锚点 A】 | 画风定调串 | cinematic illustration, clean composition | anime illustration style, 2D cel-shaded |
-| 【材质串 T】 | 质感/印刷肌理串 | subtle film grain | film grain, paper texture, halftone dots |
-
----
-
-## 英文主版骨架（Midjourney / SD / Flux / Nano Banana）
-
-```
-[主体 S 描写], [容器意象 C 融合描写], [情绪氛围 M],
-【风格锚点 A】,
-[光线 L], [镜头 Cam], [色板 P],
-【材质串 T】,
-composition: [留字位描述 R],
-negative: photorealistic face, 3D render, glossy skin, ugly anatomy, watermark, text, chinese characters, blurry
---ar [比例] --style raw --stylize 250
-```
-
-（负面提示里与画风相斥的项目也随栏目资产调整，如写实系栏目不排除 photorealistic。）
-
-### 槽位填法
-
-| 槽位 | 填法 | 范例 |
-|---|---|---|
-| S | 角色外形 + 表情 + 姿态；或抽象意象描写 | a solitary young woman with silver hair, downcast eyes, wearing a dark coat / a lone astronaut silhouette |
-| C | 容器意象的视觉化，叠在主体身上/周围 | overlaid with translucent neural network patterns glitching / surrounded by colliding light particles forming a supernova |
-| M | 情绪形容 | quiet despair yet faint hope, suffocating tenderness, cold clinical detachment |
-| L | 光线 | rim light from behind, single hard light from upper left, god rays through dust |
-| Cam | 镜头 | close-up portrait, medium shot, wide cinematic shot, dutch angle |
-| P | 色板（由栏目风格资产的色板表供英译） | 见下「色板英译」 |
-| R | 留字位 | 软建议而非硬约束。例如 "edges with softer visual weight for typography overlay" / "central subject with breathing room on sides" |
-| 比例 | --ar 参数 | `--ar 16:9` / `--ar 4:3` / `--ar 3:4` |
-
-### 色板英译
-
-色板英译由**栏目风格资产的色板表自带**（每个色板代号配一条英文描述串）；无资产时用中性描述（如 muted cool palette with a single warm accent）。格式示例：
-
-```
-| 代号 | 英文描述 |
-|---|---|
-| P-x | steel blue and bone white, single warm amber accent |
-```
-
-### 完整范例（16:9，"过拟合"主题）——某栏目实例（风格锚点/色板为该栏目资产值）
-
-```
-a lone young woman gazing away, her silhouette gradually dissolving into 
-translucent glitching neural network lines, looping patterns repeating 
-over her shoulders and hair, quiet despair with a distant trace of 
-awakening, anime illustration style, 2D cel-shaded with thick line 
-art, rim light from behind suggesting hidden warmth, medium close-up 
-slightly off-center, steel blue and bone white palette with a single 
-amber accent, film grain, paper texture, halftone noise on background,
-composition: subject centered with breathing room on both sides, 
-edges with softer visual weight so typography can overlay later,
-negative: photorealistic face, 3D render, glossy skin, ugly anatomy, 
-watermark, text, chinese characters, blurry, extra fingers, deformed hand
---ar 16:9 --style raw --stylize 250
-```
-
----
-
-## 中文辅版骨架（即梦 / 可灵 / 通义万相 / 文心）
-
-中文模型对自然语言段落式 Prompt 响应更好，不要生搬英文结构。
-
-```
-【画面主体】一位/一件/一个……，[外形 + 神态 + 姿势]。
-【容器意象】画面中融合 [容器的视觉化描述]，与主体叠压 / 环绕 / 映射在背景。
-【情绪氛围】整体气氛 [情绪形容]。
-【风格】[风格锚点 A 的中文表述]，不要真人写真，不要 3D 渲染（排除项随栏目画风调整）。
-【光线】[光线描述]。
-【镜头】[镜头角度与景别]。
-【色彩】主色 [主色]，辅色 [辅色]，点缀 [强调色]（取值由栏目色板表供给）。
-【质感】[材质串 T 的中文表述]。
-【构图】主体 [位置]；[明确留白区域]，该区域绝对不要出现任何元素。
-【排除】不要文字，不要中文字符，不要水印，不要 3D 光泽皮肤，不要多余手指。
-【比例】[16:9 / 4:3 / 3:4]。
-```
-
----
-
-## 模型差异化调参
-
-| 平台 | 独有参数 / 注意事项 |
-|---|---|
-| Midjourney v7 | 加 `--style raw --stylize 150~400`；需要一致风格时加 `--sref <URL>` 引用一张基准图 |
-| Flux.1 (dev/pro) | 去掉 `--ar` 用 `aspect ratio: 16:9` 自然语言；风格锚点要更具体 |
-| Stable Diffusion XL | 用 `(keyword:1.3)` 给权重；负面提示单独输入 |
-| Nano Banana | 接受长段描述，可直接贴中文辅版；支持参考图输入 |
-| 即梦 / 可灵 | 参考图 + 中文辅版效果最佳，英文 Prompt 表现弱 |
-| 通义万相 | 对"不要 XX"这类排除描述响应很好，用中文辅版 |
-
----
-
-## 常见 Prompt 失败与补救
-
-| 症状 | 补救 |
-|---|---|
-| 模型硬要画中文字，全是乱码 | 负面提示加 `text, chinese characters, letters, signs`，主提示加 `no text, empty space for text overlay` |
-| 脸的质感偏离栏目画风（如插画系被画成真人磨皮） | 主提示前置栏目的【风格锚点 A】并显式排除对立画风（如 `NOT photorealistic`）；负面加对立项（如 `3D render, photograph, realistic skin`） |
-| 主体被容器意象吞掉，看不清 | 调整描述比例："subject clearly visible, container motif as translucent overlay at 30% opacity" |
-| 太满没留字位 | 显式写 "composition: LEFT THIRD completely empty, solid color, no elements"；可先用构图图参考（scribble / sketch）约束 |
-| 色板没出效果 | 把色板 HEX 值写进 Prompt：`dominant colors #XXXXXX and #XXXXXX`；或附参考色板图。精确色 token 由栏目风格资产自带，写进 Prompt 用 HEX |
+# 文生图 Prompt 模板（框架版）
+
+**铁律**：
+- **不**在 Prompt 里要求生图模型渲染中文字。汉字由**阶段二的 H5 工作台**贴字（用户用浏览器交互完成），图里**只留"气息性的软留白"**——不必做硬留白约束。
+- 总是输出**英文主版 + 中文辅版**两套。
+- 三种尺寸（16:9 / 4:3 / 3:4）**各出一套**，构图差异显式化：
+  - **16:9**：横版，主体居中，两侧有气息的空间
+  - **4:3**：横版饱满，主体可以顶到三边，对角留气口
+  - **3:4**：竖版，主体在中段，上下舒展，便于"上下分飞"排字
+- 每套 Prompt 各占一段，不要三尺寸塞一个段落。
+- 每套都塞满"风格锚点 + 色板 + 材质"三件套，不要只写主体。
+
+**风格注入槽位**：框架对审美零预设，风格三件套里的「风格」与「材质」是两个注入槽位，值由**栏目封面风格资产**供给；无资产时用中性默认值。
+
+| 槽位 | 含义 | 中性默认值 | 栏目资产供值示例（示例、非默认） |
+|---|---|---|---|
+| 【风格锚点 A】 | 画风定调串 | cinematic illustration, clean composition | anime illustration style, 2D cel-shaded |
+| 【材质串 T】 | 质感/印刷肌理串 | subtle film grain | film grain, paper texture, halftone dots |
+
+---
+
+## 英文主版骨架（Midjourney / SD / Flux / Nano Banana）
+
+```
+[主体 S 描写], [容器意象 C 融合描写], [情绪氛围 M],
+【风格锚点 A】,
+[光线 L], [镜头 Cam], [色板 P],
+【材质串 T】,
+composition: [留字位描述 R],
+negative: photorealistic face, 3D render, glossy skin, ugly anatomy, watermark, text, chinese characters, blurry
+--ar [比例] --style raw --stylize 250
+```
+
+（负面提示里与画风相斥的项目也随栏目资产调整，如写实系栏目不排除 photorealistic。）
+
+### 槽位填法
+
+| 槽位 | 填法 | 范例 |
+|---|---|---|
+| S | 角色外形 + 表情 + 姿态；或抽象意象描写 | a solitary young woman with silver hair, downcast eyes, wearing a dark coat / a lone astronaut silhouette |
+| C | 容器意象的视觉化，叠在主体身上/周围 | overlaid with translucent neural network patterns glitching / surrounded by colliding light particles forming a supernova |
+| M | 情绪形容 | quiet despair yet faint hope, suffocating tenderness, cold clinical detachment |
+| L | 光线 | rim light from behind, single hard light from upper left, god rays through dust |
+| Cam | 镜头 | close-up portrait, medium shot, wide cinematic shot, dutch angle |
+| P | 色板（由栏目风格资产的色板表供英译） | 见下「色板英译」 |
+| R | 留字位 | 软建议而非硬约束。例如 "edges with softer visual weight for typography overlay" / "central subject with breathing room on sides" |
+| 比例 | --ar 参数 | `--ar 16:9` / `--ar 4:3` / `--ar 3:4` |
+
+### 色板英译
+
+色板英译由**栏目风格资产的色板表自带**（每个色板代号配一条英文描述串）；无资产时用中性描述（如 muted cool palette with a single warm accent）。格式示例：
+
+```
+| 代号 | 英文描述 |
+|---|---|
+| P-x | steel blue and bone white, single warm amber accent |
+```
+
+### 完整范例（16:9，"过拟合"主题）——某栏目实例（风格锚点/色板为该栏目资产值）
+
+```
+a lone young woman gazing away, her silhouette gradually dissolving into 
+translucent glitching neural network lines, looping patterns repeating 
+over her shoulders and hair, quiet despair with a distant trace of 
+awakening, anime illustration style, 2D cel-shaded with thick line 
+art, rim light from behind suggesting hidden warmth, medium close-up 
+slightly off-center, steel blue and bone white palette with a single 
+amber accent, film grain, paper texture, halftone noise on background,
+composition: subject centered with breathing room on both sides, 
+edges with softer visual weight so typography can overlay later,
+negative: photorealistic face, 3D render, glossy skin, ugly anatomy, 
+watermark, text, chinese characters, blurry, extra fingers, deformed hand
+--ar 16:9 --style raw --stylize 250
+```
+
+---
+
+## 中文辅版骨架（即梦 / 可灵 / 通义万相 / 文心）
+
+中文模型对自然语言段落式 Prompt 响应更好，不要生搬英文结构。
+
+```
+【画面主体】一位/一件/一个……，[外形 + 神态 + 姿势]。
+【容器意象】画面中融合 [容器的视觉化描述]，与主体叠压 / 环绕 / 映射在背景。
+【情绪氛围】整体气氛 [情绪形容]。
+【风格】[风格锚点 A 的中文表述]，不要真人写真，不要 3D 渲染（排除项随栏目画风调整）。
+【光线】[光线描述]。
+【镜头】[镜头角度与景别]。
+【色彩】主色 [主色]，辅色 [辅色]，点缀 [强调色]（取值由栏目色板表供给）。
+【质感】[材质串 T 的中文表述]。
+【构图】主体 [位置]；[明确留白区域]，该区域绝对不要出现任何元素。
+【排除】不要文字，不要中文字符，不要水印，不要 3D 光泽皮肤，不要多余手指。
+【比例】[16:9 / 4:3 / 3:4]。
+```
+
+---
+
+## 模型差异化调参
+
+| 平台 | 独有参数 / 注意事项 |
+|---|---|
+| Midjourney v7 | 加 `--style raw --stylize 150~400`；需要一致风格时加 `--sref <URL>` 引用一张基准图 |
+| Flux.1 (dev/pro) | 去掉 `--ar` 用 `aspect ratio: 16:9` 自然语言；风格锚点要更具体 |
+| Stable Diffusion XL | 用 `(keyword:1.3)` 给权重；负面提示单独输入 |
+| Nano Banana | 接受长段描述，可直接贴中文辅版；支持参考图输入 |
+| 即梦 / 可灵 | 参考图 + 中文辅版效果最佳，英文 Prompt 表现弱 |
+| 通义万相 | 对"不要 XX"这类排除描述响应很好，用中文辅版 |
+
+---
+
+## 常见 Prompt 失败与补救
+
+| 症状 | 补救 |
+|---|---|
+| 模型硬要画中文字，全是乱码 | 负面提示加 `text, chinese characters, letters, signs`，主提示加 `no text, empty space for text overlay` |
+| 脸的质感偏离栏目画风（如插画系被画成真人磨皮） | 主提示前置栏目的【风格锚点 A】并显式排除对立画风（如 `NOT photorealistic`）；负面加对立项（如 `3D render, photograph, realistic skin`） |
+| 主体被容器意象吞掉，看不清 | 调整描述比例："subject clearly visible, container motif as translucent overlay at 30% opacity" |
+| 太满没留字位 | 显式写 "composition: LEFT THIRD completely empty, solid color, no elements"；可先用构图图参考（scribble / sketch）约束 |
+| 色板没出效果 | 把色板 HEX 值写进 Prompt：`dominant colors #XXXXXX and #XXXXXX`；或附参考色板图。精确色 token 由栏目风格资产自带，写进 Prompt 用 HEX |

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

@@ -17,9 +17,9 @@ description: 美食解说垂类图纸（解说链示例）——把探店/密着
 | 形态 | 输入 | 时序档位（正本 §三） |
 |---|---|---|
 | **探店 · 密着** | 一条纪实长片（二创；带字幕文件的直接当台词锚，无则转写）或自拍探店素材夹 | 软窗档缺省：进店→点单→出品→吃→人的故事，流程线单调、允许蒙太奇跳 |
-| **做饭流程** | 一条做饭记录或素材夹 | 软窗档且**步骤线忠实**：工序 MUST NOT 乱序重排 |
+| **做饭流程** | 一条做饭记录或素材夹 | 软窗档且**步骤线忠实**：工序 MUST NOT 乱序重排 |
 
-稿源与声音基座随正本开工问询（AI 代写/自备稿；TTS/自己念）。**推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。**MUST NOT 执行任何网络下载**；二创长片是第三方作品，版权与平台二创规则责任归用户。
+稿源与声音基座随正本开工问询（AI 代写/自备稿；TTS/自己念）。**推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。**MUST NOT 执行任何网络下载**；二创长片是第三方作品，版权与平台二创规则责任归用户。
 
 ## 二、美食要素层（写稿规约，叠在通用框架层之上）
 
@@ -32,12 +32,12 @@ description: 美食解说垂类图纸（解说链示例）——把探店/密着
   禁拟声堆砌与「入口即化」式空转（文风铁律照打）；
 - **数字如实**：分量/价格/营业时间只用素材里可见可听的，MUST NOT 编造；
   **时效丑话**：价格与营业信息随拍摄时点变动，成片引用时提醒用户自行核对；
-- **背景检索建议**（旅拍 §三 通用框架层同款）：对店名/地段/菜系关键词
+- **背景检索建议**（旅拍 §三 通用框架层同款）：对店名/地段/菜系关键词
   做一轮背景检索补写稿语料（店家来历、当地饮食脉络），有检索能力就做、没有不强求；
   检索所得与素材互证后才入稿、档案标注来源；
 - **做饭流程线**：步骤忠实、关键动作给特写位（刀工/火候/翻面）、成品定格收束。
 
-## 二′、L1 看点 rubric · 画面投影版（供 `--highlight-weight` 使用）
+## 二′、L1 看点 rubric · 画面投影版（供 `--highlight-weight` 使用）
 
 `highlight` 是**镜头看点分**——服务端 VLM 对着一帧画面打 0–100。喂给它的评分准则
 （`highlight_rubric`）按垂类走，美食这一档取下面这份：
@@ -58,7 +58,7 @@ description: 美食解说垂类图纸（解说链示例）——把探店/密着
 >
 > 两侧的分工是：**画面 rubric 管「这一帧值不值得看」，写稿管「这件事值不值得讲」。**
 
-**传入方式**：把上面代码块**原样**存成工程目录下的
+**传入方式**：把上面代码块**原样**存成工程目录下的
 `highlight-rubric.txt`，理解那一步带上它——
 
 ```bash
@@ -93,17 +93,17 @@ BGM 检索词照公约 §三′ 内容驱动（这家店的气质：地域/年
 带上 `--highlight-rubric @<工程>/highlight-rubric.txt`**——不带就是按服务端缺省准则打分，
 美食这一档的分量对比/价格实物/名场面动作全不算数；两样都漏则全部候选中性、权重白传，lay 会就此告警）。
 BGM 选带人声歌曲（`audio_type:"song"`）时 **MUST 下载 `accompaniment_url` 伴奏版上轨**，
-不得直接用 `download_url` 原曲——人声与解说配音会打架。换已上轨的 BGM 文件时
+不得直接用 `download_url` 原曲——人声与解说配音会打架。换已上轨的 BGM 文件时
 注意：`audio lay` 同源幂等按文件路径判定，**换不同文件不会替换旧轨**，须先剥旧 BGM 轨再 lay。
-质检按公约「三级收敛」执行：L1 结构自检恒开；L2 画音对齐在落轨前可选运行；L3 渲后终检随本来就要交付的本地渲附带，不为质检单独逼渲。跑过的质检结论随交付呈现。
+质检按公约「三级收敛」执行：L1 结构自检恒开；L2 画音对齐在落轨前可选运行；L3 渲后终检随本来就要交付的本地渲附带，不为质检单独逼渲。跑过的质检结论随交付呈现。
 字卡走 MG 临场泛化（公约 §三）：店名条/菜名条/价格条为主，风格锚在这家店的气质上。
 
 ## 五、检查点①（拍板停一次；铺画面前另有一次用量确认）
 
 稿件（含引用窗口）+ 出处对照表（自备稿时）+ 画幅 + 音色（试听）+ BGM（试听）+ 字幕样式，
-一屏一次拍板；在确认前不发起计费动作。
+一屏一次拍板；在确认前不发起计费动作。
 
-> 本地素材的编排缺省走云端并按编排量计费。`matrix lay` 跑前必须报告预估用量，取得同意后才能带 `--yes`。
+> 本地素材的编排缺省走云端并按编排量计费。`matrix lay` 跑前必须报告预估用量，取得同意后才能带 `--yes`。
 > 详见 `gtrk-narration` 正本 §六 的 agent 纪律（先报用量拿同意，再带 `--yes`）。
 
 ## 六、个性化出路（垂类示例定位）

package/skills/gtrk-live-slicing/SKILL.md

@@ -200,6 +200,7 @@ gtrk subtitle lay --gtrk "<产物根>/clip{i}/gtrk/<该 clip 的 .gtrk>" --trans
 - `json/transcript.json` 是该段任务落下的**整片**转写，一份服务该段全部 clip；分了几段就各用各段产物根里的那份。
 - `--language` 跟该段 `gtrk long2short` 的 `--language` 一致（英文直播就 `en-US`），否则云端会按中文断句。
 - 交付时说清三件事：① 字幕在**客户端字幕轨**上，可换样式、可整轨删，不烧进画面；② 云端产出的剪映 / PR 工程是在上字幕**之前**生成的，**不含**这条字幕轨，要带字幕的剪映草稿请从客户端导出；③ 用了 `--subtitle-file` 的段，字幕按行出现、词级时间是近似值（`clips.md` 会提示）。
+  打开 PR 工程时的重链提醒照 `gtrk-oralcut`「回给用户（三端打开方式）」PR/FCP 条，引用不复制。
 - 该段产物根里**没有** `json/transcript.json`（老服务端或下载失败，CLI 日志会说）：如实告诉用户这一段没法自动上字幕，其余段照常。**MUST NOT** 拿弹幕或别的文本凑一份当字幕来源（见 §六 红线）。
 
 ### 模糊底（横竖互转时缺省做，只对入选 clip）
@@ -217,7 +218,7 @@ gtrk project background --gtrk "<产物根>/clip{i}/gtrk/<该 clip 的 .gtrk>" -
 
 **朝向一致**（竖屏直播进竖屏画布）⇒ **不跑**。
 
-交付时说清：模糊底是**客户端画布设置**（主轨画面的模糊副本垫在底下），在客户端设置里可改回黑底；剪映 / PR 工程与本地 `gtrk render` **不带**模糊底。强度缺省 200，用户嫌太虚或不够虚可加 `--intensity <0–1000>` 重跑（幂等覆盖）。零计费、不访问云端。
+交付时说清：模糊底写在**主轨每个片段**上（片段自己画面的模糊副本铺满垫底），客户端里可逐片段或多选批量改成黑底 / 纯色；从客户端导出的剪映草稿**带**模糊底，Pr 工程降级为纯黑，本地 `gtrk render` 带；云端随 `gtrk long2short` 产出的剪映 / PR 工程生成在它之前、**不带**。强度缺省 200，用户嫌太虚或不够虚可加 `--intensity <0–1000 整数>` 重跑（幂等覆盖）。零计费、不访问云端。（只想要旧的整片画布设置：`--scope canvas`。）
 
 ### 运镜（仅当开工⑤用户要了才做）
 

package/skills/gtrk-long2short/SKILL.md

@@ -78,10 +78,11 @@ gtrk long2short "D:/毛片/对谈.mp4" --language zh-CN --split-screen --split-o
 ## 产物（跑完把这些讲给用户）
 
 - 产物根 `<毛片名>-long2short/`：`report.json`（选段报告）+ `result.json` + 逐 clip 子目录 `clip0/ clip1/ …`（各含 `gtrk/` 客户端工程、`jianying/` 草稿、`xml/` PR 工程；开了 `--subtitle-out` 另有 `srt/clip{i}.srt` 单语字幕）。
+  打开 PR 工程时的重链提醒照 `gtrk-oralcut`「回给用户（三端打开方式）」PR/FCP 条，引用不复制。
 - 产物根 `json/transcript.json`：**整片**源时基转写（一份服务全部 clip）。要给某条 clip 上客户端字幕轨（可换样式、可整轨删、不烧进画面）：
   `gtrk subtitle lay --gtrk <产物根>/clip{i}/gtrk/clip{i}_project.gtrk --transcript <产物根>/json/transcript.json --language <源语种>`
   （clip 工程文件名以 `clip{i}/gtrk/` 下实际文件为准）。上完字幕的是**客户端工程**；云端早先产出的剪映 / PR 工程不含这条字幕轨，要带字幕的剪映草稿请从客户端导出。老服务端没有这份文件时，CLI 会提示「无法自动上字幕」。
-- 横屏源进竖屏画布（缺省 9:16）时工程上下是黑边；要模糊底：`gtrk project background --gtrk <产物根>/clip{i}/gtrk/clip{i}_project.gtrk --blur`（客户端画布设置，可在设置里改回黑底；剪映 / PR 与本地渲染不带；零计费）。
+- 横屏源进竖屏画布（缺省 9:16）时工程上下是黑边；要模糊底：`gtrk project background --gtrk <产物根>/clip{i}/gtrk/clip{i}_project.gtrk --blur`——给该 clip **主轨每个片段**写模糊底（片段级底板），客户端里可逐片段或多选批量改成黑底 / 纯色；从客户端导出的剪映草稿带模糊底、Pr 工程降级为纯黑、本地 `gtrk render` 带模糊底；云端随长剪短产出的剪映 / PR 工程生成在它之前、不带。零计费。只想要旧的整片画布设置：加 `--scope canvas`。
 - 用了 `--camera-move` 时：`clips.md` 每条时长后标「运镜 N 处」（0 处属正常）；若有 clip 未能加运镜，`clips.md` 会单列「未能加运镜的切片」；告诉用户运镜在客户端 / 剪映里看，本地渲染与 PR 看不到。之后用 `gtrk patch` 裁剪 / 切分带运镜的片段，关键帧会跟着调整。
 - 用了 `--speed-factor` 时：`clips.md` 的时长是**变速后**的时长并标注倍率；若有 clip 未能变速，`clips.md` 会单列「未能变速的切片」，如实告诉用户。
 - **先看 `clips.md`**（产物根，人读总览）：一张表列全部切片的标题/时长/评分/一句话简介 —— 用它给用户复述「出了哪几条、各讲什么、建议先精修哪条」，别让用户自己开工程猜。逐条的入选理由、跳剪说明、高光词在 `clip{i}/clip.md`。

package/skills/gtrk-matrix/SKILL.md

@@ -31,7 +31,7 @@ description: B-roll 检索铺轨编排手册——成片管线里第一个铺的
 1. **概览**：按素材时间顺序查看带时码的抽帧与照片；长场景也保留多个观察位置。结合 `gtrk transcript` 的原声转写整理事件、人物、环境和待核实之处，不从文件名猜内容。
 2. **细查**：脚本要求某个动作或情绪时，对相关素材用 `describe --materials <视频> --source-window <起秒,止秒> --prepare <工程目录/审阅目录>` 加密取帧；通过当前视觉工具检查过程。有音频依赖时回看/听对应原声，不以一张图证明完整动作。
 3. **回传**：查看任务中的实际图片后填写 `visual-review.json`，以相同输入参数加 `--review <回执路径>` 导入。全部本地完成时零豆包调用；不能看图或无法完成的单项标 `unavailable` 并说明原因，只有这些项由豆包补齐。不得把未查看项批量写成完成，也不得仅因省事直接调用豆包。
-4. **编排**：从已观察证据中按脚本意图选择片段。按脚本语义选材，本手册不调用视频高光算法；该增强仅由 Vlog 图纸按需编排。看片范围、未确认事实和原声覆盖均如实记录。
+4. **编排**：从已观察证据中按脚本意图选择片段。按脚本语义选材，本手册不调用视频高光算法；该增强仅由 Vlog 图纸按需编排。看片范围、未确认事实和原声覆盖均如实记录。
 
 ```bash
 gtrk matrix describe --materials <本地视频或图片> --prepare <工程目录/visual-overview> --json
@@ -154,7 +154,7 @@ gtrk matrix describe --materials <同一素材> --review <工程目录/visual-ov
 | 多铺几条候选对比 | `--lay <n>` | 非负整数 · `1`（`0`=只出 plan 不铺轨） | opencut 小眼睛切换对比挑选 |
 | 每段多给几个候选 | `--top-k <n>` | 整数 · 派单 `shots` 值（服务端上限 50） | 每 query 候选数上限 |
 | 指定素材类型 | `--material-class <c>` | `real_shot` \| `concept` · 栏目策略 | 仅 internal 矩阵成员口 |
-| 填充门槛 | `--score-floor <f>` | 浮点 0–1 · `0.2` | 低于不采纳、槽位留空露黑底；调完必看空洞告警 |
+| 填充门槛 | `--score-floor <f>` | 浮点 0–1 · `0.2` | 低于不采纳、槽位留空——口播工程里留空处由候选轨补纯黑片；调完必看空洞告警 |
 | 切点对齐字幕句 | `--cut-align <r>` | 浮点 0–1 · `0.7`（`0`=关闭） | 三七开拍板：约七成字幕句起点恰逢镜头切点、三成有意错开；句级时码取 transcript 重投影（降级自动回旧节奏并告警）；开启时结果 JSON `lay.cut_align` 报实测比例 |
 | 主轨空洞填充 | `--gap-fill <m>` | `fast` \| `solid`（默认）\| `none` | **仅音频驱动工程主轨**（口播工程不适用零回归）：fast=放宽地板随便填候选→延长相邻颗粒→**跨 beat 借候选**→**次地板补真画面**→仍不够才黑片；借来的画面与本段稿子相关性弱、次地板槽是不到 1.2s 的快切，两者都会在日志里**指名报出**（`kind` 为 `borrowed` / `subfloor`）——那是如实告知，**不是缺陷，别当 bug 上报**；solid=黑片垫齐（精修一眼看出没匹配到）；none=留 gap（客户端主轨磁吸会吸除 gap 致画面与配音错位，慎用）；生效时结果 JSON `lay.gap_fill` 报明细 |
 | 编排交给云端跑 | `--arrange <m>` | **按素材来源自动定档，一般不用传** | 铺**自己电脑里的素材**→`cloud`（编排在服务端，按编排量计费）；铺**素材矩阵的素材**→`local`（编排仍在本机、不计费，逐字不动）。`shadow`=本机照跑照铺轨、云端只对拍不采纳。⚠️ 本地素材路上 `--arrange local` **不受理**；云端拿不到产物时**直接报错**，不会换算法把活干完。⚠️ **它不是省钱开关**——矩阵素材要付检索费，两条路都花钱、只是花在不同环节，MUST NOT 对用户说「用本地就不花钱」 |
@@ -163,7 +163,7 @@ gtrk matrix describe --materials <同一素材> --review <工程目录/visual-ov
 | 先估价再决定跑不跑 | `--arrange-estimate-only` | 开关 · 缺省关 | 走到云端编排的计价确认那一步就停：报出编排量后**成功**返回（`ok:true` + `estimateOnly:true`，不是「被拒绝」），零云端调用、工程零改动。机读值在 `lay.arrange.units` 与 `lay.arrange.scale`。⚠️ 它省的是**云端那一次调用与其计费**（及其后的下载落轨），不是整条链——工程/plan/重投影照样要走。素材矩阵路会报 `applicable:false` 而**不是 0**。与 `--yes` 同给时以它为准 |
 | 云端编排请求体存证 | `--dump-request <file>` | 路径 · 缺省不写 | **排障专用，用户没提就别带。** 把**实际上行的**云端编排请求体逐字节落到该文件——服务端**不保存 plan 全文**，所以复现一次调用只能靠它。⚠️ **不能指向工程目录内**（工程会被打包拷走，而它含 beat 名与检索词），传了会报参数错；开 `--arrange-qc` 时每轮各一份（第 N 轮加 `.roundN`）。回执在 `lay.arrange_run.dump_request`。⚠️ 转交这份文件前 MUST 先告诉用户里面有什么，别替他做决定 |
 | 外发调参仪表 | `--explain` | 开关 · 缺省关 | 缺省 `lay.dedup` 只出 `emptySlots`（判素材池够不够用，upsell 判据就是它）；本开关再补 `emptySlotsByRefine` / `adjacentWaived` / `hotSlotsPlaced` / `blurrySlotsPlaced` 四个**调参仪表**，人读日志同口径。**不改任何决策**，工程产物逐字节不变。⚠️ 用户问「为什么这颗抖/糊/空」时才带，别缺省开着刷噪音 |
-| 不要黑底垫轨 | `--no-black-bed` | 开关 · 默认铺 | 黑底按 beat 包络整条铺，B-roll 期间遮口播 |
+| 用户的客户端太旧（不认片段底板） | `--black-bed` | 开关 · 默认关 | 旧形态：铺一条纯黑底垫轨、候选片段不带底板。缺省是**候选片段自带纯黑底**（`background_fill`）、空档在候选轨内补纯黑片，不铺黑底轨；`--no-black-bed` 已是缺省（无操作） |
 | 已编辑轨强铺逃生门 | `--force-relay` | 开关 · 关 | 用户明确点头才带；raw 登记删除不可恢复 |
 | 同素材彻底不二用 | `--dedup-scope material` | `scene`（默认）\| `material` | 收严会加剧空洞，先看 `lay.dedup.emptySlots` |
 | 机读（你必带） | `--json` | 开关 · 关 | 人读日志转 stderr，stdout 只出结果 JSON |
@@ -204,6 +204,14 @@ gtrk matrix describe --materials <同一素材> --review <工程目录/visual-ov
 
 出参逐条：`{id, note, duration, audio_type, tags, score, download_url, cover_url}`；`audio_type`（`pure` 纯音乐 / `song` 歌曲）与 `accompaniment_url`（song 类现成伴奏直链，零处理成本）**两档通用**；**只有 `is_copyright`（及 clip 的 `material_class`）是成员口独有**——公开口**没有**这个字段，零件如实缺省不伪造，你也别把「没有该字段」读成「不可商用」。`download_url` 带 24h 签名（过期重跑即重签）。
 
+**Pexels 补充（仅 clip / image）**：`--scope clip|image` 时零件缺省另附 Pexels 补充结果，放在 `--json` 出参顶层的 **`pexels_results`** 数组（另有 `pexels_status`，`counts.pexels` 计条数），**不在 `results` 里，也不算候选数**；`--no-stock` 关闭，`audio` 恒不带。
+
+- 补充条目 id 形如 `pexels:video:<n>` / `pexels:image:<n>`，带 `rank`（**没有 `score`**，别拿去和自有结果比分）、`author` / `author_url` / `page_url` / `download_url`；
+- 用之前先用 `download_url` **下载落地**再引用（`.gtrk` 不收 url 态素材）；**MUST NOT** 拿 `pexels:` id 跑 `matrix fetch`——补充素材不经同合云授予，CLI 会直接拒绝；
+- 引用时 **MUST 保留摄影师署名与 Pexels 链接**（条目的 `author` / `author_url`，以及 https://www.pexels.com）；
+- **MUST NOT** 把 Pexels 素材上传到任何对外可检索的素材库或图库（Pexels License 禁止再分发）；
+- `pexels_status` 为 `unavailable` / `disabled`，或出参里根本没有 `pexels_status` = 这次补充源没用上，**自有结果不受影响**，照常往下走，不必追问用户。
+
 > ⚠️ **`is_copyright` = 能不能商用，不是「有没有被版权保护」**
 >
 > ```
@@ -271,7 +279,7 @@ gtrk matrix describe --materials <同一素材> --review <工程目录/visual-ov
 | 消费（编辑后的）plan 铺轨 | `gtrk matrix lay --project <目录>` | 目录 · — | 读 `<目录>/split/broll-plan.json`，白名单校验后按 **plan 现值**铺轨（不重新检索、零检索开销） |
 | 显式指定 plan 文件 | `--plan <path>` | 路径 · 上述默认 | 配方 C 自己组的 plan 从这进。⚠️ 组的时候把检索返回的 `results` 条目**原样搬**——`cuts` / `motion` 住在 `segments[]` 里面，自己重写 segments 就把它们丢了（后果：端点残片收缩空转、高运动降权失效，见配方 C 要点） |
 | 美观度参与排序 | `--mark-weight <w>` | 浮点 0–1 · `0`（关闭） | 仅 `matrix lay`：候选融合分 = `sim×(1-w)+(mark/100)×w`，mark 取 describe 理解缓存（素材内**就近帧**命中）；无缓存候选**中性**（融合分=sim，不惩罚不加分、绝不变相剔除）；score 地板仍只看原始 sim。**零件不裁定：默认关（0 时排序与产物逐字节零回归），开不开、开多大由配方/你裁定**——先 describe 过一轮才有 mark 可用（配方 B ② 之后开才有意义），开启时结果 JSON `lay` 含 `mark_weight/mark_hit/mark_neutral` |
-| 其余铺轨参数 | `--lay/--score-floor/--cut-align/--gap-fill/--arrange/--arrange-cost-cap/--arrange-estimate-only/--arrange-qc/--dump-request/--explain/--no-black-bed/--force-relay/--dedup-scope/--yes/--no-image-broll` | 同主命令 | 语义一致 |
+| 其余铺轨参数 | `--lay/--score-floor/--cut-align/--gap-fill/--arrange/--arrange-cost-cap/--arrange-estimate-only/--arrange-qc/--dump-request/--explain/--black-bed/--force-relay/--dedup-scope/--yes/--no-image-broll` | 同主命令 | 语义一致 |
 
 ## plan 编辑口径（法定通道的边界）
 
@@ -390,9 +398,10 @@ gtrk matrix --project "<split 产物目录>" [--lay N] [--score-floor F] [--top-
 
 - `counts`：几个 beat、几条检索（几条失败）、几条候选——一句话概括盘子大小。
 - `memberType`：internal=矩阵成员口（栏目偏好/concept 生效）；external=通用口（固定 real_shot + 可商用）。
-- `lay.laidTracks` / `lay.laidClips`：铺了几条候选轨、几个颗粒（不含黑底轨）。
-- `lay.blackTrack`：黑底垫轨轨号（未铺时 null）。
-- `lay.blackBedHoleSec` / `lay.blackBedHoles`：**黑底空洞**（纯黑压口播时段），恒全量不按阈值过滤——非零就主动报（哪个 beat、几秒、在哪），这是粗剪期既定取舍不是故障。
+- `lay.laidTracks` / `lay.laidClips`：铺了几条候选轨、几个颗粒（不含空档补片 / 黑底轨）。
+- `lay.bed`：底板形态——`fill`（缺省：候选片段自带纯黑底、空档在候选轨内补黑）/ `track`（`--black-bed` 旧形态）；`lay.bed_fill` = 补了几段、几秒。
+- `lay.blackTrack`：黑底垫轨轨号（只有 `--black-bed` 才有，缺省 null）。
+- `lay.blackBedHoleSec` / `lay.blackBedHoles`：**纯黑时段**（没有任何 B-roll、靠黑片压住口播的段落；两种形态数值相同），恒全量不按阈值过滤——非零就主动报（哪个 beat、几秒、在哪），这是粗剪期既定取舍不是故障。
 - `lay.removedTracks` / `lay.keptEditedTracks`：剥了哪些旧自产轨 / 因「你编辑过」保留未剥的轨。删了什么必须跟用户说。
 - `lay.dedup`：`emptySlots`（宁空不重复的空槽数——多了是该补料或走动线②的信号）、`adjacentWaived`。
 - `lay.pinned`（有钉选才出现）：`requested/placed/yielded`——三个数**按段计**（键 `<clip_id>@<段内锚点毫秒>`）且同分母，`placed + yielded === requested` 恒成立。整片单素材的工程（二创：一条长视频钉多处引用）全靠这个粒度才看得出「钉了 5 段只落了 1 段」。`yielded` 非空要**逐段指名**哪些没落上（stderr 也有告警）。
@@ -423,7 +432,8 @@ gtrk matrix --project "<split 产物目录>" [--lay N] [--score-floor F] [--top-
 - 在同合云桌面客户端（opencut / OpenCut Gitruck Edition）里打开工程，候选轨已铺好。
 - 用轨道头「小眼睛」逐条切换对比，留满意的、关不要的。
 - 候选默认是 preview 代理；下载原片属挑选后的动作（客户端挑选 UI）。
-- 候选轨下方垫了纯黑底轨（`lay.blackTrack`）——删多余候选轨时**别误删它**；换片拖到**候选轨颗粒**上、别拖到黑底条上（0.2.10 起客户端会拒绝并提示；旧版会静默建轨——用户说「拖了没反应」先让他重启客户端吃强更，再查轨道数，`Ctrl+Z` 整条撤销）。**MUST NOT 对旧版客户端用户承诺「客户端会拒绝并提示」**。
+- 候选片段**自带纯黑底**（片段级背景填充，客户端属性面板「基础 › 背景填充」可逐片段改），空档在每条候选轨上各补了纯黑片——所以**关掉某条候选轨的小眼睛会露口播**，那是用户主动切换。纯黑补片也是候选轨上的片段，换片拖到**候选轨颗粒**上替换即可。
+- **旧工程**（之前按黑底垫轨铺的）可能还有一条纯黑底轨（`struct_meta.broll.black_track`）——别误删；重铺时它会被换成新形态。用户的客户端太旧、打开后 B-roll 黑边处露口播 ⇒ 让他升级客户端，或本次加 `--black-bed`。
 - 觉得填充有问题（太杂/太空/漏段）→ 回来找我调参重铺（配方 B 的理解裁定也在这时上场）。
 
 **用户明确说「B-roll 就这样」之后**，才往下走——先看 AI 情景片段腿（同属 ③），三源齐了再进 ④ 全局抽帧检查，过了才交棒 ⑤ 铺 MG。详见末节「下一步」。
@@ -433,10 +443,10 @@ gtrk matrix --project "<split 产物目录>" [--lay N] [--score-floor F] [--top-
 | 情况 | 怎么做 |
 |---|---|
 | 想在多个候选里挑 | `--lay N` 多铺几条候选轨。**只增加可选方案数，不扩大覆盖**——别把它当空洞的解药 |
-| 填充太差 / 命中太杂 | 先看排序前几条质量再调 `--score-floor`（调高留空处露黑底，必看空洞告警）；杂得可疑 → 走配方 B：describe top 候选，按 `usable_flags`+`desc` 剔除后 `matrix lay` |
+| 填充太差 / 命中太杂 | 先看排序前几条质量再调 `--score-floor`（调高留空处补纯黑，必看空洞告警）；杂得可疑 → 走配方 B：describe top 候选，按 `usable_flags`+`desc` 剔除后 `matrix lay` |
 | 「像但不能用」（水印/字幕/黑边混进候选） | 配方 B 的标准场景：`describe --plan` → 你删掉命中的 result → `matrix lay`。**CLI 不会自动剔**（零件不裁定），删不删你判断 |
 | 某候选非用不可 / 顺序想钦定 | 编辑 plan：该 result 标 `pinned:true` → `matrix lay`。钉选是落位保证（免负词/地板/不二用抢占/紧邻避让），`lay.pinned.yielded` 非空说明确实钉多了在打架，名单逐段指名 |
-| **出现黑底空洞告警** | 不是故障：照 `lay.blackBedHoles` 逐段报给用户，出路=调低 `--score-floor` / `--no-black-bed` 露主轨 / opencut 手动补片 / 动线②云端垫底 |
+| **出现空档补黑 / 黑底空洞告警** | 不是故障：照 `lay.blackBedHoles` 逐段报给用户，出路=调低 `--score-floor` / opencut 手动补片 / 动线②云端垫底 |
 | 每段候选太少不够挑 | `--top-k` 调大重跑 |
 | 某段有空槽 / 想补特定意象 | `gtrk matrix search "<英文长句场景描述>" --project <目录> --json` 单条补检；影视解说类补检记得带 `--source-window` 保时序 |
 | 只想先看清单不铺轨 | `--lay 0`（只产 plan）；之后铺 = `matrix lay`（不重新检索、不重新烧配额） |