deepccc 0.2.15 → 0.2.16

package/README.md

@@ -1,75 +1,75 @@
-# DeepCCC
-
-DeepCCC 是一个本地优先的开源 Coding Agent，同时提供浏览器多会话界面、终端 CLI 和适合自动化集成的 JSONL 流。它针对 DeepSeek 做了缓存和上下文优化，也支持任意 OpenAI-compatible 服务以及 Anthropic Messages 协议。
-
-- 项目主页：https://github.com/wzj998/deepccc-agent
-- npm 包：https://www.npmjs.com/package/deepccc
-- 运行要求：Node.js >= 20，以及一个兼容模型服务的 API Key
-
-## 安装与快速开始
-
-模型原生流未收到完成事件、返回错误结束原因或达到输出长度限制时，会报告异常并保留已经输出的内容，不将不完整回复判为成功。没有回复且没有工具执行的空结果也会明确报错。用户主动取消仍按中断处理。
-
-全局安装：
+# DeepCCC
+
+DeepCCC 是一个本地优先的开源 Coding Agent，同时提供浏览器多会话界面、终端 CLI 和适合自动化集成的 JSONL 流。它针对 DeepSeek 做了缓存和上下文优化，也支持任意 OpenAI-compatible 服务以及 Anthropic Messages 协议。
+
+- 项目主页：https://github.com/wzj998/deepccc-agent
+- npm 包：https://www.npmjs.com/package/deepccc
+- 运行要求：Node.js >= 20，以及一个兼容模型服务的 API Key
+
+## 安装与快速开始
+
+模型原生流未收到完成事件、返回错误结束原因或达到输出长度限制时，会报告异常并保留已经输出的内容，不将不完整回复判为成功。没有回复且没有工具执行的空结果也会明确报错。用户主动取消仍按中断处理。
+
+全局安装：
+
+```bash
+npm install -g deepccc
+```
+
+配置 `~/.deepccc/config.json` 或 `DEEPCCC_*` 环境变量后，运行：
 
 ```bash
-npm install -g deepccc
-```
-
-配置 `~/.deepccc/config.json` 或 `DEEPCCC_*` 环境变量后，运行：
-
-```bash
-deepccc
-```
-
-浏览器会自动打开 `http://127.0.0.1:28080/`。终端模式使用：
-
-```bash
-deepccc-cli
-```
-
-从源码运行：
+deepccc
+```
+
+浏览器会自动打开 `http://127.0.0.1:28080/`。终端模式使用：
+
+```bash
+deepccc-cli
+```
+
+从源码运行：
 
 ```bash
 git clone https://github.com/wzj998/deepccc-agent.git
 cd deepccc-agent
-npm install
-npm run build
-npm run dev
-```
-
-## Web UI 预览
-
-以下画面来自 DeepCCC 对本项目真实开发需求的 Agent 调用。截图仅将用户名、组织名、
-内部域名和绝对路径替换为公开示例，任务内容、模型配置、Agent 回复和审批流程均来自
-实际运行结果。
-
-多会话可以并行处理不同任务，每个会话分别选择 model、subModel 和 effort。下图来自
-`deepccc-agent/` 工作目录中的真实提问“这个项目妙在哪？”：
-
-![DeepCCC Web UI 图片附件与真实 Agent 回复](docs/deepccc-web-ui.png)
-
-命中需要确认的命令时，审批卡会直接出现在当前会话时间线中，不打断到弹窗：
-
-![DeepCCC 会话内操作审批](docs/deepccc-inline-approval.png)
-
-单一 API 配置作为新会话默认值，模型与 effort 仍可在每个会话中单独覆盖：
-
-![DeepCCC API 与 Web 设置](docs/deepccc-api-settings.png)
-
-## 核心能力
-
-- Web-first：多会话、持久化历史、实时流式过程、停止和恢复
-- 工具时间线：ChatCCC 风格 emoji 摘要、参数/结果折叠、省略行展开和状态记忆
-- 会话配置：每个会话独立选择 model、subModel 和 effort
-- 图片附件：Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP；Agent 可用 `present_file` 回传图片
-- 本地工具：代码搜索、文件读写、补丁、命令执行、Git、网页搜索和抓取
-- 权限审批：危险命令在会话时间线中暂停，支持拒绝、允许一次、会话允许和永久允许
-- 上下文管理：自动压缩、原始流日志和跨会话历史检索
-- 长会话校准：当前状态覆盖旧建议，摘要区分历史/事实/推断/局限；轮内工具结果有独立预算，避免多步调查持续膨胀
-- 项目约定：自动加载 AGENTS.md、CLAUDE.md、系统提示和目录式 Skills
-- 项目理解：可控搜索范围、按需本地项目地图、源文件变化即失效的证据笔记；不针对特定业务仓库，详见 [项目理解与搜索](docs/workspace-understanding.md)
-- 自动化：`deepccc-cli --stream-json` 提供稳定 JSONL 事件接口
+npm install
+npm run build
+npm run dev
+```
+
+## Web UI 预览
+
+以下画面来自 DeepCCC 对本项目真实开发需求的 Agent 调用。截图仅将用户名、组织名、
+内部域名和绝对路径替换为公开示例，任务内容、模型配置、Agent 回复和审批流程均来自
+实际运行结果。
+
+多会话可以并行处理不同任务，每个会话分别选择 model、subModel 和 effort。下图来自
+`deepccc-agent/` 工作目录中的真实提问“这个项目妙在哪？”：
+
+![DeepCCC Web UI 图片附件与真实 Agent 回复](docs/deepccc-web-ui.png)
+
+命中需要确认的命令时，审批卡会直接出现在当前会话时间线中，不打断到弹窗：
+
+![DeepCCC 会话内操作审批](docs/deepccc-inline-approval.png)
+
+单一 API 配置作为新会话默认值，模型与 effort 仍可在每个会话中单独覆盖：
+
+![DeepCCC API 与 Web 设置](docs/deepccc-api-settings.png)
+
+## 核心能力
+
+- Web-first：多会话、持久化历史、实时流式过程、停止和恢复
+- 工具时间线：ChatCCC 风格 emoji 摘要、参数/结果折叠、省略行展开和状态记忆
+- 会话配置：每个会话独立选择 model、subModel 和 effort
+- 图片附件：Web 支持选择、粘贴和拖拽 PNG/JPEG/WebP；Agent 可用 `present_file` 回传图片
+- 本地工具：代码搜索、文件读写、补丁、命令执行、Git、网页搜索和抓取
+- 权限审批：危险命令在会话时间线中暂停，支持拒绝、允许一次、会话允许和永久允许
+- 上下文管理：自动压缩、原始流日志和跨会话历史检索
+- 长会话校准：当前状态覆盖旧建议，摘要区分历史/事实/推断/局限；轮内工具结果有独立预算，避免多步调查持续膨胀
+- 项目约定：自动加载 AGENTS.md、CLAUDE.md、系统提示和目录式 Skills
+- 项目理解：可控搜索范围、按需本地项目地图、源文件变化即失效的证据笔记；不针对特定业务仓库，详见 [项目理解与搜索](docs/workspace-understanding.md)
+- 自动化：`deepccc-cli --stream-json` 提供稳定 JSONL 事件接口
 
 ## 缓存命中率
 
@@ -86,10 +86,10 @@ deepccc 的本地缓存优化实测命中率 **96.7%**，有效降低重复请
 ```bash
 export DEEPCCC_API_KEY="sk-..."
 export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-export DEEPCCC_MODEL="deepseek-v4-pro"
-export DEEPCCC_EFFORT="high"
-export DEEPCCC_MAX_OUTPUT_TOKENS="32768"
-export DEEPCCC_STREAMING="true"
+export DEEPCCC_MODEL="deepseek-v4-pro"
+export DEEPCCC_EFFORT="high"
+export DEEPCCC_MAX_OUTPUT_TOKENS="32768"
+export DEEPCCC_STREAMING="true"
 ```
 
 Windows PowerShell：
@@ -98,10 +98,10 @@ Windows PowerShell：
 $env:DEEPCCC_API_KEY="sk-..."
 $env:DEEPCCC_PROVIDER="openai"
 $env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-$env:DEEPCCC_MODEL="deepseek-v4-pro"
-$env:DEEPCCC_EFFORT="high"
-$env:DEEPCCC_MAX_OUTPUT_TOKENS="32768"
-$env:DEEPCCC_STREAMING="true"
+$env:DEEPCCC_MODEL="deepseek-v4-pro"
+$env:DEEPCCC_EFFORT="high"
+$env:DEEPCCC_MAX_OUTPUT_TOKENS="32768"
+$env:DEEPCCC_STREAMING="true"
 ```
 
 也兼容这些 DeepSeek 别名：
@@ -119,10 +119,10 @@ $env:DEEPCCC_STREAMING="true"
   "apiKey": "sk-...",
   "baseURL": "https://api.deepseek.com/v1",
   "model": "deepseek-v4-pro",
-  "subModel": "",
-  "effort": "",
-  "maxOutputTokens": null,
-  "streaming": true,
+  "subModel": "",
+  "effort": "",
+  "maxOutputTokens": null,
+  "streaming": true,
   "contextWindow": 1048576,
   "git": {
     "coAuthor": {
@@ -131,39 +131,39 @@ $env:DEEPCCC_STREAMING="true"
       "email": "20184052+wzj998@users.noreply.github.com"
     }
   },
-  "rawStreamLogs": {
+  "rawStreamLogs": {
     "enabled": true,
     "maxBytesPerTurn": 1048576,
     "retentionDays": 7,
-    "keepCompleted": false
-  },
-  "web": {
-    "port": 28080,
-    "openOnStart": true
-  }
-}
-```
-
-## Web UI
-
-全局安装后可以直接启动本地网页版：
-
-```bash
-deepccc
-```
-
-默认只监听 `http://127.0.0.1:28080/`，不会暴露到局域网。可在
-`~/.deepccc/config.json` 的 `web.port` 修改端口，`web.openOnStart` 控制启动时是否自动打开浏览器；也可以临时使用 `deepccc --port 28081 --no-open`。默认启动会安全替换经过实例身份验证的旧 DeepCCC Web；传入 `--reuse-existing` 时复用已有实例。`deepccc web` 保留为兼容别名。
-
-从源码开发时，`npm run dev` 启动 Web Server 并打开页面（不启用 watch）；`npm run dev:cli` 启动终端模式。
-
-Web UI 支持新建、恢复、重命名和删除多会话，多个会话可以同时运行，即使它们指向同一个工作目录。每个会话可独立选择 model、subModel 和 effort，并持续复用 CLI 已保存的历史。注意：当前版本不自动创建 Git worktree；同目录的多个运行中 Agent 直接修改同一组文件，页面会提示覆盖与冲突风险。
-
-模型文本、reasoning 心跳和工具事件通过 SSE 实时更新。每轮消息按真实发生顺序持久化和回放，因此刷新后仍会保持“阶段说明 → 工具调用 → 后续结论”的交错时间线；旧版会话没有顺序数据时，会兼容显示为“工具调用 → 最终回答”。每次工具调用与对应结果合并成一张卡片，折叠态显示 emoji、工具名、状态和关键参数；展开后调用参数默认保留前 8/后 4 行，工具结果保留前 12/后 6 行，省略内容可继续展开。工具卡及省略行的展开状态保存在当前浏览器标签页的 `sessionStorage`，持续生成、切换会话和刷新页面均不会自动收起。消息正文支持标题、表格、列表、引用、链接和代码块等常用 Markdown。
-
-图片始终按本地附件处理，不转换为 Provider 原生多模态消息。Web 支持文件选择、剪贴板粘贴和拖拽，每条消息最多 10 张 PNG/JPEG/WebP、单张最大 20 MB；附件复制到 `~/.deepccc/attachments/<session-id>/`，Agent 收到本地绝对路径后使用可用工具自行处理。Agent 可调用 `present_file` 把当前工作目录或会话附件目录中的图片直接展示在会话中；删除会话时对应附件一并清理。
-
-API 设置采用单一 Provider 配置，支持 OpenAI-compatible 与 Anthropic Messages。完整 API Key 只保存在本机 `~/.deepccc/config.json`，浏览器读取设置时仅返回掩码。危险命令会在会话中暂停并请求“拒绝、允许一次、本会话允许、永久允许”，浏览器断开或审批超时默认拒绝。
+    "keepCompleted": false
+  },
+  "web": {
+    "port": 28080,
+    "openOnStart": true
+  }
+}
+```
+
+## Web UI
+
+全局安装后可以直接启动本地网页版：
+
+```bash
+deepccc
+```
+
+默认只监听 `http://127.0.0.1:28080/`，不会暴露到局域网。可在
+`~/.deepccc/config.json` 的 `web.port` 修改端口，`web.openOnStart` 控制启动时是否自动打开浏览器；也可以临时使用 `deepccc --port 28081 --no-open`。默认启动会安全替换经过实例身份验证的旧 DeepCCC Web；传入 `--reuse-existing` 时复用已有实例。`deepccc web` 保留为兼容别名。
+
+从源码开发时，`npm run dev` 启动 Web Server 并打开页面（不启用 watch）；`npm run dev:cli` 启动终端模式。
+
+Web UI 支持新建、恢复、重命名和删除多会话，多个会话可以同时运行，即使它们指向同一个工作目录。每个会话可独立选择 model、subModel 和 effort，并持续复用 CLI 已保存的历史。注意：当前版本不自动创建 Git worktree；同目录的多个运行中 Agent 直接修改同一组文件，页面会提示覆盖与冲突风险。
+
+模型文本、reasoning 心跳和工具事件通过 SSE 实时更新。每轮消息按真实发生顺序持久化和回放，因此刷新后仍会保持“阶段说明 → 工具调用 → 后续结论”的交错时间线；旧版会话没有顺序数据时，会兼容显示为“工具调用 → 最终回答”。每次工具调用与对应结果合并成一张卡片，折叠态显示 emoji、工具名、状态和关键参数；展开后调用参数默认保留前 8/后 4 行，工具结果保留前 12/后 6 行，省略内容可继续展开。工具卡及省略行的展开状态保存在当前浏览器标签页的 `sessionStorage`，持续生成、切换会话和刷新页面均不会自动收起。消息正文支持标题、表格、列表、引用、链接和代码块等常用 Markdown。
+
+图片始终按本地附件处理，不转换为 Provider 原生多模态消息。Web 支持文件选择、剪贴板粘贴和拖拽，每条消息最多 10 张 PNG/JPEG/WebP、单张最大 20 MB；附件复制到 `~/.deepccc/attachments/<session-id>/`，Agent 收到本地绝对路径后使用可用工具自行处理。Agent 可调用 `present_file` 把当前工作目录或会话附件目录中的图片直接展示在会话中；删除会话时对应附件一并清理。
+
+API 设置采用单一 Provider 配置，支持 OpenAI-compatible 与 Anthropic Messages。完整 API Key 只保存在本机 `~/.deepccc/config.json`，浏览器读取设置时仅返回掩码。危险命令会在会话中暂停并请求“拒绝、允许一次、本会话允许、永久允许”，浏览器断开或审批超时默认拒绝。
 
 `git.coAuthor.enabled` 默认开启。DeepCCC 通过 `run_command` 创建 Git 提交时会保留用户为
 主 Author，并追加 `Co-authored-by: DeepCCC <20184052+wzj998@users.noreply.github.com>`。
@@ -174,19 +174,19 @@ API 设置采用单一 Provider 配置，支持 OpenAI-compatible 与 Anthropic
 `DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖：
 
 - `openai` 使用 OpenAI-compatible Chat Completions 协议，兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
-- `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`；目标服务不支持时应留空。
-
-`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
-`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
-
-`maxOutputTokens` 限制主对话单次最大输出 token，默认不配置（`null`/缺失），此时不向
-Provider 发送 `max_tokens`，使用模型服务端默认值。可通过 `DEEPCCC_MAX_OUTPUT_TOKENS`
-或命令行 `--max-output-tokens` 覆盖；只接受正整数。该限制会同时覆盖模型思考内容、
-工具参数和最终回答，设置过小可能导致工具调用或长回复被截断。
-
-`contextWindow` 是模型上下文窗口（token），默认 `1048576`（1M，DeepSeek V4 Pro/Flash
-原生规格）；常规上下文压缩阈值自动 = `contextWindow × 0.8`。工具输入与结果另有独立预算：
-默认取 `min(64000, 常规压缩阈值 × 25%)`，超过后会提前压缩，避免长会话积累大量低信号工具输出。
+- `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`；目标服务不支持时应留空。
+
+`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
+`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+
+`maxOutputTokens` 限制主对话单次最大输出 token，默认不配置（`null`/缺失），此时不向
+Provider 发送 `max_tokens`，使用模型服务端默认值。可通过 `DEEPCCC_MAX_OUTPUT_TOKENS`
+或命令行 `--max-output-tokens` 覆盖；只接受正整数。该限制会同时覆盖模型思考内容、
+工具参数和最终回答，设置过小可能导致工具调用或长回复被截断。
+
+`contextWindow` 是模型上下文窗口（token），默认 `1048576`（1M，DeepSeek V4 Pro/Flash
+原生规格）；常规上下文压缩阈值自动 = `contextWindow × 0.8`。工具输入与结果另有独立预算：
+默认取 `min(64000, 常规压缩阈值 × 25%)`，超过后会提前压缩，避免长会话积累大量低信号工具输出。
 可通过 `DEEPCCC_CONTEXT_WINDOW` 环境变量覆盖。⚠️ 超过模型/服务端实际上限时请求会被
 API 拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 的
 `max_input_tokens`）。
@@ -213,62 +213,62 @@ API 拒绝（context length exceeded），实际窗口以模型与所用服务
 在当前目录启动一个交互式 Agent：
 
 ```bash
-deepccc-cli
+deepccc-cli
 ```
 
 指定其他模型或 OpenAI-compatible 接口：
 
 ```bash
-deepccc-cli --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
+deepccc-cli --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
 ```
 
 使用 Anthropic Messages 协议（同样支持流式输出）：
 
 ```bash
-deepccc-cli --provider anthropic --base-url https://api.example.com --api-key "$API_KEY" --model claude-sonnet-4-6
+deepccc-cli --provider anthropic --base-url https://api.example.com --api-key "$API_KEY" --model claude-sonnet-4-6
 ```
 
-指定工作目录：
+指定工作目录：
 
 ```bash
-deepccc-cli --cwd /path/to/project
-```
-
-附加一张或多张本地图片（可重复传入 `--image`，仍采用本地附件路径，不发送原生多模态内容）：
-
-```bash
-deepccc-cli --image ./error.png --image ./expected.webp
-```
+deepccc-cli --cwd /path/to/project
+```
+
+附加一张或多张本地图片（可重复传入 `--image`，仍采用本地附件路径，不发送原生多模态内容）：
+
+```bash
+deepccc-cli --image ./error.png --image ./expected.webp
+```
 
 恢复当前工作目录最近一次会话：
 
 ```bash
-deepccc-cli --resume
+deepccc-cli --resume
 ```
 
 设置工具调用步数上限：
 
 ```bash
-deepccc-cli --max-steps 20
+deepccc-cli --max-steps 20
 ```
 
-默认情况下，`deepccc-cli` 不设置固定步数上限，会让模型自然完成工具循环。
+默认情况下，`deepccc-cli` 不设置固定步数上限，会让模型自然完成工具循环。
 
 设置推理强度（reasoning effort）：
 
 ```bash
-deepccc-cli --effort high
+deepccc-cli --effort high
 ```
 
-可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
-
-限制主对话最大输出 token：
-
-```bash
-deepccc-cli --max-output-tokens 8192
-```
-
-不设置时使用 Provider 默认值。
+可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
+
+限制主对话最大输出 token：
+
+```bash
+deepccc-cli --max-output-tokens 8192
+```
+
+不设置时使用 Provider 默认值。
 
 ## 权限机制
 
@@ -320,7 +320,7 @@ deepccc-cli --max-output-tokens 8192
 `--stream-json` 或程序化调用（无终端可交互）时，高危命令**安全默认拒绝**。需要全自动场景可显式传入：
 
 ```bash
-deepccc-cli --dangerously-bypass-permissions
+deepccc-cli --dangerously-bypass-permissions
 ```
 
 该参数与 `ChatSession` 的 `permissionMode: "bypass"` 等价，也是 chatccc 集成 deepccc 时使用的模式（对齐 chatccc 调用 Claude Code / Codex 的 bypass 方式）。
@@ -329,12 +329,12 @@ deepccc-cli --dangerously-bypass-permissions
 
 交互模式下，每轮回复渲染为固定"过程区块"：状态行（压缩上下文中/生成回复中/完成/已停止/异常结束）+ 折叠工具行 + 原地更新正文，不滚屏刷 JSON。活动状态有心跳点号动画；完成/停止/异常后区块定型留在屏幕上。
 
-持久化上下文达到常规 token 阈值或独立工具预算时，deepccc 会先按预算保留最近消息，再压缩较早内容；工具历史使用标准结构化 tool-call/tool-result 消息重放，不会把内部 `[工具记录]` 文本重复送回模型。若模型仍输出伪工具记录，系统会丢弃并重试一次；重复失败时安全终止，避免把未执行命令当成真实结果。超长历史消息、工具记录和压缩输入会被限长，一次压缩最多等待 5 分钟。
+持久化上下文达到常规 token 阈值或独立工具预算时，deepccc 会先按预算保留最近消息，再压缩较早内容；工具历史使用标准结构化 tool-call/tool-result 消息重放，不会把内部 `[工具记录]` 文本重复送回模型。若模型仍输出伪工具记录，系统会丢弃并重试一次；重复失败时安全终止，避免把未执行命令当成真实结果。超长历史消息、工具记录和压缩输入会被限长，一次压缩最多等待 5 分钟。
 
 如果终端渲染出现异常，可以强制回退为纯文本流式输出：
 
 ```bash
-deepccc-cli --plain
+deepccc-cli --plain
 ```
 
 ## JSONL 流式输出
@@ -342,13 +342,13 @@ deepccc-cli --plain
 JSONL 模式适合脚本、服务端集成或其他上层系统调用：
 
 ```bash
-deepccc-cli --stream-json --prompt "检查这个仓库并总结测试命令"
+deepccc-cli --stream-json --prompt "检查这个仓库并总结测试命令"
 ```
 
 也可以从 stdin 传入提示词：
 
 ```bash
-echo "运行测试并解释失败原因" | deepccc-cli --stream-json
+echo "运行测试并解释失败原因" | deepccc-cli --stream-json
 ```
 
 输出是逐行 JSON：
@@ -381,6 +381,8 @@ ChatCCC 是一个把 Claude Code / Codex / Cursor / CCC Agent 聚合到飞书/
 
 这种方式适合已经在 ChatCCC 里协作的场景：ChatCCC 负责会话入口和消息通道，`deepccc` 负责本地编程 Agent 能力，包括读取项目提示词、运行命令、编辑文件和输出流式结果。
 
+deepccc 内核支持**协作式让位**：任务运行期间用户继续发消息，ChatCCC 会把消息排入注入队列（深度 50），内核在每个模型步骤边界（`prepareStep`）吸收进当前 turn——不打断正在执行的工具步骤、不新开一轮对话，已完成的中间态持久化保留，收到插话后继续调整方向。`/stop` 打断当前 turn，`/cancel` 清空注入队列。该能力通过 `chat()` 的 `drainInput` 回调对外暴露，运行期新消息以 `input_injected` 事件反馈到调用方；仅流式（`streaming: true`）模式生效，non-streaming 下退化为整轮结束后消费。
+
 deepccc 的内核主战场在 ChatCCC 仓库的 `deepccc-agent/` 子目录；本仓库（deepccc-agent）是发布镜像，由 ChatCCC 仓库的 `sync-deepccc.mjs` 目录级同步（多的删、少的补、不同的改），之后 `npm run build && npm publish` 发布独立 `deepccc` 包。
 
 ## 项目提示词自动注入

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "A lightweight coding agent with OpenAI-compatible and Anthropic Messages API support.",
   "license": "Apache-2.0",
   "keywords": [