chatccc 0.2.252 → 0.2.254

package/README.md

@@ -153,6 +153,14 @@ chatccc
 
 每次直接运行 `chatccc` 时，无论是否已经完成配置，ChatCCC 默认都会用系统默认浏览器打开本地 Web UI（默认 `http://localhost:18080/`，修改 `config.port` 后跟随实际端口）。可在首次配置向导或管理页的 **Web UI** 设置中关闭；关闭后从下一次直接启动起生效。由 `/restart`、`/update` 或 Web UI 发起的内部重启始终不会重复打开浏览器。Linux 服务器没有 `DISPLAY`/`WAYLAND_DISPLAY` 时会跳过打开，并在终端输出 SSH 隧道访问提示。主页顶部的 **Agent Team** 入口会跳转到独立的 `/agent-team` 页面。
 
+#### 本地任务看板（Agent Team）
+
+Agent Team 提供本地任务看板和项目主 Agent 入口，但暂不根据任务自动分配 Agent。每个规范化后的本机目录对应一个独立项目和看板，固定包含“头脑风暴、Todo、Doing、Done、搁置”五列，支持新增、编辑、拖动排序和删除任务。页面会自动保存，不需要手动提交。当前按路径识别项目，不检查 Git 仓库或 worktree 关系，任意子目录都可以作为独立项目。
+
+打开项目后可以选择 CCC、Claude、Cursor 或 Codex 作为主 Agent。首次设置会创建固定命名为 `主Agent-<目录短名>` 的飞书群和空 Agent Session；后续切换 Agent 或重新关联目录会复用原群，运行中的主 Agent 不允许切换。建群成员取自机器人最近一次收到的飞书私聊；如果尚无私聊记录，网页会提示先给机器人发送任意私聊消息并自动检测。项目群名不会随第一句话或 `/newh` 改变。
+
+看板数据默认保存在 `~/.chatccc/agent-team/`，其中 `workspaces.json` 保存最近工作目录索引，`boards/` 保存按稳定 ID 分隔的看板 JSON，`main-agent-bindings/` 单独保存本机飞书群与 Session 绑定。目录移动或重命名后，可从最近目录列表重新关联。数据访问通过仓储接口隔离，后续接入飞书多维表格时可增加双向同步适配器，无需把本机群聊和 Session 状态混入任务同步模型。选择目录、创建群聊和启动 Agent 等操作都由本机 Node 后端执行；当前实现不依赖 Electron。
+
 #### 从源码运行
 
 ```bash
@@ -364,6 +372,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
 | `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 的 API Key 和服务地址；**不限于 DeepSeek**——可填任意 OpenAI 兼容端点（OpenAI、Kimi、通义、智谱、Ollama 本地等） |
 | `ccc.model` | CCC Agent 默认模型 |
+| `ccc.compactionTimeoutMs` | CCC Agent 上下文压缩单轮超时（毫秒），默认 300000（5 分钟）；压缩超时会让整轮对话失败，建议保持默认或调大 |
 
 > **权限控制**：普通消息以 `bypassPermissions` 模式运行，跳过 Agent 操作确认。使用 `/plan` 或 `/ask` 前缀时，ChatCCC 自动切换为只读模式：Claude SDK 仅放行 Read + stop-stuck-loop 网络请求，Codex 使用 `--sandbox read-only`，Cursor 使用 `--mode plan/ask`。请只在可信环境中使用。
 
@@ -414,4 +423,4 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 ## 技术栈
 
-TypeScript / Node.js >= 20 / tsx / AI SDK / Anthropic Claude Agent SDK（按需下载，仅启用 Claude Code 时安装）/ Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink
+TypeScript（发布前编译为 JavaScript，tsx 仅用于开发）/ Node.js >= 20 / AI SDK / Anthropic Claude Agent SDK（按需下载，仅启用 Claude Code 时安装）/ Cursor Agent CLI / Codex CLI / 飞书 WebSocket API / CardKit / 微信 iLink

package/bin/cccagent.mjs

@@ -1,14 +1,23 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 
 const require = createRequire(import.meta.url);
 const pkgRoot = dirname(require.resolve("../package.json"));
-const cliTs = join(pkgRoot, "deepccc-agent", "src", "cli.ts");
-const tsxCli = require.resolve("tsx/cli");
+const compiledEntry = join(pkgRoot, "dist", "deepccc-agent", "src", "cli.js");
+let args;
+if (existsSync(compiledEntry)) {
+  args = [compiledEntry, ...process.argv.slice(2)];
+} else {
+  // Development checkout fallback. Published packages always contain dist/.
+  const cliTs = join(pkgRoot, "deepccc-agent", "src", "cli.ts");
+  const tsxCli = require.resolve("tsx/cli");
+  args = [tsxCli, cliTs, ...process.argv.slice(2)];
+}
 
-const result = spawnSync(process.execPath, [tsxCli, cliTs, ...process.argv.slice(2)], {
+const result = spawnSync(process.execPath, args, {
   stdio: "inherit",
   cwd: process.cwd(),
   env: process.env,

package/bin/chatccc.mjs

@@ -1,15 +1,24 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 
 const require = createRequire(import.meta.url);
 // 相对 bin/chatccc.mjs 解析 package.json，包根目录不依赖 cwd，也不会多退一级到 node_modules
 const pkgRoot = dirname(require.resolve("../package.json"));
-const indexTs = join(pkgRoot, "src", "index.ts");
-const tsxCli = require.resolve("tsx/cli");
-
-const result = spawnSync(process.execPath, [tsxCli, indexTs, ...process.argv.slice(2)], {
+const compiledEntry = join(pkgRoot, "dist", "src", "index.js");
+let args;
+if (existsSync(compiledEntry)) {
+  args = [compiledEntry, ...process.argv.slice(2)];
+} else {
+  // Development checkout fallback. Published packages always contain dist/.
+  const indexTs = join(pkgRoot, "src", "index.ts");
+  const tsxCli = require.resolve("tsx/cli");
+  args = [tsxCli, indexTs, ...process.argv.slice(2)];
+}
+
+const result = spawnSync(process.execPath, args, {
   stdio: "inherit",
   cwd: process.cwd(),
   env: process.env,
@@ -21,4 +30,4 @@ if (code !== 0) {
   console.error("chatccc 子进程已结束，服务没有在后台运行。");
 }
 
-process.exit(code);
+process.exit(code);

package/config.sample.json

@@ -52,7 +52,8 @@
     "model": "deepseek-v4-pro",
     "alternativeModel": "",
     "effort": "",
-    "provider": ""
+    "provider": "",
+    "compactionTimeoutMs": 300000
   },
   "claude": {
     "enabled": false,

package/deepccc-agent/README.md

@@ -45,19 +45,19 @@ 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_STREAMING="true"
+export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
+export DEEPCCC_MODEL="deepseek-v4-pro"
+export DEEPCCC_STREAMING="true"
 ```
 
 Windows PowerShell：
 
 ```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_STREAMING="true"
+$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_STREAMING="true"
 ```
 
 也兼容这些 DeepSeek 别名：
@@ -70,30 +70,35 @@ $env:DEEPCCC_STREAMING="true"
 也可以创建 `~/.deepccc/config.json`：
 
 ```json
-{
-  "provider": "openai",
-  "apiKey": "sk-...",
+{
+  "provider": "openai",
+  "apiKey": "sk-...",
   "baseURL": "https://api.deepseek.com/v1",
-  "model": "deepseek-v4-pro",
-  "effort": "",
-  "streaming": true,
+  "model": "deepseek-v4-pro",
+  "effort": "",
+  "streaming": true,
   "rawStreamLogs": {
-    "enabled": false,
+    "enabled": true,
     "maxBytesPerTurn": 1048576,
     "retentionDays": 7,
     "keepCompleted": false
   }
-}
-```
-
-`provider` 可选 `openai` 或 `anthropic`，默认 `openai`，也可以通过
-`DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖：
-
-- `openai` 使用 OpenAI-compatible Chat Completions 协议，兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
-- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` 可以继续填写同一个服务基址；DeepCCC 会为不带 `/v1` 的地址自动补上 `/v1`。`effort` 是 OpenAI/DeepSeek 扩展参数，在 Anthropic 模式下不会发送。
-
-`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
-`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+}
+```
+
+`provider` 可选 `openai` 或 `anthropic`，默认 `openai`，也可以通过
+`DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖：
+
+- `openai` 使用 OpenAI-compatible Chat Completions 协议，兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
+- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` 可以继续填写同一个服务基址；DeepCCC 会为不带 `/v1` 的地址自动补上 `/v1`。`effort` 是 OpenAI/DeepSeek 扩展参数，在 Anthropic 模式下不会发送。
+
+`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
+`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+
+`rawStreamLogs.enabled` 默认 `true`，通过 `DEEPCCC_RAW_STREAM_LOGS` 环境变量或配置 JSON 关闭。
+开启时，每次对话的原始流按 gzip JSONL 落到 `~/.deepccc/raw-stream-logs/`，供
+`session_search` 工具在会话被压缩后找回被压缩消息的精确原文（检索时设置
+`include_raw_logs=true`）。关闭后，压缩后的旧消息原文将无法找回。
 
 ## 命令行交互
 
@@ -103,17 +108,17 @@ $env:DEEPCCC_STREAMING="true"
 deepccc
 ```
 
-指定其他模型或 OpenAI-compatible 接口：
+指定其他模型或 OpenAI-compatible 接口：
+
+```bash
+deepccc --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
+```
+
+使用 Anthropic Messages 协议（同样支持流式输出）：
 
 ```bash
-deepccc --base-url https://api.openai.com/v1 --api-key "$OPENAI_API_KEY" --model gpt-4.1
-```
-
-使用 Anthropic Messages 协议（同样支持流式输出）：
-
-```bash
-deepccc --provider anthropic --base-url https://api.example.com --api-key "$API_KEY" --model claude-sonnet-4-6
-```
+deepccc --provider anthropic --base-url https://api.example.com --api-key "$API_KEY" --model claude-sonnet-4-6
+```
 
 指定工作目录：
 

package/deepccc-agent/os-prompts/darwin.md

@@ -1,8 +1,8 @@
-## macOS 命令行提示
-
-你运行在 macOS 上。run_command 通过 zsh（POSIX shell）执行。引号遵循标准 POSIX 约定（与你在 bash 中已有的习惯相同）：
-
-- 双引号会被剥离并用于组合含空格参数：`echo "hello world"` 打印 `hello world`。
-- 单引号是字面量引用字符：`'a b'` 是单个参数 `a b`。
-- 反引号和 `$(...)` 执行命令替换；需要字面文本时请加引号。
-- 路径使用 `/` 分隔符，`~` 展开为主目录。
+## macOS 命令行提示
+
+你运行在 macOS 上。run_command 通过 zsh（POSIX shell）执行。引号遵循标准 POSIX 约定（与你在 bash 中已有的习惯相同）：
+
+- 双引号会被剥离并用于组合含空格参数：`echo "hello world"` 打印 `hello world`。
+- 单引号是字面量引用字符：`'a b'` 是单个参数 `a b`。
+- 反引号和 `$(...)` 执行命令替换；需要字面文本时请加引号。
+- 路径使用 `/` 分隔符，`~` 展开为主目录。

package/deepccc-agent/os-prompts/linux.md

@@ -1,8 +1,8 @@
-## Linux 命令行提示
-
-你运行在 Linux 上。run_command 通过 POSIX shell（bash/sh）执行。引语遵循标准 POSIX 约定（与你在 bash 中已有的习惯相同）：
-
-- 双引号会被剥离并用于组合含空格参数：`echo "hello world"` 打印 `hello world`。
-- 单引号是字面量引用字符：`'a b'` 是单个参数 `a b`。
-- 反引号和 `$(...)` 执行命令替换；需要字面文本时请加引号。
-- 路径使用 `/` 分隔符，`~` 展开为主目录。
+## Linux 命令行提示
+
+你运行在 Linux 上。run_command 通过 POSIX shell（bash/sh）执行。引语遵循标准 POSIX 约定（与你在 bash 中已有的习惯相同）：
+
+- 双引号会被剥离并用于组合含空格参数：`echo "hello world"` 打印 `hello world`。
+- 单引号是字面量引用字符：`'a b'` 是单个参数 `a b`。
+- 反引号和 `$(...)` 执行命令替换；需要字面文本时请加引号。
+- 路径使用 `/` 分隔符，`~` 展开为主目录。

package/deepccc-agent/os-prompts/win32.md

@@ -1,11 +1,11 @@
-## Windows 命令行提示
-
-你运行在 Windows 上。run_command 通过 cmd.exe 执行，而不是 bash。cmd 的引号规则与 bash 不同，容易踩坑：
-
-- 双引号不会被剥离：`echo "hello world"` 会原样打印 `"hello world"`（含引号），`"a b" "c"` 会把带引号的字面量 `"a b"` 和 `"c"` 传给程序。
-- 单引号在 cmd.exe 中不是引用字符：`'a b'` 会被解析成两个参数（`'a` 和 `b'`）。
-- 多行或引号密集的内联脚本（python -c "...\n...", ssh host "bash -c '...'"）在 cmd 引号规则下经常失败；把脚本写入临时文件再执行该文件。
-- PowerShell 专用语法（Get-Item、2>$null、Select-Object）不可用；除非显式调用 powershell，否则 shell 是 cmd.exe。
-- 传含空格参数时用双引号，并预期引号会原样到达程序；当目标接受文件输入时，优先把值写入文件。
-- cmd.exe 跨盘 `cd` 需要 `/d`：`cd /d D:\repo` 才真正切换盘符和目录；裸 `cd D:\repo` 只打印目标路径、停留在原盘，后续命令会在错误的目录执行。
-- npm 11.x 在 Windows 上忽略 `--prefix` 对 `npm publish` 的作用：`npm --prefix D:/repo publish` 发布的是**当前目录**的包，而不是 `--prefix` 指向的目录。务必先 `cd /d` 进入包目录，再执行 `npm publish`。
+## Windows 命令行提示
+
+你运行在 Windows 上。run_command 通过 cmd.exe 执行，而不是 bash。cmd 的引号规则与 bash 不同，容易踩坑：
+
+- 双引号不会被剥离：`echo "hello world"` 会原样打印 `"hello world"`（含引号），`"a b" "c"` 会把带引号的字面量 `"a b"` 和 `"c"` 传给程序。
+- 单引号在 cmd.exe 中不是引用字符：`'a b'` 会被解析成两个参数（`'a` 和 `b'`）。
+- 多行或引号密集的内联脚本（python -c "...\n...", ssh host "bash -c '...'"）在 cmd 引号规则下经常失败；把脚本写入临时文件再执行该文件。
+- PowerShell 专用语法（Get-Item、2>$null、Select-Object）不可用；除非显式调用 powershell，否则 shell 是 cmd.exe。
+- 传含空格参数时用双引号，并预期引号会原样到达程序；当目标接受文件输入时，优先把值写入文件。
+- cmd.exe 跨盘 `cd` 需要 `/d`：`cd /d D:\repo` 才真正切换盘符和目录；裸 `cd D:\repo` 只打印目标路径、停留在原盘，后续命令会在错误的目录执行。
+- npm 11.x 在 Windows 上忽略 `--prefix` 对 `npm publish` 的作用：`npm --prefix D:/repo publish` 发布的是**当前目录**的包，而不是 `--prefix` 指向的目录。务必先 `cd /d` 进入包目录，再执行 `npm publish`。

package/deepccc-agent/package.json

@@ -1,65 +1,65 @@
-{
-  "name": "deepccc",
-  "version": "0.1.21",
-  "description": "A lightweight coding agent with OpenAI-compatible and Anthropic Messages API support.",
-  "license": "Apache-2.0",
-  "keywords": [
-    "agent",
-    "deepseek",
-    "coding-agent",
-    "openai-compatible",
-    "anthropic",
-    "cli"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/wzj998/deepccc-agent.git"
-  },
-  "bugs": {
-    "url": "https://github.com/wzj998/deepccc-agent/issues"
-  },
-  "homepage": "https://github.com/wzj998/deepccc-agent#readme",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "bin": {
-    "deepccc": "bin/deepccc.mjs"
-  },
-  "files": [
-    "dist/",
-    "bin/",
-    "docs/",
-    "os-prompts/",
-    "package.json",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "node node_modules/typescript/bin/tsc -p tsconfig.build.json",
-    "prepack": "node node_modules/typescript/bin/tsc -p tsconfig.build.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "node node_modules/typescript/bin/tsc --noEmit"
-  },
-  "dependencies": {
-    "@ai-sdk/anthropic": "^3.0.105",
-    "@ai-sdk/openai-compatible": "^2.0.47",
-    "@vscode/ripgrep": "^1.18.0",
-    "ai": "^6.0.184"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^3.2.4"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "deepccc",
+  "version": "0.1.23",
+  "description": "A lightweight coding agent with OpenAI-compatible and Anthropic Messages API support.",
+  "license": "Apache-2.0",
+  "keywords": [
+    "agent",
+    "deepseek",
+    "coding-agent",
+    "openai-compatible",
+    "anthropic",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wzj998/deepccc-agent.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wzj998/deepccc-agent/issues"
+  },
+  "homepage": "https://github.com/wzj998/deepccc-agent#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "deepccc": "bin/deepccc.mjs"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "docs/",
+    "os-prompts/",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node node_modules/typescript/bin/tsc -p tsconfig.build.json",
+    "prepack": "node node_modules/typescript/bin/tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "node node_modules/typescript/bin/tsc --noEmit"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.105",
+    "@ai-sdk/openai-compatible": "^2.0.47",
+    "@vscode/ripgrep": "^1.18.0",
+    "ai": "^6.0.184"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}