chatccc 0.2.135 → 0.2.137

package/README.md

@@ -205,7 +205,7 @@ ChatCCC 只负责把聊天消息转给本地 AI 工具，不捆绑这些 CLI。
 
 #### Claude Code
 
-本机完成 Claude Code 登录后即可使用。ChatCCC 通过 Anthropic Claude Agent SDK 调用 Claude Code 能力，同时支持官方和第三方 Anthropic 兼容 API：使用官方服务无需额外配置，使用第三方 API 则填写 `claude.apiKey` 和 `claude.baseUrl`。`claude.model`、`claude.subagentModel`、`claude.effort`、`claude.apiKey`、`claude.baseUrl` 均为选填；`claude.maxTurn` 控制每次对话的最大轮数（默认 25）。填写后会把对应配置传给 Claude Agent SDK；留空则以 `~/.claude/settings.json` 为准。
+本机完成 Claude Code 登录后即可使用。ChatCCC 通过 Anthropic Claude Agent SDK 调用 Claude Code 能力，同时支持官方和第三方 Anthropic 兼容 API：使用官方服务无需额外配置，使用第三方 API 则填写 `claude.apiKey` 和 `claude.baseUrl`。`claude.model`、`claude.subagentModel`、`claude.effort`、`claude.apiKey`、`claude.baseUrl` 均为选填；`claude.maxTurn` 控制每次对话的最大轮数（默认 0，即无限制）。填写后会把对应配置传给 Claude Agent SDK；留空则以 `~/.claude/settings.json` 为准。
 
 #### Cursor Agent CLI
 
@@ -283,9 +283,9 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `*.enabled` | 是否启用对应 AI Agent |
 | `*.defaultAgent` | `/new` 未指定 Agent 时使用哪个工具 |
 | `cursor.path` / `codex.path` | CLI 可执行文件路径；留空时自动探测或使用 PATH |
-| `claude.model` / `claude.subagentModel` / `claude.effort` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
-| `claude.apiKey` / `claude.baseUrl` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
-| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 25，可在 Web UI 编辑 |
+| `claude.model` / `claude.subagentModel` / `claude.effort` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
+| `claude.apiKey` / `claude.baseUrl` | 选填；设置后传给 Claude Agent SDK，留空以 `~/.claude/settings.json` 为准 |
+| `claude.maxTurn` | 选填；Claude 最大对话轮数，默认 0（无限制），可在 Web UI 编辑 |
 
 > 当前 ChatCCC 以 `bypassPermissions` 模式运行，会跳过 Agent 操作确认。请只在可信环境中使用。
 

package/agent-prompts/claude_specific.md

@@ -1,53 +1,55 @@
-# Claude-Specific Injection Prompt
-
+# Claude-Specific Injection Prompt
+
 Use this prompt as the Claude Agent SDK injection prompt for this project.
-
-Project workspace:
-
-```text
-f:\users\weizhangjian\feishuclauderprivate
-```
-
-## Repeated Successful Command Guard
-
+
+Project workspace:
+
+```text
+f:\users\weizhangjian\feishuclauderprivate
+```
+
+## Repeated Successful Command Guard
+
 When working in this project through Claude Agent SDK, repeated successful shell commands are a completion signal, not a reason to keep using tools.
-
-A shell command is considered the same command when all of these are true:
-
-- The command text is effectively the same.
-- The working directory is the same.
-- The current task goal has not changed.
-- There is no new user input that changes the task.
-- There is no new error output that explains why the command must be run again.
-
-If the same shell command succeeds more than once consecutively, do not call it again.
-
-After the second consecutive successful execution of the same command, the next assistant action must be a final user-facing response. Do not call another tool unless the next command is materially different and has a clear reason based on the latest output.
-
-This guard applies to all shell commands, including but not limited to:
-
-- test commands
-- build commands
-- git commands
-- install commands
-- formatting commands
-- project scripts
-- status or inspection commands
-
-Do not "verify one more time" by repeating the same successful command. If verification is needed, use a different command that checks a different fact, or explain the current result to the user.
-
-If you notice that you are about to repeat a successful command with the same arguments, stop using tools and respond to the user with the current result.
-
-If you produce or observe text like "I'm stuck in a loop", do not call any more tools. Immediately send the final user-facing response explaining:
-
-- what has completed,
-- what is still uncertain, if anything,
-- and what the user can do next, if action is needed.
-
-## Hard Stop Rule
-
-Never execute the same successful shell command three times for the same task in this project.
-
-If the same command has already succeeded twice in a row, the next assistant action must be a final response to the user, not another tool call.
-
-Successful repeated command execution is a terminal condition. Prefer a concise final response over further tool calls.
+
+A shell command is considered the same command when all of these are true:
+
+- The command text is effectively the same.
+- The working directory is the same.
+- The current task goal has not changed.
+- There is no new user input that changes the task.
+- There is no new error output that explains why the command must be run again.
+
+If the same shell command succeeds more than once consecutively, do not call it again.
+
+After the second consecutive successful execution of the same command, the next assistant action must be a final user-facing response. Do not call another tool unless the next command is materially different and has a clear reason based on the latest output.
+
+This guard applies to all shell commands, including but not limited to:
+
+- test commands
+- build commands
+- git commands
+- install commands
+- formatting commands
+- project scripts
+- status or inspection commands
+
+Do not "verify one more time" by repeating the same successful command. If verification is needed, use a different command that checks a different fact, or explain the current result to the user.
+
+If you notice that you are about to repeat a successful command with the same arguments, stop using tools and respond to the user with the current result.
+
+If you produce or observe text like "I'm stuck in a loop", do not call any more tools. Immediately send the final user-facing response explaining:
+
+- what has completed,
+- what is still uncertain, if anything,
+- and what the user can do next, if action is needed.
+
+## Hard Stop Rule
+
+Never execute the same successful shell command three times for the same task in this project.
+
+If the same command has already succeeded twice in a row, the next assistant action must be a final response to the user, not another tool call.
+
+Successful repeated command execution is a terminal condition. Prefer a concise final response over further tool calls.
+
+如果计划写好了等待你的审阅，将计划文件通过当前聊天软件发给用户

package/agent-prompts/codex_specific.md

@@ -0,0 +1 @@
+如果计划写好了等待你的审阅，将计划文件通过当前聊天软件发给用户

package/agent-prompts/cursor_specific.md

@@ -0,0 +1 @@
+如果计划写好了等待你的审阅，将计划文件通过当前聊天软件发给用户

package/config.sample.json

@@ -18,7 +18,7 @@
     "effort": "",
     "apiKey": "",
     "baseUrl": "",
-    "maxTurn": 25
+    "maxTurn": 20
   },
   "cursor": {
     "enabled": false,

package/package.json

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

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

@@ -47,10 +47,10 @@ const baseAppConfig: AppConfig = {
     defaultAgent: true,
     model: "initial-model",
     subagentModel: "initial-subagent-model",
-    effort: "initial-effort",
-    apiKey: "",
-    baseUrl: "",
-    maxTurn: 25,
+    effort: "initial-effort",
+    apiKey: "",
+    baseUrl: "",
+    maxTurn: 0,
   },
   cursor: { enabled: true, defaultAgent: false, path: "/initial/cursor", model: "initial-cursor-model" },
   codex: { enabled: true, defaultAgent: false, path: "/initial/codex", model: "initial-codex-model", effort: "initial-codex-effort" },
@@ -89,11 +89,11 @@ describe("applyLoadedConfig — 刷新 export let 常量", () => {
         defaultAgent: true,
         model: "claude-sonnet-4-6",
         subagentModel: "claude-haiku-4-5-20251001",
-        effort: "high",
-        apiKey: "sk-test",
-        baseUrl: "https://api.example.com",
-        maxTurn: 25,
-      },
+        effort: "high",
+        apiKey: "sk-test",
+        baseUrl: "https://api.example.com",
+        maxTurn: 0,
+      },
     });
 
     expect(CLAUDE_MODEL).toBe("claude-sonnet-4-6");

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

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeAll, afterAll } from "vitest";
-import { getPlatform, setPlatform, getTenantAccessToken, getChatInfo, createGroupChat, updateChatInfo, sendTextReply, sendCardReply, sendRawCard, sendPostMessage, extractSessionInfo, formatDelayNotice, reportPermissionResults, verifyAllPermissions, addReaction, recallMessage, updateCardMessage, setChatAvatar, disbandChat, sendRestartCard } from "../feishu-platform.ts";
+import { getPlatform, setPlatform, getTenantAccessToken, getChatInfo, createGroupChat, updateChatInfo, sendTextReply, sendCardReply, sendRawCard, sendPostMessage, extractSessionInfo, formatDelayNotice, reportPermissionResults, verifyAllPermissions, addReaction, recallMessage, updateCardMessage, setChatAvatar, disbandChat, sendRestartCard, getMergeForwardMessages } from "../feishu-platform.ts";
 import type { FeishuPlatform } from "../feishu-platform.ts";
 
 const realPlatform = getPlatform();
@@ -35,6 +35,7 @@ describe("feishu-platform", () => {
       extractSessionId: realPlatform.extractSessionId,
       formatDelayNotice: realPlatform.formatDelayNotice,
       sendRestartCard: async () => {},
+      getMergeForwardMessages: async () => [],
     };
 
     setPlatform(mock);
@@ -45,6 +46,8 @@ describe("feishu-platform", () => {
       expect(await getChatInfo("t", "mock_chat")).toEqual({ name: "x", description: "y" });
       const perms = await verifyAllPermissions("t");
       expect(perms).toEqual([]);
+      const mergeMsgs = await getMergeForwardMessages("t", "om_test");
+      expect(mergeMsgs).toEqual([]);
     } finally {
       // 恢复到真实实现，避免影响后续测试
       setPlatform(realPlatform);

package/src/__tests__/format-message.test.ts

@@ -0,0 +1,273 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+
+// Mock feishu-platform 以控制 API 行为
+const mockGetTenantAccessToken = vi.fn();
+const mockGetOrDownloadImage = vi.fn();
+const mockGetMergeForwardMessages = vi.fn();
+
+vi.mock("../feishu-platform.ts", () => ({
+  getTenantAccessToken: (...args: unknown[]) => mockGetTenantAccessToken(...args),
+  getOrDownloadImage: (...args: unknown[]) => mockGetOrDownloadImage(...args),
+  getMergeForwardMessages: (...args: unknown[]) => mockGetMergeForwardMessages(...args),
+}));
+
+import { formatMessageContent, formatPostContent, formatMergeForward } from "../format-message.ts";
+
+describe("formatMessageContent", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetTenantAccessToken.mockResolvedValue("mock_token");
+  });
+
+  it("解析文本消息", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: JSON.stringify({ text: "hello world" }),
+    });
+    expect(result).toBe("hello world");
+  });
+
+  it("去除 HTML 标签", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: JSON.stringify({ text: "<p>你好</p><br/>世界" }),
+    });
+    expect(result).toBe("你好\n世界");
+  });
+
+  it("解析 post 消息", async () => {
+    const result = await formatMessageContent({
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[{ tag: "text", text: "第一条消息" }]],
+      }),
+    });
+    expect(result).toBe("第一条消息");
+  });
+
+  it("解析 post 中的代码块", async () => {
+    const result = await formatMessageContent({
+      message_type: "post",
+      content: JSON.stringify({
+        content: [[{ tag: "code_block", language: "ts", text: "const x = 1;" }]],
+      }),
+    });
+    expect(result).toBe("```ts\nconst x = 1;\n```");
+  });
+
+  it("解析 media 类型返回元数据", async () => {
+    const result = await formatMessageContent({
+      message_id: "om_test",
+      message_type: "media",
+      content: JSON.stringify({ file_key: "fk_001", file_name: "test.mp4" }),
+    });
+    expect(result).toContain("[视频]");
+    expect(result).toContain("om_test");
+    expect(result).toContain("fk_001");
+  });
+
+  it("解析 file 类型返回元数据", async () => {
+    const result = await formatMessageContent({
+      message_id: "om_test",
+      message_type: "file",
+      content: JSON.stringify({ file_key: "fk_001", file_name: "doc.pdf" }),
+    });
+    expect(result).toContain("[文件]");
+    expect(result).toContain("om_test");
+    expect(result).toContain("fk_001");
+  });
+
+  it("未知类型返回原始 JSON", async () => {
+    const result = await formatMessageContent({
+      message_type: "sticker",
+      content: JSON.stringify({ sticker_id: "stk_001" }),
+    });
+    expect(result).toBe(JSON.stringify({ sticker_id: "stk_001" }));
+  });
+
+  it("content 为空时返回空字符串", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+    });
+    expect(result).toBe("");
+  });
+
+  it("content JSON 解析失败返回空字符串", async () => {
+    const result = await formatMessageContent({
+      message_type: "text",
+      content: "not valid json",
+    });
+    expect(result).toBe("");
+  });
+
+  it("merge_forward 的 content 为空时仍能走 API 路径", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root" },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "hello" }) },
+        sender: { id: "ou_001" },
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMessageContent({
+      message_id: "om_mf",
+      message_type: "merge_forward",
+      content: "", // 空字符串
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("hello");
+  });
+});
+
+describe("formatMergeForward", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetTenantAccessToken.mockResolvedValue("mock_token");
+  });
+
+  const preview = [
+    {
+      content: "第一条消息",
+      sender: { id: "ou_001", name: "张三", avatar_url: "" },
+    },
+    {
+      content: "第二条消息",
+      sender: { id: "ou_002", name: "李四", avatar_url: "" },
+    },
+  ];
+
+  it("API 成功：格式化子消息列表", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      // 第一个 item: 合并转发消息自身（无 upper_message_id），会被跳过
+      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "你好" }) },
+        sender: { id: "ou_001" },
+        upper_message_id: "om_root",
+      },
+      {
+        message_id: "om_2",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "在吗" }) },
+        sender: { id: "ou_002" },
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("张三: 你好");
+    expect(result).toContain("李四: 在吗");
+    expect(mockGetMergeForwardMessages).toHaveBeenCalledWith("mock_token", "om_mf");
+  });
+
+  it("API 成功：跳过 merge_forward 自身 item", async () => {
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root", msg_type: "merge_forward", body: { content: "{}" } },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "空聊天记录",
+      preview: [],
+    });
+
+    // API 返回了 items 但只有根消息本身（无子消息），应该降级到 preview（也为空）
+    // → 返回原始 JSON
+    expect(result).toBe(JSON.stringify({ title: "空聊天记录", preview: [] }));
+  });
+
+  it("API 失败：降级使用 preview", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录]");
+    expect(result).toContain("张三: 第一条消息");
+    expect(result).toContain("李四: 第二条消息");
+  });
+
+  it("API 失败 + preview 为空：返回原始 JSON", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("permission denied"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+    });
+
+    expect(result).toBe(JSON.stringify({ title: "聊天记录" }));
+  });
+
+  it("chat_name 出现在标题中", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("no permission"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "聊天记录",
+      chat_name: "技术群",
+      preview,
+    });
+
+    expect(result).toContain("[合并转发: 聊天记录 (技术群)]");
+  });
+
+  it("发送者名称从 preview 映射到 API items", async () => {
+    // API 返回的 sender 只有 id 没有 name，应该从 preview 映射名称
+    mockGetMergeForwardMessages.mockResolvedValue([
+      { message_id: "om_root" },
+      {
+        message_id: "om_1",
+        msg_type: "text",
+        body: { content: JSON.stringify({ text: "测试" }) },
+        sender: { id: "ou_001" }, // 只有 id，无 name
+        upper_message_id: "om_root",
+      },
+    ]);
+
+    const result = await formatMergeForward("om_mf", {
+      title: "测试",
+      preview: [{ content: "", sender: { id: "ou_001", name: "张三" } }],
+    });
+
+    expect(result).toContain("张三: 测试");
+  });
+
+  it("preview 发送者为空时使用默认名称", async () => {
+    mockGetMergeForwardMessages.mockRejectedValue(new Error("fail"));
+
+    const result = await formatMergeForward("om_mf", {
+      title: "测试",
+      preview: [{ content: "消息内容" }],
+    });
+
+    expect(result).toContain("未知用户: 消息内容");
+  });
+
+  it("嵌套合并转发递归深度限制", async () => {
+    // MAX_DEPTH=3，从 depth=3 开始调用应立即返回
+    const result = await formatMergeForward("om_mf", {}, 3);
+    expect(result).toBe("[合并转发: 超出最大嵌套深度 3]");
+  });
+});
+
+describe("formatPostContent", () => {
+  it("返回空段落数组时为空字符串", () => {
+    const result = formatPostContent({});
+    expect(result).toBe("");
+  });
+
+  it("跳过非数组元素", () => {
+    const result = formatPostContent({ content: [null, undefined, "string"] });
+    expect(result).toBe("");
+  });
+});

package/src/adapters/claude-adapter.ts

@@ -327,7 +327,7 @@ class ClaudeAdapter implements ToolAdapter {
     this.baseUrl = options.baseUrl;
     this.isEmpty = options.isEmpty;
     this.metaStore = options.metaStore ?? defaultClaudeSessionMetaStore;
-    this.maxTurn = options.maxTurn ?? 25;
+    this.maxTurn = options.maxTurn ?? 0;
   }
 
   async createSession(cwd: string): Promise<CreateSessionResult> {

package/src/adapters/codex-adapter.ts

@@ -8,8 +8,11 @@
 // =============================================================================
 
 import { spawn, type ChildProcess } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { createInterface } from "node:readline";
 import { randomUUID } from "node:crypto";
+import { fileURLToPath } from "node:url";
 
 import type {
   ToolAdapter,
@@ -26,6 +29,40 @@ import {
 import { killProcessTree } from "./proc-tree-kill.ts";
 import { config } from "../config.ts";
 
+// ---------------------------------------------------------------------------
+// 特殊注入提示
+// ---------------------------------------------------------------------------
+
+const PROJECT_ROOT = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
+const CODEX_SPECIFIC_PROMPT_PATH = join(
+  PROJECT_ROOT,
+  "agent-prompts",
+  "codex_specific.md",
+);
+
+function readCodexSpecificInjectionPrompt(): string | null {
+  try {
+    if (!existsSync(CODEX_SPECIFIC_PROMPT_PATH)) return null;
+    const prompt = readFileSync(CODEX_SPECIFIC_PROMPT_PATH, "utf-8").trim();
+    return prompt.length > 0 ? prompt : null;
+  } catch {
+    return null;
+  }
+}
+
+function buildCodexPromptText(userText: string): string {
+  const prompt = readCodexSpecificInjectionPrompt();
+  if (!prompt) return userText;
+
+  return [
+    "[ChatCCC Codex-specific injection prompt]",
+    prompt,
+    "[/ChatCCC Codex-specific injection prompt]",
+    "",
+    userText,
+  ].join("\n");
+}
+
 // ---------------------------------------------------------------------------
 // 命令与参数
 // ---------------------------------------------------------------------------
@@ -254,7 +291,7 @@ class CodexAdapter implements ToolAdapter {
       ? [...CODEX_BASE_ARGS, "-C", cwd, "-"]
       : [...CODEX_BASE_ARGS, "resume", threadId, "-"];
 
-    const proc = spawnCodex(args, cwd, userText, this.modelOverride);
+    const proc = spawnCodex(args, cwd, buildCodexPromptText(userText), this.modelOverride);
     if (proc.pid !== undefined) options?.onProcessStart?.({ pid: proc.pid });
 
     // 关键：spawn 用了 shell:true，proc.pid 指向的是壳进程（cmd.exe / sh）。

package/src/adapters/cursor-adapter.ts

@@ -6,7 +6,10 @@
 // =============================================================================
 
 import { spawn, type ChildProcess } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
 import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
 
 import type {
   ToolAdapter,
@@ -23,6 +26,40 @@ import {
 } from "./cursor-session-meta-store.ts";
 import { killProcessTree } from "./proc-tree-kill.ts";
 
+// ---------------------------------------------------------------------------
+// 特殊注入提示
+// ---------------------------------------------------------------------------
+
+const PROJECT_ROOT = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
+const CURSOR_SPECIFIC_PROMPT_PATH = join(
+  PROJECT_ROOT,
+  "agent-prompts",
+  "cursor_specific.md",
+);
+
+function readCursorSpecificInjectionPrompt(): string | null {
+  try {
+    if (!existsSync(CURSOR_SPECIFIC_PROMPT_PATH)) return null;
+    const prompt = readFileSync(CURSOR_SPECIFIC_PROMPT_PATH, "utf-8").trim();
+    return prompt.length > 0 ? prompt : null;
+  } catch {
+    return null;
+  }
+}
+
+function buildCursorPromptText(userText: string): string {
+  const prompt = readCursorSpecificInjectionPrompt();
+  if (!prompt) return userText;
+
+  return [
+    "[ChatCCC Cursor-specific injection prompt]",
+    prompt,
+    "[/ChatCCC Cursor-specific injection prompt]",
+    "",
+    userText,
+  ].join("\n");
+}
+
 // ---------------------------------------------------------------------------
 // 类型：Cursor JSONL 消息行
 // ---------------------------------------------------------------------------
@@ -370,7 +407,7 @@ class CursorAdapter implements ToolAdapter {
     options?: ToolPromptOptions,
   ): AsyncIterable<UnifiedStreamMessage> {
     console.log(`[Cursor debug] prompt start: sessionId=${sessionId}, cwd=${cwd}, userTextLen=${userText.length}`);
-    const proc = spawnAgent(["--resume", sessionId], cwd, userText, this.modelOverride);
+    const proc = spawnAgent(["--resume", sessionId], cwd, buildCursorPromptText(userText), this.modelOverride);
     this.activeProcs.add(proc);
     if (proc.pid !== undefined) options?.onProcessStart?.({ pid: proc.pid });
 

package/src/cards.ts

@@ -131,6 +131,8 @@ export function buildHelpCard(
     "发送 **/new cursor** 创建新 Cursor 会话",
     "发送 **/new codex** 创建新 Codex 会话",
     "发送 **/newh** 重置当前会话（沿用当前工作目录，不切换）",
+    "发送 **/plan** 以规划模式提问（只读，不执行写操作）",
+    "发送 **/ask** 以问答模式提问（只读，不执行写操作）",
   ].join("\n");
   return JSON.stringify({
     config: { wide_screen_mode: true },

package/src/config.ts

@@ -65,11 +65,11 @@ export interface ClaudeConfig {
   model: string;
   subagentModel: string;
   effort: string;
-  /** Anthropic API Key（选填，留空则使用 Claude Code 默认认证） */
+  /** Anthropic API Key（选填，留空则使用 Claude Code 默认认证） */
   apiKey: string;
   /** Anthropic 兼容 API Base URL（选填，留空则使用默认端点） */
   baseUrl: string;
-  /** Claude Agent SDK maxTurns 设置，默认 25 */
+  /** Claude Agent SDK maxTurns 设置，默认 0（无限制） */
   maxTurn: number;
 }
 
@@ -326,7 +326,7 @@ function loadConfig(): AppConfig {
     port: 18080,
     gitTimeoutSeconds: 180,
     allowInterrupt: false,
-    claude: { enabled: false, defaultAgent: true, model: "", subagentModel: "", effort: "", apiKey: "", baseUrl: "", maxTurn: 25 },
+    claude: { enabled: false, defaultAgent: true, model: "", subagentModel: "", effort: "", apiKey: "", baseUrl: "", maxTurn: 0 },
     cursor: { enabled: false, defaultAgent: false, path: "", model: "claude-opus-4-7-max" },
     codex: { enabled: false, defaultAgent: false, path: "", model: "", effort: "" },
   };
@@ -472,7 +472,7 @@ function loadConfig(): AppConfig {
       baseUrl: normalizeOptionalConfigField(claude.baseUrl, { label: "claude.baseUrl" }),
       maxTurn: typeof (claude as Record<string, unknown>).maxTurn === "number"
         ? (claude as Record<string, unknown>).maxTurn as number
-        : 25,
+        : 0,
     },
     cursor: {
       enabled: cursorEnabled,

package/src/feishu-api.ts

@@ -18,6 +18,19 @@ import {
   toolDisplayName,
 } from "./config.ts";
 import { applyPrivacy } from "./privacy.ts";
+
+// ---------------------------------------------------------------------------
+// 合并转发消息类型
+// ---------------------------------------------------------------------------
+
+export interface FeishuMessageItem {
+  message_id?: string;
+  msg_type?: string;
+  body?: { content?: string };
+  sender?: { id?: string; id_type?: string };
+  create_time?: string;
+  upper_message_id?: string;
+}
 import { buildHelpCard } from "./cards.ts";
 
 // ---------------------------------------------------------------------------
@@ -97,6 +110,12 @@ const REQUIRED_PERMISSIONS: PermissionDef[] = [
       body: { direction: "vertical", elements: [{ tag: "markdown", content: " " }] },
     }),
   },
+  {
+    scope: "im:message:read",
+    description: "读取合并转发消息中的子消息列表",
+    method: "GET",
+    path: "/im/v1/messages/om_000000000000000000000000000000",
+  },
 ];
 
 interface PermissionResult {
@@ -1046,3 +1065,34 @@ export async function sendPostMessage(
     return false;
   }
 }
+
+// ---------------------------------------------------------------------------
+// 合并转发消息
+// ---------------------------------------------------------------------------
+
+/**
+ * 获取合并转发消息中的子消息列表。
+ *
+ * 对合并转发消息调用 GET /im/v1/messages/{messageId} 时，
+ * 返回 data.items[] 扁平的子消息列表，通过 upper_message_id 构建层级。
+ * 第一个 item（无 upper_message_id）是合并转发消息自身。
+ *
+ * 权限要求: im:message:read
+ */
+export async function getMergeForwardMessages(
+  token: string,
+  messageId: string,
+): Promise<FeishuMessageItem[]> {
+  const resp = await fetch(`${BASE_URL}/im/v1/messages/${messageId}`, {
+    headers: { Authorization: `Bearer ${token}` },
+  });
+  const json = (await resp.json()) as {
+    code: number;
+    msg?: string;
+    data?: { items?: FeishuMessageItem[] };
+  };
+  if (json.code !== 0) {
+    throw new Error(`getMergeForwardMessages [${json.code}] ${json.msg ?? ""}`);
+  }
+  return json.data?.items ?? [];
+}

package/src/feishu-platform.ts

@@ -37,6 +37,7 @@ export interface FeishuPlatform {
   extractSessionId: typeof realApi.extractSessionId;
   formatDelayNotice: typeof realApi.formatDelayNotice;
   sendRestartCard: typeof realApi.sendRestartCard;
+  getMergeForwardMessages: typeof realApi.getMergeForwardMessages;
 }
 
 let _impl: FeishuPlatform = realApi;
@@ -141,4 +142,8 @@ export function sendPostMessage(...args: Parameters<typeof realApi.sendPostMessa
 
 export function sendRestartCard(...args: Parameters<typeof realApi.sendRestartCard>): ReturnType<typeof realApi.sendRestartCard> {
   return _impl.sendRestartCard(...args);
+}
+
+export function getMergeForwardMessages(...args: Parameters<typeof realApi.getMergeForwardMessages>): ReturnType<typeof realApi.getMergeForwardMessages> {
+  return _impl.getMergeForwardMessages(...args);
 }

package/src/format-message.ts

@@ -0,0 +1,214 @@
+/**
+ * format-message.ts — 飞书消息内容格式化
+ *
+ * 从 index.ts 中提取，独立模块便于测试。
+ */
+
+import { cardJsonToPlainText } from "./card-plain-text.ts";
+import { ts } from "./config.ts";
+import {
+  getTenantAccessToken,
+  getOrDownloadImage,
+  getMergeForwardMessages,
+} from "./feishu-platform.ts";
+
+/**
+ * 根据消息类型格式化消息内容为可读文本。
+ */
+export async function formatMessageContent(message: {
+  message_id?: string;
+  message_type?: string;
+  content?: string;
+}): Promise<string> {
+  const contentStr = message.content ?? "{}";
+  let content: Record<string, unknown>;
+  try { content = JSON.parse(contentStr); } catch {
+    // merge_forward 消息的 content 可能为空字符串，但可通过 message_id 调 API 获取子消息
+    if (message.message_type === "merge_forward") {
+      content = {};
+    } else {
+      return "";
+    }
+  }
+
+  if (message.message_type === "text") {
+    let text = (content.text ?? "") as string;
+    text = text.replace(/<\/?p[^>]*>/gi, "");
+    text = text.replace(/<br\s*\/?>/gi, "\n");
+    text = text.replace(/&nbsp;/gi, " ");
+    return text.trim();
+  }
+
+  if (message.message_type === "post") {
+    return formatPostContent(content);
+  }
+
+  if (message.message_type === "image") {
+    const imageKey = content.image_key as string | undefined;
+    const messageId = message.message_id;
+    if (!imageKey || !messageId) return contentStr;
+    try {
+      const token = await getTenantAccessToken();
+      const localPath = await getOrDownloadImage(token, messageId, imageKey);
+      return `[图片] ${localPath}`;
+    } catch (err) {
+      console.error(
+        `[${ts()}] [IMAGE] download failed for ${imageKey}: ${(err as Error).message}`,
+      );
+      return `[图片: ${imageKey}]`;
+    }
+  }
+
+  if (message.message_type === "media") {
+    const fileKey = content.file_key as string | undefined;
+    const fileName = (content.file_name as string) || "video.mp4";
+    const messageId = message.message_id;
+    if (!fileKey || !messageId) return contentStr;
+    return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
+  }
+
+  if (message.message_type === "file") {
+    const fileKey = content.file_key as string | undefined;
+    const fileName = (content.file_name as string) || "download.bin";
+    const messageId = message.message_id;
+    if (!fileKey || !messageId) return contentStr;
+    return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
+  }
+
+  if (message.message_type === "interactive") {
+    const raw = JSON.stringify(content);
+    const text = cardJsonToPlainText(raw);
+    if (text) return `[卡片] ${text}`;
+    return contentStr;
+  }
+
+  if (message.message_type === "merge_forward") {
+    return formatMergeForward(message.message_id ?? "", content);
+  }
+
+  // 其他类型（audio, sticker 等）直接给原始 JSON
+  return contentStr;
+}
+
+export function formatPostContent(content: Record<string, unknown>): string {
+  const paragraphs = content.content as unknown[][];
+  if (!Array.isArray(paragraphs)) return "";
+
+  const parts: string[] = [];
+  for (const line of paragraphs) {
+    if (!Array.isArray(line)) continue;
+    for (const elem of line) {
+      const el = elem as Record<string, unknown>;
+      if (!el || typeof el !== "object") continue;
+      const t = typeof el.text === "string" ? el.text : "";
+
+      if (el.tag === "code_block") {
+        const lang = typeof el.language === "string" ? el.language : "";
+        parts.push("```" + lang + "\n" + t + "\n```");
+      } else if (el.tag === "p" || el.tag === "text") {
+        if (t) parts.push(t);
+      }
+    }
+  }
+  return parts.join("\n").trim();
+}
+
+// ---------------------------------------------------------------------------
+// 合并转发消息格式化
+// ---------------------------------------------------------------------------
+
+/**
+ * 格式化合并转发消息。
+ *
+ * 三阶段降级策略：
+ * 1. 调用 GET /im/v1/messages/{messageId} 获取完整子消息列表
+ * 2. API 失败时降级使用 content.preview 字段
+ * 3. preview 也为空时返回原始 JSON
+ *
+ * 递归深度限制 MAX_DEPTH=3，避免嵌套合并转发 API 爆炸。
+ */
+export async function formatMergeForward(
+  messageId: string,
+  content: Record<string, unknown>,
+  depth: number = 0,
+): Promise<string> {
+  const MAX_DEPTH = 3;
+  if (depth >= MAX_DEPTH) {
+    return `[合并转发: 超出最大嵌套深度 ${MAX_DEPTH}]`;
+  }
+
+  const title = (content.title as string) || "聊天记录";
+  const chatName = (content.chat_name as string) || "";
+  const header = `[合并转发: ${title}${chatName ? ` (${chatName})` : ""}]`;
+
+  // 从 preview 构建 sender ID → name 映射表
+  const senderNameMap = new Map<string, string>();
+  const preview = content.preview;
+  if (Array.isArray(preview)) {
+    for (const entry of preview) {
+      const e = entry as Record<string, unknown>;
+      const s = e.sender as Record<string, unknown> | undefined;
+      if (s && typeof s.id === "string" && typeof s.name === "string") {
+        senderNameMap.set(s.id, s.name);
+      }
+    }
+  }
+
+  const lines: string[] = [];
+  let usedApi = false;
+
+  // Phase 1: 尝试通过 API 获取完整子消息列表
+  try {
+    const token = await getTenantAccessToken();
+    const items = await getMergeForwardMessages(token, messageId);
+
+    // 跳过第一个 item（合并转发消息自身，无 upper_message_id）
+    const subItems = items.filter((item) => item.upper_message_id);
+
+    if (subItems.length > 0) {
+      for (const item of subItems) {
+        const senderId = item.sender?.id ?? "unknown";
+        const senderName = senderNameMap.get(senderId) ?? senderId;
+
+        const subMsgType = item.msg_type ?? "";
+        const subContent = item.body?.content ?? "{}";
+
+        try {
+          const formatted = await formatMessageContent({
+            message_id: item.message_id,
+            message_type: subMsgType,
+            content: subContent,
+          });
+          lines.push(`${senderName}: ${formatted}`);
+        } catch {
+          lines.push(`${senderName}: ${subContent}`);
+        }
+      }
+      usedApi = true;
+    }
+  } catch (err) {
+    console.error(
+      `[${ts()}] [MERGE_FORWARD] API 获取子消息失败 (${messageId}), 降级使用 preview: ${(err as Error).message}`,
+    );
+  }
+
+  // Phase 2: API 失败或返回空时降级使用 preview
+  if (!usedApi) {
+    if (Array.isArray(preview) && preview.length > 0) {
+      for (const entry of preview) {
+        const e = entry as Record<string, unknown>;
+        const s = e.sender as Record<string, unknown> | undefined;
+        const senderName = (s?.name as string) ?? "未知用户";
+        const text = (e.content as string) ?? "";
+        lines.push(`${senderName}: ${text}`);
+      }
+    }
+  }
+
+  // Phase 3: 没有任何内容时返回原始 JSON
+  if (lines.length === 0) {
+    return JSON.stringify(content);
+  }
+
+  return header + "\n" + lines.join("\n");
+}

package/src/index.ts

@@ -69,7 +69,6 @@ import {
   updateCardMessage,
   updateChatInfo,
   disbandChat,
-  getOrDownloadImage,
   sendRestartCard,
   verifyAllPermissions,
   reportPermissionResults,
@@ -182,83 +181,7 @@ function getInnerEvent(data: Evt): InnerEvent {
   return (data.event ?? data) as InnerEvent;
 }
 
-/**
- * 将飞书消息的原始 content JSON 结构转成可读文本，保留代码块等结构信息。
- * 未知类型直接返回 JSON 原文，让 AI 自行理解。
- */
-async function formatMessageContent(message: { message_id?: string; message_type?: string; content?: string }): Promise<string> {
-  const contentStr = message.content ?? "{}";
-  let content: Record<string, unknown>;
-  try { content = JSON.parse(contentStr); } catch { return ""; }
-
-  if (message.message_type === "text") {
-    let text = (content.text ?? "") as string;
-    text = text.replace(/<\/?p[^>]*>/gi, "");
-    text = text.replace(/<br\s*\/?>/gi, "\n");
-    text = text.replace(/&nbsp;/gi, " ");
-    return text.trim();
-  }
-
-  if (message.message_type === "post") {
-    return formatPostContent(content);
-  }
-
-  if (message.message_type === "image") {
-    const imageKey = content.image_key as string | undefined;
-    const messageId = message.message_id;
-    if (!imageKey || !messageId) return contentStr;
-    try {
-      const token = await getTenantAccessToken();
-      const localPath = await getOrDownloadImage(token, messageId, imageKey);
-      return `[图片] ${localPath}`;
-    } catch (err) {
-      console.error(`[${ts()}] [IMAGE] download failed for ${imageKey}: ${(err as Error).message}`);
-      return `[图片: ${imageKey}]`;
-    }
-  }
-
-  if (message.message_type === "media") {
-    const fileKey = content.file_key as string | undefined;
-    const fileName = (content.file_name as string) || "video.mp4";
-    const messageId = message.message_id;
-    if (!fileKey || !messageId) return contentStr;
-    return `[视频] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
-  }
-
-  if (message.message_type === "file") {
-    const fileKey = content.file_key as string | undefined;
-    const fileName = (content.file_name as string) || "download.bin";
-    const messageId = message.message_id;
-    if (!fileKey || !messageId) return contentStr;
-    return `[文件] message_id=${messageId} file_key=${fileKey} file_name=${fileName}`;
-  }
-
-  // 其他类型（audio, sticker 等）直接给原始 JSON
-  return contentStr;
-}
-
-function formatPostContent(content: Record<string, unknown>): string {
-  const paragraphs = content.content as unknown[][];
-  if (!Array.isArray(paragraphs)) return "";
-
-  const parts: string[] = [];
-  for (const line of paragraphs) {
-    if (!Array.isArray(line)) continue;
-    for (const elem of line) {
-      const el = elem as Record<string, unknown>;
-      if (!el || typeof el !== "object") continue;
-      const t = typeof el.text === "string" ? el.text : "";
-
-      if (el.tag === "code_block") {
-        const lang = typeof el.language === "string" ? el.language : "";
-        parts.push("```" + lang + "\n" + t + "\n```");
-      } else if (el.tag === "p" || el.tag === "text") {
-        if (t) parts.push(t);
-      }
-    }
-  }
-  return parts.join("\n").trim();
-}
+import { formatMessageContent } from "./format-message.ts";
 
 // ---------------------------------------------------------------------------
 // Card action helper: parse button click into text command

package/src/sim-platform.ts

@@ -153,6 +153,11 @@ export const SimulatedPlatform: FeishuPlatform = {
   async sendRestartCard(_token) {
     // 模拟模式不需要重启通知
   },
+
+  async getMergeForwardMessages(_token, _messageId) {
+    // 模拟模式没有真实 API，返回空数组让调用方降级到 preview
+    return [];
+  },
 };
 
 /** 模拟模式下的默认 chat_id（重新导出以保持向后兼容） */

package/src/web-ui.ts

@@ -321,7 +321,7 @@ export function unflattenConfig(flat: Record<string, unknown>): Record<string, u
       (result.claude as Record<string, unknown>).baseUrl = val;
     } else if (key === "CHATCCC_ANTHROPIC_MAX_TURN") {
       result.claude = result.claude || {};
-      (result.claude as Record<string, unknown>).maxTurn = parseInt(val as string, 10) || 25;
+      (result.claude as Record<string, unknown>).maxTurn = (function(v){ var n = parseInt(v, 10); return isNaN(n) ? 0 : n; })(val as string);
     } else if (key === "CHATCCC_CLAUDE_ENABLED") {
       result.claude = result.claude || {};
       (result.claude as Record<string, unknown>).enabled = val === true || val === "true";
@@ -646,7 +646,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
             </div>
             <div class="form-group">
               <label>API Key（选填）</label>
-              <input type="password" id="field-CHATCCC_ANTHROPIC_API_KEY" placeholder="留空使用 Claude Code 默认认证">
+              <input type="password" id="field-CHATCCC_ANTHROPIC_API_KEY" placeholder="留空使用 Claude Code 默认认证">
             </div>
             <div class="form-group">
               <label>Base URL（选填）</label>
@@ -788,7 +788,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
         <div class="config-row"><span class="key">Effort</span><span class="val" id="cfg-ANTHROPIC_EFFORT">-</span></div>
         <div class="config-row"><span class="key">API Key</span><span class="val" id="cfg-ANTHROPIC_API_KEY">-</span></div>
         <div class="config-row"><span class="key">Base URL</span><span class="val" id="cfg-ANTHROPIC_BASE_URL">-</span></div>
-        <div class="config-row"><span class="key">Max Turns</span><span class="val" id="cfg-ANTHROPIC_MAX_TURN">-</span></div>
+        <div class="config-row"><span class="key">Max Turns</span><span class="val" id="cfg-ANTHROPIC_MAX_TURN">-</span><span class="hint">(0=无限制)</span></div>
         <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-claude" onchange="setDashboardDefaultAgent('claude', this.checked)"> 设为默认 Agent</label>
         <button class="btn btn-outline" style="margin-top:8px" onclick="editSection('claude')">编辑</button>
       </div>
@@ -1403,7 +1403,7 @@ function updateDashboardUI() {
   document.getElementById('cfg-ANTHROPIC_EFFORT').textContent = (c.claude && c.claude.effort) || '(留空)';
   document.getElementById('cfg-ANTHROPIC_API_KEY').textContent = (c.claude && c.claude.apiKey) ? '***已设置***' : '(留空)';
   document.getElementById('cfg-ANTHROPIC_BASE_URL').textContent = (c.claude && c.claude.baseUrl) || '(留空)';
-  document.getElementById('cfg-ANTHROPIC_MAX_TURN').textContent = (c.claude && c.claude.maxTurn != null) ? String(c.claude.maxTurn) : '25';
+  document.getElementById('cfg-ANTHROPIC_MAX_TURN').textContent = (c.claude && c.claude.maxTurn != null) ? String(c.claude.maxTurn) : '0';
   document.getElementById('cfg-CURSOR_PATH').textContent = (c.cursor && (c.cursor.path || c.cursor.command)) || '-';
   document.getElementById('cfg-CURSOR_MODEL').textContent = (c.cursor && c.cursor.model) || '(留空)';
   document.getElementById('cfg-CODEX_PATH').textContent = (c.codex && (c.codex.path || c.codex.command)) || 'codex';
@@ -1464,7 +1464,7 @@ function editSection(section) {
   var labelMap = {
     'CHATCCC_APP_ID': 'App ID', 'CHATCCC_APP_SECRET': 'App Secret',
     'CHATCCC_ANTHROPIC_MODEL': '模型', 'CHATCCC_ANTHROPIC_SUBAGENT_MODEL': 'Subagent 模型', 'CHATCCC_ANTHROPIC_EFFORT': 'Effort',
-    'CHATCCC_ANTHROPIC_API_KEY': 'API Key', 'CHATCCC_ANTHROPIC_BASE_URL': 'Base URL', 'CHATCCC_ANTHROPIC_MAX_TURN': 'Max Turns',
+    'CHATCCC_ANTHROPIC_API_KEY': 'API Key', 'CHATCCC_ANTHROPIC_BASE_URL': 'Base URL', 'CHATCCC_ANTHROPIC_MAX_TURN': 'Max Turns (0=无限制)',
     'CHATCCC_CURSOR_PATH': 'CLI 路径', 'CHATCCC_CURSOR_MODEL': '模型',
     'CHATCCC_CODEX_PATH': 'CLI 路径', 'CHATCCC_CODEX_MODEL': '模型', 'CHATCCC_CODEX_EFFORT': 'Effort'
   };
@@ -1482,7 +1482,7 @@ function editSection(section) {
         else if (key === 'CHATCCC_ANTHROPIC_EFFORT') val = state.config.claude.effort || '';
         else if (key === 'CHATCCC_ANTHROPIC_API_KEY') val = state.config.claude.apiKey || '';
         else if (key === 'CHATCCC_ANTHROPIC_BASE_URL') val = state.config.claude.baseUrl || '';
-        else if (key === 'CHATCCC_ANTHROPIC_MAX_TURN') val = (state.config.claude.maxTurn != null) ? String(state.config.claude.maxTurn) : '25';
+        else if (key === 'CHATCCC_ANTHROPIC_MAX_TURN') val = (state.config.claude.maxTurn != null) ? String(state.config.claude.maxTurn) : '0';
       } else if (section === 'cursor' && state.config.cursor) {
         if (key === 'CHATCCC_CURSOR_PATH') val = state.config.cursor.path || state.config.cursor.command || '';
         else if (key === 'CHATCCC_CURSOR_MODEL') val = state.config.cursor.model || '';