chatccc 0.2.309 → 0.2.310
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.md +471 -469
- package/deepccc-agent/README.md +491 -482
- package/deepccc-agent/package.json +2 -1
- package/dist/deepccc-agent/src/cli.js +3 -3
- package/dist/deepccc-agent/src/completion-session.js +7 -5
- package/dist/deepccc-agent/src/config.js +2 -2
- package/dist/deepccc-agent/src/decision-session.js +18 -13
- package/dist/deepccc-agent/src/index.js +8 -35
- package/dist/deepccc-agent/src/json-mode-fetch.js +4 -2
- package/dist/deepccc-agent/src/model-provider.js +55 -0
- package/dist/deepccc-agent/src/web-page.js +406 -406
- package/dist/src/config-utils.js +3 -3
- package/dist/src/web-ui.js +1926 -1924
- package/package.json +2 -1
package/deepccc-agent/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
|
-
# DeepCCC
|
|
2
|
-
|
|
3
|
-
DeepCCC 是一个本地优先的开源 Coding Agent,同时提供浏览器多会话界面、终端 CLI 和适合自动化集成的 JSONL 流。它针对 DeepSeek 做了缓存和上下文优化,也支持任意 OpenAI-compatible 服务以及 Anthropic Messages 协议。
|
|
4
|
-
|
|
5
|
-
- 项目主页:https://github.com/wzj998/deepccc-agent
|
|
6
|
-
- npm 包:https://www.npmjs.com/package/deepccc
|
|
7
|
-
- 运行要求:Node.js >= 20,以及一个兼容模型服务的 API Key
|
|
8
|
-
|
|
9
|
-
## 安装与快速开始
|
|
10
|
-
|
|
1
|
+
# DeepCCC
|
|
2
|
+
|
|
3
|
+
DeepCCC 是一个本地优先的开源 Coding Agent,同时提供浏览器多会话界面、终端 CLI 和适合自动化集成的 JSONL 流。它针对 DeepSeek 做了缓存和上下文优化,也支持任意 OpenAI-compatible 服务以及 Anthropic Messages 协议。
|
|
4
|
+
|
|
5
|
+
- 项目主页:https://github.com/wzj998/deepccc-agent
|
|
6
|
+
- npm 包:https://www.npmjs.com/package/deepccc
|
|
7
|
+
- 运行要求:Node.js >= 20,以及一个兼容模型服务的 API Key
|
|
8
|
+
|
|
9
|
+
## 安装与快速开始
|
|
10
|
+
|
|
11
11
|
模型原生流未收到完成事件、返回错误结束原因或达到输出长度限制时,会报告异常并保留已经输出的内容,不将不完整回复判为成功。没有回复且没有工具执行的空结果也会明确报错。用户主动取消仍按中断处理。
|
|
12
12
|
|
|
13
13
|
命令工具拒绝缺失或类型不符的必需参数,并指出具体字段,供模型修正后再调用。`run_script` 必须显式传入 `language`(`python` 或 `node`)和完整 `code`;不会猜测脚本语言或自动执行不完整调用。
|
|
@@ -15,373 +15,382 @@ DeepCCC 是一个本地优先的开源 Coding Agent,同时提供浏览器多
|
|
|
15
15
|
启用会话持久化时,过长的工具输入字符串会在被上下文预算省略前保存到该会话的 `tool-arguments/<SHA256>.txt`,标记给出工件文件名,运行时指令给出目录。预算不足以保留参数对象时可用短 JSON 工件引用,内部仍可能包含需继续读取的字符串工件引用。通过本会话 `read_file` 读取这些工件时会校验内容哈希;复用前仍须读取并核对当前任务。工件记录生成过的参数,不证明原调用成功。
|
|
16
16
|
|
|
17
17
|
单个工件上限为 1 MiB,与文件读取上限一致;保存失败、超限或无法容纳引用时保留不可恢复标记,不编造原值。未启用持久化的会话不写工件,重置会话会清除其参数工件。现有上下文预算保留,工件引用、不可用元数据和新旧省略标记在工具入口被拦截,不直接执行或写入为文件内容。
|
|
18
|
-
|
|
19
|
-
全局安装:
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
npm install -g deepccc
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
配置 `~/.deepccc/config.json` 或 `DEEPCCC_*` 环境变量后,运行:
|
|
26
|
-
|
|
27
|
-
```bash
|
|
28
|
-
deepccc
|
|
29
|
-
```
|
|
30
|
-
|
|
31
|
-
浏览器会自动打开 `http://127.0.0.1:28080/`。终端模式使用:
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
deepccc-cli
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
从源码运行:
|
|
38
|
-
|
|
39
|
-
```bash
|
|
40
|
-
git clone https://github.com/wzj998/deepccc-agent.git
|
|
41
|
-
cd deepccc-agent
|
|
42
|
-
npm install
|
|
43
|
-
npm run build
|
|
44
|
-
npm run dev
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
## Web UI 预览
|
|
48
|
-
|
|
49
|
-
以下画面来自 DeepCCC 对本项目真实开发需求的 Agent 调用。截图仅将用户名、组织名、
|
|
50
|
-
内部域名和绝对路径替换为公开示例,任务内容、模型配置、Agent 回复和审批流程均来自
|
|
51
|
-
实际运行结果。
|
|
52
|
-
|
|
53
|
-
多会话可以并行处理不同任务,每个会话分别选择 model、subModel 和 effort。下图来自
|
|
54
|
-
`deepccc-agent/` 工作目录中的真实提问“这个项目妙在哪?”:
|
|
55
|
-
|
|
56
|
-

|
|
57
|
-
|
|
58
|
-
命中需要确认的命令时,审批卡会直接出现在当前会话时间线中,不打断到弹窗:
|
|
59
|
-
|
|
60
|
-

|
|
61
|
-
|
|
62
|
-
单一 API 配置作为新会话默认值,模型与 effort 仍可在每个会话中单独覆盖:
|
|
63
|
-
|
|
64
|
-

|
|
65
|
-
|
|
66
|
-
## 核心能力
|
|
67
|
-
|
|
68
|
-
- 有界结构化决策:程序化 `DecisionSession` 支持外部管理上下文、显式工具白名单、运行时结果校验和整轮截止时间;不改变默认聊天行为。详见 [接入文档](docs/decision-session.md)。
|
|
69
|
-
|
|
70
|
-
- Web-first:多会话、持久化历史、实时流式过程、停止和恢复
|
|
71
|
-
- 工具时间线:ChatCCC 风格 emoji 摘要、参数/结果折叠、省略行展开和状态记忆
|
|
72
|
-
- 会话配置:每个会话独立选择 model、subModel 和 effort
|
|
73
|
-
- 图片附件:Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP;Agent 可用 `present_file` 回传图片
|
|
74
|
-
- 本地工具:代码搜索、文件读写、补丁、命令执行、Git、网页搜索和抓取
|
|
75
|
-
- 权限审批:危险命令在会话时间线中暂停,支持拒绝、允许一次、会话允许和永久允许
|
|
76
|
-
- 上下文管理:自动压缩、原始流日志和跨会话历史检索
|
|
77
|
-
- 长会话校准:当前状态覆盖旧建议,摘要区分历史/事实/推断/局限;关键设定保留来源,区分用户确认、助手写入与助手推断;轮内工具结果有独立预算,避免多步调查持续膨胀
|
|
78
|
-
- 项目约定:自动加载 AGENTS.md、CLAUDE.md、系统提示和目录式 Skills
|
|
79
|
-
- 项目理解:可控搜索范围、按需本地项目地图、源文件变化即失效的证据笔记;不针对特定业务仓库,详见 [项目理解与搜索](docs/workspace-understanding.md)
|
|
80
|
-
- 自动化:`deepccc-cli --stream-json` 提供稳定 JSONL 事件接口
|
|
81
|
-
|
|
82
|
-
## 缓存命中率
|
|
83
|
-
|
|
84
|
-
deepccc 的本地缓存优化实测命中率 **96.7%**,有效降低重复请求开销,让响应更快、更省成本。
|
|
85
|
-
|
|
86
|
-

|
|
87
|
-
|
|
88
|
-

|
|
89
|
-
|
|
90
|
-
## 配置
|
|
91
|
-
|
|
92
|
-
最快的方式是使用环境变量:
|
|
93
|
-
|
|
94
|
-
```bash
|
|
95
|
-
export DEEPCCC_API_KEY="sk-..."
|
|
96
|
-
export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
|
|
97
|
-
export DEEPCCC_MODEL="deepseek-v4-pro"
|
|
98
|
-
export DEEPCCC_EFFORT="high"
|
|
99
|
-
export DEEPCCC_MAX_OUTPUT_TOKENS="32768"
|
|
100
|
-
export DEEPCCC_STREAMING="true"
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
Windows PowerShell:
|
|
104
|
-
|
|
105
|
-
```powershell
|
|
106
|
-
$env:DEEPCCC_API_KEY="sk-..."
|
|
107
|
-
$env:DEEPCCC_PROVIDER="openai"
|
|
108
|
-
$env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
|
|
109
|
-
$env:DEEPCCC_MODEL="deepseek-v4-pro"
|
|
110
|
-
$env:DEEPCCC_EFFORT="high"
|
|
111
|
-
$env:DEEPCCC_MAX_OUTPUT_TOKENS="32768"
|
|
112
|
-
$env:DEEPCCC_STREAMING="true"
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
也兼容这些 DeepSeek 别名:
|
|
116
|
-
|
|
117
|
-
- `DEEPSEEK_API_KEY`
|
|
118
|
-
- `DEEPSEEK_BASE_URL`
|
|
119
|
-
- `DEEPSEEK_MODEL`
|
|
120
|
-
- `DEEPSEEK_EFFORT`
|
|
121
|
-
|
|
122
|
-
也可以创建 `~/.deepccc/config.json`:
|
|
123
|
-
|
|
124
|
-
```json
|
|
125
|
-
{
|
|
126
|
-
"provider": "openai",
|
|
127
|
-
"apiKey": "sk-...",
|
|
128
|
-
"baseURL": "https://api.deepseek.com/v1",
|
|
129
|
-
"model": "deepseek-v4-pro",
|
|
130
|
-
"subModel": "",
|
|
131
|
-
"effort": "",
|
|
132
|
-
"maxOutputTokens": null,
|
|
133
|
-
"streaming": true,
|
|
134
|
-
"contextWindow": 1048576,
|
|
135
|
-
"git": {
|
|
136
|
-
"coAuthor": {
|
|
137
|
-
"enabled": true,
|
|
138
|
-
"name": "DeepCCC",
|
|
139
|
-
"email": "20184052+wzj998@users.noreply.github.com"
|
|
140
|
-
}
|
|
141
|
-
},
|
|
142
|
-
"rawStreamLogs": {
|
|
143
|
-
"enabled": true,
|
|
144
|
-
"maxBytesPerTurn": 1048576,
|
|
145
|
-
"retentionDays": 7,
|
|
146
|
-
"keepCompleted": false
|
|
147
|
-
},
|
|
148
|
-
"web": {
|
|
149
|
-
"port": 28080,
|
|
150
|
-
"openOnStart": true
|
|
151
|
-
}
|
|
152
|
-
}
|
|
153
|
-
```
|
|
154
|
-
|
|
155
|
-
## Web UI
|
|
156
|
-
|
|
157
|
-
全局安装后可以直接启动本地网页版:
|
|
158
|
-
|
|
159
|
-
```bash
|
|
160
|
-
deepccc
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
默认只监听 `http://127.0.0.1:28080/`,不会暴露到局域网。可在
|
|
164
|
-
`~/.deepccc/config.json` 的 `web.port` 修改端口,`web.openOnStart` 控制启动时是否自动打开浏览器;也可以临时使用 `deepccc --port 28081 --no-open`。默认启动会安全替换经过实例身份验证的旧 DeepCCC Web;传入 `--reuse-existing` 时复用已有实例。`deepccc web` 保留为兼容别名。
|
|
165
|
-
|
|
166
|
-
从源码开发时,`npm run dev` 启动 Web Server 并打开页面(不启用 watch);`npm run dev:cli` 启动终端模式。
|
|
167
|
-
|
|
168
|
-
Web UI 支持新建、恢复、重命名和删除多会话,多个会话可以同时运行,即使它们指向同一个工作目录。每个会话可独立选择 model、subModel 和 effort,并持续复用 CLI 已保存的历史。注意:当前版本不自动创建 Git worktree;同目录的多个运行中 Agent 直接修改同一组文件,页面会提示覆盖与冲突风险。
|
|
169
|
-
|
|
170
|
-
模型文本、reasoning 心跳和工具事件通过 SSE 实时更新。每轮消息按真实发生顺序持久化和回放,因此刷新后仍会保持“阶段说明 → 工具调用 → 后续结论”的交错时间线;旧版会话没有顺序数据时,会兼容显示为“工具调用 → 最终回答”。每次工具调用与对应结果合并成一张卡片,折叠态显示 emoji、工具名、状态和关键参数;展开后调用参数默认保留前 8/后 4 行,工具结果保留前 12/后 6 行,省略内容可继续展开。工具卡及省略行的展开状态保存在当前浏览器标签页的 `sessionStorage`,持续生成、切换会话和刷新页面均不会自动收起。消息正文支持标题、表格、列表、引用、链接和代码块等常用 Markdown。
|
|
171
|
-
|
|
172
|
-
图片会转换成模型可见的原生视觉输入。Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP/GIF;CLI 可用 `--image` 或交互命令 `/image`。每条消息最多 10 张、单图最大 20 MiB、图片合计最大 24 MiB,单边最多 8192 像素;超限时提示分图或缩小,保留原图细节。附件复制到 `~/.deepccc/attachments/<session-id>/`,聊天历史只保存引用,raw 日志过滤图片编码。删除 Web 会话时附件一并清理。
|
|
173
|
-
|
|
174
|
-
识图模型未配置或为空白时,跟随当前会话实际主模型,包括 CLI --model 的覆盖值;子代理没有显式识图配置时跟随自身实际主模型,显式配置则继续继承。若主模型不支持视觉,可在 API 设置中指定 `visionModel`(如 `deepseek-flash`),或设置 `DEEPCCC_VISION_MODEL` / CLI `--vision-model`;该模型使用同一 API 协议、Base URL 和 Key,先分析图片,再由主模型结合观察继续任务。界面及 JSONL 会显示实际图片模型和模式。未配置图片模型的 `deepseek-v4-pro` 收图会明确报错;其他兼容模型需服务端支持图像,接口错误不会降级成“假装看过”。官方 DeepSeek 端点的旧 Flash 名称仅在视觉请求中映射到当前 `deepseek-flash`,自定义网关保留用户配置的名称。
|
|
175
|
-
|
|
176
|
-
Agent 可用 `read_image` 查看本地截图、图表或工具产物,并通过 `question` 指定需要观察的细节;`present_file` 用于把图片展示给用户。后续追问会按预算重新加载近期图片;较早图片保留路径供 `read_image` 重新查看。独立图片模型的观察按原文问题、模型、端点与图片内容哈希缓存;细节追问可重新调用 `read_image`。压缩后的摘要应保留重要图片引用,缺失或损坏图片会明确报错。本版本支持图片输入,不包含音频、视频或 PDF 原生输入。
|
|
177
|
-
|
|
178
|
-
API 设置采用单一 Provider 配置,支持 OpenAI-compatible 与 Anthropic Messages。完整 API Key 只保存在本机 `~/.deepccc/config.json`,浏览器读取设置时仅返回掩码。危险命令会在会话中暂停并请求“拒绝、允许一次、本会话允许、永久允许”,浏览器断开或审批超时默认拒绝。
|
|
179
|
-
|
|
180
|
-
`git.coAuthor.enabled` 默认开启。DeepCCC 通过 `run_process` 或 `run_command` 创建 Git 提交时会保留用户为
|
|
181
|
-
主 Author,并追加 `Co-authored-by: DeepCCC <20184052+wzj998@users.noreply.github.com>`。
|
|
182
|
-
可设为 `false` 或用 `DEEPCCC_GIT_COAUTHOR=false` 全局关闭。ChatCCC 的
|
|
183
|
-
`ccc.gitCoAuthor` 是三态 override:`null`/缺失跟随这里,`true` 强制开启,`false` 强制关闭。
|
|
184
|
-
|
|
185
|
-
`provider` 可选 `openai` 或 `anthropic`,默认 `openai`,也可以通过
|
|
186
|
-
`DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖:
|
|
187
|
-
|
|
188
|
-
- `openai` 使用 OpenAI-compatible Chat Completions 协议,兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
|
|
189
|
-
- `
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
`
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
`
|
|
227
|
-
`
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
deepccc-cli --
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
```bash
|
|
276
|
-
deepccc-cli --
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
18
|
+
|
|
19
|
+
全局安装:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm install -g deepccc
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
配置 `~/.deepccc/config.json` 或 `DEEPCCC_*` 环境变量后,运行:
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
deepccc
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
浏览器会自动打开 `http://127.0.0.1:28080/`。终端模式使用:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
deepccc-cli
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
从源码运行:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
git clone https://github.com/wzj998/deepccc-agent.git
|
|
41
|
+
cd deepccc-agent
|
|
42
|
+
npm install
|
|
43
|
+
npm run build
|
|
44
|
+
npm run dev
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Web UI 预览
|
|
48
|
+
|
|
49
|
+
以下画面来自 DeepCCC 对本项目真实开发需求的 Agent 调用。截图仅将用户名、组织名、
|
|
50
|
+
内部域名和绝对路径替换为公开示例,任务内容、模型配置、Agent 回复和审批流程均来自
|
|
51
|
+
实际运行结果。
|
|
52
|
+
|
|
53
|
+
多会话可以并行处理不同任务,每个会话分别选择 model、subModel 和 effort。下图来自
|
|
54
|
+
`deepccc-agent/` 工作目录中的真实提问“这个项目妙在哪?”:
|
|
55
|
+
|
|
56
|
+

|
|
57
|
+
|
|
58
|
+
命中需要确认的命令时,审批卡会直接出现在当前会话时间线中,不打断到弹窗:
|
|
59
|
+
|
|
60
|
+

|
|
61
|
+
|
|
62
|
+
单一 API 配置作为新会话默认值,模型与 effort 仍可在每个会话中单独覆盖:
|
|
63
|
+
|
|
64
|
+

|
|
65
|
+
|
|
66
|
+
## 核心能力
|
|
67
|
+
|
|
68
|
+
- 有界结构化决策:程序化 `DecisionSession` 支持外部管理上下文、显式工具白名单、运行时结果校验和整轮截止时间;不改变默认聊天行为。详见 [接入文档](docs/decision-session.md)。
|
|
69
|
+
|
|
70
|
+
- Web-first:多会话、持久化历史、实时流式过程、停止和恢复
|
|
71
|
+
- 工具时间线:ChatCCC 风格 emoji 摘要、参数/结果折叠、省略行展开和状态记忆
|
|
72
|
+
- 会话配置:每个会话独立选择 model、subModel 和 effort
|
|
73
|
+
- 图片附件:Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP;Agent 可用 `present_file` 回传图片
|
|
74
|
+
- 本地工具:代码搜索、文件读写、补丁、命令执行、Git、网页搜索和抓取
|
|
75
|
+
- 权限审批:危险命令在会话时间线中暂停,支持拒绝、允许一次、会话允许和永久允许
|
|
76
|
+
- 上下文管理:自动压缩、原始流日志和跨会话历史检索
|
|
77
|
+
- 长会话校准:当前状态覆盖旧建议,摘要区分历史/事实/推断/局限;关键设定保留来源,区分用户确认、助手写入与助手推断;轮内工具结果有独立预算,避免多步调查持续膨胀
|
|
78
|
+
- 项目约定:自动加载 AGENTS.md、CLAUDE.md、系统提示和目录式 Skills
|
|
79
|
+
- 项目理解:可控搜索范围、按需本地项目地图、源文件变化即失效的证据笔记;不针对特定业务仓库,详见 [项目理解与搜索](docs/workspace-understanding.md)
|
|
80
|
+
- 自动化:`deepccc-cli --stream-json` 提供稳定 JSONL 事件接口
|
|
81
|
+
|
|
82
|
+
## 缓存命中率
|
|
83
|
+
|
|
84
|
+
deepccc 的本地缓存优化实测命中率 **96.7%**,有效降低重复请求开销,让响应更快、更省成本。
|
|
85
|
+
|
|
86
|
+

|
|
87
|
+
|
|
88
|
+

|
|
89
|
+
|
|
90
|
+
## 配置
|
|
91
|
+
|
|
92
|
+
最快的方式是使用环境变量:
|
|
93
|
+
|
|
94
|
+
```bash
|
|
95
|
+
export DEEPCCC_API_KEY="sk-..."
|
|
96
|
+
export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
|
|
97
|
+
export DEEPCCC_MODEL="deepseek-v4-pro"
|
|
98
|
+
export DEEPCCC_EFFORT="high"
|
|
99
|
+
export DEEPCCC_MAX_OUTPUT_TOKENS="32768"
|
|
100
|
+
export DEEPCCC_STREAMING="true"
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Windows PowerShell:
|
|
104
|
+
|
|
105
|
+
```powershell
|
|
106
|
+
$env:DEEPCCC_API_KEY="sk-..."
|
|
107
|
+
$env:DEEPCCC_PROVIDER="openai"
|
|
108
|
+
$env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
|
|
109
|
+
$env:DEEPCCC_MODEL="deepseek-v4-pro"
|
|
110
|
+
$env:DEEPCCC_EFFORT="high"
|
|
111
|
+
$env:DEEPCCC_MAX_OUTPUT_TOKENS="32768"
|
|
112
|
+
$env:DEEPCCC_STREAMING="true"
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
也兼容这些 DeepSeek 别名:
|
|
116
|
+
|
|
117
|
+
- `DEEPSEEK_API_KEY`
|
|
118
|
+
- `DEEPSEEK_BASE_URL`
|
|
119
|
+
- `DEEPSEEK_MODEL`
|
|
120
|
+
- `DEEPSEEK_EFFORT`
|
|
121
|
+
|
|
122
|
+
也可以创建 `~/.deepccc/config.json`:
|
|
123
|
+
|
|
124
|
+
```json
|
|
125
|
+
{
|
|
126
|
+
"provider": "openai",
|
|
127
|
+
"apiKey": "sk-...",
|
|
128
|
+
"baseURL": "https://api.deepseek.com/v1",
|
|
129
|
+
"model": "deepseek-v4-pro",
|
|
130
|
+
"subModel": "",
|
|
131
|
+
"effort": "",
|
|
132
|
+
"maxOutputTokens": null,
|
|
133
|
+
"streaming": true,
|
|
134
|
+
"contextWindow": 1048576,
|
|
135
|
+
"git": {
|
|
136
|
+
"coAuthor": {
|
|
137
|
+
"enabled": true,
|
|
138
|
+
"name": "DeepCCC",
|
|
139
|
+
"email": "20184052+wzj998@users.noreply.github.com"
|
|
140
|
+
}
|
|
141
|
+
},
|
|
142
|
+
"rawStreamLogs": {
|
|
143
|
+
"enabled": true,
|
|
144
|
+
"maxBytesPerTurn": 1048576,
|
|
145
|
+
"retentionDays": 7,
|
|
146
|
+
"keepCompleted": false
|
|
147
|
+
},
|
|
148
|
+
"web": {
|
|
149
|
+
"port": 28080,
|
|
150
|
+
"openOnStart": true
|
|
151
|
+
}
|
|
152
|
+
}
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
## Web UI
|
|
156
|
+
|
|
157
|
+
全局安装后可以直接启动本地网页版:
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
deepccc
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
默认只监听 `http://127.0.0.1:28080/`,不会暴露到局域网。可在
|
|
164
|
+
`~/.deepccc/config.json` 的 `web.port` 修改端口,`web.openOnStart` 控制启动时是否自动打开浏览器;也可以临时使用 `deepccc --port 28081 --no-open`。默认启动会安全替换经过实例身份验证的旧 DeepCCC Web;传入 `--reuse-existing` 时复用已有实例。`deepccc web` 保留为兼容别名。
|
|
165
|
+
|
|
166
|
+
从源码开发时,`npm run dev` 启动 Web Server 并打开页面(不启用 watch);`npm run dev:cli` 启动终端模式。
|
|
167
|
+
|
|
168
|
+
Web UI 支持新建、恢复、重命名和删除多会话,多个会话可以同时运行,即使它们指向同一个工作目录。每个会话可独立选择 model、subModel 和 effort,并持续复用 CLI 已保存的历史。注意:当前版本不自动创建 Git worktree;同目录的多个运行中 Agent 直接修改同一组文件,页面会提示覆盖与冲突风险。
|
|
169
|
+
|
|
170
|
+
模型文本、reasoning 心跳和工具事件通过 SSE 实时更新。每轮消息按真实发生顺序持久化和回放,因此刷新后仍会保持“阶段说明 → 工具调用 → 后续结论”的交错时间线;旧版会话没有顺序数据时,会兼容显示为“工具调用 → 最终回答”。每次工具调用与对应结果合并成一张卡片,折叠态显示 emoji、工具名、状态和关键参数;展开后调用参数默认保留前 8/后 4 行,工具结果保留前 12/后 6 行,省略内容可继续展开。工具卡及省略行的展开状态保存在当前浏览器标签页的 `sessionStorage`,持续生成、切换会话和刷新页面均不会自动收起。消息正文支持标题、表格、列表、引用、链接和代码块等常用 Markdown。
|
|
171
|
+
|
|
172
|
+
图片会转换成模型可见的原生视觉输入。Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP/GIF;CLI 可用 `--image` 或交互命令 `/image`。每条消息最多 10 张、单图最大 20 MiB、图片合计最大 24 MiB,单边最多 8192 像素;超限时提示分图或缩小,保留原图细节。附件复制到 `~/.deepccc/attachments/<session-id>/`,聊天历史只保存引用,raw 日志过滤图片编码。删除 Web 会话时附件一并清理。
|
|
173
|
+
|
|
174
|
+
识图模型未配置或为空白时,跟随当前会话实际主模型,包括 CLI --model 的覆盖值;子代理没有显式识图配置时跟随自身实际主模型,显式配置则继续继承。若主模型不支持视觉,可在 API 设置中指定 `visionModel`(如 `deepseek-flash`),或设置 `DEEPCCC_VISION_MODEL` / CLI `--vision-model`;该模型使用同一 API 协议、Base URL 和 Key,先分析图片,再由主模型结合观察继续任务。界面及 JSONL 会显示实际图片模型和模式。未配置图片模型的 `deepseek-v4-pro` 收图会明确报错;其他兼容模型需服务端支持图像,接口错误不会降级成“假装看过”。官方 DeepSeek 端点的旧 Flash 名称仅在视觉请求中映射到当前 `deepseek-flash`,自定义网关保留用户配置的名称。
|
|
175
|
+
|
|
176
|
+
Agent 可用 `read_image` 查看本地截图、图表或工具产物,并通过 `question` 指定需要观察的细节;`present_file` 用于把图片展示给用户。后续追问会按预算重新加载近期图片;较早图片保留路径供 `read_image` 重新查看。独立图片模型的观察按原文问题、模型、端点与图片内容哈希缓存;细节追问可重新调用 `read_image`。压缩后的摘要应保留重要图片引用,缺失或损坏图片会明确报错。本版本支持图片输入,不包含音频、视频或 PDF 原生输入。
|
|
177
|
+
|
|
178
|
+
API 设置采用单一 Provider 配置,支持 OpenAI-compatible 与 Anthropic Messages。完整 API Key 只保存在本机 `~/.deepccc/config.json`,浏览器读取设置时仅返回掩码。危险命令会在会话中暂停并请求“拒绝、允许一次、本会话允许、永久允许”,浏览器断开或审批超时默认拒绝。
|
|
179
|
+
|
|
180
|
+
`git.coAuthor.enabled` 默认开启。DeepCCC 通过 `run_process` 或 `run_command` 创建 Git 提交时会保留用户为
|
|
181
|
+
主 Author,并追加 `Co-authored-by: DeepCCC <20184052+wzj998@users.noreply.github.com>`。
|
|
182
|
+
可设为 `false` 或用 `DEEPCCC_GIT_COAUTHOR=false` 全局关闭。ChatCCC 的
|
|
183
|
+
`ccc.gitCoAuthor` 是三态 override:`null`/缺失跟随这里,`true` 强制开启,`false` 强制关闭。
|
|
184
|
+
|
|
185
|
+
`provider` 可选 `openai`、`openai-responses` 或 `anthropic`,默认 `openai`,也可以通过
|
|
186
|
+
`DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖:
|
|
187
|
+
|
|
188
|
+
- `openai` 使用 OpenAI-compatible Chat Completions 协议,兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
|
|
189
|
+
- `openai-responses` 使用原生 OpenAI Responses API(`/responses`),支持流式/非流式工具循环、主/子/图片模型与摘要。适合 GPT-6.2 Sol/Astra 等要求 Responses 工具调用的模型。Base URL 填 `https://api.openai.com/v1`,不要追加 `/responses`;`effort` 映射为 `reasoning.effort`。默认 `store:false`,工具循环携带加密推理状态。摘要使用 `low` effort,不发送 temperature。原有 `openai` 不会自动切换。
|
|
190
|
+
- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` **完全按填写值使用,不自动补 `/v1`**,请填写到完整版本化地址,例如 DeepSeek 官方 Anthropic 端点为 `https://api.deepseek.com/anthropic/v1`(官方 Anthropic SDK 使用的 `https://api.deepseek.com/anthropic` 基址会拼接为 `.../anthropic/v1/messages`)。`effort` 在 OpenAI-compatible 模式映射为 `reasoning_effort`,在 Anthropic 模式映射为 `output_config.effort`;目标服务不支持时应留空。
|
|
191
|
+
|
|
192
|
+
`streaming` 控制主对话是否使用流式请求,默认 `true`;也可以通过
|
|
193
|
+
`DEEPCCC_STREAMING=true|false` 覆盖。关闭后,终端会在整条模型响应完成后一次性显示结果。
|
|
194
|
+
|
|
195
|
+
`maxOutputTokens` 限制主对话单次最大输出 token,默认不配置(`null`/缺失),此时不向
|
|
196
|
+
Provider 发送 `max_tokens`,使用模型服务端默认值。可通过 `DEEPCCC_MAX_OUTPUT_TOKENS`
|
|
197
|
+
或命令行 `--max-output-tokens` 覆盖;只接受正整数。该限制会同时覆盖模型思考内容、
|
|
198
|
+
工具参数和最终回答,设置过小可能导致工具调用或长回复被截断。
|
|
199
|
+
|
|
200
|
+
`contextWindow` 是模型上下文窗口(token),默认 `1048576`(1M,DeepSeek V4 Pro/Flash
|
|
201
|
+
原生规格);常规上下文压缩阈值自动 = `contextWindow × 0.8`。工具输入与结果另有独立预算:
|
|
202
|
+
默认取 `min(64000, 常规压缩阈值 × 25%)`,超过后会提前压缩,避免长会话积累大量低信号工具输出。
|
|
203
|
+
可通过 `DEEPCCC_CONTEXT_WINDOW` 环境变量覆盖。⚠️ 超过模型/服务端实际上限时请求会被
|
|
204
|
+
API 拒绝(context length exceeded),实际窗口以模型与所用服务端为准(如 litellm 的
|
|
205
|
+
`max_input_tokens`)。
|
|
206
|
+
|
|
207
|
+
同一轮连续工具调用也有独立的结果重放预算。较早的简短成功回执、JSON 结果和错误信息,
|
|
208
|
+
若比省略提示更短,会保留原结果;较大的结果仍按预算截断或省略,工具调用关联保持不变。
|
|
209
|
+
|
|
210
|
+
`subModel` 是子模型(选填),默认 `""`(留空跟随主模型)。配置后,DeepCCC 内部的轻量
|
|
211
|
+
环节——上下文压缩摘要生成、`task` 子代理任务——使用子模型执行,主对话仍用主模型。
|
|
212
|
+
典型用法:主模型用 pro 承担复杂推理,子模型用 flash 做高频廉价的摘要与子任务。
|
|
213
|
+
可通过 `DEEPCCC_SUB_MODEL` 环境变量或命令行 `--sub-model` 覆盖。
|
|
214
|
+
|
|
215
|
+
`task` 子代理工具:主模型可把边界清晰的独立子任务(仓库调研、长文档阅读、独立模块生成)
|
|
216
|
+
委派给子代理执行——子代理使用子模型、独立上下文,不污染主对话上下文;结果截断回传。
|
|
217
|
+
子代理**不能再次委派**(禁止嵌套)。每次调用默认最多 20 步,也可用 `maxSteps` 在
|
|
218
|
+
1–100 步内指定预算;若在工具调用后耗尽预算,内核会追加一次禁止调用工具的强制总结,
|
|
219
|
+
避免只返回过程性开场白。设置 `runInBackground=true` 可让主代理继续工作,并通过
|
|
220
|
+
`task_output` 查看状态,或通过 `task_stop` 停止继续调查并要求子代理基于已有证据总结。
|
|
221
|
+
超时与主会话压缩超时一致。
|
|
222
|
+
仅在配置了子模型时建议使用(未配置时子代理跟随主模型,节省有限)。
|
|
223
|
+
|
|
224
|
+
`rawStreamLogs.enabled` 默认 `true`,通过 `DEEPCCC_RAW_STREAM_LOGS` 环境变量或配置 JSON 关闭。
|
|
225
|
+
开启时,每次对话的原始流按 gzip JSONL 落到 `~/.deepccc/raw-stream-logs/`,供
|
|
226
|
+
`session_search` 工具在会话被压缩后找回被压缩消息的精确原文(检索时设置
|
|
227
|
+
`include_raw_logs=true`)。压缩后注入的恢复提示会携带当前会话 ID:优先用
|
|
228
|
+
`session_id` 限定只搜当前会话,未命中时可省略 `session_id` 做全库检索。
|
|
229
|
+
关闭后,压缩后的旧消息原文将无法找回。
|
|
230
|
+
|
|
231
|
+
## 命令行交互
|
|
232
|
+
|
|
233
|
+
在当前目录启动一个交互式 Agent:
|
|
234
|
+
|
|
235
|
+
```bash
|
|
236
|
+
deepccc-cli
|
|
237
|
+
```
|
|
238
|
+
|
|
239
|
+
使用 OpenAI 官方 Responses API(密钥来自已关联订阅额度的 API 组织):
|
|
240
|
+
|
|
241
|
+
```bash
|
|
242
|
+
deepccc-cli --provider openai-responses --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-6.2-sol --effort medium
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
也可在 DeepCCC Web「API 与 Web 设置」选择 **OpenAI Responses**,或配置 `DEEPCCC_PROVIDER=openai-responses` / `~/.deepccc/config.json` 的 `provider`。ChatCCC 内嵌模式在「CCC Agent → API 协议」选择同名选项。不会自动创建密钥、切换已有账号或消耗额度。
|
|
246
|
+
|
|
247
|
+
指定其他模型或 OpenAI-compatible 接口:
|
|
248
|
+
|
|
249
|
+
```bash
|
|
250
|
+
deepccc-cli --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
使用 Anthropic Messages 协议(同样支持流式输出):
|
|
254
|
+
|
|
255
|
+
```bash
|
|
256
|
+
deepccc-cli --provider anthropic --base-url https://api.example.com --api-key "$API_KEY" --model claude-sonnet-4-6
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
指定工作目录:
|
|
260
|
+
|
|
261
|
+
```bash
|
|
262
|
+
deepccc-cli --cwd /path/to/project
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
附加一张或多张本地图片(重复传入 `--image`;路径含空格时加引号):
|
|
266
|
+
|
|
267
|
+
```bash
|
|
268
|
+
deepccc-cli --image ./error.png --image ./expected.webp
|
|
269
|
+
```
|
|
270
|
+
|
|
271
|
+
启动后再加图:输入 `/image "C:\截图\报错截图.png"`,看到“图片已加入下一条消息”后输入问题并回车。多图重复 `/image`;相对路径按会话工作目录(`--cwd`)解析。该命令在当前回复结束后使用。启动时的 `--image` 也只加入队列,随后输入问题发送。
|
|
272
|
+
|
|
273
|
+
脚本或纯命令模式可直接发送图片并获取 JSONL:
|
|
274
|
+
|
|
275
|
+
```bash
|
|
276
|
+
deepccc-cli --model deepseek-flash --stream-json --prompt "解释截图里的错误" --image "./error screenshot.png"
|
|
277
|
+
deepccc-cli --model deepseek-v4-pro --vision-model deepseek-flash --stream-json --prompt "对比两张图" --image ./before.png --image ./after.png
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
安装 ChatCCC 后提供的 `cccagent` 使用同一 CLI:将上述 `deepccc-cli` 换成 `cccagent` 即可。它读取 `~/.deepccc/config.json`、`DEEPCCC_*` 环境变量或命令行参数;ChatCCC 机器人里的 API 配置不会自动改写独立 CLI 配置。聊天窗口的图片粘贴/拖拽属于 Web 功能,纯终端请使用文件路径。
|
|
281
|
+
|
|
282
|
+
恢复当前工作目录最近一次会话:
|
|
283
|
+
|
|
284
|
+
```bash
|
|
285
|
+
deepccc-cli --resume
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
设置工具调用步数上限:
|
|
289
|
+
|
|
290
|
+
```bash
|
|
291
|
+
deepccc-cli --max-steps 20
|
|
292
|
+
```
|
|
293
|
+
|
|
294
|
+
默认情况下,`deepccc-cli` 不设置固定步数上限,会让模型自然完成工具循环。
|
|
295
|
+
|
|
296
|
+
设置推理强度(reasoning effort):
|
|
297
|
+
|
|
298
|
+
```bash
|
|
299
|
+
deepccc-cli --effort high
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
可选值:`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`(留空则不传 `reasoning_effort` 请求字段)。
|
|
303
|
+
|
|
304
|
+
限制主对话最大输出 token:
|
|
305
|
+
|
|
306
|
+
```bash
|
|
307
|
+
deepccc-cli --max-output-tokens 8192
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
不设置时使用 Provider 默认值。
|
|
311
|
+
|
|
312
|
+
## 权限机制
|
|
313
|
+
|
|
314
|
+
`deepccc` 内置轻量权限机制,对标主流 agent 的审批体验:**只拦截有副作用的操作**(`run_process` / `run_script` / `run_command` 与文件写操作),只读工具(`read_file` / `list_dir` / `search_code`)永不拦截,常规文件编辑默认放行不打断工作流。
|
|
315
|
+
|
|
316
|
+
默认模式(`ask`)下,只有**命中内置危险命令库**的高危命令才会询问,例如:
|
|
317
|
+
|
|
318
|
+
- `rm -rf` / `rm -fr` / `del /s` / `rmdir /s` 等强制删除
|
|
319
|
+
- `git push --force` / `git reset --hard` / `git clean -f` 等破坏性 git 操作
|
|
320
|
+
- `format` / `diskpart` / `mkfs` / `dd of=设备` 等磁盘操作
|
|
321
|
+
- `shutdown` / `reboot` 等系统操作
|
|
322
|
+
- `drop table` / `truncate table` 等数据库操作
|
|
323
|
+
- `npm publish` / `npm uninstall -g` / `pip uninstall` 等发布与全局卸载
|
|
324
|
+
|
|
325
|
+
交互模式下,高危命令会暂停并询问:
|
|
326
|
+
|
|
327
|
+
```text
|
|
328
|
+
⚠️ 高危操作需要确认
|
|
329
|
+
运行命令: rm -rf node_modules
|
|
330
|
+
允许一次(y) / 永远允许(a) / 拒绝(n) / 本会话允许所有(g) >
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
- `y` — 允许本次
|
|
334
|
+
- `a` — 永远允许,写入 `~/.deepccc/allow.json`
|
|
335
|
+
- `n` — 拒绝本次
|
|
336
|
+
- `g` — 本会话内全部放行(不落盘)
|
|
337
|
+
|
|
338
|
+
### 规则文件 `~/.deepccc/allow.json`
|
|
339
|
+
|
|
340
|
+
规则格式为 `"<工具>:<模式>"`(`*` 为通配符,`*:` 匹配所有工具),支持相对/绝对路径:
|
|
341
|
+
|
|
342
|
+
```json
|
|
343
|
+
{
|
|
344
|
+
"allow": [
|
|
345
|
+
"run_process:git status*",
|
|
346
|
+
"run_command:git status*",
|
|
347
|
+
"run_command:git push --force origin release*"
|
|
348
|
+
],
|
|
349
|
+
"deny": [
|
|
350
|
+
"edit_file:node_modules/**",
|
|
351
|
+
"run_process:npm publish*",
|
|
352
|
+
"run_command:npm publish*"
|
|
353
|
+
]
|
|
354
|
+
}
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
`deny` 命中永远拒绝,`allow` 命中永远放行(可覆盖高危判定)。文件变更后自动热加载,无需重启。
|
|
358
|
+
|
|
359
|
+
### 非交互模式与 bypass
|
|
360
|
+
|
|
361
|
+
`--stream-json` 或程序化调用(无终端可交互)时,高危命令**安全默认拒绝**。需要全自动场景可显式传入:
|
|
362
|
+
|
|
363
|
+
```bash
|
|
364
|
+
deepccc-cli --dangerously-bypass-permissions
|
|
365
|
+
```
|
|
366
|
+
|
|
367
|
+
该参数与 `ChatSession` 的 `permissionMode: "bypass"` 等价,也是 chatccc 集成 deepccc 时使用的模式(对齐 chatccc 调用 Claude Code / Codex 的 bypass 方式)。
|
|
368
|
+
|
|
369
|
+
## 终端过程区块
|
|
370
|
+
|
|
371
|
+
交互模式下,每轮回复渲染为固定"过程区块":状态行(压缩上下文中/生成回复中/完成/已停止/异常结束)+ 折叠工具行 + 原地更新正文,不滚屏刷 JSON。活动状态有心跳点号动画;完成/停止/异常后区块定型留在屏幕上。
|
|
372
|
+
|
|
373
|
+
持久化上下文达到常规 token 阈值或独立工具预算时,deepccc 会先按预算保留最近消息,再压缩较早内容;工具历史使用标准结构化 tool-call/tool-result 消息重放,不会把内部 `[工具记录]` 文本重复送回模型。若模型仍输出伪工具记录,系统会丢弃并重试一次;重复失败时安全终止,避免把未执行命令当成真实结果。超长历史消息、工具记录和压缩输入会被限长,一次压缩最多等待 5 分钟。
|
|
374
|
+
|
|
375
|
+
持久化工具记录在总量受限时优先完整保留短参数和短结果,再分配长载荷预算,避免子代理句柄、路径或退出状态被长正文挤成无效 JSON。task、task_output 和 task_stop 在创建或查找任务前校验必需参数;错误的 raw 包装或缺失句柄会返回具体参数提示,不产生额外子任务。
|
|
376
|
+
|
|
377
|
+
如果终端渲染出现异常,可以强制回退为纯文本流式输出:
|
|
378
|
+
|
|
379
|
+
```bash
|
|
380
|
+
deepccc-cli --plain
|
|
381
|
+
```
|
|
382
|
+
|
|
383
|
+
## JSONL 流式输出
|
|
384
|
+
|
|
385
|
+
JSONL 模式适合脚本、服务端集成或其他上层系统调用:
|
|
386
|
+
|
|
387
|
+
```bash
|
|
388
|
+
deepccc-cli --stream-json --prompt "检查这个仓库并总结测试命令"
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
也可以从 stdin 传入提示词:
|
|
392
|
+
|
|
393
|
+
```bash
|
|
385
394
|
echo "运行测试并解释失败原因" | deepccc-cli --stream-json
|
|
386
395
|
```
|
|
387
396
|
|
|
@@ -400,108 +409,108 @@ deepccc-cli --raw-stream-json --prompt "Read the specified files" > machine-even
|
|
|
400
409
|
0.2.40 起,损坏的保留参数标记(例如工件哈希写错、标记不完整或包有空白)同样在权限、执行和文件写入前被拒绝;错误指出受影响字段,合法引用给出当前会话的读取路径,损坏引用要求检查实际文件而不猜哈希。不会自动读取、修补或执行引用。合法脚本内部用于说明或处理的标记字面量仍可使用。
|
|
401
410
|
|
|
402
411
|
输出是逐行 JSON:
|
|
403
|
-
|
|
404
|
-
```jsonl
|
|
405
|
-
{"type":"start","session_id":"session-...","mode":"new","cwd":"/repo","model":"deepseek-v4-pro"}
|
|
406
|
-
{"type":"status","phase":"compacting"}
|
|
407
|
-
{"type":"compact","compactedMessages":12}
|
|
408
|
-
{"type":"status","phase":"generating"}
|
|
409
|
-
{"type":"text_delta","text":"...","accumulated":"..."}
|
|
410
|
-
{"type":"tool_call","id":"call_...","name":"read_file","input":{"path":"package.json"}}
|
|
411
|
-
{"type":"tool_result","tool_call_id":"call_...","name":"read_file","content":{},"is_error":false}
|
|
412
|
-
{"type":"done","text":"..."}
|
|
413
|
-
```
|
|
414
|
-
|
|
415
|
-
## 在 ChatCCC 中使用
|
|
416
|
-
|
|
417
|
-
**ChatCCC 已内置 deepccc**:ChatCCC 的 "CCC Agent" 工具直接内嵌 deepccc 的代码(仓库内 `deepccc-agent/` 子目录),以 `permissionMode: "bypass"` 全自动运行,无需单独安装或配置本仓库。
|
|
418
|
-
|
|
419
|
-
ChatCCC 是一个把 Claude Code / Codex / Cursor / CCC Agent 聚合到飞书/企微等 IM 消息通道的本地机器人框架,提供会话管理、过程卡片、用量统计与隐私替换等能力。
|
|
420
|
-
|
|
421
|
-
- 公有仓库:https://github.com/wzj998/ChatCCC
|
|
422
|
-
- npm 包:`chatccc`(`npm install -g chatccc`)
|
|
423
|
-
|
|
424
|
-
在 ChatCCC 会话里可以使用隐藏指令创建 `deepccc` Agent 会话:
|
|
425
|
-
|
|
426
|
-
```text
|
|
427
|
-
/new ccc
|
|
428
|
-
```
|
|
429
|
-
|
|
430
|
-
这种方式适合已经在 ChatCCC 里协作的场景:ChatCCC 负责会话入口和消息通道,`deepccc` 负责本地编程 Agent 能力,包括读取项目提示词、运行命令、编辑文件和输出流式结果。
|
|
431
|
-
|
|
432
|
-
deepccc 内核支持**协作式让位**:任务运行期间用户继续发消息,ChatCCC 会把消息排入注入队列(深度 50),内核在每个模型步骤边界(`prepareStep`)吸收进当前 turn——不打断正在执行的工具步骤、不新开一轮对话,已完成的中间态持久化保留,收到插话后继续调整方向。`/stop` 打断当前 turn,`/cancel` 清空注入队列。该能力通过 `chat()` 的 `drainInput` 回调对外暴露,运行期新消息以 `input_injected` 事件反馈到调用方;仅流式(`streaming: true`)模式生效,non-streaming 下退化为整轮结束后消费。
|
|
433
|
-
|
|
434
|
-
deepccc 的内核主战场在 ChatCCC 仓库的 `deepccc-agent/` 子目录;本仓库(deepccc-agent)是发布镜像,由 ChatCCC 仓库的 `sync-deepccc.mjs` 目录级同步(多的删、少的补、不同的改),之后 `npm run build && npm publish` 发布独立 `deepccc` 包。
|
|
435
|
-
|
|
436
|
-
## 项目提示词自动注入
|
|
437
|
-
|
|
438
|
-
会话启动时,`deepccc` 会从当前工作目录读取这些文件,如果存在就注入为项目级提示词:
|
|
439
|
-
|
|
440
|
-
- `AGENTS.md`
|
|
441
|
-
- `AGENTS.local.md`
|
|
442
|
-
- `CLAUDE.md`
|
|
443
|
-
- `CLAUDE.local.md`
|
|
444
|
-
|
|
445
|
-
这些内容会放在固定系统提示词之后,作为项目指导使用。
|
|
446
|
-
|
|
447
|
-
## Skills 自动加载
|
|
448
|
-
|
|
449
|
-
`deepccc` 会并行扫描本机 **Claude / Codex / Cursor / DeepCCC** 四套生态的目录式 skill(`<name>/SKILL.md`,含 `name` + `description` frontmatter),把索引注入系统提示词;模型在任务匹配时先用 `read_file` 读取 `SKILL.md` 全文再执行。
|
|
450
|
-
|
|
451
|
-
自动加载的目录(按优先级从低到高排列,扫描时后者覆盖前者):
|
|
452
|
-
|
|
453
|
-
| 目录 | 来源 | 级别 |
|
|
454
|
-
| --- | --- | --- |
|
|
455
|
-
| `~/.claude/skills` | claude | 用户级 |
|
|
456
|
-
| `<cwd>/.claude/skills` | claude | 项目级 |
|
|
457
|
-
| `~/.cursor/skills` | cursor | 用户级 |
|
|
458
|
-
| `<cwd>/.cursor/skills` | cursor | 项目级 |
|
|
459
|
-
| `~/.codex/skills` | codex | 用户级 |
|
|
460
|
-
| `~/.agents/skills` | codex | 用户级(标准全局目录) |
|
|
461
|
-
| `<cwd>/.codex/skills` | codex | 项目级 |
|
|
462
|
-
| `~/.deepccc/skills` | deepccc | 用户级 |
|
|
463
|
-
| `<cwd>/.deepccc/skills` | deepccc | 项目级 |
|
|
464
|
-
|
|
465
|
-
**同名去重优先级(高 → 低):`deepccc` > `codex` > `cursor` > `claude`**;同一来源内:**项目级(project)> 用户级(global)**。扫描时低优先级先入索引、高优先级同名覆盖,天然实现优先级。
|
|
466
|
-
|
|
467
|
-
扫描带 mtime 热加载缓存:SKILL.md 内容变化自动重读,新技能目录每次扫描立即被发现——因此"创建技能 → 下一次对话自动生效",无需重启。
|
|
468
|
-
|
|
469
|
-
需要新建技能时,创建为 Codex 结构:`~/.deepccc/skills/<name>/SKILL.md`(默认,全局)或 `<cwd>/.deepccc/skills/<name>/SKILL.md`(`--scope project`,仅当用户明确要求项目级时)。
|
|
470
|
-
|
|
471
|
-
## 内置工具
|
|
472
|
-
|
|
473
|
-
`deepccc` 可以让模型调用这些本地工具:
|
|
474
|
-
|
|
475
|
-
- 按行读取文件
|
|
476
|
-
- 列目录
|
|
477
|
-
- 用 ripgrep 搜索代码
|
|
478
|
-
- 编辑、创建、删除、移动文件
|
|
479
|
-
- 应用 unified diff patch
|
|
480
|
-
- 用 `run_process` 以结构化 argv、`shell:false` 运行单个程序,避免参数被 shell 二次解析
|
|
481
|
-
- 用 `run_script` 通过 stdin 运行多行 Python/Node 代码,避免复杂 `python -c` / `node -e` 引号
|
|
482
|
-
- 仅在需要 `&&`、管道或重定向时用 `run_command` 运行非交互式 shell 命令
|
|
483
|
-
- 联网搜索(`websearch`:DuckDuckGo,免 API key,返回标题 + URL + 摘要)
|
|
484
|
-
- 抓取网页并转纯文本(`webfetch`:仅 http/https,自动去 HTML 标签、控制长度与超时)
|
|
485
|
-
|
|
486
|
-
三个命令工具都支持独立 `cwd`、超时、取消、输出限长和运行中消息让位;返回非零退出码时不会直接被当成工具异常,模型可以读取结构化结果继续判断。Windows 下 `run_command` 会拒绝多行或嵌套同类引号的复杂 Python/Node 内联代码,并提示改用 `run_script`。
|
|
487
|
-
|
|
488
|
-
命令工具及后台命令查询/终止会先检查必需的命名参数。误把参数放进 `raw`、传 JSON 字符串或缺少必需字段时,会在权限处理与进程操作前返回明确的入参错误;有效脚本里的 JSON 内容保持原样,不会被当作参数重新解析。
|
|
489
|
-
|
|
490
|
-
## License
|
|
491
|
-
|
|
492
|
-
Apache-2.0
|
|
493
|
-
### Per-invocation tool allowlist
|
|
494
|
-
|
|
495
|
-
For a bounded task, expose only the builtin tools it needs:
|
|
496
|
-
|
|
497
|
-
```sh
|
|
498
|
-
deepccc-cli --stream-json --allowed-tools read_file,create_file,run_script --prompt "Read the specified files and save the result."
|
|
499
|
-
```
|
|
500
|
-
|
|
501
|
-
The SDK equivalent is `new ChatSession(config, { allowedTools: ["read_file", "run_script"] })`.
|
|
502
|
-
Omitting the option keeps the existing full tool set; the SDK also accepts `[]` for no tools.
|
|
503
|
-
Unknown tool names are rejected before model generation. Automatic workspace navigation is skipped
|
|
504
|
-
when `workspace_map` is outside the allowlist, and child tasks inherit the same tool restriction.
|
|
505
|
-
The option applies to that invocation, so pass it again when resuming. Existing permission checks
|
|
506
|
-
still apply. This limits tool exposure and execution, not filesystem/network access inside an allowed
|
|
507
|
-
script or process tool; it is not a sandbox.
|
|
412
|
+
|
|
413
|
+
```jsonl
|
|
414
|
+
{"type":"start","session_id":"session-...","mode":"new","cwd":"/repo","model":"deepseek-v4-pro"}
|
|
415
|
+
{"type":"status","phase":"compacting"}
|
|
416
|
+
{"type":"compact","compactedMessages":12}
|
|
417
|
+
{"type":"status","phase":"generating"}
|
|
418
|
+
{"type":"text_delta","text":"...","accumulated":"..."}
|
|
419
|
+
{"type":"tool_call","id":"call_...","name":"read_file","input":{"path":"package.json"}}
|
|
420
|
+
{"type":"tool_result","tool_call_id":"call_...","name":"read_file","content":{},"is_error":false}
|
|
421
|
+
{"type":"done","text":"..."}
|
|
422
|
+
```
|
|
423
|
+
|
|
424
|
+
## 在 ChatCCC 中使用
|
|
425
|
+
|
|
426
|
+
**ChatCCC 已内置 deepccc**:ChatCCC 的 "CCC Agent" 工具直接内嵌 deepccc 的代码(仓库内 `deepccc-agent/` 子目录),以 `permissionMode: "bypass"` 全自动运行,无需单独安装或配置本仓库。
|
|
427
|
+
|
|
428
|
+
ChatCCC 是一个把 Claude Code / Codex / Cursor / CCC Agent 聚合到飞书/企微等 IM 消息通道的本地机器人框架,提供会话管理、过程卡片、用量统计与隐私替换等能力。
|
|
429
|
+
|
|
430
|
+
- 公有仓库:https://github.com/wzj998/ChatCCC
|
|
431
|
+
- npm 包:`chatccc`(`npm install -g chatccc`)
|
|
432
|
+
|
|
433
|
+
在 ChatCCC 会话里可以使用隐藏指令创建 `deepccc` Agent 会话:
|
|
434
|
+
|
|
435
|
+
```text
|
|
436
|
+
/new ccc
|
|
437
|
+
```
|
|
438
|
+
|
|
439
|
+
这种方式适合已经在 ChatCCC 里协作的场景:ChatCCC 负责会话入口和消息通道,`deepccc` 负责本地编程 Agent 能力,包括读取项目提示词、运行命令、编辑文件和输出流式结果。
|
|
440
|
+
|
|
441
|
+
deepccc 内核支持**协作式让位**:任务运行期间用户继续发消息,ChatCCC 会把消息排入注入队列(深度 50),内核在每个模型步骤边界(`prepareStep`)吸收进当前 turn——不打断正在执行的工具步骤、不新开一轮对话,已完成的中间态持久化保留,收到插话后继续调整方向。`/stop` 打断当前 turn,`/cancel` 清空注入队列。该能力通过 `chat()` 的 `drainInput` 回调对外暴露,运行期新消息以 `input_injected` 事件反馈到调用方;仅流式(`streaming: true`)模式生效,non-streaming 下退化为整轮结束后消费。
|
|
442
|
+
|
|
443
|
+
deepccc 的内核主战场在 ChatCCC 仓库的 `deepccc-agent/` 子目录;本仓库(deepccc-agent)是发布镜像,由 ChatCCC 仓库的 `sync-deepccc.mjs` 目录级同步(多的删、少的补、不同的改),之后 `npm run build && npm publish` 发布独立 `deepccc` 包。
|
|
444
|
+
|
|
445
|
+
## 项目提示词自动注入
|
|
446
|
+
|
|
447
|
+
会话启动时,`deepccc` 会从当前工作目录读取这些文件,如果存在就注入为项目级提示词:
|
|
448
|
+
|
|
449
|
+
- `AGENTS.md`
|
|
450
|
+
- `AGENTS.local.md`
|
|
451
|
+
- `CLAUDE.md`
|
|
452
|
+
- `CLAUDE.local.md`
|
|
453
|
+
|
|
454
|
+
这些内容会放在固定系统提示词之后,作为项目指导使用。
|
|
455
|
+
|
|
456
|
+
## Skills 自动加载
|
|
457
|
+
|
|
458
|
+
`deepccc` 会并行扫描本机 **Claude / Codex / Cursor / DeepCCC** 四套生态的目录式 skill(`<name>/SKILL.md`,含 `name` + `description` frontmatter),把索引注入系统提示词;模型在任务匹配时先用 `read_file` 读取 `SKILL.md` 全文再执行。
|
|
459
|
+
|
|
460
|
+
自动加载的目录(按优先级从低到高排列,扫描时后者覆盖前者):
|
|
461
|
+
|
|
462
|
+
| 目录 | 来源 | 级别 |
|
|
463
|
+
| --- | --- | --- |
|
|
464
|
+
| `~/.claude/skills` | claude | 用户级 |
|
|
465
|
+
| `<cwd>/.claude/skills` | claude | 项目级 |
|
|
466
|
+
| `~/.cursor/skills` | cursor | 用户级 |
|
|
467
|
+
| `<cwd>/.cursor/skills` | cursor | 项目级 |
|
|
468
|
+
| `~/.codex/skills` | codex | 用户级 |
|
|
469
|
+
| `~/.agents/skills` | codex | 用户级(标准全局目录) |
|
|
470
|
+
| `<cwd>/.codex/skills` | codex | 项目级 |
|
|
471
|
+
| `~/.deepccc/skills` | deepccc | 用户级 |
|
|
472
|
+
| `<cwd>/.deepccc/skills` | deepccc | 项目级 |
|
|
473
|
+
|
|
474
|
+
**同名去重优先级(高 → 低):`deepccc` > `codex` > `cursor` > `claude`**;同一来源内:**项目级(project)> 用户级(global)**。扫描时低优先级先入索引、高优先级同名覆盖,天然实现优先级。
|
|
475
|
+
|
|
476
|
+
扫描带 mtime 热加载缓存:SKILL.md 内容变化自动重读,新技能目录每次扫描立即被发现——因此"创建技能 → 下一次对话自动生效",无需重启。
|
|
477
|
+
|
|
478
|
+
需要新建技能时,创建为 Codex 结构:`~/.deepccc/skills/<name>/SKILL.md`(默认,全局)或 `<cwd>/.deepccc/skills/<name>/SKILL.md`(`--scope project`,仅当用户明确要求项目级时)。
|
|
479
|
+
|
|
480
|
+
## 内置工具
|
|
481
|
+
|
|
482
|
+
`deepccc` 可以让模型调用这些本地工具:
|
|
483
|
+
|
|
484
|
+
- 按行读取文件
|
|
485
|
+
- 列目录
|
|
486
|
+
- 用 ripgrep 搜索代码
|
|
487
|
+
- 编辑、创建、删除、移动文件
|
|
488
|
+
- 应用 unified diff patch
|
|
489
|
+
- 用 `run_process` 以结构化 argv、`shell:false` 运行单个程序,避免参数被 shell 二次解析
|
|
490
|
+
- 用 `run_script` 通过 stdin 运行多行 Python/Node 代码,避免复杂 `python -c` / `node -e` 引号
|
|
491
|
+
- 仅在需要 `&&`、管道或重定向时用 `run_command` 运行非交互式 shell 命令
|
|
492
|
+
- 联网搜索(`websearch`:DuckDuckGo,免 API key,返回标题 + URL + 摘要)
|
|
493
|
+
- 抓取网页并转纯文本(`webfetch`:仅 http/https,自动去 HTML 标签、控制长度与超时)
|
|
494
|
+
|
|
495
|
+
三个命令工具都支持独立 `cwd`、超时、取消、输出限长和运行中消息让位;返回非零退出码时不会直接被当成工具异常,模型可以读取结构化结果继续判断。Windows 下 `run_command` 会拒绝多行或嵌套同类引号的复杂 Python/Node 内联代码,并提示改用 `run_script`。
|
|
496
|
+
|
|
497
|
+
命令工具及后台命令查询/终止会先检查必需的命名参数。误把参数放进 `raw`、传 JSON 字符串或缺少必需字段时,会在权限处理与进程操作前返回明确的入参错误;有效脚本里的 JSON 内容保持原样,不会被当作参数重新解析。
|
|
498
|
+
|
|
499
|
+
## License
|
|
500
|
+
|
|
501
|
+
Apache-2.0
|
|
502
|
+
### Per-invocation tool allowlist
|
|
503
|
+
|
|
504
|
+
For a bounded task, expose only the builtin tools it needs:
|
|
505
|
+
|
|
506
|
+
```sh
|
|
507
|
+
deepccc-cli --stream-json --allowed-tools read_file,create_file,run_script --prompt "Read the specified files and save the result."
|
|
508
|
+
```
|
|
509
|
+
|
|
510
|
+
The SDK equivalent is `new ChatSession(config, { allowedTools: ["read_file", "run_script"] })`.
|
|
511
|
+
Omitting the option keeps the existing full tool set; the SDK also accepts `[]` for no tools.
|
|
512
|
+
Unknown tool names are rejected before model generation. Automatic workspace navigation is skipped
|
|
513
|
+
when `workspace_map` is outside the allowlist, and child tasks inherit the same tool restriction.
|
|
514
|
+
The option applies to that invocation, so pass it again when resuming. Existing permission checks
|
|
515
|
+
still apply. This limits tool exposure and execution, not filesystem/network access inside an allowed
|
|
516
|
+
script or process tool; it is not a sandbox.
|