@gitruck/cli 1.3.12 → 1.3.13

package/CHANGELOG.md

@@ -11,6 +11,19 @@
 
 ## 未发布
 
+## 1.3.13（2026-11-06）
+
+- 新：`gtrk matrix --online --online-concurrency <n>`（1–8，缺省 3）：外网检索按派单顺序提前提交、同时至多 n 单，不再一单跑完（8–11 分钟）才提交下一单；plan、逐条日志与进度落盘仍按派单顺序，和串行时一样。提交与进度日志带 beat 名。`1` = 旧行为（fix-matrix-layered-plans-and-ux）。
+- 改：每轮检索除主 plan `split/broll-plan.json` 外另存本层快照 `split/broll-plan.<层>.json`（local / online / concept / common；外网零候选、主 plan 被保住时不写），`--json` 带 `layer_plan_path`。换层检索覆盖主 plan 后，别的层仍可 `gtrk matrix lay --plan split/broll-plan.<层>.json` 重铺；`gtrk patch --candidate` 与 `gtrk matrix status` 连同快照一起找候选（主 plan 优先）。概念层检索的 plan 带 `source_layer: "concept"`，`matrix lay` 据此铺进概念层（此前会被当成通用层）；其余层不写该键，既有 plan 不变；`source_layer` 与 `member_type` 不配套的 plan 拒收（fix-matrix-layered-plans-and-ux）。
+- 改：`gtrk patch add / replace` 放上 / 换过的片段带 patch 自己的产出方身份（此前 `add` 不写、`replace` 删掉），所在候选轨判「已编辑」：同一层再 `matrix lay` 拒铺（`tracks_edited`，工程零改动），不再当成你的轨保留、另铺一条越铺越多。整条都是 patch 放的、又不在铺轨登记里的轨仍算你的轨（fix-matrix-layered-plans-and-ux）。
+- 改：已编辑候选轨的拒铺只看本轮要铺的层：别的层的已编辑轨（客户端确认过原片的、patch 改过的）随它的层带保留、不挡本层铺轨，`--force-relay` 也不剥它；告警写明「本轮铺的是 X 层，不动它」。`gtrk matrix status` 的 `lay.edited_track_layers` 报出各已编辑轨所属的层（fix-matrix-layered-plans-and-ux）。
+- 新：铺轨后点名被地板藏起来的候选——整条分（`result.score`）过了 `--score-floor`、片段分（`segments[].score`）却全低于它、一条也没铺上的，逐 beat 报条数与最高片段分，并说明地板卡的是片段分、给出调低地板或钉选两条出路；`--json` 带 `lay.floor_hidden`。`gtrk matrix status` 的候选带片段分（`seg.score`），与整条分不同时人读输出并列「（片段 x）」；`--score-floor` 帮助写明卡的是片段分。地板算法不变（fix-matrix-layered-plans-and-ux）。
+- 改：已装的 gtrk skill 落后于 CLI 包时，没被你改过的（已装副本与安装时的戳一致）直接换成包内版本、只说一行「已把 N 个 gtrk skill 更新到当前 CLI 包的版本」；改过的、换不动的、新加的照旧提示 `gtrk skills install`。`GTRK_SKILL_FRESHNESS=off` 同时关掉自动换新（fix-matrix-layered-plans-and-ux）。
+- 改：`gtrk matrix --online` 不带 `--platforms` 时只检索 `youtube` / `vimeo` / `bilibili` / `pexels`，TikTok 须显式写进 `--platforms`（服务端 TikTok 发现改走按次计费的 TikHub）。升级前同一批次（`--online-session`）按旧缺省（五平台、最早的四平台）建过单的，照旧沿用原请求续跑、不新建单、不重复扣费；要按新缺省检索请换批次名（link-online-broll-tikhub-discovery-cli）。
+- 修：外网检索产出的 plan 被 `gtrk matrix lay` 整单拒收（「segment cuts 须为升序有限数字且严格落在 (start,end) 开区间内」）。服务端把片段起止点本身也列成切点：现在写进 plan 前去掉这些端点切点，`matrix lay` 校验也容忍恰在段起止点上的切点，盘上已有的旧 plan 不用改就能铺；乱序、越界照旧拒收（fix-matrix-online-relay-and-review）。
+- 修：`gtrk patch add / replace --candidate` 在工程根目录本身叫 `gtrk`（`<x>/gtrk/project.gtrk` + `<x>/gtrk/split/`）时读到外层 `<x>/split/broll-plan.json`，报「都没有候选」。现在与 `gtrk matrix` 同一口径：给了 `--project` 且其下有 `split/` 就以它为根，否则看工程文件所在目录有没有 `split/`，再否则退到 `gtrk/` 的上一级；找不到候选时报错写出实际读的 plan 路径（fix-matrix-online-relay-and-review）。
+- 修：外网检索没有可自动铺的候选、只有待人工确认候选（需求里的地点 / 事件 / 年份 / 素材类型等硬条件服务端核实不了）时，CLI 此前报「0 条候选」或「外网平台或素材处理失败」、计入 `errors`，还建议「调整检索描述后重试」（换描述会新建计费任务）。现在逐条写「0 条自动候选，另有 N 条待人工确认」、不计 `errors`；汇总单独列出，说明它们在 plan 的 `queries[].online.review_candidates`、挑中后移进 `results`（可加 `pinned:true`）再 `gtrk matrix lay` 即可铺，并说明不必重跑；铺轨阶段的零候选告警点名各 beat 的待核条数（已进客户端候选池）；`--json` 的 `counts` 加 `review_only` 与 `review_candidates`，既有字段不变。真正零召回的仍给重试建议（fix-matrix-online-relay-and-review）。
+
 ## 1.3.12（2026-11-05）
 
 - 新：`gtrk patch add --track video:<N> --to <秒> (--candidate <clip_id> [--beat <id>] | --material <id>) [--from <秒>] [--dur <秒|Nf>]`，把一条 B-roll 候选或已登记素材放到视频轨的空位上：候选先查工程候选池（含邻居）再查 `split/broll-plan.json`，素材还没登记时顺手下载预览到 `assets/broll-preview/` 并登记（与 `gtrk matrix lay` 同一份落地实现，已登记的不重下）——`matrix source-import` 之后一条命令就能上轨。缺省时长取落点所在空位、出点与右邻同一帧；入点缺省与客户端拖候选同一取窗。落点与已有片段重叠即拒并列出挡路片段（黑底补片指路 `patch replace`），覆盖到的空档让位；源片不够长钳短告警、不拉伸；图片候选不收；不建轨、不 ripple。新片段 `<beat>-add-<n>`、不带产出方身份（add-patch-insert-replace）。