@gitruck/cli 0.2.23 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/AGENT.md CHANGED
@@ -48,6 +48,20 @@ gtrk transcript <本地视频.mp4> --json # 转成一个含总结/时
48
48
  > agent 自检:没配 Key 时任何命令会明确报「缺 API Key —— 先跑 `gtrk init`」。剪映目录没配只影响剪映直开,不挡 gtrk/PR。
49
49
  > `init` 是**人手一次性**交互配置(会弹提示);agent 日常只跑非交互的 `oralcut`。
50
50
 
51
+ 5. **按需装运行时资产**(只有用到本地渲染/烧录才需要):
52
+
53
+ ```
54
+ gtrk deps status # 先查:ffmpeg / 字体各自的来源与授权
55
+ gtrk deps install --ffmpeg --font # 缺什么装什么,已存在自动跳过
56
+ ```
57
+
58
+ - **agent 纪律:CLI 绝不静默自动下载**。遇到「未找到 ffmpeg/ffprobe」或「本机缺字幕模板所需字体」,
59
+ **先跑 `gtrk deps status` 确认真缺**,再跑 `install`——不要看到报错就无脑装(先查后拉)。
60
+ - 包体 30–90 MB(按平台),走同合云镜像;下载自动过 sha256 校验,解包用系统 tar,无第三方依赖。
61
+ - **不越过用户自装的 ffmpeg**:定位仍是 `--ffmpeg-path` → `~/.gitruck/ffmpeg` → 系统 PATH。
62
+ - 字体落 `~/.gitruck/fonts`,经 `ass` 滤镜 `fontsdir` 供给——**不动用户的系统字体表**。
63
+ - 平台未覆盖时(如 linux-arm64)会明确报错并指引手工安装,**不会错装其他架构的包**。
64
+
51
65
  ---
52
66
 
53
67
  ## 2. 核心命令:`gtrk oralcut <毛片>`
package/README.md CHANGED
@@ -28,6 +28,7 @@
28
28
  | ✂️ | `gtrk split [拆分稿]` | 视觉拆分派单器:成片 × transcript 投影 → beat 分镜校验落地(`struct_meta.split` + `dispatch.json`),驱动四车道派单;`--column <id>` 按栏目词表校验 |
29
29
  | ⚙️ | `gtrk init` | 引导式一次性配置(API Key + 剪映草稿目录),之后免管 |
30
30
  | 🩺 | `gtrk doctor` | 体检:配置 / 云端连通 / 剪映目录 / 运行时一键自检 |
31
+ | 📦 | `gtrk deps` | 运行时资产:`status` 查 ffmpeg/字体的来源与授权,`install` 从同合云镜像装(**须显式触发,绝不静默自动下载**) |
31
32
  | 🤖 | `gtrk skills install` | 通过通用 `skills` 适配器和 gtrk 补充层,把 10 个 CLI 自带 skill 装进本机检测到的主流 Agent;`--all` 可覆盖全部已登记宿主 |
32
33
  | ⬆️ | `gtrk upgrade` | 升级 CLI 到最新版 + 刷新 skill(配置保留);`--check` 只查不装 |
33
34
  | 🎞️ | `gtrk render` | 本地渲染 gtrk 工程(EDL)→ 成片 mp4(需 ffmpeg) |
@@ -484,6 +485,13 @@ gtrk transcript "D:/素材/采访视频.mp4" --lang zh-CN --out "D:/文字稿/
484
485
  - `gtrk install [--api-key … -y --skill-agents codex,cursor --all-agents --copy-skills --skills-dir …]` — 一条命令装全(skill + 配置 + 体检),对标飞书 `lark-cli install`。
485
486
  - `gtrk init [--api-key … --api-base … --jianying-draft-dir … -y]` — 仅配置(交互 / 非交互)。
486
487
  - `gtrk doctor` — 体检(含 CLI 版本 / 有无新版)。
488
+ - `gtrk deps status` — 查 ffmpeg/ffprobe 与渲染字体的**当前来源**(`--ffmpeg-path` / `~/.gitruck` / 系统 / 缺失)、版本、授权与源码地址。
489
+ - `gtrk deps install [--ffmpeg] [--font] [--force]` — 从同合云镜像安装运行时资产,**已存在则跳过**。
490
+ - **不会静默自动下载**:任何缺失路径只报错并指向本命令(包体 30–90 MB,且分发物涉及授权,须由用户/agent 显式触发)。
491
+ - 下载一律 https + **sha256 强校验**,校验不过即丢弃、不落地;解包调**系统 tar**(Win10+/macOS/Linux 自带),不引第三方解压依赖。
492
+ - 定位优先级不变:`--ffmpeg-path` → `~/.gitruck/ffmpeg` → 系统 PATH。镜像只填中间那一格,**不越过你自己装的 ffmpeg**。
493
+ - 字体落 `~/.gitruck/fonts`,烧录时经 ffmpeg `ass` 滤镜的 `fontsdir` 供给——**不装进系统字体表、不写注册表、不要管理员权限**。
494
+ - 分发的 ffmpeg 为 GPLv3 构建,对应源码与二进制同处提供(见分发点 `SOURCE.md`);**下载不附加任何使用限制**。
487
495
  - `gtrk upgrade [--check]` — 升级 CLI 到最新版 + 刷新 skill(配置保留);`--check` 只查不装。
488
496
  - `gtrk skills install [--agents codex,workbuddy,comate,…] [--all] [--copy] [--dir <skills 目录>]` — 单独安装/刷新 Agent Skills;缺省由通用适配器与 gtrk 补充层自动检测。
489
497