@gitruck/cli 0.2.23 → 1.0.1
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 +20 -0
- package/README.en.md +540 -0
- package/README.md +540 -526
- package/dist/index.js +4850 -1760
- package/package.json +66 -65
- package/skills/gtrk-matrix/SKILL.md +314 -148
package/AGENT.md
CHANGED
|
@@ -48,6 +48,26 @@ gtrk transcript <本地视频.mp4> --json # 转成一个含总结/时
|
|
|
48
48
|
> agent 自检：没配 Key 时任何命令会明确报「缺 API Key —— 先跑 `gtrk init`」。剪映目录没配只影响剪映直开，不挡 gtrk/PR。
|
|
49
49
|
> `init` 是**人手一次性**交互配置（会弹提示）；agent 日常只跑非交互的 `oralcut`。
|
|
50
50
|
|
|
51
|
+
> **合规告知（只告知、不是闸门）**：`init` 配好、以及首次把内容送上云之前，CLI 会往 **stderr** 打一次条款告知
|
|
52
|
+
> （用户协议 / 隐私政策链接 + 「你是所处理内容合法性的第一责任人」），**恰好一次**、之后不再复读。
|
|
53
|
+
> 它**不阻断命令、不等任何输入、没有 `--accept-terms` 之类开关**，也不写 stdout（`--json` 机读面照旧干净）——
|
|
54
|
+
> agent 见到它照常往下跑即可，**MUST NOT** 去改 `~/.gitruck/config.json` 的 `termsNoticeVersion` 来「绕过」它。
|
|
55
|
+
> 内容不出本机的命令（`render` 本地渲染 / 工程互转 / `mg` 铺轨 / `doctor` / `deps install`）**不会**出现这条。
|
|
56
|
+
|
|
57
|
+
5. **按需装运行时资产**（只有用到本地渲染/烧录才需要）：
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
gtrk deps status # 先查：ffmpeg / 字体各自的来源与授权
|
|
61
|
+
gtrk deps install --ffmpeg --font # 缺什么装什么，已存在自动跳过
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
- **agent 纪律：CLI 绝不静默自动下载**。遇到「未找到 ffmpeg/ffprobe」或「本机缺字幕模板所需字体」，
|
|
65
|
+
**先跑 `gtrk deps status` 确认真缺**，再跑 `install`——不要看到报错就无脑装（先查后拉）。
|
|
66
|
+
- 包体 30–90 MB（按平台），走同合云镜像；下载自动过 sha256 校验，解包用系统 tar，无第三方依赖。
|
|
67
|
+
- **不越过用户自装的 ffmpeg**：定位仍是 `--ffmpeg-path` → `~/.gitruck/ffmpeg` → 系统 PATH。
|
|
68
|
+
- 字体落 `~/.gitruck/fonts`，经 `ass` 滤镜 `fontsdir` 供给——**不动用户的系统字体表**。
|
|
69
|
+
- 平台未覆盖时（如 linux-arm64）会明确报错并指引手工安装，**不会错装其他架构的包**。
|
|
70
|
+
|
|
51
71
|
---
|
|
52
72
|
|
|
53
73
|
## 2. 核心命令：`gtrk oralcut <毛片>`
|