chatccc 0.2.59 → 0.2.61

package/config.sample.json

@@ -13,7 +13,7 @@
   "claude": {
     "enabled": false,
     "defaultAgent": true,
-    "model": "claude-sonnet-4-6",
+    "model": "",
     "subagentModel": "",
     "effort": "",
     "apiKey": "",

package/im-skills/wechat-skill/receive-send-image.md

@@ -1,39 +1,39 @@
-# Receiving & Sending Images (WeChat)
-
-## Receive Images
-
-Images sent to the bot are **automatically downloaded** to `~/.chatccc/images/downloads/` with the `wx_` filename prefix.
-
-The message text you receive will include the downloaded path in the format:
-```
-[图片] C:\Users\<用户名>\.chatccc\images\downloads\wx_<key>.png
-```
-
-You can read the image file at that path to understand what the user sent.
-
-## Send Images
-
-### Script (recommended)
-```bash
-node "{{wechat_send_image_script}}" --path "<absolute image path>" --caption "<optional caption>"
-```
-
-The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the image to the most recent chat.
-
-### Direct usage in test scripts
-
-The underlying SDK call is:
-```ts
-import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
-const wire = new OpenIlinkWire(token, { base_url: baseUrl });
-await wire.sendMediaFile(chatId, contextToken, imageBuffer, "filename.png", "caption");
-```
-
-### Rules
-
-- Save or choose a local image file first.
-- Use an absolute local path.
-- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
-- Max image size: 10MB (SDK guideline; larger files upload slower).
-- Only send an image when the user asked for one or when it materially helps the answer.
+# Receiving & Sending Images (WeChat)
+
+## Receive Images
+
+Images sent to the bot are **automatically downloaded** to `~/.chatccc/images/downloads/` with the `wx_` filename prefix.
+
+The message text you receive will include the downloaded path in the format:
+```
+[图片] C:\Users\<用户名>\.chatccc\images\downloads\wx_<key>.png
+```
+
+You can read the image file at that path to understand what the user sent.
+
+## Send Images
+
+### Script (recommended)
+```bash
+node "{{wechat_send_image_script}}" --path "<absolute image path>" --caption "<optional caption>"
+```
+
+The script reads the current WeChat session's auth token, chat ID, and context token from `~/.chatccc/state/ilink-auth.json`, then sends the image to the most recent chat.
+
+### Direct usage in test scripts
+
+The underlying SDK call is:
+```ts
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+const wire = new OpenIlinkWire(token, { base_url: baseUrl });
+await wire.sendMediaFile(chatId, contextToken, imageBuffer, "filename.png", "caption");
+```
+
+### Rules
+
+- Save or choose a local image file first.
+- Use an absolute local path.
+- Supported formats: .png, .jpg, .jpeg, .webp, .gif, .bmp.
+- Max image size: 10MB (SDK guideline; larger files upload slower).
+- Only send an image when the user asked for one or when it materially helps the answer.
 - **Claw 限制**: 图片发送也计入微信 claw 连发计数，连续 10 条未回复会截断。

package/im-skills/wechat-skill/send-image.mjs

@@ -1,80 +1,80 @@
-#!/usr/bin/env node
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { basename, extname, join } from "node:path";
-import { homedir } from "node:os";
-
-import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
-
-const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
-const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
-const ALLOWED_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp"]);
-
-function parseArgs(argv) {
-  const result = {};
-  for (let i = 0; i < argv.length; i++) {
-    const key = argv[i];
-    if (!key.startsWith("--")) continue;
-    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
-    result[key.slice(2)] = value;
-  }
-  return result;
-}
-
-function usage() {
-  console.error(`Usage:
-  node ${basename(process.argv[1])} --path <absolute image path> [--caption <text>]`);
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const imagePath = args.path;
-  const caption = args.caption || "";
-
-  if (!imagePath) {
-    usage();
-    process.exit(1);
-  }
-
-  const ext = extname(imagePath).toLowerCase();
-  if (!ALLOWED_EXTS.has(ext)) {
-    console.error(`Unsupported image extension: ${ext || "(none)"}`);
-    process.exit(1);
-  }
-
-  const st = statSync(imagePath);
-  if (!st.isFile()) {
-    console.error("Image path is not a file");
-    process.exit(1);
-  }
-  if (st.size > MAX_IMAGE_BYTES) {
-    console.error("Image file exceeds 10MB limit");
-    process.exit(1);
-  }
-
-  if (!existsSync(ILINK_AUTH_PATH)) {
-    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
-    console.error("Make sure the WeChat iLink platform is logged in.");
-    process.exit(1);
-  }
-
-  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
-  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
-    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
-    process.exit(1);
-  }
-
-  const imgData = readFileSync(imagePath);
-  const fileName = basename(imagePath);
-
-  const wire = new OpenIlinkWire(snap.token, {
-    base_url: snap.baseUrl,
-  });
-
-  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, imgData, fileName, caption);
-  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
-}
-
-main().catch((err) => {
-  console.error(err instanceof Error ? err.message : String(err));
-  process.exit(1);
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { basename, extname, join } from "node:path";
+import { homedir } from "node:os";
+
+import { Client as OpenIlinkWire } from "@openilink/openilink-sdk-node";
+
+const ILINK_AUTH_PATH = join(homedir(), ".chatccc", "state", "ilink-auth.json");
+const MAX_IMAGE_BYTES = 10 * 1024 * 1024;
+const ALLOWED_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif", ".bmp"]);
+
+function parseArgs(argv) {
+  const result = {};
+  for (let i = 0; i < argv.length; i++) {
+    const key = argv[i];
+    if (!key.startsWith("--")) continue;
+    const value = argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : "true";
+    result[key.slice(2)] = value;
+  }
+  return result;
+}
+
+function usage() {
+  console.error(`Usage:
+  node ${basename(process.argv[1])} --path <absolute image path> [--caption <text>]`);
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const imagePath = args.path;
+  const caption = args.caption || "";
+
+  if (!imagePath) {
+    usage();
+    process.exit(1);
+  }
+
+  const ext = extname(imagePath).toLowerCase();
+  if (!ALLOWED_EXTS.has(ext)) {
+    console.error(`Unsupported image extension: ${ext || "(none)"}`);
+    process.exit(1);
+  }
+
+  const st = statSync(imagePath);
+  if (!st.isFile()) {
+    console.error("Image path is not a file");
+    process.exit(1);
+  }
+  if (st.size > MAX_IMAGE_BYTES) {
+    console.error("Image file exceeds 10MB limit");
+    process.exit(1);
+  }
+
+  if (!existsSync(ILINK_AUTH_PATH)) {
+    console.error(`Auth snapshot not found: ${ILINK_AUTH_PATH}`);
+    console.error("Make sure the WeChat iLink platform is logged in.");
+    process.exit(1);
+  }
+
+  const snap = JSON.parse(readFileSync(ILINK_AUTH_PATH, "utf8"));
+  if (!snap.token || !snap.lastChatId || !snap.contextToken) {
+    console.error("Auth snapshot missing token, lastChatId, or contextToken.");
+    process.exit(1);
+  }
+
+  const imgData = readFileSync(imagePath);
+  const fileName = basename(imagePath);
+
+  const wire = new OpenIlinkWire(snap.token, {
+    base_url: snap.baseUrl,
+  });
+
+  await wire.sendMediaFile(snap.lastChatId, snap.contextToken, imgData, fileName, caption);
+  console.log(JSON.stringify({ ok: true, sentTo: 1 }));
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
 });

package/im-skills/wechat-skill/skill.md

@@ -1,11 +1,11 @@
----
-name: wechat-skill
-description: WeChat iLink local skills for sending and receiving images.
----
-
-Current working directory: {{cwd}}
-
-WeChat images are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper scripts below instead.
-
-- **Receive images**: Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[图片] <absolute path>`.
+---
+name: wechat-skill
+description: WeChat iLink local skills for sending and receiving images.
+---
+
+Current working directory: {{cwd}}
+
+WeChat images are handled through the iLink SDK. The local server does NOT have HTTP RPC endpoints for WeChat; use the helper scripts below instead.
+
+- **Receive images**: Images sent to the bot are automatically downloaded to `~/.chatccc/images/downloads/` with the filename prefix `wx_`. The message text will include the local path as `[图片] <absolute path>`.
 - **Send images**: Use the send-image helper script — read `{{im_skills_cache_dir}}/wechat-skill/receive-send-image.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.59",
+  "version": "0.2.61",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",

package/src/__tests__/claude-adapter.test.ts

@@ -771,10 +771,10 @@ describe("createClaudeAdapter — env 注入", () => {
     expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://api.deepseek.com/anthropic");
   });
 
-  it("apiKey + baseUrl 都设置 → 同时覆盖", async () => {
-    setupMockCreateSession();
-    const adapter = createClaudeAdapter({
-      model: "",
+  it("apiKey + baseUrl 都设置 → 同时覆盖", async () => {
+    setupMockCreateSession();
+    const adapter = createClaudeAdapter({
+      model: "",
       effort: "",
       isEmpty: (v) => v.trim() === "",
       apiKey: "sk-x",
@@ -784,50 +784,50 @@ describe("createClaudeAdapter — env 注入", () => {
     await adapter.createSession("/cwd");
 
     const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
-    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-x");
-    expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://gateway.example/anthropic");
-  });
-
-  it("官方 API 模式下 subagentModel 不注入 env，也不覆盖 Claude 登录环境", async () => {
-    setupMockCreateSession();
-    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
-    const adapter = createClaudeAdapter({
-      model: "claude-sonnet-4-6",
-      subagentModel: "claude-haiku-4-5-20251001",
-      effort: "",
-      isEmpty: (v) => v.trim() === "",
-      apiKey: "",
-      baseUrl: "",
-    });
-
-    await adapter.createSession("/cwd");
-
-    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
-    expect(opts).not.toHaveProperty("env");
-  });
-
-  it("第三方 API 模式下 subagentModel 通过 CLAUDE_CODE_SUBAGENT_MODEL 覆盖 Haiku", async () => {
-    setupMockCreateSession();
-    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
-    const adapter = createClaudeAdapter({
-      model: "claude-sonnet-4-6",
-      subagentModel: "claude-haiku-4-5-20251001",
-      effort: "",
-      isEmpty: (v) => v.trim() === "",
-      apiKey: "sk-thirdparty",
-      baseUrl: "https://gateway.example/anthropic",
-    });
-
-    await adapter.createSession("/cwd");
-
-    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
-    expect(opts.model).toBe("claude-sonnet-4-6");
-    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-thirdparty");
-    expect(opts.env.CLAUDE_CODE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
-    expect(opts.env.CLAUDE_CODE_OAUTH_TOKEN).toBeUndefined();
-  });
-
-  it("ChatCCC API config is isolated from Claude settings auth/model env", async () => {
+    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-x");
+    expect(opts.env.ANTHROPIC_BASE_URL).toBe("https://gateway.example/anthropic");
+  });
+
+  it("官方 API 模式下 subagentModel 不注入 env，也不覆盖 Claude 登录环境", async () => {
+    setupMockCreateSession();
+    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
+    const adapter = createClaudeAdapter({
+      model: "claude-sonnet-4-6",
+      subagentModel: "claude-haiku-4-5-20251001",
+      effort: "",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "",
+      baseUrl: "",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts).not.toHaveProperty("env");
+  });
+
+  it("第三方 API 模式下 subagentModel 通过 CLAUDE_CODE_SUBAGENT_MODEL 覆盖 Haiku", async () => {
+    setupMockCreateSession();
+    process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-login";
+    const adapter = createClaudeAdapter({
+      model: "claude-sonnet-4-6",
+      subagentModel: "claude-haiku-4-5-20251001",
+      effort: "",
+      isEmpty: (v) => v.trim() === "",
+      apiKey: "sk-thirdparty",
+      baseUrl: "https://gateway.example/anthropic",
+    });
+
+    await adapter.createSession("/cwd");
+
+    const opts = sdk.unstable_v2_createSession.mock.calls[0][0];
+    expect(opts.model).toBe("claude-sonnet-4-6");
+    expect(opts.env.ANTHROPIC_API_KEY).toBe("sk-thirdparty");
+    expect(opts.env.CLAUDE_CODE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
+    expect(opts.env.CLAUDE_CODE_OAUTH_TOKEN).toBeUndefined();
+  });
+
+  it("ChatCCC API config is isolated from Claude settings auth/model env", async () => {
     setupMockCreateSession();
     process.env.ANTHROPIC_AUTH_TOKEN = "token-from-claude-settings";
     process.env.CLAUDE_CODE_OAUTH_TOKEN = "oauth-from-claude-settings";

package/src/__tests__/config-reload.test.ts

@@ -10,9 +10,9 @@ import {
   CHATCCC_PORT,
   CLAUDE_API_KEY,
   CLAUDE_BASE_URL,
-  CLAUDE_EFFORT,
-  CLAUDE_MODEL,
-  CLAUDE_SUBAGENT_MODEL,
+  CLAUDE_EFFORT,
+  CLAUDE_MODEL,
+  CLAUDE_SUBAGENT_MODEL,
   CURSOR_AGENT_ARGS,
   CURSOR_AGENT_COMMAND,
   FEISHU_ENABLED,
@@ -44,10 +44,10 @@ const baseAppConfig: AppConfig = {
   allowInterrupt: false,
   claude: {
     enabled: true,
-    defaultAgent: true,
-    model: "initial-model",
-    subagentModel: "initial-subagent-model",
-    effort: "initial-effort",
+    defaultAgent: true,
+    model: "initial-model",
+    subagentModel: "initial-subagent-model",
+    effort: "initial-effort",
     apiKey: "sk-initial",
     baseUrl: "https://initial.gw/anthropic",
   },
@@ -80,22 +80,22 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
     expect(APP_SECRET).toBe("NEW_APP_SECRET");
   });
 
-  it("更新 Claude 配置（model / subagentModel / effort / apiKey / baseUrl）", () => {
+  it("更新 Claude 配置（model / subagentModel / effort / apiKey / baseUrl）", () => {
     applyLoadedConfig({
       ...structuredClone(baseAppConfig),
       claude: {
         enabled: true,
-        defaultAgent: true,
-        model: "claude-sonnet-4-6",
-        subagentModel: "claude-haiku-4-5-20251001",
-        effort: "high",
+        defaultAgent: true,
+        model: "claude-sonnet-4-6",
+        subagentModel: "claude-haiku-4-5-20251001",
+        effort: "high",
         apiKey: "sk-newkey",
         baseUrl: "https://gw2.example/anthropic",
       },
     });
 
-    expect(CLAUDE_MODEL).toBe("claude-sonnet-4-6");
-    expect(CLAUDE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
+    expect(CLAUDE_MODEL).toBe("claude-sonnet-4-6");
+    expect(CLAUDE_SUBAGENT_MODEL).toBe("claude-haiku-4-5-20251001");
     expect(CLAUDE_EFFORT).toBe("high");
     expect(CLAUDE_API_KEY).toBe("sk-newkey");
     expect(CLAUDE_BASE_URL).toBe("https://gw2.example/anthropic");

package/src/__tests__/config-sample.test.ts

@@ -6,25 +6,25 @@ import { describe, expect, it } from "vitest";
 describe("config.sample.json", () => {
   it("enables Feishu and WeChat iLink by default", () => {
     const configSamplePath = join(process.cwd(), "config.sample.json");
-    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
-      platforms?: {
-        feishu?: { enabled?: unknown };
-        ilink?: { enabled?: unknown };
-      };
-      claude?: { model?: unknown; subagentModel?: unknown };
-    };
-
-    expect(sample.platforms?.feishu?.enabled).toBe(true);
-    expect(sample.platforms?.ilink?.enabled).toBe(true);
-  });
-
-  it("uses an Anthropic official main model and leaves subagent override empty by default", () => {
-    const configSamplePath = join(process.cwd(), "config.sample.json");
-    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
-      claude?: { model?: unknown; subagentModel?: unknown };
-    };
-
-    expect(sample.claude?.model).toBe("claude-sonnet-4-6");
-    expect(sample.claude?.subagentModel).toBe("");
-  });
-});
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      platforms?: {
+        feishu?: { enabled?: unknown };
+        ilink?: { enabled?: unknown };
+      };
+      claude?: { model?: unknown; subagentModel?: unknown };
+    };
+
+    expect(sample.platforms?.feishu?.enabled).toBe(true);
+    expect(sample.platforms?.ilink?.enabled).toBe(true);
+  });
+
+  it("uses an Anthropic official main model and leaves subagent override empty by default", () => {
+    const configSamplePath = join(process.cwd(), "config.sample.json");
+    const sample = JSON.parse(readFileSync(configSamplePath, "utf8")) as {
+      claude?: { model?: unknown; subagentModel?: unknown };
+    };
+
+    expect(sample.claude?.model).toBe("claude-sonnet-4-6");
+    expect(sample.claude?.subagentModel).toBe("");
+  });
+});

package/src/__tests__/web-ui.test.ts

@@ -1,10 +1,10 @@
 import { describe, it, expect } from "vitest";
 import {
-  applyClaudeApiMode,
-  chooseStartPath,
-  detectClaudeApiMode,
-  unflattenConfig,
-} from "../web-ui.ts";
+  applyClaudeApiMode,
+  chooseStartPath,
+  detectClaudeApiMode,
+  unflattenConfig,
+} from "../web-ui.ts";
 
 // ---------------------------------------------------------------------------
 // detectClaudeApiMode — 加载已有 config 时如何判定 UI 初始模式
@@ -57,7 +57,7 @@ describe("detectClaudeApiMode", () => {
 //   - mode 未传 默认按 official 兌底（不保留可能误填的密钥）
 // ---------------------------------------------------------------------------
 
-describe("applyClaudeApiMode", () => {
+describe("applyClaudeApiMode", () => {
   it("mode=official 时清空 CLAUDE_API_KEY / CLAUDE_BASE_URL（即使 vars 没传）", () => {
     const out = applyClaudeApiMode({ CHATCCC_APP_ID: "x" }, "official");
     expect(out).toEqual({
@@ -128,23 +128,23 @@ describe("applyClaudeApiMode", () => {
     expect(input).toEqual({ CLAUDE_API_KEY: "sk-x" }); // 原对象未变
     expect(out).not.toBe(input);
   });
-});
-
-describe("unflattenConfig", () => {
-  it("maps Claude subagent model into claude.subagentModel", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_ANTHROPIC_MODEL: "claude-sonnet-4-6",
-        CHATCCC_ANTHROPIC_SUBAGENT_MODEL: "claude-haiku-4-5-20251001",
-      }),
-    ).toEqual({
-      claude: {
-        model: "claude-sonnet-4-6",
-        subagentModel: "claude-haiku-4-5-20251001",
-      },
-    });
-  });
-});
+});
+
+describe("unflattenConfig", () => {
+  it("maps Claude subagent model into claude.subagentModel", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_ANTHROPIC_MODEL: "claude-sonnet-4-6",
+        CHATCCC_ANTHROPIC_SUBAGENT_MODEL: "claude-haiku-4-5-20251001",
+      }),
+    ).toEqual({
+      claude: {
+        model: "claude-sonnet-4-6",
+        subagentModel: "claude-haiku-4-5-20251001",
+      },
+    });
+  });
+});
 
 // ---------------------------------------------------------------------------
 // chooseStartPath — /api/start 的路径选择

package/src/__tests__/wechat-platform.test.ts

@@ -2,14 +2,15 @@ import { beforeEach, describe, expect, it, vi } from "vitest";
 
 import { buildHelpCard } from "../cards.ts";
 import {
-  _flushPendingClawFinalTextForTest,
   _resetWechatClawStateForTest,
+  _setWxMinSendIntervalMsForTest,
   createWechatAdapter,
 } from "../wechat-platform.ts";
 
 describe("createWechatAdapter", () => {
   beforeEach(() => {
     _resetWechatClawStateForTest();
+    _setWxMinSendIntervalMsForTest(0); // 测试中禁用发送间隔限制
   });
 
   it("degrades raw cards to plain text messages", async () => {
@@ -38,7 +39,7 @@ describe("createWechatAdapter", () => {
     expect(log).toHaveBeenCalledWith("[WECHAT] sendRawCard degraded to text");
   });
 
-  it("reports unsent non-final messages after the claw limit", async () => {
+  it("appends claw suffix on 9th non-final message and blocks further non-final messages", async () => {
     const wire = {
       push: vi.fn(async (_chatId: string, _text: string) => "msg-id"),
       sendText: vi.fn(
@@ -52,18 +53,28 @@ describe("createWechatAdapter", () => {
       log,
     });
 
-    for (let i = 0; i < 10; i++) {
+    // 前8条正常发送
+    for (let i = 0; i < 8; i++) {
       await expect(platform.sendText("wx-chat-limit", `chunk ${i}`)).resolves.toBe(true);
     }
 
-    await expect(platform.sendText("wx-chat-limit", "chunk 10")).resolves.toBe(false);
-    expect(wire.push).toHaveBeenCalledTimes(10);
+    // 第9条非最终消息：应附加 claw 后缀
+    await expect(platform.sendText("wx-chat-limit", "chunk 8")).resolves.toBe(true);
+
+    // 第10条起非最终消息被阻止
+    await expect(platform.sendText("wx-chat-limit", "chunk 9")).resolves.toBe(false);
+
+    expect(wire.push).toHaveBeenCalledTimes(9);
+    // 验证第9条附带了 claw 后缀
+    const ninthCall = wire.push.mock.calls[8];
+    expect(ninthCall[1]).toContain("chunk 8");
+    expect(ninthCall[1]).toContain("由于微信claw机制限制，不再发送过程，稍后把最终结果发送给你");
     expect(log).toHaveBeenCalledWith(
-      "[WECHAT] sendText skipped (claw limit): chatId=wx-chat-limit count=11",
+      "[WECHAT] sendText skipped (claw limit): chatId=wx-chat-limit count=10",
     );
   });
 
-  it("queues final messages after the claw limit until the user wakes the chat", async () => {
+  it("allows final messages through after the 9th message claw limit", async () => {
     const wire = {
       push: vi.fn(async (_chatId: string, _text: string) => "msg-id"),
       sendText: vi.fn(
@@ -76,24 +87,25 @@ describe("createWechatAdapter", () => {
       getWire: () => wire,
       log,
     });
-    const chatId = "wx-chat-final-limit";
+    const chatId = "wx-chat-final-allow";
     const finalText = "done\n━━━ 回答结束 ━━━";
 
-    for (let i = 0; i < 10; i++) {
+    // 前8条正常发送
+    for (let i = 0; i < 8; i++) {
       await expect(platform.sendText(chatId, `chunk ${i}`)).resolves.toBe(true);
     }
 
+    // 第9条非最终消息带后缀
+    await expect(platform.sendText(chatId, "chunk 8")).resolves.toBe(true);
+
+    // 第10条：最终消息应允许发送（不被阻止也不被 queuing）
     await expect(platform.sendText(chatId, finalText)).resolves.toBe(true);
-    expect(wire.push).toHaveBeenCalledTimes(10);
-    expect(log).toHaveBeenCalledWith(
-      `[WECHAT] final queued (claw limit): chatId=${chatId} count=11 len=${finalText.length}`,
-    );
 
-    await expect(_flushPendingClawFinalTextForTest(chatId, wire, log)).resolves.toBe(true);
-    expect(wire.push).toHaveBeenCalledTimes(11);
-    expect(wire.push).toHaveBeenLastCalledWith(chatId, finalText);
+    expect(wire.push).toHaveBeenCalledTimes(10);
+    const lastCall = wire.push.mock.calls[9];
+    expect(lastCall[1]).toBe(finalText);
     expect(log).toHaveBeenCalledWith(
-      `[WECHAT] pending final sent after claw wake: chatId=${chatId} len=${finalText.length}`,
+      expect.stringContaining("[WECHAT] sendText OK"),
     );
   });
 });

package/src/adapters/claude-adapter.ts

@@ -86,33 +86,33 @@ function buildSdkEnv(
   baseUrl: string | undefined,
   subagentModel: string | undefined,
 ): Record<string, string | undefined> | undefined {
-  const apiKeyTrim = (apiKey ?? "").trim();
-  const baseUrlTrim = (baseUrl ?? "").trim();
-  const subagentModelTrim = (subagentModel ?? "").trim();
-  const hasApiOverride = Boolean(apiKeyTrim || baseUrlTrim);
-  if (!hasApiOverride) return undefined;
-
-  const env: Record<string, string | undefined> = { ...process.env };
-  // ChatCCC's third-party Claude API config is authoritative when present.
-  // Remove Claude Code/user settings env that can silently override gateway/auth/model choice.
-  delete env.ANTHROPIC_AUTH_TOKEN;
-  delete env.CLAUDE_CODE_OAUTH_TOKEN;
-  delete env.ANTHROPIC_MODEL;
-  delete env.ANTHROPIC_DEFAULT_OPUS_MODEL;
-  delete env.ANTHROPIC_DEFAULT_SONNET_MODEL;
-  delete env.ANTHROPIC_DEFAULT_HAIKU_MODEL;
-  delete env.CLAUDE_CODE_SUBAGENT_MODEL;
-  delete env.CLAUDE_CODE_EFFORT_LEVEL;
-
-  if (apiKeyTrim) env.ANTHROPIC_API_KEY = apiKeyTrim;
-  if (baseUrlTrim) {
-    env.ANTHROPIC_BASE_URL = baseUrlTrim;
-  } else {
-    delete env.ANTHROPIC_BASE_URL;
-  }
-  if (subagentModelTrim) env.CLAUDE_CODE_SUBAGENT_MODEL = subagentModelTrim;
-  return env;
-}
+  const apiKeyTrim = (apiKey ?? "").trim();
+  const baseUrlTrim = (baseUrl ?? "").trim();
+  const subagentModelTrim = (subagentModel ?? "").trim();
+  const hasApiOverride = Boolean(apiKeyTrim || baseUrlTrim);
+  if (!hasApiOverride) return undefined;
+
+  const env: Record<string, string | undefined> = { ...process.env };
+  // ChatCCC's third-party Claude API config is authoritative when present.
+  // Remove Claude Code/user settings env that can silently override gateway/auth/model choice.
+  delete env.ANTHROPIC_AUTH_TOKEN;
+  delete env.CLAUDE_CODE_OAUTH_TOKEN;
+  delete env.ANTHROPIC_MODEL;
+  delete env.ANTHROPIC_DEFAULT_OPUS_MODEL;
+  delete env.ANTHROPIC_DEFAULT_SONNET_MODEL;
+  delete env.ANTHROPIC_DEFAULT_HAIKU_MODEL;
+  delete env.CLAUDE_CODE_SUBAGENT_MODEL;
+  delete env.CLAUDE_CODE_EFFORT_LEVEL;
+
+  if (apiKeyTrim) env.ANTHROPIC_API_KEY = apiKeyTrim;
+  if (baseUrlTrim) {
+    env.ANTHROPIC_BASE_URL = baseUrlTrim;
+  } else {
+    delete env.ANTHROPIC_BASE_URL;
+  }
+  if (subagentModelTrim) env.CLAUDE_CODE_SUBAGENT_MODEL = subagentModelTrim;
+  return env;
+}
 
 function resolveSettingSources(
   _apiKey: string | undefined,
@@ -291,19 +291,19 @@ class ClaudeAdapter implements ToolAdapter {
       this.baseUrl,
       this.subagentModel,
     );
-    const session = unstable_v2_resumeSession(
-      sessionId,
-      sessionOpts as any,
-    );
-
-    if (signal?.aborted) {
-      session.close();
-      return;
-    }
-    const onAbort = () => { session.close(); };
-    signal?.addEventListener("abort", onAbort, { once: true });
-
-    await session.send(userText);
+    const session = unstable_v2_resumeSession(
+      sessionId,
+      sessionOpts as any,
+    );
+
+    if (signal?.aborted) {
+      session.close();
+      return;
+    }
+    const onAbort = () => { session.close(); };
+    signal?.addEventListener("abort", onAbort, { once: true });
+
+    await session.send(userText);
 
     const stream = session.stream();
 

package/src/session.ts

@@ -30,6 +30,13 @@ import { createCursorAdapter } from "./adapters/cursor-adapter.ts";
 import { createCodexAdapter } from "./adapters/codex-adapter.ts";
 import { buildImSkillsPrompt, exportSkillSubDocs } from "./im-skills.ts";
 import type { PlatformAdapter } from "./platform-adapter.ts";
+
+// 微信显示循环压缩：头5 + ... + 尾5，避免在最后一步 sendText 中压缩指令回复
+function compressWechatDisplayText(text: string): string {
+  const lines = text.split("\n");
+  if (lines.length <= 10) return text;
+  return [...lines.slice(0, 5), "...", ...lines.slice(-5)].join("\n");
+}
 import { readStreamState, writeStreamState, createEmptyStreamState, fixStaleStreamStates } from "./stream-state.ts";
 import {
   bindChatToSession,
@@ -1015,7 +1022,7 @@ export function ensureDisplayLoop(sessionId: string): void {
 
             d.cardBusy = true;
             try {
-              const ok = await p.sendText(chatId, delta);
+              const ok = await p.sendText(chatId, compressWechatDisplayText(delta));
               if (ok) {
                 d.lastSentAccLen = state.accumulatedContent.length;
                 d.lastSentFinalReply = state.finalReply;

package/src/wechat-platform.ts

@@ -66,14 +66,20 @@ export function getIlinkWire(): OpenIlinkWire | null {
 const contextTokenMap = new Map<string, string>();
 /** chatId → 用户未回复时已连发消息数 */
 const consecutiveSendCount = new Map<string, number>();
-/** chatId → claw 限制后等待用户唤醒再补发的最终消息 */
-const pendingClawFinalText = new Map<string, string>();
+/** chatId → 上一次 sendText 成功的时间戳 */
+const lastSendTimeMap = new Map<string, number>();
 const textCardMap = new Map<string, { chatId?: string; text: string; lastSentText: string; lastSentAt: number }>();
 let textCardSeq = 0;
 let platformLog: (msg: string) => void = () => {};
 
 const TEXT_CARD_UPDATE_INTERVAL_MS = 30_000;
 
+/** 微信连发间隔阈值：第5条起限制 ≥ 此值（默认10秒），测试可覆写 */
+let wxMinSendIntervalMs = 10_000;
+export function _setWxMinSendIntervalMsForTest(ms: number): void {
+  wxMinSendIntervalMs = ms;
+}
+
 type WechatWireSender = Pick<OpenIlinkWire, "sendText" | "push">;
 
 export interface WechatAdapterOptions {
@@ -89,7 +95,7 @@ function isFinalReplyText(text: string): boolean {
   return text.includes("━━━ 回答结束 ━━━");
 }
 
-function compressGeneratingText(text: string): string {
+export function compressGeneratingText(text: string): string {
   const lines = text.split("\n");
   if (lines.length <= 10) return text;
   return [...lines.slice(0, 5), "...", ...lines.slice(-5)].join("\n");
@@ -104,38 +110,10 @@ async function sendWechatTextRaw(wire: WechatWireSender, chatId: string, text: s
   }
 }
 
-async function flushPendingClawFinalText(
-  chatId: string,
-  wire: WechatWireSender | null,
-  log: (msg: string) => void,
-): Promise<boolean> {
-  const text = pendingClawFinalText.get(chatId);
-  if (!text || !wire) return false;
-
-  try {
-    await sendWechatTextRaw(wire, chatId, text);
-    pendingClawFinalText.delete(chatId);
-    consecutiveSendCount.set(chatId, 1);
-    log(`[WECHAT] pending final sent after claw wake: chatId=${chatId} len=${text.length}`);
-    return true;
-  } catch (err) {
-    log(`[WECHAT] pending final send failed: ${(err as Error).message}`);
-    return false;
-  }
-}
-
 export function _resetWechatClawStateForTest(): void {
   consecutiveSendCount.clear();
-  pendingClawFinalText.clear();
   contextTokenMap.clear();
-}
-
-export async function _flushPendingClawFinalTextForTest(
-  chatId: string,
-  wire: WechatWireSender | null,
-  log: (msg: string) => void = () => {},
-): Promise<boolean> {
-  return flushPendingClawFinalText(chatId, wire, log);
+  lastSendTimeMap.clear();
 }
 
 // ---------------------------------------------------------------------------
@@ -206,25 +184,29 @@ export function createWechatAdapter(
 
       const isFinal = isFinalReplyText(text);
 
-      // 第10条且非最终消息：附加 claw 限制提示
-      if (count === 10 && !isFinal) {
-        text = text + "\n━━ 后台工作中，由于微信claw机制限制，请唤醒我才能继续发送消息";
+      // 第9条且非最终消息：附加 claw 限制提示，此后禁止继续发送生成消息
+      if (count === 9 && !isFinal) {
+        text = text + "\n---由于微信claw机制限制，不再发送过程，稍后把最终结果发送给你---";
+      }
+
+      // 超过9条后不允许发送非最终消息（生成消息），最终结果消息仍然允许
+      if (count > 9 && !isFinal) {
+        log(`[WECHAT] sendText skipped (claw limit): chatId=${chatId} count=${count}`);
+        return false;
       }
 
-      // 超过10条后不再直接发送。微信端 claw 可能会静默丢弃，即使 iLink 返回 OK。
-      if (count > 10) {
-        if (isFinal) {
-          pendingClawFinalText.set(chatId, text);
-          log(`[WECHAT] final queued (claw limit): chatId=${chatId} count=${count} len=${text.length}`);
-          return true;
-        } else {
-          log(`[WECHAT] sendText skipped (claw limit): chatId=${chatId} count=${count}`);
-          return false;
+      // 第5条起限制发送间隔 ≥ 10 秒（前4条保持原有 3s 显示循环节奏）
+      if (count > 4) {
+        const lastSentAt = lastSendTimeMap.get(chatId) ?? 0;
+        const elapsed = Date.now() - lastSentAt;
+        if (elapsed < wxMinSendIntervalMs) {
+          await new Promise((r) => setTimeout(r, wxMinSendIntervalMs - elapsed));
         }
       }
 
       try {
         await sendWechatTextRaw(wire, chatId, text);
+        lastSendTimeMap.set(chatId, Date.now());
         const preview = text.length > 60 ? text.slice(0, 60) + "..." : text;
         log(`[WECHAT] sendText OK: chatId=${chatId} len=${text.length} count=${count} text="${preview}"`);
         return true;
@@ -619,12 +601,6 @@ async function handleWechatMessage(
   // 用户回复，重置 claw 连发计数
   consecutiveSendCount.set(chatId, 0);
 
-  // 如果上一轮最终消息因 claw 被暂存，这次用户消息只作为唤醒使用。
-  if (pendingClawFinalText.has(chatId)) {
-    await flushPendingClawFinalText(chatId, ilinkWire, platformLog);
-    return;
-  }
-
   // WeChat 中所有会话都视为 p2p，/new 复用 p2p 路径（等同飞书 /newh 效果）
   // 不 await：避免长 prompt 阻塞后续消息处理（如 /cd、/stop 等命令）
   handler(fullText, chatId, chatId, msgTimestamp, "p2p").catch((err) => {