chatccc 0.2.244 → 0.2.246

package/README.md

@@ -208,15 +208,15 @@ chatccc
 
 ### 3. AI 工具配置
 
-Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，开箱即用，**模型接入不限于 DeepSeek**——它走 OpenAI 兼容协议，任意兼容端点都可以直接替换（详见下文 CCC Agent）。
+Claude Code、Cursor 和 Codex 需要对应的本地工具；CCC Agent 内置于 ChatCCC，开箱即用，**模型接入不限于 DeepSeek**——它支持 OpenAI-compatible 和 Anthropic Messages 两种协议（详见下文 CCC Agent）。
 
-#### CCC Agent
-
-CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI，开箱即用。在首次配置向导或 Web 管理页中启用后，填写 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
-
-ChatCCC 会把 `ccc.DEEPSEEK_API_KEY`、`ccc.DEEPSEEK_BASE_URL`、模型和 effort 显式传给内置 Agent；这些配置不会回退读取 `~/.deepccc/config.json`，因此用户无需安装或配置独立的 `deepccc` 包。API Key 为空时 CCC Agent 会自动保持禁用。
+#### CCC Agent
 
-**API 支持不限于 DeepSeek。** CCC Agent 底层使用 OpenAI 兼容协议（`@ai-sdk/openai-compatible`），DeepSeek 只是出厂默认端点。`ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` 可以指向**任意 OpenAI 兼容服务**，例如：
+CCC Agent 是 ChatCCC 内置的编程 Agent，不需要额外安装 CLI，开箱即用。在首次配置向导或 Web 管理页中启用后，填写 API Key、Base URL 和模型即可使用；它可以设为 `/new` 的默认 Agent，也可以通过 `/new ccc` 显式创建会话。
+
+ChatCCC 会把 `ccc.DEEPSEEK_API_KEY`、`ccc.DEEPSEEK_BASE_URL`、模型和 effort 显式传给内置 Agent；API Key 为空时 CCC Agent 会自动保持禁用。DeepCCC 的传输层选项 `provider`（默认 `openai`）和 `streaming`（默认 `true`）可通过 `~/.deepccc/config.json` 或 `DEEPCCC_PROVIDER` / `DEEPCCC_STREAMING` 配置，无需额外安装独立 CLI。
+
+**API 支持不限于 DeepSeek。** 默认的 `provider: "openai"` 使用 OpenAI 兼容协议（`@ai-sdk/openai-compatible`），DeepSeek 只是出厂默认端点；设置 `provider: "anthropic"` 后改用 Anthropic Messages 协议（`@ai-sdk/anthropic`）。两种模式都支持流式输出，并复用相同的 API Key、Base URL 和模型配置。
 
 | 服务 | Base URL 示例 | 说明 |
 | --- | --- | --- |
@@ -371,7 +371,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 
 **微信：** 扫码登录后，在机器人私聊里发送 `/new` 或指定 Agent 的 `/new ...` 命令即可开始。功能与飞书基本一致，但展示为纯文本。
 
-**会话停滞保护：** 只有 Agent 明确进入“生成回复中”后，连续 3 分钟没有新增回复字符且尚未报告权威终态，ChatCCC 才判定停滞、结束旧 CLI，并优先补发一次“完成了吗？如果没完成继续”；恢复轮再次发生相同停滞时不再递归续跑。启动、上下文压缩、思考、搜索和工具调用阶段不会触发这项回复停滞计时；其中 CCC Agent 会单独显示“压缩上下文中”，压缩最多等待 5 分钟，失败时直接报告具体原因且不自动重放。`/new claude` 和 `/new cursor` 等创建会话操作仍有独立的 init 超时，进程资源监控也继续负责识别真正僵死。Codex 只有 `turn.completed` 才算权威终态，阶段性的 `agent_message` 不算；任一 Agent 报告权威终态后若输出流仍超过 10 秒未关闭，ChatCCC 会强制清理该 CLI 并按正常完成收尾，不会重复询问 Agent。
+**会话停滞保护：** 只有 Agent 明确进入“生成回复中”后，连续 3 分钟没有新增回复字符且尚未报告权威终态，ChatCCC 才判定停滞、结束旧 CLI，并优先补发一次“完成了吗？如果没完成继续”；恢复轮再次发生相同停滞时不再递归续跑。启动、上下文压缩、思考、搜索和工具调用阶段不会触发这项回复停滞计时；DeepCCC 关闭 streaming 时只会在请求完成后一次性返回结果，因此不会启用这项基于流式字符进度的停滞检测。其中 CCC Agent 会单独显示“压缩上下文中”，压缩最多等待 5 分钟，失败时直接报告具体原因且不自动重放。`/new claude` 和 `/new cursor` 等创建会话操作仍有独立的 init 超时，进程资源监控也继续负责识别真正僵死。Codex 只有 `turn.completed` 才算权威终态，阶段性的 `agent_message` 不算；任一 Agent 报告权威终态后若输出流仍超过 10 秒未关闭，ChatCCC 会强制清理该 CLI 并按正常完成收尾，不会重复询问 Agent。
 
 **CCC Agent 代码搜索：** `search_code` 使用项目自带的跨平台 ripgrep，不要求系统另行安装 `rg`。如果当前平台没有可用的 bundled/system ripgrep，会自动降级为内置 Node 搜索，并继续支持常用正则、glob、结果上限、中止和超时控制。
 

package/deepccc-agent/README.md

@@ -47,14 +47,17 @@ deepccc 的本地缓存优化实测命中率 **96.7%**，有效降低重复请
 export DEEPCCC_API_KEY="sk-..."
 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"
 ```
 
 也兼容这些 DeepSeek 别名：
@@ -68,10 +71,12 @@ $env:DEEPCCC_MODEL="deepseek-v4-pro"
 
 ```json
 {
+  "provider": "openai",
   "apiKey": "sk-...",
   "baseURL": "https://api.deepseek.com/v1",
   "model": "deepseek-v4-pro",
   "effort": "",
+  "streaming": true,
   "rawStreamLogs": {
     "enabled": false,
     "maxBytesPerTurn": 1048576,
@@ -81,6 +86,15 @@ $env:DEEPCCC_MODEL="deepseek-v4-pro"
 }
 ```
 
+`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` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+
 ## 命令行交互
 
 在当前目录启动一个交互式 Agent：
@@ -95,6 +109,12 @@ deepccc
 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
+```
+
 指定工作目录：
 
 ```bash

package/deepccc-agent/package-lock.json

@@ -1,14 +1,15 @@
 {
   "name": "deepccc",
-  "version": "0.1.12",
+  "version": "0.1.16",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "deepccc",
-      "version": "0.1.10",
+      "version": "0.1.16",
       "license": "Apache-2.0",
       "dependencies": {
+        "@ai-sdk/anthropic": "^3.0.105",
         "@ai-sdk/openai-compatible": "^2.0.47",
         "@vscode/ripgrep": "^1.18.0",
         "ai": "^6.0.184"
@@ -26,6 +27,52 @@
         "node": ">=20"
       }
     },
+    "node_modules/@ai-sdk/anthropic": {
+      "version": "3.0.105",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/anthropic/-/anthropic-3.0.105.tgz",
+      "integrity": "sha512-6B9UjgK14JwG4PtyhHKMQrqg49s90FClsreNZ9HmMdSWZ9tJFHuYmy4cauS/BqO/6rKC+qcNEXTP45+qivdypA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.14",
+        "@ai-sdk/provider-utils": "4.0.41"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
+    "node_modules/@ai-sdk/anthropic/node_modules/@ai-sdk/provider": {
+      "version": "3.0.14",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider/-/provider-3.0.14.tgz",
+      "integrity": "sha512-5X1k57JBJ4H7H1QjX7CnJYAB1I19r/trVZTMcSms7/kLNZ8RaU4Nt2agcwZzv82Hfx6Q7/TOLU7agAKeFfc8cA==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "json-schema": "^0.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@ai-sdk/anthropic/node_modules/@ai-sdk/provider-utils": {
+      "version": "4.0.41",
+      "resolved": "https://registry.npmjs.org/@ai-sdk/provider-utils/-/provider-utils-4.0.41.tgz",
+      "integrity": "sha512-I7hhjfw01yEI8NkuAsT8Mv6xbWFr/lqLXMdaJQ2zWfXEpxog1eT7skDcv1+RY29/+5btzH8wD+vVvy48bk9oNQ==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@ai-sdk/provider": "3.0.14",
+        "@standard-schema/spec": "^1.1.0",
+        "eventsource-parser": "^3.0.8",
+        "undici": "^5.29.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "zod": "^3.25.76 || ^4.1.8"
+      }
+    },
     "node_modules/@ai-sdk/gateway": {
       "version": "3.0.143",
       "resolved": "https://registry.npmjs.org/@ai-sdk/gateway/-/gateway-3.0.143.tgz",
@@ -530,6 +577,15 @@
         "node": ">=18"
       }
     },
+    "node_modules/@fastify/busboy": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-2.1.1.tgz",
+      "integrity": "sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=14"
+      }
+    },
     "node_modules/@jridgewell/sourcemap-codec": {
       "version": "1.5.5",
       "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
@@ -1749,6 +1805,18 @@
         "node": ">=14.17"
       }
     },
+    "node_modules/undici": {
+      "version": "5.29.0",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-5.29.0.tgz",
+      "integrity": "sha512-raqeBD6NQK4SkWhQzeYKd1KmIG6dllBOTt55Rmkt4HtI9mwdWtJljnrXjAFUBLTSN67HWrOIZ3EPF4kjUw80Bg==",
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/busboy": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.0"
+      }
+    },
     "node_modules/undici-types": {
       "version": "6.21.0",
       "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",

package/deepccc-agent/package.json

@@ -1,13 +1,14 @@
 {
   "name": "deepccc",
-  "version": "0.1.14",
-  "description": "A lightweight DeepSeek-optimized coding agent with OpenAI-compatible model support.",
+  "version": "0.1.16",
+  "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": {
@@ -47,6 +48,7 @@
     "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"

package/deepccc-agent/src/__tests__/chat-session.test.ts

@@ -3,7 +3,7 @@ import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-import { afterEach, describe, expect, it, vi } from "vitest";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 import { config } from "../config.js";
 import { estimateBuiltinContextTokens } from "../context.js";
@@ -14,9 +14,17 @@ const createRawStreamLogMock = vi.fn();
 const rawLogWriteLineMock = vi.fn();
 const rawLogCloseMock = vi.fn();
 const originalRawStreamLogs = structuredClone(config.rawStreamLogs);
+const originalStreaming = config.streaming;
+const originalProvider = config.provider;
+const createOpenAICompatibleMock = vi.fn(() => (modelId: string) => ({ modelId }));
+const createAnthropicMock = vi.fn(() => (modelId: string) => ({ modelId, provider: "anthropic" }));
 
 vi.mock("@ai-sdk/openai-compatible", () => ({
-  createOpenAICompatible: vi.fn(() => (modelId: string) => ({ modelId })),
+  createOpenAICompatible: createOpenAICompatibleMock,
+}));
+
+vi.mock("@ai-sdk/anthropic", () => ({
+  createAnthropic: createAnthropicMock,
 }));
 
 vi.mock("ai", () => ({
@@ -46,6 +54,11 @@ async function* fullStream(...parts: unknown[]): AsyncIterable<unknown> {
   for (const part of parts) yield part;
 }
 
+beforeEach(() => {
+  config.provider = "openai";
+  config.streaming = true;
+});
+
 afterEach(() => {
   streamTextMock.mockReset();
   generateTextMock.mockReset();
@@ -53,9 +66,120 @@ afterEach(() => {
   rawLogWriteLineMock.mockReset();
   rawLogCloseMock.mockReset();
   config.rawStreamLogs = structuredClone(originalRawStreamLogs);
+  config.provider = originalProvider;
+  config.streaming = originalStreaming;
+  createOpenAICompatibleMock.mockClear();
+  createAnthropicMock.mockClear();
   vi.useRealTimers();
 });
 
+describe("ChatSession response transport", () => {
+  it("uses the OpenAI-compatible provider by default", async () => {
+    const { ChatSession } = await import("../index.js");
+
+    new ChatSession({ apiKey: "sk-test", baseURL: "https://gateway.example", model: "model-a" });
+
+    expect(createOpenAICompatibleMock).toHaveBeenLastCalledWith(expect.objectContaining({
+      baseURL: "https://gateway.example",
+      apiKey: "sk-test",
+    }));
+    expect(createAnthropicMock).not.toHaveBeenCalled();
+  });
+
+  it("uses Anthropic Messages with the same base URL and appends /v1 when needed", async () => {
+    const { ChatSession } = await import("../index.js");
+
+    new ChatSession({
+      provider: "anthropic",
+      apiKey: "sk-test",
+      baseURL: "https://gateway.example/",
+      model: "model-a",
+    });
+
+    expect(createAnthropicMock).toHaveBeenLastCalledWith({
+      baseURL: "https://gateway.example/v1",
+      apiKey: "sk-test",
+    });
+    expect(createOpenAICompatibleMock).not.toHaveBeenCalled();
+  });
+
+  it("keeps an existing /v1 suffix for Anthropic and streams without OpenAI-only effort options", async () => {
+    const { ChatSession } = await import("../index.js");
+    streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
+    const session = new ChatSession({
+      provider: "anthropic",
+      apiKey: "sk-test",
+      baseURL: "https://gateway.example/v1/",
+      model: "model-a",
+      effort: "high",
+    });
+
+    await collect(session.chat("hello"));
+
+    expect(createAnthropicMock).toHaveBeenLastCalledWith({
+      baseURL: "https://gateway.example/v1",
+      apiKey: "sk-test",
+    });
+    expect(streamTextMock).toHaveBeenCalledOnce();
+    expect(streamTextMock.mock.calls[0]?.[0]).not.toHaveProperty("providerOptions");
+  });
+
+  it("asks the provider to include usage in streaming responses", async () => {
+    const { ChatSession } = await import("../index.js");
+
+    new ChatSession({ apiKey: "sk-test" });
+
+    expect(createOpenAICompatibleMock).toHaveBeenLastCalledWith(expect.objectContaining({
+      includeUsage: true,
+    }));
+  });
+
+  it("uses generateText and preserves text/tool events when streaming is disabled", async () => {
+    const { ChatSession } = await import("../index.js");
+    config.streaming = false;
+    generateTextMock.mockResolvedValueOnce({
+      text: "done",
+      steps: [{
+        text: "done",
+        toolCalls: [{
+          type: "tool-call",
+          toolCallId: "call-1",
+          toolName: "read_file",
+          input: { path: "package.json" },
+        }],
+        toolResults: [{
+          type: "tool-result",
+          toolCallId: "call-1",
+          toolName: "read_file",
+          input: { path: "package.json" },
+          output: { content: "{}" },
+        }],
+      }],
+    });
+    const session = new ChatSession({ apiKey: "sk-test" });
+
+    const events = await collect(session.chat("read package"));
+
+    expect(streamTextMock).not.toHaveBeenCalled();
+    expect(generateTextMock).toHaveBeenCalledOnce();
+    expect(events).toContainEqual({
+      type: "tool_use",
+      id: "call-1",
+      name: "read_file",
+      input: { path: "package.json" },
+    });
+    expect(events).toContainEqual({
+      type: "tool_result",
+      tool_use_id: "call-1",
+      name: "read_file",
+      content: { content: "{}" },
+      is_error: false,
+    });
+    expect(events).toContainEqual({ type: "text", text: "done", accumulated: "done" });
+    expect(events).toContainEqual({ type: "done", text: "done" });
+  });
+});
+
 describe("ChatSession context management", () => {
   it("keeps the generalized evidence gate in the stable system prompt prefix", async () => {
     const { ChatSession } = await import("../index.js");

package/deepccc-agent/src/__tests__/config.test.ts

@@ -1,26 +1,34 @@
-import { afterEach, describe, expect, it } from "vitest";
-
-import { ChatSession } from "../index.js";
-import { config } from "../config.js";
-
-const originalDeepSeekApiKey = process.env.DEEPSEEK_API_KEY;
-const originalDeepCccApiKey = config.apiKey;
-
-afterEach(() => {
-  if (originalDeepSeekApiKey === undefined) {
-    delete process.env.DEEPSEEK_API_KEY;
-  } else {
-    process.env.DEEPSEEK_API_KEY = originalDeepSeekApiKey;
-  }
-  config.apiKey = originalDeepCccApiKey;
-});
-
-describe("builtin ChatSession config", () => {
-  it("uses the builtin ~/.deepccc config when no apiKey is passed", () => {
-    expect(() => new ChatSession()).not.toThrow();
-  });
-
-  it("allows constructor parameters to override config defaults", () => {
-    expect(() => new ChatSession({ apiKey: "sk-test" })).not.toThrow();
-  });
-});
+import { afterEach, describe, expect, it } from "vitest";
+
+import { ChatSession } from "../index.js";
+import { config, normalizeDeepCccProvider } from "../config.js";
+
+const originalDeepSeekApiKey = process.env.DEEPSEEK_API_KEY;
+const originalDeepCccApiKey = config.apiKey;
+
+afterEach(() => {
+  if (originalDeepSeekApiKey === undefined) {
+    delete process.env.DEEPSEEK_API_KEY;
+  } else {
+    process.env.DEEPSEEK_API_KEY = originalDeepSeekApiKey;
+  }
+  config.apiKey = originalDeepCccApiKey;
+});
+
+describe("builtin ChatSession config", () => {
+  it("defaults provider selection to openai and accepts anthropic case-insensitively", () => {
+    expect(normalizeDeepCccProvider(undefined)).toBe("openai");
+    expect(normalizeDeepCccProvider("")).toBe("openai");
+    expect(normalizeDeepCccProvider("OPENAI")).toBe("openai");
+    expect(normalizeDeepCccProvider("Anthropic")).toBe("anthropic");
+    expect(() => normalizeDeepCccProvider("antropic")).toThrow(/openai.*anthropic/i);
+  });
+
+  it("uses the builtin ~/.deepccc config when no apiKey is passed", () => {
+    expect(() => new ChatSession()).not.toThrow();
+  });
+
+  it("allows constructor parameters to override config defaults", () => {
+    expect(() => new ChatSession({ apiKey: "sk-test" })).not.toThrow();
+  });
+});