@unitsvc/cc-helper 1.3.6 → 1.3.8

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.
Files changed (5) hide show
  1. package/LICENSE +661 -661
  2. package/README-zh.md +471 -432
  3. package/README.md +471 -432
  4. package/dist/cli.js +0 -0
  5. package/package.json +48 -48
package/README-zh.md CHANGED
@@ -1,432 +1,471 @@
1
- # cc-helper
2
-
3
- [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper) [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE) [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org) [![CLAUDE](https://img.shields.io/badge/Claude%20Code-v2.1.71%2B-green.svg)](https://docs.anthropic.com/en/docs/claude-code)
4
-
5
- [**English**](./README.md) | [**简体中文**](./README-zh.md)
6
-
7
- > 一键解锁 Claude Code 隐藏超能力：`/loop`、`/btw`、`/keybindings`、`/context1m`、`automode` 和 `MCPSearch`
8
-
9
- ---
10
-
11
- ## 环境要求
12
-
13
- | 项目 | 版本 |
14
- | ----------- | --------- |
15
- | Node.js | >= 14.0.0 |
16
- | Claude Code | v2.1.71+ |
17
-
18
- ```bash
19
- npm install -g @anthropic-ai/claude-code@v2.1.100
20
- ```
21
-
22
- ## 安装
23
-
24
- 两种使用方式（二选一）：
25
-
26
- ```bash
27
- # 全局安装（可选）
28
- npm install -g @unitsvc/cc-helper@latest
29
-
30
- # 或直接运行，无需安装
31
- npx @unitsvc/cc-helper@latest enable
32
- ```
33
-
34
- ### 代理支持
35
-
36
- 如果下载失败，使用 `--proxy` 参数：
37
-
38
- ```bash
39
- # 使用默认代理
40
- npx @unitsvc/cc-helper --proxy enable
41
-
42
- # 使用自定义代理
43
- npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
44
- ```
45
-
46
- ## 使用方法
47
-
48
- ```bash
49
- # 启用默认功能（/loop, /btw, /keybindings）
50
- npx @unitsvc/cc-helper enable
51
-
52
- # 启用特定功能
53
- npx @unitsvc/cc-helper enable loop
54
- npx @unitsvc/cc-helper enable btw
55
- npx @unitsvc/cc-helper enable keybindings
56
- npx @unitsvc/cc-helper enable toolsearch
57
- npx @unitsvc/cc-helper enable context1m # 别名: 1m, 1M
58
- npx @unitsvc/cc-helper enable automode # 所有模型的自动模式
59
-
60
- # 查看状态
61
- npx @unitsvc/cc-helper status
62
-
63
- # 禁用所有功能
64
- npx @unitsvc/cc-helper disable
65
- ```
66
-
67
- ## 命令说明
68
-
69
- | 命令 | 说明 |
70
- | -------------------- | -------------------------------------------- |
71
- | `enable` | 启用 `/loop`、`/btw`、`/keybindings`（默认） |
72
- | `enable loop` | 仅启用 `/loop` |
73
- | `enable btw` | 仅启用 `/btw` |
74
- | `enable keybindings` | 仅启用 `/keybindings` |
75
- | `enable toolsearch` | 启用 toolsearch（需要显式激活） |
76
- | `enable context1m` | 启用 1M 上下文（v2.1.76+） |
77
- | `enable automode` | 启用所有模型的自动模式（v2.1.75+） |
78
- | `disable` | 恢复原始状态 |
79
- | `status` | 查看当前状态及版本要求 |
80
-
81
- > **注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量：
82
- >
83
- > ```json
84
- > {
85
- > "env": {
86
- > "DISABLE_INSTALLATION_CHECKS": "1",
87
- > "DISABLE_AUTOUPDATER": "1",
88
- > "DISABLE_BUG_COMMAND": "1",
89
- > "DISABLE_ERROR_REPORTING": "1",
90
- > "DISABLE_TELEMETRY": "1",
91
- > "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
92
- > "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
93
- > "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
94
- > "CLAUDE_CODE_HIDE_ACCOUNT_INFO": "1",
95
- > "CLAUDE_CODE_NEW_INIT": "1",
96
- > "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
97
- > "API_TIMEOUT_MS": "3000000"
98
- > }
99
- > }
100
- > ```
101
-
102
- ---
103
-
104
- ## 配置命令
105
-
106
- ### plan 命令
107
-
108
- 配置 AI Provider，支持 vault 加密存储。
109
-
110
- ```bash
111
- # 添加 Provider（自动保存到 vault + settings.json）
112
- cc-helper plan add -p bailian -k YOUR_API_KEY
113
- cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
114
-
115
- # 切换 Provider
116
- cc-helper plan switch -p zai
117
-
118
- # 切换模型配置（当前 Provider）
119
- cc-helper plan switch --profile 1m
120
-
121
- # 切换 Provider 并指定配置
122
- cc-helper plan switch -p bailian -k YOUR_KEY --profile 1m
123
-
124
- # 列出 Provider
125
- cc-helper plan list
126
-
127
- # 导出配置
128
- cc-helper plan export --all-env -o config.json
129
- ```
130
-
131
- **支持的 Provider：**
132
-
133
- | Provider | 说明 |
134
- | ---------- | ------------ |
135
- | `bailian` | (CN) Aliyun |
136
- | `minimaxi` | (CN) MiniMax |
137
- | `glm` | (CN) Zhipu |
138
- | `zai` | (EN) Zhipu |
139
-
140
- **模型配置（Model Profiles）：**
141
-
142
- 每个 Provider 支持多个模型配置。一个配置定义了所有模型层级的映射：
143
-
144
- | 字段 | 说明 |
145
- | --------- | ------------------------------------------- |
146
- | Model | 默认模型 (`ANTHROPIC_MODEL`) |
147
- | Haiku | 快速模型 (`ANTHROPIC_DEFAULT_HAIKU_MODEL`) |
148
- | Sonnet | 均衡模型 (`ANTHROPIC_DEFAULT_SONNET_MODEL`) |
149
- | Opus | 强力模型 (`ANTHROPIC_DEFAULT_OPUS_MODEL`) |
150
- | Reasoning | 扩展思维 (`ANTHROPIC_REASONING_MODEL`) |
151
-
152
- **bailian 配置：**
153
-
154
- | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
155
- | ------- | ------------ | ------------ | ------------ | ------------ | ------------ |
156
- | default | glm-5 | glm-4.7 | glm-5 | glm-5 | glm-5 |
157
- | 5 | glm-5 | glm-5 | glm-5 | qwen3.6-plus | glm-5 |
158
- | 1m | glm-5 | glm-4.7 | qwen3.5-plus | qwen3.5-plus | glm-5 |
159
- | 3.6 | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus |
160
- | kimi | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 |
161
- | minimax | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 |
162
-
163
- **glm / zai 配置：**
164
-
165
- | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
166
- | ------- | ------------ | ----------- | ------- | ------------ | ------------ |
167
- | default | glm-5 | glm-4.7 | glm-5 | glm-5 | glm-5 |
168
- | 5 | glm-5 | glm-5-turbo | glm-5 | glm-5 | glm-5 |
169
- | 5.1 | glm-5.1 | glm-4.7 | glm-4.7 | glm-5 | glm-5.1 |
170
- | 5v | glm-5v-turbo | glm-5-turbo | glm-5.1 | glm-5v-turbo | glm-5v-turbo |
171
-
172
- **minimaxi 配置：**
173
-
174
- | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
175
- | ------- | ------------ | ------------ | ------------ | ------------ | ------------ |
176
- | default | MiniMax-M2.7 | MiniMax-M2.5 | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.7 |
177
-
178
- ```bash
179
- # 示例：在 bailian 上使用 1M 上下文
180
- cc-helper plan add -p bailian -k YOUR_KEY
181
- cc-helper plan switch --profile 1m
182
- ```
183
-
184
- ### vault 命令
185
-
186
- 安全的密钥存储，加密存储在 `cc-helper.json` 中。
187
-
188
- ```bash
189
- cc-helper vault list # 列出密钥
190
- cc-helper vault set bailian default -k "KEY" # 设置
191
- cc-helper vault get bailian default # 获取并解密
192
- cc-helper vault delete bailian default # 删除
193
- ```
194
-
195
- ### env 命令
196
-
197
- 多环境配置（default、work、staging 等）。
198
-
199
- ```bash
200
- cc-helper env list # 列出环境
201
- cc-helper env create work # 创建
202
- cc-helper env switch work # 切换
203
- ```
204
-
205
- ### sync 命令
206
-
207
- 将配置导出/导入到 Git 仓库，支持 JWE 加密。
208
-
209
- ```bash
210
- # 登录 GitHub
211
- cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
212
-
213
- # 导出
214
- cc-helper sync export
215
- cc-helper sync export --file config.json
216
- cc-helper sync export --workspace test
217
-
218
- # 导入
219
- cc-helper sync import
220
- ```
221
-
222
- ---
223
-
224
- ## 核心功能详解
225
-
226
- ### `/loop` - 定时重复提示
227
-
228
- 定时重复提示，适用于轮询部署、监控 PR、设置提醒、定时执行工作流。
229
-
230
- ```
231
- /loop [间隔时间] <提示内容>
232
- ```
233
-
234
- **示例：**
235
-
236
- ```
237
- /loop 5m check if the deployment finished
238
- /loop 30m /review-pr 1234
239
- /loop remind me to push the release at 3pm
240
- ```
241
-
242
- | 形式 | 示例 | 解析间隔 |
243
- | ---------- | --------------------------- | ------------ |
244
- | 前置时间 | `/loop 30m check` | 每 30 分钟 |
245
- | 后置 every | `/loop check every 2 hours` | 每 2 小时 |
246
- | 无间隔 | `/loop check` | 默认 10 分钟 |
247
-
248
- 支持单位：`s`（秒）、`m`（分）、`h`（时）、`d`（天）
249
-
250
- **核心特性：**
251
-
252
- - **会话级别**：任务仅在当前会话中存在，退出即消失
253
- - **自动过期**：3 天后自动过期
254
- - **抖动保护**：小偏移量防止 API 惊群效应
255
- - **低优先级**：在你与 Claude 交互间隙触发
256
-
257
- ```
258
- what scheduled tasks do I have? # 列出所有任务
259
- cancel the deploy check job # 按描述或 ID 取消
260
- ```
261
-
262
- ### `/btw` - 旁支问题
263
-
264
- 在不打断主对话的情况下提问旁支问题。
265
-
266
- ```
267
- /btw <问题>
268
- ```
269
-
270
- **示例：**
271
-
272
- ```
273
- /btw 这个函数是做什么的？
274
- /btw 解释一下这里的错误处理
275
- /btw 为什么这里要用 async/await？
276
- ```
277
-
278
- ### `/keybindings` - 自定义键盘快捷键
279
-
280
- 在 `~/.claude/keybindings.json` 中配置：
281
-
282
- ```json
283
- {
284
- "submit": ["ctrl+s"],
285
- "interrupt": ["ctrl+c"],
286
- "custom_commands": {
287
- "ctrl+shift+l": "/loop 5m check status"
288
- }
289
- }
290
- ```
291
-
292
- ### `/context1m` - 1M 上下文
293
-
294
- 为 Claude Opus 模型启用 1M token 上下文窗口。
295
-
296
- **要求：**
297
-
298
- - Claude Code v2.1.76 或更高版本
299
- - Claude Opus 4+ 模型
300
- - 可能需要 Pro 计划或官方 API
301
-
302
- ![/context1m 启用](./docs/images/1m-1.png)
303
-
304
- **扩展思维与上下文长度：**
305
-
306
- | 模型 | 最大思维链长度 | 上下文长度 |
307
- | -------------------- | -------------: | ---------: |
308
- | qwen3.6-plus | 81,920 | 1,000,000 |
309
- | qwen3.5-plus | 81,920 | 1,000,000 |
310
- | qwen3-coder-plus | 不支持 | 1,000,000 |
311
- | qwen3-max-2026-01-23 | 81,920 | 262,144 |
312
- | qwen3-coder-next | 不支持 | 262,144 |
313
- | kimi-k2.5 | 81,920 | 262,144 |
314
- | MiniMax-M2.5 | 32,768 | 204,800 |
315
- | glm-5 | 32,768 | 202,752 |
316
- | glm-4.7 | 32,768 | 202,752 |
317
-
318
- ### 工具搜索
319
-
320
- 在运行时动态搜索和加载工具，而非一次性发送所有工具定义。节省 token 并提高性能。
321
-
322
- **为什么为第三方 API 启用？** Claude Code 在使用第三方 API 代理时默认禁用工具搜索。此功能为这些代理启用工具搜索。
323
-
324
- **优势：**
325
-
326
- - **Token 效率**：减少大型 MCP 工具目录的上下文占用
327
- - **性能提升**：延迟加载，响应更快
328
- - **代理兼容**：支持 Kimi 和其他提供商
329
-
330
- **要求：**
331
-
332
- - 代理必须支持 API 响应中的 `tool_reference` 块
333
- - 仅支持 Claude Sonnet 4+ 和 Opus 4+ 模型（不支持 Haiku）
334
-
335
- 通过 `ENABLE_TOOL_SEARCH` 环境变量控制：
336
-
337
- | 值 | 行为 |
338
- | ---------- | --------------------------------- |
339
- | （未设置） | 默认启用，非第一方主机时禁用 |
340
- | `true` | 始终启用 |
341
- | `auto` | MCP 工具超过上下文 10% 时激活 |
342
- | `auto:<N>` | 自定义阈值（如 `auto:5` 表示 5%） |
343
- | `false` | 禁用，所有工具预先加载 |
344
-
345
- ```bash
346
- ENABLE_TOOL_SEARCH=auto:5 claude # 5% 阈值
347
- ENABLE_TOOL_SEARCH=false claude # 禁用
348
- ENABLE_TOOL_SEARCH=true claude # 始终启用
349
- ```
350
-
351
- 禁用 MCPSearch 工具：
352
-
353
- ```json
354
- {
355
- "permissions": {
356
- "deny": ["MCPSearch"]
357
- }
358
- }
359
- ```
360
-
361
- ### 自动模式
362
-
363
- 为所有模型和 API 类型启用自动模式，绕过模型限制。
364
-
365
- **为什么启用？** Claude Code 限制自动模式仅适用于特定模型（Opus/Sonnet 4.6）和官方 API。此功能为所有模型和第三方代理启用自动模式。
366
-
367
- **优势：**
368
-
369
- - **通用访问**：自动模式适用于任意模型
370
- - **代理支持**：兼容 Bedrock、Vertex 和第三方 API
371
- - **无限制**：绕过远程配置控制
372
-
373
- **要求：**
374
-
375
- - Claude Code v2.1.75 或更高版本
376
-
377
- ```bash
378
- npx @unitsvc/cc-helper enable automode
379
- ```
380
-
381
- **环境变量：**
382
-
383
- | 变量 | 说明 |
384
- | ------------------------------- | ------------------ |
385
- | `CC_HELPER_AUTO_MODE_MODEL` | 自定义分类器模型 |
386
- | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 未指定时的回退模型 |
387
-
388
- ---
389
-
390
- ## 功能特点
391
-
392
- | 功能 | 说明 |
393
- | ------------- | -------------------------------------------- |
394
- | 一键启用 | 启用 `/loop`、`/btw`、`/keybindings` |
395
- | 工具搜索 | 可选 `/toolsearch` 用于第三方 API 代理 |
396
- | 1M 上下文 | 可选 `/context1m` 用于 1M 上下文（v2.1.76+） |
397
- | 自动模式 | 可选 `automode` 用于所有模型（v2.1.75+） |
398
- | Provider 配置 | `plan` 命令支持 vault 加密存储 |
399
- | 密钥管理 | `vault` 命令安全管理密钥 |
400
- | 多环境支持 | `env` 命令环境切换 |
401
- | Git 同步 | `sync` 命令配置同步 |
402
- | 轻松恢复 | 自动备份和恢复 |
403
- | 零依赖 | 无运行时依赖 |
404
-
405
- ### 截图
406
-
407
- ![/loop 命令提示](./docs/images/loop-1.png)
408
- ![/loop 执行示例](./docs/images/loop-2.png)
409
-
410
- ## 支持平台
411
-
412
- | 平台 | 架构 |
413
- | ------- | ------------ |
414
- | macOS | amd64, arm64 |
415
- | Linux | amd64, arm64 |
416
- | Windows | amd64, arm64 |
417
-
418
- ## 许可证
419
-
420
- AGPL-3.0 - 详见 [LICENSE](./LICENSE)
421
-
422
- ## 安全
423
-
424
- ### 报告漏洞
425
-
426
- 如果您发现 cc-helper 的安全漏洞，请负责任地报告：
427
-
428
- 1. **不要**公开提 issue
429
- 2. 发送邮件给维护者说明详情
430
- 3. 给予合理时间修复后再公开
431
-
432
- 我们非常重视安全问题，会尽快响应。
1
+ # cc-helper
2
+
3
+ [![npm version](https://img.shields.io/npm/v/@unitsvc/cc-helper.svg)](https://www.npmjs.com/package/@unitsvc/cc-helper) [![License](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](https://github.com/next-bin/cc-helper/blob/master/LICENSE) [![Node](https://img.shields.io/badge/Node-%3E%3D14.0.0-green.svg)](https://nodejs.org) [![CLAUDE](https://img.shields.io/badge/Claude%20Code-v2.1.71%2B-green.svg)](https://docs.anthropic.com/en/docs/claude-code)
4
+
5
+ [**English**](./README.md) | [**简体中文**](./README-zh.md)
6
+
7
+ > 一键解锁 Claude Code 隐藏超能力：`/loop`、`/btw`、`/keybindings`、`/context1m`、`automode`、`monitor` 和 `MCPSearch`
8
+
9
+ ---
10
+
11
+ ## 环境要求
12
+
13
+ | 项目 | 版本 |
14
+ | ----------- | --------- |
15
+ | Node.js | >= 14.0.0 |
16
+ | Claude Code | v2.1.71+ |
17
+
18
+ ```bash
19
+ npm install -g @anthropic-ai/claude-code@v2.1.101
20
+ ```
21
+
22
+ ## 安装
23
+
24
+ 两种使用方式（二选一）：
25
+
26
+ ```bash
27
+ # 全局安装（可选）
28
+ npm install -g @unitsvc/cc-helper@latest
29
+
30
+ # 或直接运行，无需安装
31
+ npx @unitsvc/cc-helper@latest enable
32
+ ```
33
+
34
+ ### 代理支持
35
+
36
+ 如果下载失败，使用 `--proxy` 参数：
37
+
38
+ ```bash
39
+ # 使用默认代理
40
+ npx @unitsvc/cc-helper --proxy enable
41
+
42
+ # 使用自定义代理
43
+ npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
44
+ ```
45
+
46
+ ## 使用方法
47
+
48
+ ```bash
49
+ # 启用默认功能（/loop, /btw, /keybindings）
50
+ npx @unitsvc/cc-helper enable
51
+
52
+ # 启用特定功能
53
+ npx @unitsvc/cc-helper enable loop
54
+ npx @unitsvc/cc-helper enable btw
55
+ npx @unitsvc/cc-helper enable keybindings
56
+ npx @unitsvc/cc-helper enable toolsearch
57
+ npx @unitsvc/cc-helper enable context1m # 别名: 1m, 1M
58
+ npx @unitsvc/cc-helper enable automode # 所有模型的自动模式
59
+ npx @unitsvc/cc-helper enable monitor # 流式事件监控（v2.1.100+）
60
+
61
+ # 查看状态
62
+ npx @unitsvc/cc-helper status
63
+
64
+ # 禁用所有功能
65
+ npx @unitsvc/cc-helper disable
66
+ ```
67
+
68
+ ## 命令说明
69
+
70
+ | 命令 | 说明 |
71
+ | -------------------- | -------------------------------------------- |
72
+ | `enable` | 启用 `/loop`、`/btw`、`/keybindings`（默认） |
73
+ | `enable loop` | 仅启用 `/loop` |
74
+ | `enable btw` | 仅启用 `/btw` |
75
+ | `enable keybindings` | 仅启用 `/keybindings` |
76
+ | `enable toolsearch` | 启用 toolsearch（需要显式激活） |
77
+ | `enable context1m` | 启用 1M 上下文（v2.1.76+） |
78
+ | `enable automode` | 启用所有模型的自动模式（v2.1.75+） |
79
+ | `enable monitor` | 启用 Monitor 流式事件监控（v2.1.100+） |
80
+ | `disable` | 恢复原始状态 |
81
+ | `status` | 查看当前状态及版本要求 |
82
+
83
+ > **注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量：
84
+ >
85
+ > ```json
86
+ > {
87
+ > "env": {
88
+ > "DISABLE_INSTALLATION_CHECKS": "1",
89
+ > "DISABLE_AUTOUPDATER": "1",
90
+ > "DISABLE_BUG_COMMAND": "1",
91
+ > "DISABLE_ERROR_REPORTING": "1",
92
+ > "DISABLE_TELEMETRY": "1",
93
+ > "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
94
+ > "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
95
+ > "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
96
+ > "CLAUDE_CODE_HIDE_ACCOUNT_INFO": "1",
97
+ > "CLAUDE_CODE_NEW_INIT": "1",
98
+ > "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
99
+ > "API_TIMEOUT_MS": "3000000"
100
+ > }
101
+ > }
102
+ > ```
103
+
104
+ ---
105
+
106
+ ## 配置命令
107
+
108
+ ### plan 命令
109
+
110
+ 配置 AI Provider，支持 vault 加密存储。
111
+
112
+ ```bash
113
+ # 添加 Provider（自动保存到 vault + settings.json）
114
+ cc-helper plan add -p bailian -k YOUR_API_KEY
115
+ cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
116
+
117
+ # 切换 Provider
118
+ cc-helper plan switch -p zai
119
+
120
+ # 切换模型配置（当前 Provider）
121
+ cc-helper plan switch --profile 1m
122
+
123
+ # 切换 Provider 并指定配置
124
+ cc-helper plan switch -p bailian -k YOUR_KEY --profile 1m
125
+
126
+ # 列出 Provider
127
+ cc-helper plan list
128
+
129
+ # 导出配置
130
+ cc-helper plan export --all-env -o config.json
131
+ ```
132
+
133
+ **支持的 Provider：**
134
+
135
+ | Provider | 说明 |
136
+ | ---------- | ------------ |
137
+ | `bailian` | (CN) Aliyun |
138
+ | `minimaxi` | (CN) MiniMax |
139
+ | `glm` | (CN) Zhipu |
140
+ | `zai` | (EN) Zhipu |
141
+
142
+ **模型配置（Model Profiles）：**
143
+
144
+ 每个 Provider 支持多个模型配置。一个配置定义了所有模型层级的映射：
145
+
146
+ | 字段 | 说明 |
147
+ | --------- | ------------------------------------------- |
148
+ | Model | 默认模型 (`ANTHROPIC_MODEL`) |
149
+ | Haiku | 快速模型 (`ANTHROPIC_DEFAULT_HAIKU_MODEL`) |
150
+ | Sonnet | 均衡模型 (`ANTHROPIC_DEFAULT_SONNET_MODEL`) |
151
+ | Opus | 强力模型 (`ANTHROPIC_DEFAULT_OPUS_MODEL`) |
152
+ | Reasoning | 扩展思维 (`ANTHROPIC_REASONING_MODEL`) |
153
+
154
+ **bailian 配置：**
155
+
156
+ | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
157
+ | ------- | ------------ | ------------ | ------------ | ------------ | ------------ |
158
+ | default | glm-5 | glm-4.7 | glm-5 | glm-5 | glm-5 |
159
+ | 5 | glm-5 | glm-5 | glm-5 | qwen3.6-plus | glm-5 |
160
+ | 1m | glm-5 | glm-4.7 | qwen3.5-plus | qwen3.5-plus | glm-5 |
161
+ | 3.6 | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus | qwen3.6-plus |
162
+ | kimi | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 | kimi-k2.5 |
163
+ | minimax | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 | MiniMax-M2.5 |
164
+
165
+ **glm / zai 配置：**
166
+
167
+ | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
168
+ | ------- | ------------ | ----------- | ------- | ------------ | ------------ |
169
+ | default | glm-5 | glm-4.7 | glm-5 | glm-5 | glm-5 |
170
+ | 5 | glm-5 | glm-5-turbo | glm-5 | glm-5 | glm-5 |
171
+ | 5.1 | glm-5.1 | glm-4.7 | glm-4.7 | glm-5 | glm-5.1 |
172
+ | 5v | glm-5v-turbo | glm-5-turbo | glm-5.1 | glm-5v-turbo | glm-5v-turbo |
173
+
174
+ **minimaxi 配置：**
175
+
176
+ | Profile | Model | Haiku | Sonnet | Opus | Reasoning |
177
+ | ------- | ------------ | ------------ | ------------ | ------------ | ------------ |
178
+ | default | MiniMax-M2.7 | MiniMax-M2.5 | MiniMax-M2.7 | MiniMax-M2.7 | MiniMax-M2.7 |
179
+
180
+ ```bash
181
+ # 示例：在 bailian 上使用 1M 上下文
182
+ cc-helper plan add -p bailian -k YOUR_KEY
183
+ cc-helper plan switch --profile 1m
184
+ ```
185
+
186
+ ### vault 命令
187
+
188
+ 安全的密钥存储，加密存储在 `cc-helper.json` 中。
189
+
190
+ ```bash
191
+ cc-helper vault list # 列出密钥
192
+ cc-helper vault set bailian default -k "KEY" # 设置
193
+ cc-helper vault get bailian default # 获取并解密
194
+ cc-helper vault delete bailian default # 删除
195
+ ```
196
+
197
+ ### env 命令
198
+
199
+ 多环境配置（default、work、staging 等）。
200
+
201
+ ```bash
202
+ cc-helper env list # 列出环境
203
+ cc-helper env create work # 创建
204
+ cc-helper env switch work # 切换
205
+ ```
206
+
207
+ ### sync 命令
208
+
209
+ 将配置导出/导入到 Git 仓库，支持 JWE 加密。
210
+
211
+ ```bash
212
+ # 登录 GitHub
213
+ cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
214
+
215
+ # 导出
216
+ cc-helper sync export
217
+ cc-helper sync export --file config.json
218
+ cc-helper sync export --workspace test
219
+
220
+ # 导入
221
+ cc-helper sync import
222
+ ```
223
+
224
+ ---
225
+
226
+ ## 核心功能详解
227
+
228
+ ### `/loop` - 定时重复提示
229
+
230
+ 定时重复提示，适用于轮询部署、监控 PR、设置提醒、定时执行工作流。
231
+
232
+ ```
233
+ /loop [间隔时间] <提示内容>
234
+ ```
235
+
236
+ **示例：**
237
+
238
+ ```
239
+ /loop 5m check if the deployment finished
240
+ /loop 30m /review-pr 1234
241
+ /loop remind me to push the release at 3pm
242
+ ```
243
+
244
+ | 形式 | 示例 | 解析间隔 |
245
+ | ---------- | --------------------------- | ------------ |
246
+ | 前置时间 | `/loop 30m check` | 每 30 分钟 |
247
+ | 后置 every | `/loop check every 2 hours` | 每 2 小时 |
248
+ | 无间隔 | `/loop check` | 默认 10 分钟 |
249
+
250
+ 支持单位：`s`（秒）、`m`（分）、`h`（时）、`d`（天）
251
+
252
+ **核心特性：**
253
+
254
+ - **会话级别**：任务仅在当前会话中存在，退出即消失
255
+ - **自动过期**：3 天后自动过期
256
+ - **抖动保护**：小偏移量防止 API 惊群效应
257
+ - **低优先级**：在你与 Claude 交互间隙触发
258
+
259
+ ```
260
+ what scheduled tasks do I have? # 列出所有任务
261
+ cancel the deploy check job # 按描述或 ID 取消
262
+ ```
263
+
264
+ ### `/btw` - 旁支问题
265
+
266
+ 在不打断主对话的情况下提问旁支问题。
267
+
268
+ ```
269
+ /btw <问题>
270
+ ```
271
+
272
+ **示例：**
273
+
274
+ ```
275
+ /btw 这个函数是做什么的？
276
+ /btw 解释一下这里的错误处理
277
+ /btw 为什么这里要用 async/await？
278
+ ```
279
+
280
+ ### `/keybindings` - 自定义键盘快捷键
281
+
282
+ 在 `~/.claude/keybindings.json` 中配置：
283
+
284
+ ```json
285
+ {
286
+ "submit": ["ctrl+s"],
287
+ "interrupt": ["ctrl+c"],
288
+ "custom_commands": {
289
+ "ctrl+shift+l": "/loop 5m check status"
290
+ }
291
+ }
292
+ ```
293
+
294
+ ### `/context1m` - 1M 上下文
295
+
296
+ 为 Claude Opus 模型启用 1M token 上下文窗口。
297
+
298
+ **要求：**
299
+
300
+ - Claude Code v2.1.76 或更高版本
301
+ - Claude Opus 4+ 模型
302
+ - 可能需要 Pro 计划或官方 API
303
+
304
+ ![/context1m 启用](./docs/images/1m-1.png)
305
+
306
+ **扩展思维与上下文长度：**
307
+
308
+ | 模型 | 最大思维链长度 | 上下文长度 |
309
+ | -------------------- | -------------: | ---------: |
310
+ | qwen3.6-plus | 81,920 | 1,000,000 |
311
+ | qwen3.5-plus | 81,920 | 1,000,000 |
312
+ | qwen3-coder-plus | 不支持 | 1,000,000 |
313
+ | qwen3-max-2026-01-23 | 81,920 | 262,144 |
314
+ | qwen3-coder-next | 不支持 | 262,144 |
315
+ | kimi-k2.5 | 81,920 | 262,144 |
316
+ | MiniMax-M2.5 | 32,768 | 204,800 |
317
+ | glm-5 | 32,768 | 202,752 |
318
+ | glm-4.7 | 32,768 | 202,752 |
319
+
320
+ ### 工具搜索
321
+
322
+ 在运行时动态搜索和加载工具，而非一次性发送所有工具定义。节省 token 并提高性能。
323
+
324
+ **为什么为第三方 API 启用？** Claude Code 在使用第三方 API 代理时默认禁用工具搜索。此功能为这些代理启用工具搜索。
325
+
326
+ **优势：**
327
+
328
+ - **Token 效率**：减少大型 MCP 工具目录的上下文占用
329
+ - **性能提升**：延迟加载，响应更快
330
+ - **代理兼容**：支持 Kimi 和其他提供商
331
+
332
+ **要求：**
333
+
334
+ - 代理必须支持 API 响应中的 `tool_reference` 块
335
+ - 仅支持 Claude Sonnet 4+ 和 Opus 4+ 模型（不支持 Haiku）
336
+
337
+ 通过 `ENABLE_TOOL_SEARCH` 环境变量控制：
338
+
339
+ | 值 | 行为 |
340
+ | ---------- | --------------------------------- |
341
+ | （未设置） | 默认启用，非第一方主机时禁用 |
342
+ | `true` | 始终启用 |
343
+ | `auto` | MCP 工具超过上下文 10% 时激活 |
344
+ | `auto:<N>` | 自定义阈值（如 `auto:5` 表示 5%） |
345
+ | `false` | 禁用，所有工具预先加载 |
346
+
347
+ ```bash
348
+ ENABLE_TOOL_SEARCH=auto:5 claude # 5% 阈值
349
+ ENABLE_TOOL_SEARCH=false claude # 禁用
350
+ ENABLE_TOOL_SEARCH=true claude # 始终启用
351
+ ```
352
+
353
+ 禁用 MCPSearch 工具：
354
+
355
+ ```json
356
+ {
357
+ "permissions": {
358
+ "deny": ["MCPSearch"]
359
+ }
360
+ }
361
+ ```
362
+
363
+ ### 自动模式
364
+
365
+ 为所有模型和 API 类型启用自动模式，绕过模型限制。
366
+
367
+ **为什么启用？** Claude Code 限制自动模式仅适用于特定模型（Opus/Sonnet 4.6）和官方 API。此功能为所有模型和第三方代理启用自动模式。
368
+
369
+ **优势：**
370
+
371
+ - **通用访问**：自动模式适用于任意模型
372
+ - **代理支持**：兼容 Bedrock、Vertex 和第三方 API
373
+ - **无限制**：绕过远程配置控制
374
+
375
+ **要求：**
376
+
377
+ - Claude Code v2.1.75 或更高版本
378
+
379
+ ```bash
380
+ npx @unitsvc/cc-helper enable automode
381
+ ```
382
+
383
+ **环境变量：**
384
+
385
+ | 变量 | 说明 |
386
+ | ------------------------------- | ------------------ |
387
+ | `CC_HELPER_AUTO_MODE_MODEL` | 自定义分类器模型 |
388
+ | `ANTHROPIC_DEFAULT_HAIKU_MODEL` | 未指定时的回退模型 |
389
+
390
+ ### Monitor
391
+
392
+ 启用 Monitor 工具用于流式事件监控。
393
+
394
+ **为什么启用？** Claude Code 通过远程配置（`tengu_amber_sentinel` 标志）控制 Monitor 功能。此 patch 绕过远程控制，在本地启用该功能。
395
+
396
+ **优势：**
397
+
398
+ - **流式监控**：实时监控日志、文件变化、API 事件
399
+ - **事件驱动工作流**：事件到达时立即响应
400
+ - **持久监控**：在会话期间运行长期监控任务
401
+
402
+ **要求：**
403
+
404
+ - Claude Code v2.1.100 或更高版本
405
+
406
+ ```bash
407
+ npx @unitsvc/cc-helper enable monitor
408
+ ```
409
+
410
+ **示例：**
411
+
412
+ ```bash
413
+ # 监控日志文件中的错误
414
+ tail -f /var/log/app.log | grep --line-buffered "ERROR"
415
+
416
+ # 监控文件变化
417
+ inotifywait -m --format '%e %f' /watched/dir
418
+
419
+ # 轮询 GitHub 获取新的 PR 评论
420
+ while true; do
421
+ gh api "repos/owner/repo/issues/123/comments?since=$last" --jq '.[].body'
422
+ sleep 30
423
+ done
424
+ ```
425
+
426
+ ---
427
+
428
+ ## 功能特点
429
+
430
+ | 功能 | 说明 |
431
+ | ------------- | -------------------------------------------- |
432
+ | 一键启用 | 启用 `/loop`、`/btw`、`/keybindings` |
433
+ | 工具搜索 | 可选 `/toolsearch` 用于第三方 API 代理 |
434
+ | 1M 上下文 | 可选 `/context1m` 用于 1M 上下文（v2.1.76+） |
435
+ | 自动模式 | 可选 `automode` 用于所有模型（v2.1.75+） |
436
+ | Monitor | 可选 `monitor` 用于流式事件监控（v2.1.100+） |
437
+ | Provider 配置 | `plan` 命令支持 vault 加密存储 |
438
+ | 密钥管理 | `vault` 命令安全管理密钥 |
439
+ | 多环境支持 | `env` 命令环境切换 |
440
+ | Git 同步 | `sync` 命令配置同步 |
441
+ | 轻松恢复 | 自动备份和恢复 |
442
+ | 零依赖 | 无运行时依赖 |
443
+
444
+ ### 截图
445
+
446
+ ![/loop 命令提示](./docs/images/loop-1.png)
447
+ ![/loop 执行示例](./docs/images/loop-2.png)
448
+
449
+ ## 支持平台
450
+
451
+ | 平台 | 架构 |
452
+ | ------- | ------------ |
453
+ | macOS | amd64, arm64 |
454
+ | Linux | amd64, arm64 |
455
+ | Windows | amd64, arm64 |
456
+
457
+ ## 许可证
458
+
459
+ AGPL-3.0 - 详见 [LICENSE](./LICENSE)
460
+
461
+ ## 安全
462
+
463
+ ### 报告漏洞
464
+
465
+ 如果您发现 cc-helper 的安全漏洞，请负责任地报告：
466
+
467
+ 1. **不要**公开提 issue
468
+ 2. 发送邮件给维护者说明详情
469
+ 3. 给予合理时间修复后再公开
470
+
471
+ 我们非常重视安全问题，会尽快响应。