@gitruck/cli 1.3.14 → 1.3.16

package/AGENT.md

@@ -365,11 +365,15 @@ gtrk patch split --project <dir> --clip c2 --cut 5.5       # 切成两段
 gtrk patch set   --project <dir> --track audio:1 --at 3.0 --volume 0.5
 gtrk patch set   --project <dir> --total max               # 改顶层总长（工程级）
 gtrk patch add     --project <dir> --track video:2 --to 263.733 --candidate <clip_id>   # 把候选放上空位
+gtrk patch add     --project <dir> --track video:2 --to 263.7 --candidate A --to 266.2 --candidate B   # 一次放多段（成对重复）
 gtrk patch replace --project <dir> --clip <clip_id> --candidate <clip_id>               # 原地换源
+gtrk patch remove  --project <dir> --clip <clip_id>                                     # 删掉一个片段，原位置留空
 ```
 
-**精修期把候选放上空位用 `patch add`；空位被黑底补片占着用 `patch replace`**——不要为此整轮 `matrix lay --force-relay`，也不要手改 `.gtrk`。
-先 `gtrk matrix status --project <dir> --beat <id> --json` 看空缺在哪、候选有哪些，再放。
+**精修期把候选放上空位用 `patch add`；空位被黑底补片占着用 `patch replace`；多铺了的用 `patch remove`**——不要为此整轮 `matrix lay --force-relay`，也不要手改 `.gtrk`。
+先 `gtrk matrix status --project <dir> --beat <id> --json` 看空缺在哪、候选有哪些，再放；轨号以它的 `video_tracks`（盘上）为准——`gtrk client state` 的 `disk.track_map` 会告诉你客户端里没保存的轨把号挪到了哪。
+一次放多段：`--to` 每给一次是一段，`--candidate` / `--material` / `--dur` 等与它按顺序配对（只给一次就各段共用），一次下载、一次写回，不用写 `--ops` 文件。
+plan 里的候选放上轨时会顺手登记进该 beat 的候选池（回执 `source.pooled`），用户在客户端面板里就能看到、能换；只想补进候选池不上轨用 `gtrk matrix lay --project <dir> --pool-only --beat <id>`。
 
 **寻址两条路**（互斥，二选一）：
 

package/CHANGELOG.md

@@ -11,6 +11,21 @@
 
 ## 未发布
 
+- 新：`gtrk matrix describe --layout grid` 可选让服务端把帧拼成 3×3 宫格一次理解，同一 beat / 检索词的候选尽量拼在同一页；缺省仍逐张（`--layout single`），计费不变（1 积分/张）。服务端是否真按宫格执行只看回执：未升级或被运维停用时如实说明「按逐张理解」，`--json` 带 `layout_receipt` / `layout_counts`。宫格产物的 mark / highlight 只在同一页内可比、景别与黑边不如逐张稳，人读输出会提醒；缓存记下产出方式，逐张运行不复用宫格产出的缓存（`--json` 的 `stale_layout`）。需服务端同步上线宫格批量后才生效（link-add-material-describe-grid-batch）。
+
+## 1.3.15（2026-11-07）
+
+- 新：`gtrk matrix search` 的 `--query` 可重复给，几个角度一次跑完：结果按素材合并（留最高分），逐条标 `matched_queries`、按分数排，回执带 `queries`；只给一个检索词时输出不变。外网检索仍一次一个词（fix-agent-harness-feedback）。
+- 新：`gtrk matrix search --estimate-only` 只报这次最多花多少积分、不检索：`--json` 的 `billing_estimate: {credits, basis}`（成员口与 `--local` 为 0，公开口按价目表 × 检索词数，算不出为 `null`）。`gtrk oralcut` / `gtrk long2short` 的 `--dry-run --json` 同带 `billing_estimate`。即剪内置 AI 据此对估价不超过 100 积分的命令不再弹确认（fix-agent-harness-feedback）。
+- 新：`gtrk matrix search "<词>" --beat <id> --project <目录>` 把结果写进这个 beat 的候选池：并进本层快照 `split/broll-plan.<层>.json`、追加进工程候选登记，客户端 B-roll 面板立刻能看到，`gtrk patch add --candidate` 直接认得；不铺轨，重跑不重复（fix-agent-harness-feedback）。
+- 新：`gtrk matrix lay --pool-only [--beat <id,…>]` 只把 plan 里还没进工程候选池的候选登记进去——不铺轨、不下载、不动任何轨，也不需要联网。治「`matrix status` 报 `not_in_pool`、面板里看不到」；此前只能跑局部 `matrix lay`，会按铺轨口径另起一条候选轨（fix-agent-harness-feedback）。
+- 新：`gtrk patch add` 一次放多段：`--to 263.7 --candidate A --to 266.2 --candidate B`，`--to` 每给一次是一段，`--candidate` / `--material` / `--track` / `--beat` / `--from` / `--dur` 只给一次就各段共用、给同样多次就按顺序配对。一次下载、一次写回；同一条轨上前一段缺省停在后一段起点；某段出错报「第 N 段」、整批不写（fix-agent-harness-feedback）。
+- 新：`gtrk patch remove (--clip <id> | --track video:<N> --at <秒>)` 删掉一个片段，原位置留空、后面的片段不动；视频与同 id 的镜像音频一起删；`--ops` 里也能用（fix-agent-harness-feedback）。
+- 改：`gtrk patch add / replace` 放上轨的候选只在 plan 里、不在工程候选池时，顺手登记进该 beat 的候选池（层取它所在那份 plan），回执 `source.pooled`——此前轨上有画面、面板里却找不到这条候选（fix-agent-harness-feedback）。
+- 改：`gtrk client state` 读到客户端实时状态时带 `disk`：与盘上工程的轨号对照（客户端有没保存的轨道增删时两边会错开）、是否有未保存改动；对不上时 stderr 提示 `gtrk patch` / `gtrk matrix` 按盘上的轨号写（fix-agent-harness-feedback）。
+- 改：`gtrk matrix status` 顶层带 `video_tracks[]` 全工程视频轨总览（轨号、口播主轨、判定、来源层、片段数），人读首行列出（fix-agent-harness-feedback）。
+- 修：重铺某一层时，候选池里「添加视频链接」/ `gtrk matrix source-import` 导入的候选（没登记来源层）被当成老式条目洗掉；客户端随后把导入任务当检索翻页，「加载更多外网候选」报「更多候选来源或时间段不一致」。现在手动导入的候选哪一层重铺都保留，连同它的导入任务号；没登记层但来自外网的候选按外网层算（fix-agent-harness-feedback）。
+
 ## 1.3.14（2026-11-07）
 
 - 修：`gtrk patch --ops` 清单里的时刻写成 JSON 数字（如 `"at": 375`）时，按 `track` + `at` 寻址的动作崩在 `f.trim is not a function`；现在数字与字符串同一口径（`at` / `to` / `cut` / `track` / `total` 均可）（fix-matrix-partial-relay 3.2）。