@gitruck/cli 0.2.0 → 0.2.2
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 +10 -4
- package/LICENSE +21 -21
- package/README.md +177 -154
- package/dist/index.js +2755 -40
- package/package.json +10 -4
- package/skills/gtrk-oralcut/SKILL.md +112 -109
package/AGENT.md
CHANGED
|
@@ -60,6 +60,10 @@ gtrk oralcut <毛片.mp4> [--script 文字稿.txt] # 剪一条；剪完自动
|
|
|
60
60
|
|
|
61
61
|
- **上传缓存**：同一毛片（按 `size:mtime` 指纹）二次跑直接复用 `file_id`，跳过整段上传。缓存在
|
|
62
62
|
`~/.gtrk-cli/upload-cache.json`。云端 file_id 失效会自动重传兜底。毛片改了但指纹意外没变 → `--reupload`。
|
|
63
|
+
- **大文件分片断点续传**：≥256MiB 自动走分片上传（32MiB/片、3 并发、单片自动重试）。上传中断（断网/
|
|
64
|
+
Ctrl+C/进程崩）→ **重跑同一命令即自动续传**，只补缺片不重来（会话在 `~/.gtrk-cli/upload-sessions.json`）。
|
|
65
|
+
云端已有同内容文件（未过期）时**秒传**：零字节上传直接拿 file_id。`--reupload` 同时跳过缓存/续传会话/秒传，
|
|
66
|
+
强制整传。小文件路径与输出契约完全不变。
|
|
63
67
|
- **剪映草稿自动落位**：探到剪映/CapCut 草稿目录时，下载后自动把草稿拷进
|
|
64
68
|
`<草稿根>/<毛片名>-video-project-<时间戳>/`（与产物目录同名、含时间戳）→ 剪映项目列表里每次剪辑
|
|
65
69
|
各为独立条目、不互相覆盖。探不到会警告并提示加 `--jianying-draft-dir`（此时剪映只产 `draft_content.json`、
|
|
@@ -69,7 +73,7 @@ gtrk oralcut <毛片.mp4> [--script 文字稿.txt] # 剪一条；剪完自动
|
|
|
69
73
|
|
|
70
74
|
**细节微调 —— 按用户诉求因势象形、自由组合**（上表是常用一等 flag；下面是节奏细调 + 完整取值）。你有云端全部参数，按需自由决定用哪些。**唯一要求：名字 / 取值 / 范围照文档用**（别记错拼错）；传越界云端报 `6016` 附原因、照改即可（乱传不产错误成片、只明确报错）。没特别诉求就跑默认。
|
|
71
75
|
|
|
72
|
-
- **剪不准 / 剪掉真内容 / 有句话没剪进去** → `--visual-assist`：ASR 之外并行跑人脸 +
|
|
76
|
+
- **剪不准 / 剪掉真内容 / 有句话没剪进去** → `--visual-assist`：ASR 之外并行跑人脸 + 说话检测，画面在说话却没识别出字的地方**保护不剪**并重识别捞回（需说话人面部基本可见），捞不回的进 `report.review_points` 复核；引擎挂了只降级不失败；会增加处理耗时（与主识别并行、约两者较大值），但不额外计费、绝不凭空生成。**「剪不准」的兜底。**
|
|
73
77
|
- **节奏散参数**（无一等 flag，走 `--param 键=值` / `--params-json`，单位秒、范围 0–5）：
|
|
74
78
|
- `punctuation_breaks`：逐标点停顿，键 `，、；：。！？—……` + `paragraph`（段落）。例 `--params-json '{"punctuation_breaks":{"。":0.6,"，":0.3}}'`。
|
|
75
79
|
- `intra_gap_max`（>此值算气口，默认 0.35）/ `intra_gap_target`（收到多长，默认 0.10）/ `pad_in`(0.05) / `pad_out`(0.08)。例「气口留白多点」`--param pad_out=0.15`。
|
|
@@ -94,7 +98,7 @@ gtrk oralcut <毛片.mp4> [--script 文字稿.txt] # 剪一条；剪完自动
|
|
|
94
98
|
|
|
95
99
|
```
|
|
96
100
|
<毛片名>-video-project-<YYMMDD-HHMMSS>/
|
|
97
|
-
├── gtrk/project.gtrk → 客户端（
|
|
101
|
+
├── gtrk/project.gtrk → 客户端（OpenCut Gitruck Edition）：「打开工程」选它
|
|
98
102
|
├── jianying/ → 剪映：已自动拷进剪映草稿根，剪映里直接见草稿
|
|
99
103
|
│ ├── draft_content.json
|
|
100
104
|
│ └── draft_meta_info.json （仅当探到/指定了剪映草稿目录才有）
|
|
@@ -121,7 +125,7 @@ gtrk oralcut <毛片.mp4> [--script 文字稿.txt] # 剪一条；剪完自动
|
|
|
121
125
|
7. **有具体细节诉求**（剪不准 / 换语言 / 要成片 / 调某个停顿）→ 见上「细节微调」，按需自由取用（`--visual-assist` / `--lang` / `--render` / 散参数）；没特别诉求跑默认即可。
|
|
122
126
|
|
|
123
127
|
**跑完读 `report`、验证、给用户交代**（`--json` 的 stdout 那行带 `files` / `errors` / **`report`**；别只信"成功"、别谎报三端都好）：
|
|
124
|
-
- **读 `report`（因势象形的另一半）**：`duration_before`→`after`（剪了多少）；`dropped[]`（剔了哪些、`reason` retake/misread）；`coverage`（<0.6 附 `low_coverage` = 文稿与实拍严重不符）；`uncovered_script[]`（**漏读**：文稿有、实拍没找到 → 如实说，疑似漏识别则建议 `--visual-assist` 重跑）；`review_points[]`（建议复核处）；开了 visual_assist 还有 `suspect_omissions` / `stt_recovered` / `visual_assist_degraded`。**据此因势象形**：覆盖率低 / 漏读多 → 开 `--visual-assist` 或核对文稿重跑；节奏不满意 → 调 `--preset` / 散参数重跑（同毛片可反复剪对比）。
|
|
128
|
+
- **读 `report`（因势象形的另一半）**：`duration_before`→`after`（剪了多少）；`script_source`/`final_script`（无稿 `rebuilt` 时把 `final_script` 回给用户核对）；`dropped[]`（剔了哪些、`reason` retake/misread）；`coverage`（<0.6 附 `low_coverage` = 文稿与实拍严重不符）；`uncovered_script[]`（**漏读**：文稿有、实拍没找到 → 如实说，疑似漏识别则建议 `--visual-assist` 重跑）；`review_points[]`（建议复核处）；开了 visual_assist 还有 `suspect_omissions` / `stt_recovered` / `visual_assist_degraded`。**据此因势象形**：覆盖率低 / 漏读多 → 开 `--visual-assist` 或核对文稿重跑；节奏不满意 → 调 `--preset` / 散参数重跑（同毛片可反复剪对比）。
|
|
125
129
|
- 确认产物目录在、`gtrk/project.gtrk` 非空（>0 字节）；要剪映就确认剪映草稿根里有**同名工程目录** + `draft_meta_info.json`。
|
|
126
130
|
- 云端 `errors` 非空 → 如实告知哪个格式失败、原因。
|
|
127
131
|
- 然后**回给用户**：产物目录路径 + 三端各自怎么打开（客户端选 `gtrk/project.gtrk`、剪映已在项目列表、PR 导入 `xml/premiere.xml`），并**据 `report` 给一句交代**（剪了多久 → 多久、去掉了什么、有无漏读需复核）。
|
|
@@ -130,6 +134,8 @@ gtrk oralcut <毛片.mp4> [--script 文字稿.txt] # 剪一条；剪完自动
|
|
|
130
134
|
|
|
131
135
|
## 5. 典型调用
|
|
132
136
|
|
|
137
|
+
> 下面示例为聚焦某个参数、**省略了 `--json`**；你（agent）实际调用**一律带 `--json`**（见 §4），stdout 才只剩结果 JSON、便于解析。
|
|
138
|
+
|
|
133
139
|
```bash
|
|
134
140
|
# 有稿 + 剪完就看（最常见；剪完默认自动打开产物目录，无需额外 flag）
|
|
135
141
|
gtrk oralcut "D:/素材/某选题-原始口播.mp4" --script "D:/素材/某选题-文字稿.txt" --json
|
|
@@ -168,5 +174,5 @@ gtrk oralcut "D:/素材/某条.mp4" --params-json '{"punctuation_breaks":{"。":
|
|
|
168
174
|
|
|
169
175
|
新增命令 = 写 `src/commands/<name>.ts` 的 `register<Name>(program)` + 在 `src/index.ts` 注册一行。
|
|
170
176
|
云端调用走 `src/lib/cloud.ts`（`{code,msg,data}` 包装、鉴权 Header `Authorization:<裸key>`）；上传一律走
|
|
171
|
-
`src/lib/upload-cache.ts` 的 `uploadCached
|
|
177
|
+
`src/lib/upload-cache.ts` 的 `uploadCached`（白嫖指纹缓存；≥256MiB 自动分片断点续传，见 `src/lib/chunk-upload.ts`）。规划中：`render`（云渲）、`struct`（已有 gtrk →
|
|
172
178
|
三方工程）、`matrix`（B-roll 检索）。
|
package/LICENSE
CHANGED
|
@@ -1,21 +1,21 @@
|
|
|
1
|
-
MIT License
|
|
2
|
-
|
|
3
|
-
Copyright (c) 2026 同合云 (Gitruck)
|
|
4
|
-
|
|
5
|
-
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
-
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
-
in the Software without restriction, including without limitation the rights
|
|
8
|
-
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
-
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
-
furnished to do so, subject to the following conditions:
|
|
11
|
-
|
|
12
|
-
The above copyright notice and this permission notice shall be included in all
|
|
13
|
-
copies or substantial portions of the Software.
|
|
14
|
-
|
|
15
|
-
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
-
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
-
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
-
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
-
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
-
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
-
SOFTWARE.
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 同合云 (Gitruck)
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,154 +1,177 @@
|
|
|
1
|
-
# gtrk-cli
|
|
2
|
-
|
|
3
|
-
> 同合云成片流水线 CLI —— **agent 驱动云端任务、产物拉回本地、三方工程文件（客户端 / 剪映 / PR）互通**。
|
|
4
|
-
>
|
|
5
|
-
> 一条命令，把口播毛片变成可二次精修的剪辑工程。云端做重活，本地只装配，源视频不出本地。
|
|
6
|
-
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
## 为什么用 gtrk-cli
|
|
10
|
-
|
|
11
|
-
- **一条命令出三方工程**：上传口播毛片 → 云端智能剪辑（剪废话 / 重复 / 长停顿）→ 拉回**客户端（gtrk）+ 剪映 + PR/FCP** 三方工程文件 → 自动打开产物目录。
|
|
12
|
-
- **云端做重活、本地只装配**：识别、剪辑、对齐都在云端；本地只拿结果，**源视频不出本地**（路径写进工程、本地打开直接认素材）。
|
|
13
|
-
- **为 agent 而生**：配套 skill `/gtrk-oralcut`，在 Claude Code 等工具里一句「帮我剪个口播」就能发起，CLI 是手、agent 是脑。
|
|
14
|
-
- **专业可扩展**：单 binary + 子命令（对标飞书 `lark-cli`），后续长出 `render` / `struct` / `matrix` 等命令。
|
|
15
|
-
|
|
16
|
-
## 功能
|
|
17
|
-
|
|
18
|
-
| | 命令 | 做什么 |
|
|
19
|
-
|---|---|---|
|
|
20
|
-
| 🎬 | `gtrk oralcut <毛片>` | 智能口播剪辑闭环：一次出 gtrk + 剪映 + PR 三方工程，自动打开 |
|
|
21
|
-
| ⚙️ | `gtrk init` | 引导式一次性配置（API Key + 剪映草稿目录），之后免管 |
|
|
22
|
-
| 🩺 | `gtrk doctor` | 体检：配置 / 云端连通 / 剪映目录 / 运行时一键自检 |
|
|
23
|
-
| 🤖 | `gtrk skills install` | 把 `/gtrk-oralcut` skill 装进 Claude Code |
|
|
24
|
-
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
-
|
|
137
|
-
-
|
|
138
|
-
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
```
|
|
153
|
-
|
|
154
|
-
|
|
1
|
+
# gtrk-cli
|
|
2
|
+
|
|
3
|
+
> 同合云成片流水线 CLI —— **agent 驱动云端任务、产物拉回本地、三方工程文件（客户端 / 剪映 / PR）互通**。
|
|
4
|
+
>
|
|
5
|
+
> 一条命令，把口播毛片变成可二次精修的剪辑工程。云端做重活，本地只装配，源视频不出本地。
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 为什么用 gtrk-cli
|
|
10
|
+
|
|
11
|
+
- **一条命令出三方工程**：上传口播毛片 → 云端智能剪辑（剪废话 / 重复 / 长停顿）→ 拉回**客户端（gtrk）+ 剪映 + PR/FCP** 三方工程文件 → 自动打开产物目录。
|
|
12
|
+
- **云端做重活、本地只装配**：识别、剪辑、对齐都在云端；本地只拿结果，**源视频不出本地**（路径写进工程、本地打开直接认素材）。
|
|
13
|
+
- **为 agent 而生**：配套 skill `/gtrk-oralcut`，在 Claude Code 等工具里一句「帮我剪个口播」就能发起，CLI 是手、agent 是脑。
|
|
14
|
+
- **专业可扩展**：单 binary + 子命令（对标飞书 `lark-cli`），后续长出 `render` / `struct` / `matrix` 等命令。
|
|
15
|
+
|
|
16
|
+
## 功能
|
|
17
|
+
|
|
18
|
+
| | 命令 | 做什么 |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| 🎬 | `gtrk oralcut <毛片>` | 智能口播剪辑闭环：一次出 gtrk + 剪映 + PR 三方工程，自动打开 |
|
|
21
|
+
| ⚙️ | `gtrk init` | 引导式一次性配置（API Key + 剪映草稿目录），之后免管 |
|
|
22
|
+
| 🩺 | `gtrk doctor` | 体检：配置 / 云端连通 / 剪映目录 / 运行时一键自检 |
|
|
23
|
+
| 🤖 | `gtrk skills install` | 把 `/gtrk-oralcut` skill 装进 Claude Code |
|
|
24
|
+
| ⬆️ | `gtrk upgrade` | 升级 CLI 到最新版 + 刷新 skill（配置保留）；`--check` 只查不装 |
|
|
25
|
+
| 🚧 | `render` / `struct` / `matrix` | （规划中）云渲染 / 已有 gtrk 转三方工程 / B-roll 检索 |
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
## 获取 API Key
|
|
30
|
+
|
|
31
|
+
CLI 要调用同合云云端能力，需先拿一个 API Key（形如 `gc_xxxxxxxx`）：
|
|
32
|
+
|
|
33
|
+
1. 打开官网 **[cloud.ai-mcn.tv](https://cloud.ai-mcn.tv)** 并登录 —— **登录即开通**、自带免费测试额度、零门槛。
|
|
34
|
+
2. 进入 **[控制台](https://cloud.ai-mcn.tv/zh-CN/dashboard)**，在「API 密钥 / 密钥管理」处生成并复制你的 Key。
|
|
35
|
+
3. 下一步 `gtrk install` 会让你把它粘进去（一次配好、本地长期复用）。
|
|
36
|
+
|
|
37
|
+
> 快速开始文档：[cloud.ai-mcn.tv/zh-CN/docs/quick-start](https://cloud.ai-mcn.tv/zh-CN/docs/quick-start) · 对接咨询：business@migotimes.com
|
|
38
|
+
|
|
39
|
+
## 安装 & 快速上手
|
|
40
|
+
|
|
41
|
+
需要 Node.js ≥ 20.6（`node -v` 查看）。
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
# 1) 一条命令装全：命令行 gtrk + /gtrk-oralcut skill + 配置（填 API Key、自动扫剪映目录）
|
|
45
|
+
npm i -g @gitruck/cli@latest && gtrk install
|
|
46
|
+
# 或免全局安装直接用：npx @gitruck/cli@latest install
|
|
47
|
+
|
|
48
|
+
# 2) 剪一条（剪完自动打开产物目录）
|
|
49
|
+
gtrk oralcut "D:/素材/某选题-原始口播.mp4" --script "D:/素材/某选题-文字稿.txt"
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
> 只想配置、不装 skill：用 `gtrk init`。本地开发：`cd gtrk-cli && bun install && bun run src/index.ts <命令>`。
|
|
53
|
+
|
|
54
|
+
产物目录形如 `<毛片名>-video-project-<YYMMDD-HHMMSS>/`，内含 `gtrk/`、`jianying/`、`xml/` 三端工程。
|
|
55
|
+
|
|
56
|
+
> **重复装不会重复填配置**：`gtrk install` / `gtrk init` 检测到已配好就默认保留、只刷新 skill；想改配置加 `--reconfigure`（Key / 剪映目录也都能回车沿用）。
|
|
57
|
+
|
|
58
|
+
## 升级
|
|
59
|
+
|
|
60
|
+
**CLI + skill**（配置原样保留）：
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
gtrk upgrade # 有新版则升到最新 + 刷新 skill
|
|
64
|
+
gtrk upgrade --check # 只看有没有新版，不动手
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
> 用 `npx` 的（没全局装）本就每次拉最新：`npx @gitruck/cli@latest install`。`gtrk doctor` 也会顺带提示「有新版可升级」。
|
|
68
|
+
|
|
69
|
+
**桌面客户端**：重跑一键安装脚本即覆盖装最新版（per-user、免管理员、配置不动）：
|
|
70
|
+
|
|
71
|
+
```powershell
|
|
72
|
+
irm https://api.ai-mcn.tv:9000/broadcast/exe/install.ps1 | iex
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## 给 AI Agent 用
|
|
76
|
+
|
|
77
|
+
`gtrk install` 已经把 `/gtrk-oralcut` skill 装进 `~/.claude/skills`（单独装用 `gtrk skills install`）。
|
|
78
|
+
|
|
79
|
+
然后在 Claude Code 里直接说「**帮我把这条口播剪一版**」或打 `/gtrk-oralcut`，agent 会问清毛片 / 文稿 / 节奏，调 `gtrk oralcut --json` 跑通闭环、验证产物、把三端打开方式回给你。完整可移植 playbook 见 [`AGENT.md`](./AGENT.md)。
|
|
80
|
+
|
|
81
|
+
### Skills
|
|
82
|
+
|
|
83
|
+
| Skill | 触发 | 做什么 |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| `/gtrk-oralcut` | 斜杠，或「剪口播 / 智能剪辑 / 去掉废话停顿 / 出剪映草稿」 | 驱动 `oralcut` 闭环：云端剪辑 → 拉回三方工程 → 验证 → 回报三端打开方式 |
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
89
|
+
## 配置
|
|
90
|
+
|
|
91
|
+
`gtrk init` 把配置写到 `~/.gtrk-cli/config.json`。读取优先级：**环境变量 / `.env` > `init` 持久配置 > 默认根地址**。
|
|
92
|
+
|
|
93
|
+
| 项 | 来源 | 说明 |
|
|
94
|
+
|---|---|---|
|
|
95
|
+
| `GITRUCK_API_KEY` | env / init | 鉴权 Header `Authorization` 的**裸值**（非 Bearer） |
|
|
96
|
+
| `GITRUCK_API_BASE` | env / init | API 根地址，默认 `https://api.ai-mcn.tv:10000` |
|
|
97
|
+
| 剪映草稿目录 | init / 自动探测 / `--jianying-draft-dir` | 决定剪映草稿落哪、能否直接打开 |
|
|
98
|
+
|
|
99
|
+
非交互配置（脚本 / CI）：
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
gtrk init --api-key <KEY> --jianying-draft-dir auto -y
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
随时 `gtrk doctor` 自检：
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
✅ 运行时：node v24.x
|
|
109
|
+
✅ CLI 版本：v0.3.0（已是最新）
|
|
110
|
+
✅ API Key：已配（gc_xxx…）
|
|
111
|
+
✅ 云端连通 + 鉴权：可达，鉴权通过
|
|
112
|
+
✅ 剪映草稿目录：C:\Users\…\com.lveditor.draft
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 命令参考
|
|
118
|
+
|
|
119
|
+
### `gtrk oralcut <毛片>`
|
|
120
|
+
|
|
121
|
+
| 参数 | 作用 | 缺省 |
|
|
122
|
+
|---|---|---|
|
|
123
|
+
| `-s, --script <file>` | 文字稿 txt（有稿按稿剪、更准） | 探毛片同名 `.txt`；无则无稿智能重建 |
|
|
124
|
+
| `-p, --preset <p>` | 节奏 `steady`\|`concise`\|`compact`（松→紧） | `concise` |
|
|
125
|
+
| `-o, --out <dir>` | 自定义产物目录 | `<毛片名>-video-project-<时间戳>` |
|
|
126
|
+
| `-f, --formats <list>` | 三方格式逗号分隔 | `gtrk,jianying,xml` |
|
|
127
|
+
| `--jianying-draft-dir <dir>` | 剪映草稿根目录（或 `auto`） | 读 init 配置 / 自动探测 |
|
|
128
|
+
| `--reupload` | 强制重传，忽略上传缓存 | 关 |
|
|
129
|
+
| `--no-open` | 完成后不自动打开产物目录 | **默认自动打开** |
|
|
130
|
+
| `--json` | 机读：stdout 只输出结果 JSON（给 agent / 脚本） | 关 |
|
|
131
|
+
|
|
132
|
+
`--json` 输出（成功时 stdout 单行）：`{ ok, outDir, files:{gtrk,jianying,xml}, jianyingDraftPath, report, errors, taskId, fileId }`；命令失败则进程非 0 退出、报错走 stderr、stdout 无 JSON。
|
|
133
|
+
|
|
134
|
+
### 其它
|
|
135
|
+
|
|
136
|
+
- `gtrk install [--api-key … -y --skills-dir …]` — 一条命令装全（skill + 配置 + 体检），对标飞书 `lark-cli install`。
|
|
137
|
+
- `gtrk init [--api-key … --api-base … --jianying-draft-dir … -y]` — 仅配置（交互 / 非交互）。
|
|
138
|
+
- `gtrk doctor` — 体检（含 CLI 版本 / 有无新版）。
|
|
139
|
+
- `gtrk upgrade [--check]` — 升级 CLI 到最新版 + 刷新 skill（配置保留）；`--check` 只查不装。
|
|
140
|
+
- `gtrk skills install [--dir <skills 目录>]` — 单独安装 agent skill。
|
|
141
|
+
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
## 工作原理
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
本地 gtrk CLI 同合云 本地三端
|
|
148
|
+
───────────── ───────────── ─────────────
|
|
149
|
+
毛片 ──上传(指纹缓存免重传)──▶ video_oral_cut 智能剪辑 ──产物──▶ 客户端 gtrk/project.gtrk
|
|
150
|
+
(一次出 gtrk/剪映/xml) 剪映 自动落草稿目录
|
|
151
|
+
源路径写进 gtrk materials.path PR/FCP 导入 premiere.xml
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
- **gtrk** 是 timeline 的真超集 + HTML 颗粒，是同合云的统一工程契约；三端从同一份 gtrk 派生、切点一致。
|
|
155
|
+
- 云端**零改动**全用现成 `video_oral_cut`；CLI 只做编排（上传 / 提交 / 轮询 / 拉回 / 落位 / 打开）。
|
|
156
|
+
|
|
157
|
+
## 注意
|
|
158
|
+
|
|
159
|
+
- 剪映 / CapCut 草稿需 `draft_content.json` + `draft_meta_info.json` **成对**才被软件识别——要么 `gtrk init` 配好草稿目录、要么 `--jianying-draft-dir` 指定，否则只产 content、需手动导入。
|
|
160
|
+
- 多台机器盘符不同时，配置走 `~/.gtrk-cli/`（用户级），产物默认落毛片同目录。
|
|
161
|
+
- 节奏预设强度以云端为准；`--preset` 只选预设、不改源裁剪。
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 结构
|
|
166
|
+
|
|
167
|
+
```
|
|
168
|
+
gtrk-cli/
|
|
169
|
+
├── src/index.ts # commander 入口
|
|
170
|
+
├── src/commands/ # 子命令：install / init / oralcut / doctor / upgrade / skills
|
|
171
|
+
├── src/lib/ # cloud / config / user-config / jianying / open / upload-cache / log
|
|
172
|
+
├── skills/gtrk-oralcut/ # 打包的 agent skill（skills install 装它）
|
|
173
|
+
├── assets/ # 剪映草稿目录指引图
|
|
174
|
+
└── AGENT.md # 可移植 agent playbook（skill 底座）
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
新增命令 = 写 `src/commands/<name>.ts` 的 `register<Name>(program)` + 在 `src/index.ts` 注册一行。
|