gtrk-vlog-docu（Vlog 纪实类 · 组合成片图纸）
审片与脚本的实际工作顺序
先建立全批素材概览，包含视频、照片和原声，再提出影响主线的关键问题。已有回答直接沿用，不重复问。不要先定故事，再只找支持它的几张画面。
视觉部分沿用 gtrk-matrix 的当前 Agent 优先通路：describe --materials ... --prepare <工程目录/visual-overview> → 当前 Agent 按时码看图、记录事实与不确定项 → --review <回执> 导入。长场景多个观察点；动作、表情、剪辑入出点在相关窗口内加密查看。原声有内容时结合转写/试听；不能把抽帧概览称为完整看过原片。Agent 无视觉能力或单项无法完成时才由豆包补齐，注明回退原因。
概览后组织可审阅的视听脚本：每段表达什么、采用哪条素材的哪个时间区间、保留什么同期声、哪里需要旁白、照片如何进入。交给用户审阅；有异议则多轮修改同一份脚本，认可后继续成片。照片可由既有图片运镜能力进入时间线，但不能虚构照片之外的事件。
明确脚本的取材由语义与实际画面证据主导；泛高光发现只是探索素材的一种工具，其分数不能覆盖脚本意图。下方云端 describe 示例仅在当前 Agent 无法完成时直接使用；有视觉能力时先 prepare/review，交接由 Agent 完成，不让用户填逐帧表格。
把一批现场素材变成一条纪实成片工程：素材理解 → 选档写稿 → 检查点①一次拍板 → 同期声骨架 + 旁白配音 + B-roll + 字幕层 + BGM 全自动 → 客户端出片。
定位：structure 级组合图纸，不新增命令，只编排既有原子零件。零件参数以各自 skill（gtrk-transcript / gtrk-matrix / gtrk-splitter / gtrk-mg）与 --help 为准，本图纸引用不复制；编排次序、检查点、配方参数以本图纸为准。CLI 是手，你是脑。
本体定性：
纪实 Vlog 是散文的载体——用有限的素材，把一个故事、或一个几个思想，最终串联起来。
三个推论，构成本图纸的全部决策原点：
- 形散神不散：素材可以跳跃、场景可以断裂、时间可以不连续，但必须有一根线。没有那根线的片子叫「相册」不叫作品。
- 素材有限是前提不是缺陷：创作力体现在「用手上这些素材能串出什么」，不是「还差什么素材」。先看素材里有什么，再决定串什么——这是散文与说明文的分野。
- 先立神，再选材：写稿的第一步不是排素材顺序，是找到那根线（§3.2）。顺序反了就会写成流水账。
表达形态上的定义性特征：纪实类是双声道交替——现场同期声承载真实感与人格，后期旁白承载知识与升华。同期声片段是内容本体，不是可替换的配画。这是它区别于口播链与配音链的根本。
当前实现状态：本地候选 CLI 已支持 gtrk project compose，按清单组装视频、图片和已合成旁白。先用 gtrk project --help 核对当前安装版本是否提供 compose；旧版不支持时停在图纸，不手写工程冒充链路。声音仍经检查点确认后生成。
高光发现与失败兜底（仅本图纸使用）
在全批概览之后，用户只说“挑高光”或某段值得探索但缺少明确事件线索时，按需执行：
gtrk tool video_highlight "<本地视频>" --out "<工程目录>/highlight/<素材名>" --json
该入口当前仅供内部验收。只上传本地生成的448p/4fps分析代理，缺省附单声道低码率原声，原片不上传；用户在意对话隐私时加 --no-audio，只少一项声音信号，候选照常产出。若报错要求短边224或无音频，说明云端尚未升级到新版代理，如实告知用户，不要重试或自行改参数。结果在 result-output.json。groups 各自的 top3 只代表该请求内的三秒候选；不可跨素材、跨分块混排分数。用 matrix describe --materials <原片> --source-window <起秒,止秒> --prepare <目录> 查看候选前后过程，再结合原声判定它能否进入脚本。不要用三秒评分推断整段事件完整性。已有明确脚本时优先语义检索，不自动调用视频高光算法，也不覆盖语义 best 或 VLM highlight。
服务忙、冷却、超时、坏响应、无候选或接口未部署时，记录素材、任务号（若有）、失败原因和后续来源 agent_semantic_overview，继续从已观察素材按故事选材。视觉项当前 Agent 确实无法完成才标 unavailable 交豆包；两者都不可用则保留缺口，不写成已看过。纯粹请求“高光评分结果”时，原子失败就如实报告未完成。已有任务号优先查询原任务；提交状态未知时用同一素材、输出目录恢复，不换身份盲目建单。
脚本验收交付物
在工程目录维护一份可持续修改的视听脚本，按顺序列出：段落目的、源素材、源入出点、预计片长、画面事实、同期声或环境声、旁白、照片运镜、证据覆盖与待核对项。素材时间轴与成片时间轴分列。旁白草稿不当作录音事实，未听清的同期声不编台词，文件名日期不自动当作真实行程日期。
连同全批素材概览、采用/舍弃理由、高光调用与回退记录一起交付。先审这份完整图纸；用户认可后再合成旁白、组装工程和渲染。组装必须走 project compose，不能手写 .gtrk；图纸确认和成片验收分别记账。
一、输入契约与三档识别
用户给一个素材文件夹（多个用逗号分隔）：
| 内容 | 必须性 | 说明 |
|---|
| 现场视频素材（含同期声） | 必须 | 一条长素材或几十条碎片皆可；这是内容本体 |
| 图片素材 | 可选 | 自动运镜成动态上轨 |
| BGM 音频 | 可选 | 没有走素材矩阵搜索（检查点①） |
| 文字备忘（txt/md） | 可选 | 行程单、选题笔记，作写稿补充 |
MUST NOT 执行任何网络下载：素材从哪来归用户（版权责任边界）。
精剪包装（公约 §三⁵）：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；gtrk composite bake --abi 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
1.1 配比档位识别（本类型独有的第一决策）
先听素材里有没有可用的同期声，再定档——档位决定写多少稿、TTS 花多少钱、成片什么质感：
| 档 | 旁白占比 | 判据 | 典型 |
|---|
| A 同期声主导 | 0–10% | 多人在场、有对话有反应、事件自带戏剧性 | 双人探险、挑战企划、野采、探店闲聊 |
| B 旁白主导 | 60–100% | 单人、素材多为空镜与地点、信息/考据型 | 攻略、圣地巡礼、废墟考据、风光记录 |
| C 三明治换挡 | 旁白定调→同期声主体→旁白升华 | 有观点要表达、事件之上还有一层态度 | 活动纪实+吐槽、旅途+自白 |
判别动作：gtrk transcript 抽听 1-2 条代表素材——转写出大量口语碎句、语气词、对话接话 → A 档；几乎无人声或只有环境音 → B 档；有对话但用户明显想表达观点 → C 档。拿不准问用户一句：「你是想让现场的声音说话，还是你来讲？」
C 档适合需要升华观点的自制片：以纪实同期声承载事件，中后程切入议论式旁白，把当天经历升华为观点与私人自白，落一句可摘录的态度句。有条件优先推 C。
二、全链总览（快速成片）
① 理解 transcript 抽听定档 + matrix index/describe 建素材索引
② 立神 ★【多轮对话·必问】与创作者访谈找出那根线，问够为止（§3.2）
③ 选材串珠 按「神」挑素材、定幕结构（服务于神，不是按时间流水排）
④ 写稿 只写定调层旁白（§三）→ 稿 + 标题 + HashTag
⑤ 检查点① 【必停】神 · 配比档 · 稿件 · 画幅 · 音色 · BGM · 字幕样式（§四）
⑥ 配音 gtrk tool audio_tts_clone（仅旁白段，★ 分段合成）
⑦ 拼主轨 gtrk project compose（分段清单 → live 段引用原片区间 + narration 段落位）
⑧ 拆分派单 gtrk split：live 段=A_ROLL/真人出镜|口播继续；narration 段=FILM_BROLL|MG/旁白主导
⑨ 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% → 复核 → 构建机检 → 铺轨烘焙，不停）
⑬ 交付 客户端打开工程出片
快速成片的「免打扰」只覆盖 ⑥ 之后的执行环节：①–⑤ 沿用已有创作意图，补问必要信息并保留检查点①，MUST NOT 因为用户选了快速成片就跳过立神对话自行拍板——那是把创作者的片子做成 agent 的片子。用户要精修按 §七 逐步停。
三、写稿规约
3.1 通用框架层（原样继承旅拍图纸，勿改）
结构三段式：钩子（抓眼球保留存）→ 干货（内容价值）→ 升华（情绪价值）。爆款四属性贯穿：快乐+知识+共鸣+节奏。
文风铁律：
- 禁模板连接词：让我们/首先/然后/最后/此外；
- 拒翻译腔：短句中文语感，无欧化从句；
- 禁「否定—转折」对举句式（最高优先级）：八成的 AI 厌恶感来自这一种句式。禁整个家族：「这不是 X，而是 Y」「与其说是 X，不如说是 Y」「X 不仅仅是 Y，更是 Z」「重要的不是 X，而是 Y」「不是因为 X，而是因为 Y」。识别特征=先立一个没人主张过的靶子再推翻它、用对偶结构制造顿悟感。改法=把后半句直接说出来，删掉假靶子。能直接陈述的事实，绝不用对举包装。也适用于标题与 HashTag。
- 禁幼稚拟声与过度儿化：换成真实事实——数字与事实比拟声词有力。
- 风格贴着素材走：素材什么气质，稿子就什么气质，不加分不减分。
成片时长 = min(内容支撑, 素材支撑)；旁白折算用挂钟语速（按检查点①选定的音色取，取不到用缺省 ≈330 字/分钟）——口径与标定档案见 skills/gtrk-travel-recap/references/speech-rate.md，MUST NOT 复制数值表。
3.2 立神：找出那根线（★ 本类型的第一步，先于选材）
纪实 Vlog 是散文的载体——用有限的素材，把一个故事、或一个几个思想，串联起来。「神」就是那根线。没有神的片子是相册，不是作品。
主线由创作者决定：先利用已有回答和素材概览，只有仍影响主线的缺失信息才提问。用户已经讲清经历、重点和感受，或授权其余内容按素材编排时，直接写出可审阅脚本，不机械增加访谈轮数。多轮修改围绕同一份脚本进行，快速成片也保留脚本确认。
访谈协议（写稿前必做）：
第一步，agent 自答素材侧一问：这堆素材里反复出现的东西是什么？（一个地方的衰败痕迹、一群人的某种状态、一件事的三次反复）——据此提名 1–3 个候选神。
第二步，向创作者开问（每轮 1–2 个问题，别一次倒完；按回答追问）：
| 问什么 | 挖什么 |
|---|
| 拍的时候，什么瞬间让你想按下录制？ | 那个冲动往往就是神 |
| 这趟结束后，你跟朋友聊起它时先说哪件事？ | 自然叙述里藏着真正的主线 |
| 如果只能留一句话给观众，你想说什么？ | 思想线的候选 |
| 这趟有没有什么真话想说（遗憾/触动/不甘）？ | Resonance 素材，有则必用无则不硬造 |
| 有没有不想放进片子的东西？ | 边界，先问后剪 |
第三步，收敛判据（满足其一即立住）：创作者用自己的话说出了神；或对 agent 提名的候选明确说「就是这个」。agent MUST NOT 单凭素材分析自立神；创作者的说法与素材分析冲突时，以创作者为准（可以提醒「素材可能撑不住这个神」，但决定权不在你）。
神的确认不止一次：立神访谈初确认 → 检查点①随稿件终确认（此时创作者看得见神落在稿子上的样子，常会修正）→ 精修中仍可推翻重立（神变 = 稿全变，如实告知代价再动）。
神的三种类型（选一，也可故事线套思想线）：
| 类型 | 形态 | 判断标志 | 样本参照 |
|---|
| 故事线 | 一件事的发生—进展—结局 | 有开头有结尾，观众想知道「后来呢」 | 挑战企划（100 块能不能回本）、探险（能不能进去、里面有什么） |
| 思想线 | 一个观念的提出—印证—落定 | 素材是论据，观众记住的是那句话 | 香港那条（华而不实 / 日渐衰落 / 身陷囹圄，三个意象串一个失落）、聚会那条（套路 vs 真诚） |
| 情绪线 | 一种状态的沉浸—转折—释然 | 说不出道理但看完有感觉 | 归乡（离世—旧物—烟花）、江城夏日（重新点燃热忱） |
立神后 MUST 一句话写下来（写进检查点①给用户确认）：
「这条片是关于 ______ 的。」
写不出来 = 神没立住，MUST NOT 进入写稿——回去重看素材或问用户。
形散神不散的操作含义：
- 允许素材跳跃、场景断裂、时间不连续（散文的自由）；
- 要求每一段都能回答「它为神做了什么」——是铺垫、是印证、是转折、还是留白？答不上来的段砍掉，哪怕画面好看；
- 素材有限是前提不是缺陷：不要为「素材不够」而注水或强行拉长。手上有什么，就串什么——这正是本类型的创作力所在。
⚠️ 主要失败模式：素材拍得不差却没有串成一条神，记录了一天的见闻，每段都成立，合起来仍像相册。它比文笔差、素材糙更致命。
3.3 纪实要素层（本类型专属）
★ 第一铁律：旁白只写定调层，同期声段不写稿。
这是新手最易犯的错——把全片写成解说稿，旁白盖住现场声，纪实感当场消失。写稿前先在素材序列上标出哪几段留给现场（有对话、有反应、有笑点的），旁白只写：
| 旁白该写的 | 旁白不该写的 |
|---|
| 开场定调（人物/时间/地点/事件） | 现场正在发生的事（画面已经说了） |
| 背景知识与硬数据（年份/造价/历史/物种） | 同期声已经讲过的内容（重复=灾难） |
| 场景转换的过桥句（下一站是哪、为什么去） | 描述画面（「可以看到…」是废话） |
| 攻略信息件（车程/价格/免费与否/避坑） | 替观众说笑点（笑点归现场） |
| 结尾升华与态度金句 | 强行煽情（无坦白素材就不做 R） |
站点模块化循环（可选结构件，不是默认）：结构服务于神——神是「攻略/巡礼」型（信息即价值）时，站点循环是最优结构；神是故事线或情绪线时，MUST NOT 套站点模板（会把散文切成说明书）。攻略型每站跑一遍——
到场定位（口播或旁白一句）→ 背景科普（旁白）→ 现场体验（同期声，让开）→ 攻略数字（旁白/字卡）→ 转场（车程字卡）
攻略信息件标准化（收藏钩）：凡有地点/消费属性，每站必报车程 + 价格 + 免费与否 + 避坑，缺一项就少一分收藏价值。数字进字卡比进旁白更好用。
Resonance 素材优先（有则必用、无则不硬造）：用坦白脆弱（落榜、心碎、没钱、亲人离世）与集体记忆锚点（城市旧地标、经典电影、老游戏）建立共鸣。写稿前问用户一句：这趟有没有什么真话想说？有就放进升华段，没有就老实做知识与快乐，不要编情绪。
态度金句是收尾硬指标：升华段必须落一句可摘录的话（能被观众截图、能当评论区引用）。写完自问：这句话单独拎出来，有人愿意转发吗？
3.4 写后自校验清单（逐项过，不过重写）
神（第一组，先过这组）：
结构与文风：
HKRR 四维（缺哪补哪）：
抖音四目标（各至少命中一项）：
四、检查点①（双模式共有，必停）
写完稿必须停下，把以下七项一次给用户拍板。未经确认 MUST NOT 发起 TTS 计费动作。
- 神（那根线）· 终确认：一句话「这条片是关于 ______ 的」+ 神的类型（故事线/思想线/情绪线）。此处是 §3.2 访谈初确认之后的第二次确认——创作者此时第一次看见神落在稿子上的样子，常会修正，这是正常且被鼓励的。这是最上位的拍板项：神错了，稿再好也是别人的片；
- 配比档位（本类型独有）：明确告诉用户你判的是 A/B/C 哪档、旁白占比多少、哪几段留给现场声。这一项拍错，后面全白跑；
- 旁白稿 + 标题：正文全文贴给用户（不是给路径），标注每段旁白挂在哪个位置；标题候选列出；
- 画幅：横屏 B 站/西瓜=1920x1080，竖屏抖音=1080x1920。素材几何与画幅不一致时明确提示；
- TTS 音色：拉 catalog（
GET {apiBase}/task/tts/voices，免鉴权）挑 2–4 个候选，每个附试听链接（audition_url）。⚠️ 纪实类的旁白与现场同期声会交替出现，音色应贴近用户本人音色或明显区分（避免观众困惑「这是谁在说」）——如用户本人出镜说话，优先建议同性别接近音色；
- BGM 处置（双来源）：用户自带 → 询问是否
audio_separation 取伴奏；未提供 → gtrk matrix material "<按内容情绪写的检索词>" --scope audio --top-k 5 --diversity --json，推荐 3–5 首每首附试听链接（download_url），audio_type:"song" 取 accompaniment_url。⚠️ 版权状态如实转述：is_copyright 的语义是 1/true=可商用、0/false=不可商用（反直觉，MUST NOT 把 false 读成「无版权、可随便用」）；矩阵成员档缺省搜全库，MUST NOT 默认加 --commercial-only、也 MUST NOT 擅自剔掉 false 的候选，但推荐时 MUST 逐条带上派生位 copyright_label 的中文标签（不追问不阻塞）——用户特意说明只要可商用 / 要商用发布时才加 --commercial-only 收紧。⚠️ 纪实类 BGM 要给同期声让路，音量口径同旅拍（-20dB）；
- 字幕样式：7 样式 × 11 色；用户没选用 default+雅黑（不追问不阻塞）。
试听链接义务（MUST）：音色与 BGM 的推荐没有试听链接=未完成推荐。
五、快速成片编排
链路形态：C 分段拼接——全片切 N 段，每段声明 live（同期声段，引用原片区间，内容本体）或 narration（旁白段，TTS + B-roll 空档），由 gtrk project compose 按序拼主轨。设计草案见探索工件 §四之二。
compose 只引用本地文件：TTS 先合成落地，再以 narration 的 source 引用；需要旁白叠在已确认画面上时，用既有 audio lay --offset 另铺音轨。图片要运动，先用 image_move 产视频再入 live；image 段本身只显示静帧。
分段旁白铺完后，使用 gtrk patch set --clip <旁白片段ID> --audio-track <首条旁白轨的track_index> --project <工程目录> 将同一讲述者的各段收进同一条旁白轨，保持原时间位置；同期声与 BGM 各自独立。重铺旁白后也要归轨，不能把“一段一轨”的阶梯布局作为交付。目标时间段已有片段时先检查重叠，不强行合并。
大场景或活动转换处用简短 MG 交代叙事关系（如从游览转到参与体验），不按每个镜头机械加字卡，不杜撰日期/地点。手写 GSAP 颗粒须在 template 内先声明 gsap.min.js，再创建并注册 paused 时间线；静态 lint 通过不等于预览可见，交付前还应检查客户端播放环境内的入场与驻留。
# ① 理解与定档（抽听 1-2 条代表素材；live 段的 in/out 时码后面全从这份转写里读）
gtrk transcript "<代表素材>" --lang zh-CN --json
gtrk matrix index --dirs "<素材夹>" --json # 建本地索引（素材本体不上传）
# ②③④ 立神 → 选材串珠 → 写稿（你执笔，§三规约）→ 检查点①拍板
gtrk matrix material "<情绪+题材检索词>" --scope audio --top-k 5 --diversity --json # BGM 候选
# ⑥ 旁白配音（★ 纪实类分段 TTS，不是全片一条）
gtrk tool audio_tts_clone --text-file <旁白段1.txt> --speaker <voice_id> --json
gtrk tool audio_tts_clone --text-file <旁白段2.txt> --speaker <voice_id> --json
# ↑ 每段单独合成，compose 按段落位；同参重合成走缓存不重复扣费
# ⑦ 拼主轨（新目录；不覆盖既有精修工程）
gtrk project compose --list <分段清单.json> --out <新工程目录> --canvas 1920x1080 --json
# 清单：{"version":1,"segments":[
# {"kind":"live","source":"原片.mp4","in":3,"out":11},
# {"kind":"narration","source":"旁白.wav","transcript":"旁白-transcript.json"},
# {"kind":"image","source":"合影.jpg","duration":4}
# ]}
# live 默认保留原声；keep_audio:false 才关闭。旁白段留画面空档给 B-roll。
# 原片不上传；路径相对清单；in/out 单位秒。transcript 为源时基 st/ed/text 句表。
# 毛边由选段保留；compose 不做静默删除或自动精剪。
# 多源文稿逐句绑定素材，split/subtitle 根据当刻工程重投影。
# 没提供 transcript 的素材不生成猜测字幕，跨切点整句会省略并报告。
# ⑧ 拆分派单（★ 本类型的车道映射，词表无需扩展）
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）
gtrk split "<拆分稿>" --project "<工程目录>" --json
# ⑨ B-roll（★ 只铺 narration 段空档，live 段 MUST NOT 覆盖）
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
# ⑩ 字幕层字卡（§六 规约）
gtrk mg lint "<工程目录>/mg/<composition_id>.html" --dispatch "<工程目录>/split/dispatch.json"
gtrk mg --project "<工程目录>" --json
# ⑪ 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 与排版。
停顿太长时：自训音色加 --fragment-interval 0.2（合成时就对）；云引擎音色不支持该参数（传了会报错，不会静默忽略），改在合成后跑 gtrk audio tighten --project <工程> 收紧句间停顿（纯本地零计费；只压跨句界的停顿，句内换气与原声引用段不动）。
配方级参数口径：
- 旁白音量 = 1.0（线性），BGM = 0.10（-20dB）：旁白是主角、BGM 垫底；⚠️ 契约
volume 字段只写线性增益、MUST NOT 写 dB（客户端面板显示的才是 dB）；
- 同期声段音量不动：现场声是内容本体，保持原电平，用户在客户端终调；
--mark-weight 0.3 / --gap-fill fast / 句界吸附 0.7：同旅拍图纸口径；- 素材不二用、黑片叠底、层序由 lay 内建，MUST NOT 绕过。
六、字幕层规约（本类型的第二解说轨）
字幕层不是被动烧字幕，而是承载人格与信息的第二条解说轨。 无语音段可由它承接信息。四类字卡进 MG 派单：
| 类 | 用途 | 样本形态 | 挂点 |
|---|
| 吐槽字幕 | 补心声、造笑点 | 「你怎么一直拍着我」「常规操作~」 | 现场段的反应瞬间 |
| 观察字卡 | 补信息、点特色 | 「宿舍楼特色：外卖挂铁门」 | 空镜段 |
| 信息卡 | 攻略数字（收藏钩） | 「田七炖鸡 ¥22」「停车 15 元/3 小时」 | 站点段 |
| 进度/梗卡 | 节奏引擎、互动钩 | 「挑战完成进度:50% 评论区已追加物品」「没动静啊」 | 幕间黑屏 |
工艺：严格按 contracts/gsap-emit-v1.md 颗粒骨架（<template> 包裹 / gsap.timeline({paused:true}) / __timelines 注册 / 无随机无时钟 / 本地 vendor GSAP）；入场 1–1.5s → 定格驻留到坑位末尾（禁全局渐隐）；产前对挂点抽 1 帧看底轨明暗与主体位置。
快速成片禁留白：字卡按规约先斩后奏直接产好叠上，用户不满意在客户端删。
七、精修模式（逐步推进）
每步完成即停、报告产物、等确认再推进：
| 环节 | 暂停点产物 | 调整方式 | 增量重跑 |
|---|
| 立神 | 神一句话 + 类型 + 候选备选 | 随时可推翻重立（创作者想通了、或看稿后发现不对） | 神变=全变：重走选材→写稿→⑥以后全链；如实告知代价再动，别默默重跑 |
| 定档 | 配比判定 + 现场段清单 | 用户改档 | 从写稿重来（档变=稿全变） |
| 写稿 | 旁白稿 vN | 用户改意见 | 改稿后从 ④ 重跑（TTS 变=时码变） |
| 拆分 | split/view.json + 拆分稿 | 改 beat/lane | gtrk split <稿> --project 重落 |
| B-roll | broll-plan.json | 编辑 plan（删/换/pinned） | gtrk matrix lay（零检索零计费） |
| 字卡 | 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 当成片交付；- 云渲必拒：含本地素材的工程提交云渲会被拒（
local_broll_cloud_render_rejected），如实告知；
- 交付话术：报产物目录 + 客户端打开指引 + 各环节实耗；把悔棋通道讲清楚（候选轨小眼睛、字卡可删、三条音轨音量可终调、字幕可整轨换样式）。特别提示用户去客户端调三源混音比例——纪实类的成败很大程度在同期声与旁白的响度平衡上。
九、计费速查
| 环节 | 计费 | 备注 |
|---|
| transcript 抽听定档 | ASR 按分钟 | 只听 1-2 条代表素材，不是全量 |
| matrix index（embed） | 会话计量 | 内部成员豁免 |
| matrix describe | 1 积分/张 | 内部成员豁免；同帧缓存不重复 |
| TTS 旁白 | 1–12 积分/计费分钟 | 仅旁白段，A 档几乎不花钱、B 档接近配音链 |
| project init / split / audio lay / subtitle lay | 0 积分 | --beat-align 走 audio_music_analyze 计费 |
| BGM 矩阵搜索 | 公开口 1 积分/次；成员口 0 | 命令输出如实报口径 |
| image_move 图片运镜 | 2 积分/张 | 素材夹含图片且被选中时 |
起跑前报预估总消耗（检查点①一并确认），结束报实耗。
十、已知边界与排障
gtrk project compose 的当前状态见顶部实现状态块：核对本地版本，组装与图纸分别验收；未完成声音、字幕、运镜时不得称为完整成片；- 毛边口径已定（默认保留部分毛边）：只剪长静默/明显重来/跑题闲聊，语气词与自然停顿保留——MUST NOT 照口播链标准剪干净；
- 旁白盖住现场声：铺完先在客户端听一遍交界处；
- 三源混音（同期声/旁白/BGM）的响度平衡当前靠客户端手调，无自动 ducking；
- 闪帧 / 拆分注释客户端不显示 / describe 的
text_overlay 撞原片字幕区 / matrix lay 拒铺（tracks_edited）/ BGM 曲长不足：同旅拍图纸口径。
改工程：走 gtrk patch，不要裸手改 JSON
跑完之后微调片段（挪位置 / 改时长 / 切开 / 改音量）一律用 gtrk patch：
gtrk patch move --project <dir> --clip <clip_id> --to 5.0
gtrk patch trim --project <dir> --clip <clip_id> --out -1s
MUST NOT 直接编辑 .gtrk 的 JSON：片段时码两套并存（clip_st+clip_ed 与 clip_st+duration），改一份不改另一份会造成客户端与后端读取不同出点。gtrk patch 替你做恒等式同步 + 帧对齐 + 写前全档校验。