@unitsvc/cc-helper 1.0.19 → 1.0.20
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/README-zh.md +183 -200
- package/README.md +185 -215
- package/package.json +1 -1
package/README-zh.md
CHANGED
|
@@ -1,17 +1,29 @@
|
|
|
1
1
|
# cc-helper
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/@unitsvc/cc-helper)
|
|
4
|
-
[](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
|
|
5
|
-
[](https://nodejs.org)
|
|
3
|
+
[](https://www.npmjs.com/package/@unitsvc/cc-helper) [](https://github.com/next-bin/cc-helper/blob/master/LICENSE) [](https://nodejs.org) [](https://docs.anthropic.com/en/docs/claude-code)
|
|
6
4
|
|
|
7
|
-
[**English**](./README.md) | **简体中文**
|
|
5
|
+
[**English**](./README.md) | [**简体中文**](./README-zh.md)
|
|
8
6
|
|
|
9
|
-
>
|
|
7
|
+
> 一键解锁 Claude Code 隐藏超能力:`/loop`、`/btw`、`/keybindings`、`/context1m` 和 `MCPSearch`
|
|
8
|
+
|
|
9
|
+
## 目录
|
|
10
|
+
|
|
11
|
+
| 分类 | 内容 |
|
|
12
|
+
| ------------ | --------------------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| **快速开始** | [环境要求](#环境要求) · [安装](#安装) · [使用方法](#使用方法) · [命令说明](#命令说明) |
|
|
14
|
+
| **核心功能** | [`/loop`](#什么是-loop) · [`/btw`](#什么是-btw) · [`/keybindings`](#什么是-keybindings) · [`/context1m`](#什么是-context1m) |
|
|
15
|
+
| **工具搜索** | [概述](#什么是工具搜索) · [配置说明](#配置说明) |
|
|
16
|
+
| **配置命令** | [plan](#plan-命令) · [vault](#vault-命令) · [env](#env-命令) · [sync](#sync-命令) |
|
|
17
|
+
| **更多** | [功能特点](#功能特点) · [支持平台](#支持平台) · [许可证](#许可证) · [安全](#安全) |
|
|
18
|
+
|
|
19
|
+
---
|
|
10
20
|
|
|
11
21
|
## 环境要求
|
|
12
22
|
|
|
13
|
-
|
|
14
|
-
|
|
23
|
+
| 项目 | 版本 |
|
|
24
|
+
| ----------- | --------- |
|
|
25
|
+
| Node.js | >= 14.0.0 |
|
|
26
|
+
| Claude Code | v2.1.71+ |
|
|
15
27
|
|
|
16
28
|
```bash
|
|
17
29
|
npm install -g @anthropic-ai/claude-code@v2.1.76
|
|
@@ -19,14 +31,26 @@ npm install -g @anthropic-ai/claude-code@v2.1.76
|
|
|
19
31
|
|
|
20
32
|
## 安装
|
|
21
33
|
|
|
34
|
+
两种使用方式(二选一):
|
|
35
|
+
|
|
22
36
|
```bash
|
|
37
|
+
# 全局安装(可选)
|
|
23
38
|
npm install -g @unitsvc/cc-helper@latest
|
|
39
|
+
|
|
40
|
+
# 或直接运行,无需安装
|
|
41
|
+
npx @unitsvc/cc-helper@latest enable
|
|
24
42
|
```
|
|
25
43
|
|
|
26
|
-
|
|
44
|
+
### 代理支持
|
|
45
|
+
|
|
46
|
+
如果下载失败,使用 `--proxy` 参数:
|
|
27
47
|
|
|
28
48
|
```bash
|
|
29
|
-
|
|
49
|
+
# 使用默认代理
|
|
50
|
+
npx @unitsvc/cc-helper --proxy enable
|
|
51
|
+
|
|
52
|
+
# 使用自定义代理
|
|
53
|
+
npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
|
|
30
54
|
```
|
|
31
55
|
|
|
32
56
|
## 使用方法
|
|
@@ -45,46 +69,47 @@ npx @unitsvc/cc-helper enable context1m # 别名: 1m, 1M
|
|
|
45
69
|
# 查看状态
|
|
46
70
|
npx @unitsvc/cc-helper status
|
|
47
71
|
|
|
48
|
-
#
|
|
72
|
+
# 禁用所有功能
|
|
49
73
|
npx @unitsvc/cc-helper disable
|
|
50
74
|
```
|
|
51
75
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
| 命令 | 说明
|
|
55
|
-
| -------------------- |
|
|
56
|
-
| `enable` | 启用 `/loop`、`/btw
|
|
57
|
-
| `enable loop` | 仅启用 `/loop`
|
|
58
|
-
| `enable btw` | 仅启用 `/btw`
|
|
59
|
-
| `enable keybindings` | 仅启用 `/keybindings`
|
|
60
|
-
| `enable toolsearch` | 启用 toolsearch
|
|
61
|
-
| `enable context1m` | 启用 1M
|
|
62
|
-
| `disable` | 恢复原始状态
|
|
63
|
-
| `status` | 查看当前状态及版本要求
|
|
64
|
-
|
|
65
|
-
**注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量:
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
76
|
+
## 命令说明
|
|
77
|
+
|
|
78
|
+
| 命令 | 说明 |
|
|
79
|
+
| -------------------- | -------------------------------------------- |
|
|
80
|
+
| `enable` | 启用 `/loop`、`/btw`、`/keybindings`(默认) |
|
|
81
|
+
| `enable loop` | 仅启用 `/loop` |
|
|
82
|
+
| `enable btw` | 仅启用 `/btw` |
|
|
83
|
+
| `enable keybindings` | 仅启用 `/keybindings` |
|
|
84
|
+
| `enable toolsearch` | 启用 toolsearch(需要显式激活) |
|
|
85
|
+
| `enable context1m` | 启用 1M 上下文(v2.1.76+) |
|
|
86
|
+
| `disable` | 恢复原始状态 |
|
|
87
|
+
| `status` | 查看当前状态及版本要求 |
|
|
88
|
+
|
|
89
|
+
> **注意**: 运行 `cc-helper enable` 时会自动在 `~/.claude/settings.json` 中配置推荐的环境变量:
|
|
90
|
+
>
|
|
91
|
+
> ```json
|
|
92
|
+
> {
|
|
93
|
+
> "env": {
|
|
94
|
+
> "DISABLE_INSTALLATION_CHECKS": "1",
|
|
95
|
+
> "DISABLE_AUTOUPDATER": "1",
|
|
96
|
+
> "DISABLE_BUG_COMMAND": "1",
|
|
97
|
+
> "DISABLE_ERROR_REPORTING": "1",
|
|
98
|
+
> "DISABLE_TELEMETRY": "1",
|
|
99
|
+
> "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
|
|
100
|
+
> "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
|
|
101
|
+
> "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
|
|
102
|
+
> "CLAUDE_CODE_HIDE_ACCOUNT_INFO": "1",
|
|
103
|
+
> "API_TIMEOUT_MS": "3000000"
|
|
104
|
+
> }
|
|
105
|
+
> }
|
|
106
|
+
> ```
|
|
77
107
|
|
|
78
108
|
---
|
|
79
109
|
|
|
80
110
|
## 什么是 `/loop`?
|
|
81
111
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
- 轮询部署或构建状态
|
|
85
|
-
- 监控 PR 状态
|
|
86
|
-
- 设置提醒
|
|
87
|
-
- 定时执行工作流
|
|
112
|
+
定时重复提示,适用于轮询部署、监控 PR、设置提醒、定时执行工作流。
|
|
88
113
|
|
|
89
114
|
### 使用语法
|
|
90
115
|
|
|
@@ -102,20 +127,20 @@ npx @unitsvc/cc-helper disable
|
|
|
102
127
|
|
|
103
128
|
### 间隔时间格式
|
|
104
129
|
|
|
105
|
-
| 形式 | 示例 | 解析间隔
|
|
106
|
-
| ---------- | --------------------------- |
|
|
107
|
-
| 前置时间 | `/loop 30m check` | 每 30 分钟
|
|
108
|
-
| 后置 every | `/loop check every 2 hours` | 每 2 小时
|
|
109
|
-
| 无间隔 | `/loop check` |
|
|
130
|
+
| 形式 | 示例 | 解析间隔 |
|
|
131
|
+
| ---------- | --------------------------- | ------------ |
|
|
132
|
+
| 前置时间 | `/loop 30m check` | 每 30 分钟 |
|
|
133
|
+
| 后置 every | `/loop check every 2 hours` | 每 2 小时 |
|
|
134
|
+
| 无间隔 | `/loop check` | 默认 10 分钟 |
|
|
110
135
|
|
|
111
136
|
支持单位:`s`(秒)、`m`(分)、`h`(时)、`d`(天)
|
|
112
137
|
|
|
113
138
|
### 核心特性
|
|
114
139
|
|
|
115
|
-
-
|
|
116
|
-
-
|
|
117
|
-
-
|
|
118
|
-
-
|
|
140
|
+
- **会话级别**:任务仅在当前会话中存在,退出即消失
|
|
141
|
+
- **自动过期**:3 天后自动过期
|
|
142
|
+
- **抖动保护**:小偏移量防止 API 惊群效应
|
|
143
|
+
- **低优先级**:在你与 Claude 交互间隙触发
|
|
119
144
|
|
|
120
145
|
### 管理任务
|
|
121
146
|
|
|
@@ -126,7 +151,7 @@ cancel the deploy check job # 按描述或 ID 取消
|
|
|
126
151
|
|
|
127
152
|
## 什么是 `/btw`?
|
|
128
153
|
|
|
129
|
-
|
|
154
|
+
在不打断主对话的情况下提问旁支问题。
|
|
130
155
|
|
|
131
156
|
### 使用方法
|
|
132
157
|
|
|
@@ -142,186 +167,152 @@ cancel the deploy check job # 按描述或 ID 取消
|
|
|
142
167
|
/btw 为什么这里要用 async/await?
|
|
143
168
|
```
|
|
144
169
|
|
|
145
|
-
##
|
|
170
|
+
## 什么是 `/keybindings`?
|
|
146
171
|
|
|
147
|
-
|
|
172
|
+
自定义键盘快捷键。在 `~/.claude/keybindings.json` 中配置:
|
|
148
173
|
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
174
|
+
```json
|
|
175
|
+
{
|
|
176
|
+
"submit": ["ctrl+s"],
|
|
177
|
+
"interrupt": ["ctrl+c"],
|
|
178
|
+
"custom_commands": {
|
|
179
|
+
"ctrl+shift+l": "/loop 5m check status"
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
```
|
|
152
183
|
|
|
153
|
-
|
|
184
|
+
## 什么是 `/context1m`?
|
|
154
185
|
|
|
155
|
-
|
|
156
|
-
- **性能提升**:延迟加载工具,响应更快
|
|
157
|
-
- **代理兼容**:支持 Kimi 和其他第三方 Claude API 提供商
|
|
186
|
+
为 Claude Opus 模型启用 1M token 上下文窗口。
|
|
158
187
|
|
|
159
188
|
### 要求
|
|
160
189
|
|
|
161
|
-
-
|
|
162
|
-
-
|
|
163
|
-
|
|
164
|
-
### 配置说明
|
|
165
|
-
|
|
166
|
-
使用官方 Anthropic API 时,工具搜索默认启用。但当 `ANTHROPIC_BASE_URL` 指向非第一方主机时,工具搜索默认禁用(大多数代理不转发 `tool_reference` 块)。
|
|
167
|
-
|
|
168
|
-
通过 `ENABLE_TOOL_SEARCH` 环境变量控制工具搜索行为:
|
|
169
|
-
|
|
170
|
-
| 值 | 行为 |
|
|
171
|
-
| ---------- | ------------------------------------------------------ |
|
|
172
|
-
| (未设置) | 默认启用。当 `ANTHROPIC_BASE_URL` 为非第一方主机时禁用 |
|
|
173
|
-
| `true` | 始终启用,包括非第一方 `ANTHROPIC_BASE_URL` |
|
|
174
|
-
| `auto` | 当 MCP 工具超过上下文 10% 时激活 |
|
|
175
|
-
| `auto:<N>` | 自定义阈值激活(如 `auto:5` 表示 5%) |
|
|
176
|
-
| `false` | 禁用,所有 MCP 工具预先加载 |
|
|
190
|
+
- Claude Code v2.1.76 或更高版本
|
|
191
|
+
- Claude Opus 4+ 模型
|
|
192
|
+
- 可能需要 Pro 计划或官方 API
|
|
177
193
|
|
|
178
|
-
|
|
194
|
+
### 使用方法
|
|
179
195
|
|
|
180
196
|
```bash
|
|
181
|
-
#
|
|
182
|
-
ENABLE_TOOL_SEARCH=auto:5 claude
|
|
183
|
-
|
|
184
|
-
# 完全禁用工具搜索
|
|
185
|
-
ENABLE_TOOL_SEARCH=false claude
|
|
186
|
-
|
|
187
|
-
# 始终启用(适用于支持 tool_reference 的代理)
|
|
188
|
-
ENABLE_TOOL_SEARCH=true claude
|
|
197
|
+
npx @unitsvc/cc-helper enable context1m # 别名: 1m, 1M
|
|
189
198
|
```
|
|
190
199
|
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
#### 禁用 MCPSearch 工具
|
|
200
|
+

|
|
194
201
|
|
|
195
|
-
|
|
202
|
+
### 扩展思维与上下文长度
|
|
196
203
|
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
+
| 模型 | 最大思维链长度 | 上下文长度 |
|
|
205
|
+
| -------------------- | -------------- | ---------- |
|
|
206
|
+
| qwen3.5-plus | 81,920 | 1,000,000 |
|
|
207
|
+
| qwen3-coder-plus | 不支持 | 1,000,000 |
|
|
208
|
+
| qwen3-max-2026-01-23 | 81,920 | 262,144 |
|
|
209
|
+
| qwen3-coder-next | 不支持 | 262,144 |
|
|
210
|
+
| kimi-k2.5 | 81,920 | 262,144 |
|
|
211
|
+
| MiniMax-M2.5 | 32,768 | 204,800 |
|
|
212
|
+
| glm-5 | 32,768 | 202,752 |
|
|
213
|
+
| glm-4.7 | 32,768 | 202,752 |
|
|
204
214
|
|
|
205
|
-
|
|
215
|
+
---
|
|
206
216
|
|
|
207
|
-
|
|
217
|
+
## 什么是工具搜索?
|
|
208
218
|
|
|
209
|
-
|
|
219
|
+
在运行时动态搜索和加载工具,而非一次性发送所有工具定义。节省 token 并提高性能。
|
|
210
220
|
|
|
211
|
-
|
|
221
|
+
### 为什么为第三方 API 启用?
|
|
212
222
|
|
|
213
|
-
|
|
214
|
-
{
|
|
215
|
-
"submit": ["ctrl+s"],
|
|
216
|
-
"interrupt": ["ctrl+c"],
|
|
217
|
-
"custom_commands": {
|
|
218
|
-
"ctrl+shift+l": "/loop 5m check status"
|
|
219
|
-
}
|
|
220
|
-
}
|
|
221
|
-
```
|
|
223
|
+
Claude Code 在使用第三方 API 代理时默认禁用工具搜索。此功能为这些代理启用工具搜索。
|
|
222
224
|
|
|
223
|
-
|
|
225
|
+
### 优势
|
|
224
226
|
|
|
225
|
-
|
|
227
|
+
- **Token 效率**:减少大型 MCP 工具目录的上下文占用
|
|
228
|
+
- **性能提升**:延迟加载,响应更快
|
|
229
|
+
- **代理兼容**:支持 Kimi 和其他提供商
|
|
226
230
|
|
|
227
231
|
### 要求
|
|
228
232
|
|
|
229
|
-
-
|
|
230
|
-
- Claude Opus 4+
|
|
231
|
-
- 可能需要 Pro 计划或官方 API
|
|
233
|
+
- 代理必须支持 API 响应中的 `tool_reference` 块
|
|
234
|
+
- 仅支持 Claude Sonnet 4+ 和 Opus 4+ 模型(不支持 Haiku)
|
|
232
235
|
|
|
233
|
-
###
|
|
236
|
+
### 配置说明
|
|
234
237
|
|
|
235
|
-
|
|
236
|
-
# 启用 1M 上下文
|
|
237
|
-
npx @unitsvc/cc-helper enable context1m
|
|
238
|
+
通过 `ENABLE_TOOL_SEARCH` 环境变量控制:
|
|
238
239
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
240
|
+
| 值 | 行为 |
|
|
241
|
+
| ---------- | --------------------------------- |
|
|
242
|
+
| (未设置) | 默认启用,非第一方主机时禁用 |
|
|
243
|
+
| `true` | 始终启用 |
|
|
244
|
+
| `auto` | MCP 工具超过上下文 10% 时激活 |
|
|
245
|
+
| `auto:<N>` | 自定义阈值(如 `auto:5` 表示 5%) |
|
|
246
|
+
| `false` | 禁用,所有工具预先加载 |
|
|
247
|
+
|
|
248
|
+
```bash
|
|
249
|
+
ENABLE_TOOL_SEARCH=auto:5 claude # 5% 阈值
|
|
250
|
+
ENABLE_TOOL_SEARCH=false claude # 禁用
|
|
251
|
+
ENABLE_TOOL_SEARCH=true claude # 始终启用
|
|
242
252
|
```
|
|
243
253
|
|
|
244
|
-
|
|
254
|
+
#### 禁用 MCPSearch 工具
|
|
245
255
|
|
|
246
|
-
|
|
256
|
+
```json
|
|
257
|
+
{
|
|
258
|
+
"permissions": {
|
|
259
|
+
"deny": ["MCPSearch"]
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
```
|
|
247
263
|
|
|
248
|
-
|
|
249
|
-
| -------------------- | ----------------------- | -------------------- |
|
|
250
|
-
| qwen3.5-plus | 81,920 | 1,000,000 |
|
|
251
|
-
| qwen3-coder-plus | 不支持思考模式 | 1,000,000 |
|
|
252
|
-
| qwen3-max-2026-01-23 | 81,920 | 262,144 |
|
|
253
|
-
| qwen3-coder-next | 不支持思考模式 | 262,144 |
|
|
254
|
-
| kimi-k2.5 | 81,920 | 262,144 |
|
|
255
|
-
| MiniMax-M2.5 | 32,768(思维链 + 回复) | 204,800 |
|
|
256
|
-
| glm-5 | 32,768 | 202,752 |
|
|
257
|
-
| glm-4.7 | 32,768 | 202,752 |
|
|
264
|
+
---
|
|
258
265
|
|
|
259
|
-
## plan 命令
|
|
266
|
+
## plan 命令
|
|
260
267
|
|
|
261
|
-
|
|
268
|
+
配置 AI Provider,支持 vault 加密存储。
|
|
262
269
|
|
|
263
270
|
```bash
|
|
264
271
|
# 添加 Provider(自动保存到 vault + settings.json)
|
|
265
272
|
cc-helper plan add -p bailian -k YOUR_API_KEY
|
|
266
273
|
cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
|
|
267
274
|
|
|
268
|
-
# 切换 Provider
|
|
275
|
+
# 切换 Provider
|
|
269
276
|
cc-helper plan switch -p zai
|
|
270
277
|
|
|
271
|
-
#
|
|
278
|
+
# 列出 Provider
|
|
272
279
|
cc-helper plan list
|
|
273
280
|
|
|
274
281
|
# 导出配置
|
|
275
282
|
cc-helper plan export --all-env -o config.json
|
|
276
283
|
```
|
|
277
284
|
|
|
278
|
-
**支持的 Provider
|
|
285
|
+
**支持的 Provider:**
|
|
279
286
|
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
287
|
+
| Provider | 说明 |
|
|
288
|
+
| ---------- | ------------ |
|
|
289
|
+
| `bailian` | (CN) Aliyun |
|
|
290
|
+
| `minimaxi` | (CN) MiniMax |
|
|
291
|
+
| `glm` | (CN) Zhipu |
|
|
292
|
+
| `zai` | (EN) Zhipu |
|
|
284
293
|
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
## vault 命令 - 密钥管理
|
|
294
|
+
## vault 命令
|
|
288
295
|
|
|
289
296
|
安全的密钥存储,加密存储在 `cc-helper.json` 中。
|
|
290
297
|
|
|
291
298
|
```bash
|
|
292
|
-
#
|
|
293
|
-
cc-helper vault
|
|
294
|
-
|
|
295
|
-
#
|
|
296
|
-
cc-helper vault set bailian default -k "YOUR_API_KEY"
|
|
297
|
-
|
|
298
|
-
# 获取并解密密钥
|
|
299
|
-
cc-helper vault get bailian default
|
|
300
|
-
|
|
301
|
-
# 删除密钥
|
|
302
|
-
cc-helper vault delete bailian default
|
|
299
|
+
cc-helper vault list # 列出密钥
|
|
300
|
+
cc-helper vault set bailian default -k "KEY" # 设置
|
|
301
|
+
cc-helper vault get bailian default # 获取并解密
|
|
302
|
+
cc-helper vault delete bailian default # 删除
|
|
303
303
|
```
|
|
304
304
|
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
## env 命令 - 环境管理
|
|
305
|
+
## env 命令
|
|
308
306
|
|
|
309
|
-
|
|
307
|
+
多环境配置(default、work、staging 等)。
|
|
310
308
|
|
|
311
309
|
```bash
|
|
312
|
-
# 列出环境
|
|
313
|
-
cc-helper env
|
|
314
|
-
|
|
315
|
-
# 创建环境
|
|
316
|
-
cc-helper env create work
|
|
317
|
-
|
|
318
|
-
# 切换环境
|
|
319
|
-
cc-helper env switch work
|
|
310
|
+
cc-helper env list # 列出环境
|
|
311
|
+
cc-helper env create work # 创建
|
|
312
|
+
cc-helper env switch work # 切换
|
|
320
313
|
```
|
|
321
314
|
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
## sync 命令 - 配置同步
|
|
315
|
+
## sync 命令
|
|
325
316
|
|
|
326
317
|
将配置导出/导入到 Git 仓库,支持 JWE 加密。
|
|
327
318
|
|
|
@@ -329,14 +320,12 @@ cc-helper env switch work
|
|
|
329
320
|
# 登录 GitHub
|
|
330
321
|
cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
|
|
331
322
|
|
|
332
|
-
#
|
|
323
|
+
# 导出
|
|
333
324
|
cc-helper sync export
|
|
334
|
-
|
|
335
|
-
# 导出到文件
|
|
336
325
|
cc-helper sync export --file config.json
|
|
337
|
-
cc-helper sync export --workspace test
|
|
326
|
+
cc-helper sync export --workspace test
|
|
338
327
|
|
|
339
|
-
#
|
|
328
|
+
# 导入
|
|
340
329
|
cc-helper sync import
|
|
341
330
|
```
|
|
342
331
|
|
|
@@ -344,36 +333,30 @@ cc-helper sync import
|
|
|
344
333
|
|
|
345
334
|
## 功能特点
|
|
346
335
|
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
- 零运行时依赖
|
|
359
|
-
- 跨平台支持
|
|
360
|
-
- 支持版本:2.1.71 - 2.1.76+
|
|
361
|
-
|
|
362
|
-
### 示例
|
|
363
|
-
|
|
364
|
-
启用后,在 Claude Code 中使用 `/loop` 命令:
|
|
336
|
+
| 功能 | 说明 |
|
|
337
|
+
| ------------- | -------------------------------------------- |
|
|
338
|
+
| 一键启用 | 启用 `/loop`、`/btw`、`/keybindings` |
|
|
339
|
+
| 工具搜索 | 可选 `/toolsearch` 用于第三方 API 代理 |
|
|
340
|
+
| 1M 上下文 | 可选 `/context1m` 用于 1M 上下文(v2.1.76+) |
|
|
341
|
+
| Provider 配置 | `plan` 命令支持 vault 加密存储 |
|
|
342
|
+
| 密钥管理 | `vault` 命令安全管理密钥 |
|
|
343
|
+
| 多环境支持 | `env` 命令环境切换 |
|
|
344
|
+
| Git 同步 | `sync` 命令配置同步 |
|
|
345
|
+
| 轻松恢复 | 自动备份和恢复 |
|
|
346
|
+
| 零依赖 | 无运行时依赖 |
|
|
365
347
|
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
执行 loop 命令示例:
|
|
348
|
+
### 截图
|
|
369
349
|
|
|
350
|
+

|
|
370
351
|

|
|
371
352
|
|
|
372
353
|
## 支持平台
|
|
373
354
|
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
355
|
+
| 平台 | 架构 |
|
|
356
|
+
| ------- | ------------ |
|
|
357
|
+
| macOS | amd64, arm64 |
|
|
358
|
+
| Linux | amd64, arm64 |
|
|
359
|
+
| Windows | amd64, arm64 |
|
|
377
360
|
|
|
378
361
|
## 许可证
|
|
379
362
|
|
package/README.md
CHANGED
|
@@ -1,17 +1,29 @@
|
|
|
1
1
|
# cc-helper
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/@unitsvc/cc-helper)
|
|
4
|
-
[](https://github.com/next-bin/cc-helper/blob/master/LICENSE)
|
|
5
|
-
[](https://nodejs.org)
|
|
3
|
+
[](https://www.npmjs.com/package/@unitsvc/cc-helper) [](https://github.com/next-bin/cc-helper/blob/master/LICENSE) [](https://nodejs.org) [](https://docs.anthropic.com/en/docs/claude-code)
|
|
6
4
|
|
|
7
|
-
**English** | [**简体中文**](./README-zh.md)
|
|
5
|
+
[**English**](./README.md) | [**简体中文**](./README-zh.md)
|
|
8
6
|
|
|
9
|
-
>
|
|
7
|
+
> One command to unlock Claude Code's hidden superpowers: `/loop`, `/btw`, `/keybindings`, `/context1m`, and `MCPSearch`
|
|
8
|
+
|
|
9
|
+
## Table of Contents
|
|
10
|
+
|
|
11
|
+
| Category | Content |
|
|
12
|
+
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
|
|
13
|
+
| **Quick Start** | [Requirements](#requirements) · [Installation](#installation) · [Usage](#usage) · [Commands](#commands) |
|
|
14
|
+
| **Core Features** | [`/loop`](#what-is-loop) · [`/btw`](#what-is-btw) · [`/keybindings`](#what-is-keybindings) · [`/context1m`](#what-is-context1m) |
|
|
15
|
+
| **Tool Search** | [Overview](#what-is-tool-search) · [Configuration](#configuration) |
|
|
16
|
+
| **Commands** | [plan](#plan-command) · [vault](#vault-command) · [env](#env-command) · [sync](#sync-command) |
|
|
17
|
+
| **More** | [Features](#features) · [Platforms](#platforms) · [License](#license) · [Security](#security) |
|
|
18
|
+
|
|
19
|
+
---
|
|
10
20
|
|
|
11
21
|
## Requirements
|
|
12
22
|
|
|
13
|
-
|
|
14
|
-
|
|
23
|
+
| Item | Version |
|
|
24
|
+
| ----------- | --------- |
|
|
25
|
+
| Node.js | >= 14.0.0 |
|
|
26
|
+
| Claude Code | v2.1.71+ |
|
|
15
27
|
|
|
16
28
|
```bash
|
|
17
29
|
npm install -g @anthropic-ai/claude-code@v2.1.76
|
|
@@ -19,14 +31,26 @@ npm install -g @anthropic-ai/claude-code@v2.1.76
|
|
|
19
31
|
|
|
20
32
|
## Installation
|
|
21
33
|
|
|
34
|
+
Two ways to use (choose one):
|
|
35
|
+
|
|
22
36
|
```bash
|
|
37
|
+
# Install globally (optional)
|
|
23
38
|
npm install -g @unitsvc/cc-helper@latest
|
|
39
|
+
|
|
40
|
+
# Or run directly without installation
|
|
41
|
+
npx @unitsvc/cc-helper@latest enable
|
|
24
42
|
```
|
|
25
43
|
|
|
26
|
-
|
|
44
|
+
### Proxy Support
|
|
45
|
+
|
|
46
|
+
If download fails, use `--proxy` flag:
|
|
27
47
|
|
|
28
48
|
```bash
|
|
29
|
-
|
|
49
|
+
# Use default proxy
|
|
50
|
+
npx @unitsvc/cc-helper --proxy enable
|
|
51
|
+
|
|
52
|
+
# Use custom proxy
|
|
53
|
+
npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
|
|
30
54
|
```
|
|
31
55
|
|
|
32
56
|
## Usage
|
|
@@ -45,58 +69,47 @@ npx @unitsvc/cc-helper enable context1m # or: 1m, 1M
|
|
|
45
69
|
# Check status
|
|
46
70
|
npx @unitsvc/cc-helper status
|
|
47
71
|
|
|
48
|
-
# Disable all features
|
|
72
|
+
# Disable all features
|
|
49
73
|
npx @unitsvc/cc-helper disable
|
|
50
74
|
```
|
|
51
75
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
| Command | Description
|
|
55
|
-
| -------------------- |
|
|
56
|
-
| `enable` | Enable `/loop`, `/btw`, and `/keybindings`
|
|
57
|
-
| `enable loop` | Enable only `/loop`
|
|
58
|
-
| `enable btw` | Enable only `/btw`
|
|
59
|
-
| `enable keybindings` | Enable only `/keybindings`
|
|
60
|
-
| `enable toolsearch` | Enable toolsearch
|
|
61
|
-
| `enable context1m` | Enable 1M context
|
|
62
|
-
| `disable` | Restore original
|
|
63
|
-
| `status` | Check current status with version requirements
|
|
64
|
-
|
|
65
|
-
**Note**: Running `cc-helper enable` also automatically configures recommended environment variables in `~/.claude/settings.json`:
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
```
|
|
83
|
-
# Use default proxy (https://edgeone.gh-proxy.org)
|
|
84
|
-
npx @unitsvc/cc-helper --proxy enable
|
|
85
|
-
|
|
86
|
-
# Use custom proxy
|
|
87
|
-
npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
|
|
88
|
-
```
|
|
76
|
+
## Commands
|
|
77
|
+
|
|
78
|
+
| Command | Description |
|
|
79
|
+
| -------------------- | ---------------------------------------------------- |
|
|
80
|
+
| `enable` | Enable `/loop`, `/btw`, and `/keybindings` (default) |
|
|
81
|
+
| `enable loop` | Enable only `/loop` |
|
|
82
|
+
| `enable btw` | Enable only `/btw` |
|
|
83
|
+
| `enable keybindings` | Enable only `/keybindings` |
|
|
84
|
+
| `enable toolsearch` | Enable toolsearch (requires explicit activation) |
|
|
85
|
+
| `enable context1m` | Enable 1M context for Claude Opus (v2.1.76+) |
|
|
86
|
+
| `disable` | Restore original |
|
|
87
|
+
| `status` | Check current status with version requirements |
|
|
88
|
+
|
|
89
|
+
> **Note**: Running `cc-helper enable` also automatically configures recommended environment variables in `~/.claude/settings.json`:
|
|
90
|
+
>
|
|
91
|
+
> ```json
|
|
92
|
+
> {
|
|
93
|
+
> "env": {
|
|
94
|
+
> "DISABLE_INSTALLATION_CHECKS": "1",
|
|
95
|
+
> "DISABLE_AUTOUPDATER": "1",
|
|
96
|
+
> "DISABLE_BUG_COMMAND": "1",
|
|
97
|
+
> "DISABLE_ERROR_REPORTING": "1",
|
|
98
|
+
> "DISABLE_TELEMETRY": "1",
|
|
99
|
+
> "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
|
|
100
|
+
> "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
|
|
101
|
+
> "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
|
|
102
|
+
> "CLAUDE_CODE_HIDE_ACCOUNT_INFO": "1",
|
|
103
|
+
> "API_TIMEOUT_MS": "3000000"
|
|
104
|
+
> }
|
|
105
|
+
> }
|
|
106
|
+
> ```
|
|
89
107
|
|
|
90
108
|
---
|
|
91
109
|
|
|
92
110
|
## What is `/loop`?
|
|
93
111
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
- Polling deployments or builds
|
|
97
|
-
- Babysitting PRs
|
|
98
|
-
- Setting reminders
|
|
99
|
-
- Running workflows on an interval
|
|
112
|
+
Schedule recurring prompts for polling deployments, babysitting PRs, setting reminders, or running workflows on an interval.
|
|
100
113
|
|
|
101
114
|
### Usage Syntax
|
|
102
115
|
|
|
@@ -114,20 +127,20 @@ npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
|
|
|
114
127
|
|
|
115
128
|
### Interval Formats
|
|
116
129
|
|
|
117
|
-
| Form
|
|
118
|
-
|
|
|
119
|
-
| Leading token
|
|
120
|
-
| Trailing `every`
|
|
121
|
-
| No interval
|
|
130
|
+
| Form | Example | Parsed Interval |
|
|
131
|
+
| ---------------- | --------------------------- | ---------------------- |
|
|
132
|
+
| Leading token | `/loop 30m check` | every 30 minutes |
|
|
133
|
+
| Trailing `every` | `/loop check every 2 hours` | every 2 hours |
|
|
134
|
+
| No interval | `/loop check` | defaults to 10 minutes |
|
|
122
135
|
|
|
123
136
|
Supported units: `s` (seconds), `m` (minutes), `h` (hours), `d` (days)
|
|
124
137
|
|
|
125
138
|
### Key Features
|
|
126
139
|
|
|
127
|
-
- **Session-scoped**: Tasks live in the current
|
|
128
|
-
- **Auto-expiry**:
|
|
129
|
-
- **Jitter protection**:
|
|
130
|
-
- **Low priority**:
|
|
140
|
+
- **Session-scoped**: Tasks live in the current session and disappear on exit
|
|
141
|
+
- **Auto-expiry**: Tasks expire after 3 days
|
|
142
|
+
- **Jitter protection**: Small offsets prevent API thundering herd
|
|
143
|
+
- **Low priority**: Fires between your turns, not while Claude is busy
|
|
131
144
|
|
|
132
145
|
### Managing Tasks
|
|
133
146
|
|
|
@@ -138,7 +151,7 @@ cancel the deploy check job # Cancel by description or ID
|
|
|
138
151
|
|
|
139
152
|
## What is `/btw`?
|
|
140
153
|
|
|
141
|
-
|
|
154
|
+
Ask side questions without disrupting the main conversation flow.
|
|
142
155
|
|
|
143
156
|
### Usage
|
|
144
157
|
|
|
@@ -154,121 +167,103 @@ cancel the deploy check job # Cancel by description or ID
|
|
|
154
167
|
/btw why use async/await in this case?
|
|
155
168
|
```
|
|
156
169
|
|
|
157
|
-
## What is
|
|
158
|
-
|
|
159
|
-
Tool Search is a feature that allows Claude to dynamically search and load tools at runtime instead of sending all tool definitions upfront. This saves tokens and improves performance.
|
|
170
|
+
## What is `/keybindings`?
|
|
160
171
|
|
|
161
|
-
|
|
172
|
+
Custom keyboard shortcuts. Configure in `~/.claude/keybindings.json`:
|
|
162
173
|
|
|
163
|
-
|
|
174
|
+
```json
|
|
175
|
+
{
|
|
176
|
+
"submit": ["ctrl+s"],
|
|
177
|
+
"interrupt": ["ctrl+c"],
|
|
178
|
+
"custom_commands": {
|
|
179
|
+
"ctrl+shift+l": "/loop 5m check status"
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
```
|
|
164
183
|
|
|
165
|
-
|
|
184
|
+
## What is `/context1m`?
|
|
166
185
|
|
|
167
|
-
|
|
168
|
-
- **Better performance**: Faster response times with deferred tool loading
|
|
169
|
-
- **Proxy compatibility**: Works with Kimi and other third-party Claude API providers
|
|
186
|
+
Enable 1M token context window for Claude Opus models.
|
|
170
187
|
|
|
171
188
|
### Requirements
|
|
172
189
|
|
|
173
|
-
-
|
|
174
|
-
-
|
|
175
|
-
|
|
176
|
-
### Configuration
|
|
177
|
-
|
|
178
|
-
Tool Search is enabled by default when using official Anthropic APIs. However, when `ANTHROPIC_BASE_URL` points to a non-first-party host, Tool Search is disabled by default (most proxies do not forward `tool_reference` blocks).
|
|
179
|
-
|
|
180
|
-
Control Tool Search behavior using the `ENABLE_TOOL_SEARCH` environment variable:
|
|
181
|
-
|
|
182
|
-
| Value | Behavior |
|
|
183
|
-
| ---------- | -------------------------------------------------------------------------------- |
|
|
184
|
-
| (unset) | Enabled by default. Disabled when `ANTHROPIC_BASE_URL` is a non-first-party host |
|
|
185
|
-
| `true` | Always enabled, including for non-first-party `ANTHROPIC_BASE_URL` |
|
|
186
|
-
| `auto` | Activates when MCP tools exceed 10% of context |
|
|
187
|
-
| `auto:<N>` | Activates at custom threshold (e.g., `auto:5` for 5%) |
|
|
188
|
-
| `false` | Disabled, all MCP tools loaded upfront |
|
|
190
|
+
- Claude Code v2.1.76 or higher
|
|
191
|
+
- Claude Opus 4+ model
|
|
192
|
+
- May require Pro plan or first-party API
|
|
189
193
|
|
|
190
|
-
|
|
194
|
+
### Usage
|
|
191
195
|
|
|
192
196
|
```bash
|
|
193
|
-
#
|
|
194
|
-
ENABLE_TOOL_SEARCH=auto:5 claude
|
|
195
|
-
|
|
196
|
-
# Disable tool search entirely
|
|
197
|
-
ENABLE_TOOL_SEARCH=false claude
|
|
198
|
-
|
|
199
|
-
# Always enable (useful for proxies that support tool_reference)
|
|
200
|
-
ENABLE_TOOL_SEARCH=true claude
|
|
197
|
+
npx @unitsvc/cc-helper enable context1m # or: 1m, 1M
|
|
201
198
|
```
|
|
202
199
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
#### Disabling MCPSearch Tool
|
|
200
|
+

|
|
206
201
|
|
|
207
|
-
|
|
202
|
+
### Extended Thinking & Context Length
|
|
208
203
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
204
|
+
| Model | Max Thinking Tokens | Context Length |
|
|
205
|
+
| -------------------- | ------------------- | -------------- |
|
|
206
|
+
| qwen3.5-plus | 81,920 | 1,000,000 |
|
|
207
|
+
| qwen3-coder-plus | Not supported | 1,000,000 |
|
|
208
|
+
| qwen3-max-2026-01-23 | 81,920 | 262,144 |
|
|
209
|
+
| qwen3-coder-next | Not supported | 262,144 |
|
|
210
|
+
| kimi-k2.5 | 81,920 | 262,144 |
|
|
211
|
+
| MiniMax-M2.5 | 32,768 | 204,800 |
|
|
212
|
+
| glm-5 | 32,768 | 202,752 |
|
|
213
|
+
| glm-4.7 | 32,768 | 202,752 |
|
|
216
214
|
|
|
217
|
-
|
|
215
|
+
---
|
|
218
216
|
|
|
219
|
-
|
|
217
|
+
## What is Tool Search?
|
|
220
218
|
|
|
221
|
-
|
|
219
|
+
Dynamically search and load tools at runtime instead of sending all tool definitions upfront. Saves tokens and improves performance.
|
|
222
220
|
|
|
223
|
-
|
|
221
|
+
### Why Third-Party APIs?
|
|
224
222
|
|
|
225
|
-
|
|
226
|
-
{
|
|
227
|
-
"submit": ["ctrl+s"],
|
|
228
|
-
"interrupt": ["ctrl+c"],
|
|
229
|
-
"custom_commands": {
|
|
230
|
-
"ctrl+shift+l": "/loop 5m check status"
|
|
231
|
-
}
|
|
232
|
-
}
|
|
233
|
-
```
|
|
223
|
+
Claude Code disables Tool Search for third-party proxies by default. This feature enables it.
|
|
234
224
|
|
|
235
|
-
|
|
225
|
+
### Benefits
|
|
236
226
|
|
|
237
|
-
|
|
227
|
+
- **Token efficiency**: Reduces context usage for large MCP tool catalogs
|
|
228
|
+
- **Better performance**: Faster response with deferred loading
|
|
229
|
+
- **Proxy compatibility**: Works with Kimi and other providers
|
|
238
230
|
|
|
239
231
|
### Requirements
|
|
240
232
|
|
|
241
|
-
-
|
|
242
|
-
- Claude Opus 4+
|
|
243
|
-
- May require Pro plan or first-party API
|
|
233
|
+
- Proxy must support `tool_reference` blocks
|
|
234
|
+
- Claude Sonnet 4+ or Opus 4+ models only (not Haiku)
|
|
244
235
|
|
|
245
|
-
###
|
|
236
|
+
### Configuration
|
|
246
237
|
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
238
|
+
Control via `ENABLE_TOOL_SEARCH` environment variable:
|
|
239
|
+
|
|
240
|
+
| Value | Behavior |
|
|
241
|
+
| ---------- | --------------------------------------------------- |
|
|
242
|
+
| (unset) | Default enabled, disabled for non-first-party hosts |
|
|
243
|
+
| `true` | Always enabled |
|
|
244
|
+
| `auto` | Activates when MCP tools exceed 10% of context |
|
|
245
|
+
| `auto:<N>` | Custom threshold (e.g., `auto:5` for 5%) |
|
|
246
|
+
| `false` | Disabled, all tools loaded upfront |
|
|
250
247
|
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
248
|
+
```bash
|
|
249
|
+
ENABLE_TOOL_SEARCH=auto:5 claude # 5% threshold
|
|
250
|
+
ENABLE_TOOL_SEARCH=false claude # Disable
|
|
251
|
+
ENABLE_TOOL_SEARCH=true claude # Always enable
|
|
254
252
|
```
|
|
255
253
|
|
|
256
|
-
|
|
254
|
+
#### Disable MCPSearch Tool
|
|
257
255
|
|
|
258
|
-
|
|
256
|
+
```json
|
|
257
|
+
{
|
|
258
|
+
"permissions": {
|
|
259
|
+
"deny": ["MCPSearch"]
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
```
|
|
259
263
|
|
|
260
|
-
|
|
261
|
-
| -------------------- | ---------------------------- | ----------------------- |
|
|
262
|
-
| qwen3.5-plus | 81,920 | 1,000,000 |
|
|
263
|
-
| qwen3-coder-plus | Not supported | 1,000,000 |
|
|
264
|
-
| qwen3-max-2026-01-23 | 81,920 | 262,144 |
|
|
265
|
-
| qwen3-coder-next | Not supported | 262,144 |
|
|
266
|
-
| kimi-k2.5 | 81,920 | 262,144 |
|
|
267
|
-
| MiniMax-M2.5 | 32,768 (thinking + response) | 204,800 |
|
|
268
|
-
| glm-5 | 32,768 | 202,752 |
|
|
269
|
-
| glm-4.7 | 32,768 | 202,752 |
|
|
264
|
+
---
|
|
270
265
|
|
|
271
|
-
## plan Command
|
|
266
|
+
## plan Command
|
|
272
267
|
|
|
273
268
|
Configure AI providers with vault-based secret storage.
|
|
274
269
|
|
|
@@ -277,78 +272,60 @@ Configure AI providers with vault-based secret storage.
|
|
|
277
272
|
cc-helper plan add -p bailian -k YOUR_API_KEY
|
|
278
273
|
cc-helper plan add -p minimaxi -k YOUR_API_KEY --mcp
|
|
279
274
|
|
|
280
|
-
# Switch provider
|
|
275
|
+
# Switch provider
|
|
281
276
|
cc-helper plan switch -p zai
|
|
282
277
|
|
|
283
|
-
# List
|
|
278
|
+
# List providers
|
|
284
279
|
cc-helper plan list
|
|
285
280
|
|
|
286
|
-
# Export
|
|
281
|
+
# Export config
|
|
287
282
|
cc-helper plan export --all-env -o config.json
|
|
288
283
|
```
|
|
289
284
|
|
|
290
285
|
**Supported Providers:**
|
|
291
286
|
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
287
|
+
| Provider | Description |
|
|
288
|
+
| ---------- | ------------ |
|
|
289
|
+
| `bailian` | (CN) Aliyun |
|
|
290
|
+
| `minimaxi` | (CN) MiniMax |
|
|
291
|
+
| `glm` | (CN) Zhipu |
|
|
292
|
+
| `zai` | (EN) Zhipu |
|
|
298
293
|
|
|
299
|
-
## vault Command
|
|
294
|
+
## vault Command
|
|
300
295
|
|
|
301
|
-
|
|
296
|
+
Secure API key storage, encrypted in `cc-helper.json`.
|
|
302
297
|
|
|
303
298
|
```bash
|
|
304
|
-
# List
|
|
305
|
-
cc-helper vault
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
cc-helper vault set bailian default -k "YOUR_API_KEY"
|
|
309
|
-
|
|
310
|
-
# Get and decrypt a secret
|
|
311
|
-
cc-helper vault get bailian default
|
|
312
|
-
|
|
313
|
-
# Delete a secret
|
|
314
|
-
cc-helper vault delete bailian default
|
|
299
|
+
cc-helper vault list # List secrets
|
|
300
|
+
cc-helper vault set bailian default -k "KEY" # Set
|
|
301
|
+
cc-helper vault get bailian default # Get & decrypt
|
|
302
|
+
cc-helper vault delete bailian default # Delete
|
|
315
303
|
```
|
|
316
304
|
|
|
317
|
-
|
|
305
|
+
## env Command
|
|
318
306
|
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
Support multiple environments (default, work, staging, etc.).
|
|
307
|
+
Multiple environments (default, work, staging, etc.).
|
|
322
308
|
|
|
323
309
|
```bash
|
|
324
|
-
# List environments
|
|
325
|
-
cc-helper env
|
|
326
|
-
|
|
327
|
-
# Create environment
|
|
328
|
-
cc-helper env create work
|
|
329
|
-
|
|
330
|
-
# Switch environment
|
|
331
|
-
cc-helper env switch work
|
|
310
|
+
cc-helper env list # List environments
|
|
311
|
+
cc-helper env create work # Create
|
|
312
|
+
cc-helper env switch work # Switch
|
|
332
313
|
```
|
|
333
314
|
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
## sync Command - Configuration Sync
|
|
315
|
+
## sync Command
|
|
337
316
|
|
|
338
|
-
Export/import
|
|
317
|
+
Export/import config to Git repository with JWE encryption.
|
|
339
318
|
|
|
340
319
|
```bash
|
|
341
320
|
# Login to GitHub
|
|
342
321
|
cc-helper sync login -r https://github.com/user/repo -t ghp_xxx
|
|
343
322
|
|
|
344
|
-
# Export
|
|
323
|
+
# Export
|
|
345
324
|
cc-helper sync export
|
|
346
|
-
|
|
347
|
-
# Export to file
|
|
348
325
|
cc-helper sync export --file config.json
|
|
349
|
-
cc-helper sync export --workspace test
|
|
326
|
+
cc-helper sync export --workspace test
|
|
350
327
|
|
|
351
|
-
# Import
|
|
328
|
+
# Import
|
|
352
329
|
cc-helper sync import
|
|
353
330
|
```
|
|
354
331
|
|
|
@@ -356,37 +333,30 @@ cc-helper sync import
|
|
|
356
333
|
|
|
357
334
|
## Features
|
|
358
335
|
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
- Auto-skip onboarding flow
|
|
371
|
-
- Zero runtime dependencies
|
|
372
|
-
- Cross-platform support
|
|
373
|
-
- Version support: 2.1.71 - 2.1.76+
|
|
374
|
-
|
|
375
|
-
### Examples
|
|
376
|
-
|
|
377
|
-
After enabling, use the `/loop` command in Claude Code:
|
|
336
|
+
| Feature | Description |
|
|
337
|
+
| ------------------ | ------------------------------------------------------- |
|
|
338
|
+
| One-command enable | Enable `/loop`, `/btw`, `/keybindings` with one command |
|
|
339
|
+
| Tool Search | Optional `/toolsearch` for third-party API proxies |
|
|
340
|
+
| 1M Context | Optional `/context1m` for 1M context (v2.1.76+) |
|
|
341
|
+
| Provider config | `plan` command with vault-based API key storage |
|
|
342
|
+
| Secret management | `vault` command for secure secret storage |
|
|
343
|
+
| Multi-environment | `env` command for environment switching |
|
|
344
|
+
| Git sync | `sync` command for configuration sync |
|
|
345
|
+
| Easy restore | Automatic backup and restore |
|
|
346
|
+
| Zero dependencies | No runtime dependencies |
|
|
378
347
|
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
Example of executing a loop command:
|
|
348
|
+
### Screenshots
|
|
382
349
|
|
|
350
|
+

|
|
383
351
|

|
|
384
352
|
|
|
385
353
|
## Platforms
|
|
386
354
|
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
355
|
+
| Platform | Architecture |
|
|
356
|
+
| -------- | ------------ |
|
|
357
|
+
| macOS | amd64, arm64 |
|
|
358
|
+
| Linux | amd64, arm64 |
|
|
359
|
+
| Windows | amd64, arm64 |
|
|
390
360
|
|
|
391
361
|
## License
|
|
392
362
|
|
|
@@ -396,7 +366,7 @@ AGPL-3.0 - see [LICENSE](./LICENSE)
|
|
|
396
366
|
|
|
397
367
|
### Reporting Vulnerabilities
|
|
398
368
|
|
|
399
|
-
If you discover a security vulnerability
|
|
369
|
+
If you discover a security vulnerability, please report it responsibly:
|
|
400
370
|
|
|
401
371
|
1. **Do not** open a public issue
|
|
402
372
|
2. Send an email to the maintainer with details
|