@gitruck/cli 1.3.6 → 1.3.8

package/skills/gtrk-music-visualizer/SKILL.md

@@ -18,11 +18,11 @@ description: 音乐可视化成片——把一首歌通过同合云出成一条
 
 ## 一条命令
 
-> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：
-> 交付物 MUST NOT 先写 agent 自有目录再拷进工程；中转本身即违规，体积不是豁免理由。
+> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：
+> 交付物 MUST NOT 先写 agent 自有目录再拷进工程；中转本身即违规，体积不是豁免理由。
 > 成片等一切产物只落产物目录（缺省 = 音频同目录）或**用户显式指定的 `--out`**；
 > **MUST NOT** 把成片、预览或任何大媒体文件复制到 agent 自有工作目录（如用户文档目录下 agent 产品自建的目录、agent 家目录缓存、会话工作区）——需要引用媒体时**用原路径引用**，不做副本；
-> 临时文件一律放系统 temp 且**用完即删**。交付物直接写入工程目录或用户显式指定的路径；引用媒体用原路径。
+> 临时文件一律放系统 temp 且**用完即删**。交付物直接写入工程目录或用户显式指定的路径；引用媒体用原路径。
 
 ```
 gtrk music-visualizer <音频> --template <模板id> [可选样式/文件] [--json]

package/skills/gtrk-narration/SKILL.md

@@ -37,6 +37,7 @@ description: 通用解说视频创作图纸（解说链正本）——把「一
 | ⑦ | **源片语种 / 方言** | **问用户**：听一段 / 看片内有无内嵌字幕 / 看素材出处 | `gtrk transcript --lang`（`zh-CN` 普通话 / **`zh-HK` 粤语** / `en-US` / `ja-JP`…）；素材通篇无对白答「无对白 / 不转写」即闭合，MUST NOT 因缺这个答案阻塞开工 |
 
 > ②③④⑤⑦ MUST 问用户、MUST NOT 代猜；一张表一次问完，不碎问。
+> **精剪包装（公约 §三⁵）**：开工时告知一句「快速成片会在适合的段落做合成包装，最多全片四分之一，不要就说一声」——不是问题，用户说不要即零动作；`gtrk composite bake --abi` 报烘焙浏览器没装时，在这张问询表里多问一句装不装（不装用本机 Chrome / Edge）。
 > **推荐面（公约 §三‴）**：问答收口时可问一句「要不要看看第三方 skill？」；题材命中场景触发词才定向推荐，读取 `gtrk skills recommend --scene <id> --json`；用户拒绝后不执行推荐动作。
 >
 > 语种必须在转写前确认。非中文素材传错语种会让检查点①拿到错误稿件并产生重复 ASR 成本；不要静默使用 `zh-CN`。粤语建议填写 `zh-HK` 作为元数据，当前 `--json` 路径按字级转写；无对白素材回答「无对白 / 不转写」即可。
@@ -224,8 +225,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`、句界吸附缺省）与旅拍图纸 §五 同源，本图纸引用不复制。
@@ -279,8 +283,8 @@ gtrk subtitle lay --project "<工程>" --style <样式> --color <色> --json
 
 | 模式 | 停点 |
 |---|---|
-| **快速成片**（默认） | 开工七问 → 检查点①（必停一次）→ 一杆到底 |
-| **逐步推进** | 每步停等确认（索引结论 / 稿件 / 对照表 / 铺排结果 / 字卡 / BGM / 字幕逐项） |
+| **快速成片**（默认） | 开工七问 → 检查点①（必停一次）→ 一杆到底（含精剪包装，合成静帧随交付一次给） |
+| **逐步推进** | 每步停等确认（索引结论 / 稿件 / 对照表 / 铺排结果 / 字卡 / BGM / 字幕逐项 / 精剪包装按合成 skill 两个检查点） |
 
 差别只在停几次；三条腿自检见《成片型图纸公约》§四。
 

package/skills/gtrk-ref-reading/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: gtrk-ref-reading
+description: 参考片精读——把一条别人的视频读成「可复刻」的整片模型与时码细节：逐字时码转写 + 带台词标签的抽帧网格 + 关键动效逐帧看 + 按「系统」记录每个设计事件对着哪句话，落成 ANALYSIS.md / TIMELINE.md / PROGRESS.md，读完可交给 /gtrk-style-maker 产栏目 skill，或直接指导把这套包装迁移到用户自己的片子上。驱动 `gtrk transcript --json`（取字级时码）与纯本地零计费的 `gtrk media` 看片命令族。当用户想「拆解这条视频 / 精读参考片 / 学一下这个博主的包装 / 分析这条视频的风格 / 这条视频的动画是怎么做的 / 照着这条参考片的风格做 / 把 XX 的风格蒸馏出来 / 参考片逆向」时使用本 skill。凡要从一条参考视频里学包装与节奏，先用本 skill 读透再动手，别看几张截图就开始仿。
+---
+
+# gtrk-ref-reading · 参考片精读
+
+你是读片的人。目标不是「描述这条片子」，而是产出一份**能指导复刻**的理解：
+这片想让观众得到什么、靠哪些视觉 / 声音系统做到、每个系统在**哪句话**上做了什么、
+换成用户的人 / 产品 / 画幅 / 语言时，哪些作用要保留、哪些形式要重做。
+
+## 这个 skill 不做什么 → 找谁
+
+- **不产栏目 skill、不写栏目配置** → 读完交 `/gtrk-style-maker`（精读结论作为「作品逆向」的证据，见文末）。
+- **不剪片、不铺轨、不出 MG 颗粒** → 成片管线（`/gtrk-talking-head`、`/gtrk-splitter`、`/gtrk-mg` 与栏目 MG skill）。
+- **不下载链接**：只读用户本地的视频文件。给的是链接 / 平台 ID 时，请用户先自行合法取得、放到本地。
+
+## 硬边界
+
+> **产物落点纪律（MUST · 全文见随包 `AGENT.md` 同名一节）**：精读产物（ANALYSIS / TIMELINE / PROGRESS / 转写稿 / evidence 下的网格与片段）
+> 只落**精读目录**（缺省 `<参考片同目录>/<参考片名>-精读/`，用户指定优先）。
+> 交付物 MUST NOT 先写 agent 自有目录再拷进工程；中转本身即违规，体积不是豁免理由。
+> 引用参考片用原路径，**不复制原片**；`gtrk media` 的中间物由命令自己放系统 temp、用完即删。
+
+- **计费只有转写一处**：`gtrk transcript --json` 走云端字级 ASR，按官网实时价格计费——跑之前告诉用户这一步要花钱、大约多少（以 CLI 打出的实时提示为准）。`gtrk media` 全部纯本地、零计费、不联网。
+- **用户须有权使用这条参考片**做学习分析。证据图只在精读目录里供判读，**原片的帧与片段 MUST NOT 进栏目 skill 的 assets、MUST NOT 混进成片**。
+- **转写稿 MUST 是这条参考片自己的**：标签和 `--around` 都假设转写稿与视频同一条时钟。`gtrk media` 发现时长 / 文件名对不上会告警——见到告警先查，别带着错时钟读下去。
+
+## 铁律（读片方法，贯穿全程）
+
+1. **整片与细节来回修正。** 先通读形成暂定解释，再逐系统精读；细节推翻整片理解时，回去改 ANALYSIS。只做其中一头都读不准。
+2. **让时间可见，不靠代表帧。** 口播类参考片先取字级时码；网格一律带 `--transcript`；关键动效逐帧看。几张截图说不清一个东西何时进、怎么变、驻多久、何时走。
+3. **按「系统」记，不按镜头记。** 跨镜头存在的物件（一块板、一个圆窗、一套字幕）在 ANALYSIS 里**记一次**，再在 TIMELINE 里按时间记它的**状态变化**（出现 / 高亮 / 灰化 / 合并 / 换形态 / 退场）。镜头边界只用来导航。
+4. **每个设计事件都写「对着哪句话」。** 原句引文 + 源片秒，再写它为观众做了什么（落一个数、答一个问题、给判断盖章、让位给下一个论点）。迁移时按这句话的**作用**重绑到目标稿，**MUST NOT 照抄秒数**。
+5. **迁移时保留作用、重做形式。** 换人 / 换产品 / 换画幅 / 换语言时，问「这个系统在这里干什么」，再为目标设计能干同一件事的形式。目标上不成立的作用（没有真实数据却要画数据图）就明确不做，**MUST NOT 编内容去填形式**。
+6. **文件是记忆。** 发现一条写一条：整片模型进 ANALYSIS，时码细节进 TIMELINE，当前问题 / 未看的段落 / 下一步进 PROGRESS。换会话的人只读这三份文件就能接着读。
+7. **事实与解读分开写。** 「看到的」是画面 / 网格 / 转写稿上能指出的东西；「它在做什么」是你的解读。没看清的标「待查」并记下时码，回到源片换个尺度再看，**MUST NOT 凭印象补写**。
+8. **采样之间有空隙。** 概览网格会漏掉短事件，相邻两格看着没变不等于中间没发生事。追一个系统时把密度加到能看清它的进 / 变 / 驻 / 出为止。
+9. **动效的名字只是起点。** 「弹出」「推近」不够复刻：要看路径、缩放 / 透明度变化、几帧到位、有没有过冲和回落、到位后是静止还是慢漂、和邻近事件谁先谁后。一个物件的「淡出副本」可能就是它自己在退场——逐帧看清再下结论。
+10. **边读边说。** 每读完一段，用一两句话 + 一张代表网格告诉用户你发现了什么、它对迁移意味着什么；细节留在文件里。用户的口味与背景信息能改变读法，别闷头读完才开口。
+
+## 工序
+
+### 0 · 立案
+
+确认四件事并写进 `PROGRESS.md` 第一版：参考片路径（可多条，定一条主读、其余交叉印证）；用户要学什么（整体包装 / 某个系统 / 节奏）；目标是什么（套到谁的什么片上：换人？换产品？换画幅？换语言？）；精读目录在哪。
+
+### 1 · 取证底座
+
+```bash
+gtrk media probe "<参考片>"                                     # 时长 / 尺寸 / 帧率 / 有无音轨
+gtrk transcript "<参考片>" --json --out "<精读目录>/transcript.md" # 计费：先告知用户
+gtrk media lines "<精读目录>/transcript.json"                     # 逐句：u<id> 起–止 文本
+gtrk media boundaries "<参考片>" --rate 4 --threshold 0.12 \
+  --transcript "<精读目录>/transcript.json" -o "<精读目录>/evidence/boundaries.json"
+```
+
+- `--out` 指到精读目录里的 `transcript.md`，字级时码稿就落在同目录的 `transcript.json`（`gtrk media --transcript` 吃它）。Markdown 里待补的「总结」可以不补——ANALYSIS 就是这条片子的总结。
+- 无口播的参考片（纯音乐 / 纯画面）跳过转写，用画面变化与动作定位。
+- `boundaries` 给的是**视觉变化候选**（机械证据，不是镜头判定）；它的平均间隔就是「多久一变」，候选附的句号告诉你换板发生在哪句话上。
+
+### 2 · 通读整片
+
+读完整的转写全文，再看整片概览网格：
+
+```bash
+gtrk media tiles "<参考片>" --frames 48 --cols 6 --rows 4 --cell 320 \
+  --transcript "<精读目录>/transcript.json" -o "<精读目录>/evidence/overview"
+```
+
+写 ANALYSIS 的「这片想让观众得到什么」「整片结构与节奏」（分段表：段 / 时码 / 看到的 / 它在做什么）。长片分段读，但始终保持对整片走向的把握。
+
+### 3 · 认出系统
+
+从概览与变化点里找**反复出现、跨镜头存在**的东西：讲者机位、画中画、实体图标 / 徽章、数字、标题牌、字幕、章节标识、B-roll、梗图、转场、声音标点……
+每个系统在 ANALYSIS 记一次：**看到的**（形态、位置、配色、字体气质）/ **它在做什么** / **状态集合** / 首次出现时码。用参考片自己的样子命名（S1 书柜机位、S4 逐字落板……），别套别人的分类表。
+
+### 4 · 逐系统精读
+
+对每个系统挑 2–3 处最典型的出现，按尺度切换：
+
+| 要回答的问题 | 命令 |
+|---|---|
+| 这段话和画面怎么一一对上 | `gtrk media tiles "<参考片>" --around "<台词>" --padding 1 --every 0.5 --cols 4 --rows 3 --transcript <稿> -o evidence/<名>` |
+| 一个元素几帧到位、之后怎么动 | `gtrk media tiles "<参考片>" --around "<台词>" --padding 0.3 --every-frame --cols 6 --rows 4 --cell 360 --transcript <稿> -o evidence/motion/<名>` |
+| 字体、配色、间距、层级 | `gtrk media frames "<参考片>" --at <秒,秒> -o evidence/<名>`（缺省源分辨率，看清再写色值与字重） |
+| 一次看好几段 | `gtrk media tiles "<参考片>" --ranges <ranges.json> --transcript <稿> -o evidence/<名>`（`[{id, around}` 或 `{id, start, end}]`） |
+| 台词出现在哪 / 重复几次 | `gtrk media lines <稿> --find "<台词>"`，再用 `--occurrence <n>` 选 |
+| 留一段动态证据 | `gtrk media cut "<参考片>" --around "<台词>" --occurrence <n> -o evidence/<名>.mp4` |
+
+每读清一处，就在 TIMELINE 写一节（格式见 `references/landing-templates.md`）。逐帧看动效时照 `references/close-reading-checklist.md` 过一遍。
+
+**读网格**：每格画面下方三行——①源片秒 · 时码（逐帧模式加帧号）· 句号；②此刻正在读的字与字级起止；③所在整句（当前字高亮）。
+「此刻无字在读」「句间空隙」只说明这一刻没有字级时码覆盖，**不等于静音**。网格是证据，结论由你写，并在 TIMELINE 里写上证据路径。
+
+### 5 · 回头修正整片模型
+
+细节改变了理解（发现两个「不同物件」其实是同一物件的两个状态、某个转场其实是章节标点），就回去改 ANALYSIS。
+补齐「色彩与字体」（从大图取近似色值，写清用途）与「动效性格」（快进慢驻？状态变化多于出场？切走不清板？）。
+
+### 6 · 给每个系统判归属：叠层还是版式
+
+逐个系统问一句：**「它改不改变讲者在画面里的位置、大小或可见区域？」**
+
+- **不改变** → **叠层**：叠在既有画面上、讲者原样不动（字卡、角标、大数字、印章、标签……）。迁移时归 MG 生产 skill（`produces: "MG"`）。
+- **改变** → **版式**：讲者被缩放、裁切、挪位或让位（人像圆窗、图版与讲者同屏、对照并排、整幅标题版式、逐句换画面……）。迁移时归合成风格 skill（`produces: "composite"`，由 `/gtrk-composite` 消费）。
+
+判据看**讲者**，不看元素大小：整幅替换掉讲者的标题版属版式（讲者的可见区域变成零）；一枚很小的人像圆窗也属版式（讲者被缩放、裁切）；压在讲者画面上的大号字卡仍属叠层（讲者原样在场）。
+在 ANALYSIS 每个系统下加一行「归属：叠层 / 版式」并写一句理由（看了哪张网格判的）。拿不准的系统去逐帧网格里看讲者那一格的变化，别凭印象定。
+两类**不能混进同一个栏目 skill**——把「图版 + 讲者圆窗」做成 MG 的结果，是整幅底板挖洞露脸，讲者其实没被缩放，形式对不上作用。怎么登记进栏目配置以 `/gtrk-style-maker` 第⑥招「家族切分」为准，本 skill 只负责判归属、给证据。
+
+### 7 · 迁移表
+
+ANALYSIS 末节按系统写一张表：**归属（叠层 / 版式）/ 保留什么作用 / 在目标上形式怎么重做 / 不做什么及理由**。
+目标的变化逐项过：换人（这个角色在所有出现处都要换，不只是脸）、换产品（产品的真实卖点、道具、界面、证据、CTA）、
+换语言（字幕分组与节奏跟着新语言走）、换画幅（横转竖时哪些系统要重新构图、哪些要拆）、增删系统（删掉的系统原来干的活交给谁）、多参考片（每个作用来自哪条，冲突怎么取舍）。
+
+### 8 · 交付与交棒
+
+跟用户讲清：整片模型一句话、最关键的 3–5 个系统（各附一张证据网格路径）、迁移要点、仍待查的问题。然后按用户的去向交棒：
+
+- **要沉淀成自己栏目的风格体系 / 栏目 skill** → `/gtrk-style-maker`（见下节）。
+- **栏目 skill 已就绪、要直接做片** → 回成片管线，按 TIMELINE 里「对着哪句话」的关系在目标稿上重新落点。
+- **只是学习 / 评估** → 精读目录本身就是交付物。
+
+## 交给 /gtrk-style-maker 时
+
+精读结论是**证据**，不是用户的维度。`/gtrk-style-maker` 的「作品逆向」会拿 ANALYSIS 里的系统**逐个出示证据网格**问用户：
+「这个像你吗？哪里不像？你会怎么叫它？」——用户认领的才进栏目 skill，命名用用户的话；用户否掉的记成禁令候选。
+所以交棒时给它：精读目录路径、系统清单（每条附一张最能说明问题的网格**和归属：叠层 / 版式**）、迁移表。**不要替用户把系统清单直接写成栏目 skill。**
+归属决定用户认领的系统最后进 MG 生产 skill 还是合成风格 skill；两类分开登记的做法见 `/gtrk-style-maker` 第⑥招。
+
+TIMELINE 里的典型段落可以成为栏目 skill 的判例（「这句话该落一个大数字，因为……」），但判例里放的是**我们按其作用重做的成品**，不是原片截图。
+
+## 交付前自检
+
+- [ ] 口播参考片有字级转写；所有引用的网格都带了 `--transcript`？
+- [ ] ANALYSIS 每个系统都写了「看到的 / 它在做什么 / 状态集合」，且是**一次**记录、不按镜头重复？
+- [ ] 每个系统都按「改不改变讲者的位置、大小或可见区域」判了归属（叠层 / 版式）并写了依据；没有把版式类系统归成叠层？
+- [ ] TIMELINE 每节都有：源片秒区间 + 段落意义、原句引文、发生了什么、为观众做了什么、证据路径（文件真实存在）？
+- [ ] 至少一个关键动效做过逐帧（写得出几帧到位、之后怎么动）？
+- [ ] 事实与解读分开；没看清的标了「待查」与时码？
+- [ ] 迁移表逐系统写了保留作用 / 重做形式 / 不做及理由；没有为填形式编造内容？
+- [ ] PROGRESS 写清当前问题、未看的段落 / 系统、下一步？
+- [ ] 产物全在精读目录；没复制原片；原片帧没有流进栏目 skill 或成片？

package/skills/gtrk-ref-reading/references/close-reading-checklist.md

@@ -0,0 +1,47 @@
+# 精读清单（按系统类型）
+
+> 清单是**提问的方向**，不是要填满的表：只问这条参考片里真实存在的系统。
+> 每一问都要能落到 TIMELINE 的某一节（源片秒 + 对着哪句话 + 证据路径）。
+
+## 动效（逐帧网格上看）
+
+- **前一刻是什么、变了什么、之后留下什么。** 一个入场再漂亮，落定后的状态说不清论点也白搭——落定状态是重点。
+- **几帧到位**：从第一帧可见到落定数帧号（网格标签带 `帧#n`），换算成秒；**到位之后**是静止、慢推、慢漂还是呼吸。
+- **怎么动**：路径（直线 / 弧线 / 从哪个物件来）、缩放与透明度、有无过冲和回落、模糊或拖影。
+- **和谁同步**：落在哪个字上（字头前已落定？字尾才到？）；和邻近事件谁先谁后；是否跟声音标点同拍。
+- **物件身份**：同一个物件跨状态是否保持形状 / 颜色 / 轨迹（徽章变饼图、卡片变附件）；「淡出的副本」是不是它自己在退场。
+- **硬切还是连续变化**：硬切适合「下一个想法一眼就懂」，连续变化适合「要看清怎么变的」。
+
+## 构图与图形（大图上看）
+
+- 眼睛**第一眼**落在哪、然后看哪；靠尺寸、间距、分组、对比、颜色还是运动建立层级。
+- 讲者的位置给图形留了多大地方；讲者、图形、字幕谁在这一刻领衔。
+- 配色：几种主色、各干什么（正向 / 负向 / 强调 / 底）；字体：标题 / 正文 / 数字 / 外文各是什么气质、字重、字距。
+- 哪些是可编辑的结构（随话改变的数字、标签、状态），哪些只是素材（照片、截图、纹理）。
+
+## 字幕与画面文字
+
+- 字幕显示的是说出来的话；独立的标题、标签、意译属于排版 / 图形，不是字幕——分开记。
+- 字幕的分组（一屏几字、按意群还是按句）、位置、强调方式、是否随讲者 / 画面让位。
+- 每种**不同的配置**（讲者不同、位置不同、强调不同）各记一次，也记它们之间怎么切换。
+
+## 讲者（A-roll）与画中画
+
+- 讲者在画面里是什么角色：全屏聊天、缩成小窗继续在场、被图形临时替换。
+- 观点句 / 吐槽句 / 转折句是否总回到讲者全画面，信息句交给图形——这是节奏语法，记清楚。
+
+## 素材（B-roll）
+
+- 素材在这一刻是**精确对应**（这句话必须看见这张图）还是**一组画面传达一个意思**（习惯、历史、过程、态度）。
+- 素材被怎么处理：压暗做底、裁切、加框、局部高亮。
+
+## 声音
+
+- 音乐的起落是否标出段落；有没有声音标点（转场音、印章音、计数音）和画面同拍。
+- 讲者声音在全屏素材下是否连续；换段时声音先走还是画面先走。
+
+## 迁移时逐项问
+
+- 这个系统在这里**干什么**？目标片里有没有同样的活要干？
+- 目标换了人 / 产品 / 画幅 / 语言后，这个形式还成立吗？不成立就换一个能干同样活的形式。
+- 删掉一个系统时，它原来干的活交给谁？

package/skills/gtrk-ref-reading/references/landing-templates.md

@@ -0,0 +1,95 @@
+# 精读目录落盘模板
+
+> 骨架是起点，不是表单：章节随这条参考片长，没有的系统不硬写，多出来的就加。
+> 时码一律写**源片秒**（如 `121.9`），需要时括注 `02:01.9`；证据路径写相对精读目录的路径。
+
+```
+<精读目录>/
+├── ANALYSIS.md      整片模型
+├── TIMELINE.md      时码细节
+├── PROGRESS.md      接力
+├── transcript.md    gtrk transcript 的可读稿
+├── transcript.json  字级时码稿（gtrk media --transcript 吃它）
+└── evidence/
+    ├── overview/            整片概览网格（tiles 产物目录，含 index.json）
+    ├── boundaries.json      视觉变化候选
+    ├── <段落名>/            段落带台词网格
+    ├── motion/<动效名>/      逐帧网格
+    ├── <名>-frames/         大图（字体 / 配色）
+    └── <名>.mp4             证据片段
+```
+
+---
+
+## ANALYSIS.md
+
+```md
+# <栏目 / 参考片名> · 整片解读（ANALYSIS）
+
+> 证据：<参考片路径>（<时长>，逐字转写 `transcript.json`）；交叉印证：<其它参考片>。时码细节见 `TIMELINE.md`，抽帧证据在 `evidence/`。
+> 下文「看到的」是画面事实，「它在做什么」是解读。
+
+## 一、这片想让观众得到什么
+<观众看完能复述什么；它让人坐得住 / 看下去的办法是什么>
+
+## 二、整片结构与节奏
+| 段 | 时码 | 看到的 | 它在做什么 |
+|---|---|---|---|
+| 冷开场 | 0–6 | … | … |
+
+切点密度：`boundaries` <参数> 测得 <N> 处视觉变化，平均约 <x>s 一变；<各系统单次停留时长>。
+
+## 三、视觉 / 声音系统（每个系统写一次，状态变化见 TIMELINE）
+
+### S1 <用这条片自己的样子命名>
+- 看到的：<形态 / 位置 / 配色 / 字体气质>
+- 状态：<出现 / 高亮 / 灰化 / 合并 / 换形态 / 退场……>
+- 它在做什么：<对观众的作用>
+- 首次出现：<秒>（`evidence/…`）
+- 归属：<叠层 / 版式>——<讲者的位置、大小或可见区域变没变；依据哪张网格>
+
+## 四、色彩与字体（从大图取的近似值）
+- <角色>：<色值>，用在 <哪里>
+- 字体气质：<标题 / 正文 / 数字 / 英文各是什么气质>
+
+## 五、动效性格
+- <如：快进慢驻——元素 4–6 帧到位，之后整幅慢推，见 `evidence/motion/…`>
+- <如：状态变化多于出场；切走不清板>
+
+## 六、迁移：哪些保留作用、哪些重做形式
+| 系统 | 归属 | 目标上怎么落 |
+|---|---|---|
+| S1 … | 叠层 / 版式 | 保留：<作用>；重做：<目标上的形式>；不做：<什么及理由> |
+```
+
+## TIMELINE.md
+
+每节一个「源片秒区间 · 段落意义」标题，节内写**对着哪句话、发生了什么、为观众做了什么、证据在哪**。
+密集段落可以逐句列。同一个系统跨多节时，用 ANALYSIS 里的系统名指代它，只写这次的状态变化。
+
+```md
+# <参考片名> · 时码精读（TIMELINE）
+
+> 源：<参考片>（<时长>）。时码 = 源片秒；字级时码见 `transcript.json`。
+
+## 121.5–146.0 · 持续板：逐个排除（核心范例）
+证据：`evidence/排除/`、`evidence/motion/stamp/`。
+- 121.9「这个行业有 5 家大公司」→ S4 徽章板回来，左上小灰条标题，S2 讲者圆窗在左下。
+- 123.9「第一家」→ 该徽章放大变亮；「买不动」→ S5 红色印章约 124.9s 落在徽章上（逐帧：4 帧到位、轻微过冲后回落）。
+- 131.9「剩下的两家还可以」→ 两枚徽章变金黄（选中态）。
+→ 观众每听到一个名字，眼睛就落到那枚徽章上；判断落章。插一句讲者全画面后板回来，状态保留。
+```
+
+## PROGRESS.md
+
+```md
+# 精读进度
+
+- 目标：<学什么；套到谁的什么片上>
+- 主读：<参考片>；交叉印证：<…>
+- 当前问题：<正在弄清的一件事>
+- 已读：<段落 / 系统清单>
+- 未读：<段落 / 系统清单，带时码>
+- 待查：<没看清的事 + 时码 + 打算用什么尺度看>
+- 下一步：<一句话>
+```