@gitruck/cli 1.2.13 → 1.2.15

package/AGENT.md

@@ -8,6 +8,25 @@
 > → 拉回 gtrk/剪映/PR 三方工程文件 →（可选）本地 ffmpeg 渲染成片 → 三端打开**。云端零改动、纯结构产物，
 > 源视频不出本地。结果/报告恒落盘 `result.json`，可按 `task_id` 秒级取回、无需重跑（见 §2.1 / §4）。
 
+## Agent 去水印/去字幕
+
+按用户意图选择流程，文字候选不等于该删除的内容；图形台标由 Agent 判断并补框。
+
+**去除前必须主动问用户选模式并等答复**：快速 ffmpeg 做基础模糊，可能留涂抹痕迹；慢速 raft 做内容修复，通常更自然、可接近无痕，但不保证无损或还原遮挡细节。不得替用户默认任何模式。“无需复核选区”不等于选了模式；本任务已经明确选择的无需重复问。仅检测、编辑和空清单原片返回不受影响。模式不可因失败、耗时或限额自动切换，本地 ffmpeg 兜底也须另获用户同意。
+
+1. `gtrk purify detect <视频> --out <目录> --json`：只检测，返回待审区域文件、摘要、代表时间点和运行记录。
+2. 读取摘要、按代表时间查看原片；用 `gtrk purify edit <区域文件> --select-roi x,y,w,h --delete-id det-000001 --watermark-region x,y,w,h --protect-region x,y,w,h --out <最终文件>` 做本地筛选和补框。各筛选参数按需使用；完整 JSON 留在文件，不灌入对话。
+3. `gtrk purify apply <最终文件> --purify-func-type <用户选定模式> --json`：只按最终清单处理，不重新检测。
+
+用户明确全部清理范围时，可用 `gtrk purify run <视频> --detect-scope subtitle --watermark-region x,y,w,h --purify-func-type <用户选定模式> --json` 连续完成。run 必须明确 full_screen/subtitle/custom；custom 同时传 --detect-roi。
+
+- `--purify-func-type ffmpeg|raft`：处理前显式必选，无默认值；ffmpeg 快速模糊，raft 慢速内容修复。保留处用 protect-region，保护优先。
+- `gtrk purify resume <运行记录.json> --json`：继续已有任务和下载，沿用已选模式；旧记录尚未建处理任务时须询问并补 --purify-func-type。提交结果未知时停止重发，先核对云端任务。
+- 空最终清单直接返回原视频，不创建处理任务。
+- 检测与处理按原计费口径各计一次；本地 edit 免费。源路径、SHA256 与云文件绑定，换片须重检。
+- JSON 回执给出实际文件路径；状态是 awaiting_review / completed / unchanged。
+- 新处理请求会先查询 /task/video_purify/capabilities，必须支持 review_protocol=2；未升级会在上传与计费前停止。先更新 worker，再开放 HTTP 能力声明。
+
 > **写/改 structure 级成片图纸**（旅拍 / 口播链 / 直播切片 / Vlog……）先过 `docs/成片型图纸公约.md`
 > ——双模式命名（快速成片 / 逐步推进）、决策前置三条腿、MG 临场泛化的横切正本与自检清单都在那里。
 
@@ -132,16 +151,16 @@ gtrk transcript <本地视频.mp4> --json          # 转成一个含总结/时
    - **不越过用户自装的 ffmpeg**：定位仍是 `--ffmpeg-path` → `~/.gitruck/ffmpeg` → 系统 PATH。
    - 字体落 `~/.gitruck/fonts`，经 `ass` 滤镜 `fontsdir` 供给——**不动用户的系统字体表**。
    - 平台未覆盖时（如 linux-arm64）会明确报错并指引手工安装，**不会错装其他架构的包**。
-
-6. **skill 新鲜度（agent 纪律 · fix-skill-install-staleness）**：随包 `/gtrk-*` skill 是
-   **装进去的那一刻的快照**，`npm i -g @gitruck/cli@latest` 升级 CLI **不会**刷新它们。
-   ⇒ **你正在读的这份 skill 有可能落后于当前 CLI 版本，而且落后时不会报任何错。**
-   需要 skill 的命令在检测到落后时会往 **stderr** 打一次提示并附修复命令；
-   见到它 **MUST** 转告用户跑 `gtrk skills install`（或 `gtrk upgrade`），
-   **MUST NOT** 当噪音忽略 —— 「照着旧口径继续干活」正是这条提示要防的事。
-   随时自查：`gtrk doctor` 里的「Skill 新鲜度」一行。判不出或一致时**零输出**，
-   所以没看到提示不等于装过（没装过 manifest 就不存在，doctor 会如实说判不出）。
-
+
+6. **skill 新鲜度（agent 纪律 · fix-skill-install-staleness）**：随包 `/gtrk-*` skill 是
+   **装进去的那一刻的快照**，`npm i -g @gitruck/cli@latest` 升级 CLI **不会**刷新它们。
+   ⇒ **你正在读的这份 skill 有可能落后于当前 CLI 版本，而且落后时不会报任何错。**
+   需要 skill 的命令在检测到落后时会往 **stderr** 打一次提示并附修复命令；
+   见到它 **MUST** 转告用户跑 `gtrk skills install`（或 `gtrk upgrade`），
+   **MUST NOT** 当噪音忽略 —— 「照着旧口径继续干活」正是这条提示要防的事。
+   随时自查：`gtrk doctor` 里的「Skill 新鲜度」一行。判不出或一致时**零输出**，
+   所以没看到提示不等于装过（没装过 manifest 就不存在，doctor 会如实说判不出）。
+
 
 ---
 

package/CHANGELOG.md

@@ -9,6 +9,27 @@
 > ⚠️ **`gitHead` 只是旁证**：1.2.7 是从**带未提交改动的工作区**发的——`link-cloud-font-library` 的实现
 > 在 1.2.7 的包体里逐字可见，却要到 2026-09-19 的 `4ee4f74` 才进仓。判版本归属一律以包体为准。
 
+## 未发布
+
+- 视频去水印不再默认 FFmpeg：Agent 必须在处理前说明快速模糊与慢速内容修复的效果代价，等待用户选模式；`purify run/apply`、人工框和 `tool video_purify` 缺少显式模式时在上传前停止。仅检测、编辑和空清单不受影响；旧记录未建处理单时需补选模式，已建单继续原任务。失败后不得擅自改用快速或本地 FFmpeg。
+
+- `tool --batch` 补齐整批费用预估：标准价/超额价积分与额度包单位数分别汇总，按分钟收费先本地探时长，逐任务取整后求和；跳过项不计费、不探测。价格或计量不可用时明确说明无法预估。
+
+- `ai-drama lay` 成功回轨后提示先显式指定口播音频运行 `patch snap --dry-run` 检查，再执行吸附并用 `patch seal` 补缝；只提示，不自动编辑。
+
+## 1.2.13（2026-09-22，AI 漫剧工具批次补记）
+
+> npm 发布时点为 2026-09-22 08:26:53 UTC。本节补记这批已实现能力；不表示其全部 OpenSpec 已归档。后续音轨识别、素材内容寻址和镜头锚定仍在独立待办中。
+
+- `ai-drama pack` 从本地镜头与派单构建 return-v1 包，实测尺寸、帧率、时长，缺镜或校验失败不落包；`swap` 验证结构等价后替换并默认备份，工程文件不改。
+- `patch snap` 按音频能量定位切点，支持干跑和诊断；当前自动选音轨仍有已登记缺陷，含 BGM 的工程应显式给 `--audio`。`patch seal` 按指定轨和阈值补小缝，重叠及超阈值间隙只报，推荐顺序为 snap → seal。
+- `patch --json` 输出单行 JSON，补齐 `ok`、`dry_run`、`project`、`invariants`；旧 `gtrk` 与 `preexisting` 别名保留。依赖多行缩进输出的外部脚本请改为逐行解析完整 JSON。工程级操作补齐 `frames:null`、`before` 与参数回执。
+- 投影选轨加入口播素材匹配；视频主轨有画面却不含目标口播素材时可回退音轨，避免配音工程被额外视频轨阻断。
+- `mg` / `split` 增加覆盖区间与空档读数，以最长空档提示，不因颗粒稀疏阻断工作流。
+- `doctor --project` 汇总素材、轨道和工程结构检查；只对视觉底轨提示缝隙，缺省环境体检入口不变。
+- `qc contact-sheet` 生成带镜号和时长标签的分页联络表，标签与源文件保持绑定。
+- `tool --batch` 增加受限并发、已有产物跳过、失败汇总与 JSONL 明细；本地工具默认串行。该发布版的计费提示仅提供批次条数和单价；整批总费用估算已在上方「未发布」条目补齐。
+
 ## 1.2.11（2026-09-19）
 
 ### 改：`gtrk transcript --json` 带字级时码，成片字幕时间按语音贴（adjust-transcript-json-word-level）