chatccc 0.2.256 → 0.2.258

package/README.md

@@ -157,7 +157,7 @@ chatccc
 
 Agent Team 提供本地任务看板和项目主 Agent 入口，但暂不根据任务自动分配 Agent。每个规范化后的本机目录对应一个独立项目和看板，固定包含“头脑风暴、Todo、Doing、Done、搁置”五列，支持新增、编辑、拖动排序和删除任务。页面会自动保存，不需要手动提交。当前按路径识别项目，不检查 Git 仓库或 worktree 关系，任意子目录都可以作为独立项目。
 
-打开项目后可以选择 CCC、Claude、Cursor 或 Codex 作为主 Agent。首次设置会创建固定命名为 `主Agent-<目录短名>` 的飞书群和空 Agent Session；后续切换 Agent 或重新关联目录会复用原群，运行中的主 Agent 不允许切换。建群成员取自机器人最近一次收到的飞书私聊；如果尚无私聊记录，网页会提示先给机器人发送任意私聊消息并自动检测。项目群名不会随第一句话或 `/newh` 改变。
+打开项目后可以选择 CCC、Claude、Cursor 或 Codex 作为主 Agent。首次设置会创建固定命名为 `主Agent-<目录短名>` 的飞书群和空 Agent Session；后续切换 Agent 或重新关联目录会复用原群，运行中的主 Agent 不允许切换。建群成员取自机器人最近一次收到的飞书私聊；如果尚无私聊记录，网页会提示先给机器人发送任意私聊消息并自动检测。项目群名不会随第一句话或 `/forget` 改变。
 
 看板数据默认保存在 `~/.chatccc/agent-team/`，其中 `workspaces.json` 保存最近工作目录索引，`boards/` 保存按稳定 ID 分隔的看板 JSON，`main-agent-bindings/` 单独保存本机飞书群与 Session 绑定。目录移动或重命名后，可从最近目录列表重新关联。数据访问通过仓储接口隔离，后续接入飞书多维表格时可增加双向同步适配器，无需把本机群聊和 Session 状态混入任务同步模型。选择目录、创建群聊和启动 Agent 等操作都由本机 Node 后端执行；当前实现不依赖 Electron。
 
@@ -372,6 +372,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `cursor.alternativeModel` / `codex.alternativeModel` / `ccc.alternativeModel` | 单个备选模型；加入 `/model` 人工切换列表，不会自动故障转移 |
 | `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 的 API Key 和服务地址；**不限于 DeepSeek**——可填任意 OpenAI 兼容端点（OpenAI、Kimi、通义、智谱、Ollama 本地等） |
 | `ccc.model` | CCC Agent 默认模型 |
+| `ccc.subModel` | CCC Agent 子模型（选填）：用于内部轻量环节（压缩摘要生成、task 子代理任务）；留空跟随主模型 |
 | `ccc.compactionTimeoutMs` | CCC Agent 上下文压缩单轮超时（毫秒），默认 300000（5 分钟）；压缩超时会让整轮对话失败，建议保持默认或调大 |
 | `ccc.contextWindow` | CCC Agent 模型上下文窗口（token），默认 1048576（1M，DeepSeek V4 Pro/Flash 原生规格）；压缩阈值自动 = 窗口 × 80%；超过模型/服务端实际上限会被 API 拒绝，可在 Web UI 下拉选择或自定义（单位 k） |
 
@@ -396,7 +397,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `/new cursor` | 创建 Cursor 会话；飞书中会创建新群 |
 | `/new codex` | 创建 Codex 会话；飞书中会创建新群 |
 | `/new ccc` | 创建内置 CCC Agent 会话；飞书中会创建新群 |
-| `/newh` | 在当前聊天原地重置会话；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
+| `/forget` | 在当前聊天原地重置会话（忘掉上下文）；群聊保留工作目录，飞书私聊固定使用系统用户目录 |
 | `/model` | 查看或切换当前会话的模型 |
 | `/fast` | 查看当前 Codex 会话的 Fast 模式；使用 `/fast on` 或 `/fast off` 切换 |
 | `/stop` | 停止当前回复 |

package/config.sample.json

@@ -50,6 +50,7 @@
     "DEEPSEEK_API_KEY": "",
     "DEEPSEEK_BASE_URL": "https://api.deepseek.com/v1",
     "model": "deepseek-v4-pro",
+    "subModel": "",
     "alternativeModel": "",
     "effort": "",
     "provider": "",

package/deepccc-agent/README.md

@@ -75,6 +75,7 @@ $env:DEEPCCC_STREAMING="true"
   "apiKey": "sk-...",
   "baseURL": "https://api.deepseek.com/v1",
   "model": "deepseek-v4-pro",
+  "subModel": "",
   "effort": "",
   "streaming": true,
   "contextWindow": 1048576,
@@ -102,6 +103,16 @@ $env:DEEPCCC_STREAMING="true"
 API 拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 的
 `max_input_tokens`）。
 
+`subModel` 是子模型（选填），默认 `""`（留空跟随主模型）。配置后，DeepCCC 内部的轻量
+环节——上下文压缩摘要生成、`task` 子代理任务——使用子模型执行，主对话仍用主模型。
+典型用法：主模型用 pro 承担复杂推理，子模型用 flash 做高频廉价的摘要与子任务。
+可通过 `DEEPCCC_SUB_MODEL` 环境变量或命令行 `--sub-model` 覆盖。
+
+`task` 子代理工具：主模型可把边界清晰的独立子任务（仓库调研、长文档阅读、独立模块生成）
+委派给子代理执行——子代理使用子模型、独立上下文，不污染主对话上下文；结果截断回传。
+子代理**不能再次委派**（禁止嵌套），单轮最多 20 个工具步，超时与主会话压缩超时一致。
+仅在配置了子模型时建议使用（未配置时子代理跟随主模型，节省有限）。
+
 `rawStreamLogs.enabled` 默认 `true`，通过 `DEEPCCC_RAW_STREAM_LOGS` 环境变量或配置 JSON 关闭。
 开启时，每次对话的原始流按 gzip JSONL 落到 `~/.deepccc/raw-stream-logs/`，供
 `session_search` 工具在会话被压缩后找回被压缩消息的精确原文（检索时设置

package/deepccc-agent/package.json

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

package/dist/deepccc-agent/src/cli.js

@@ -57,6 +57,10 @@ function parseArgs(argv = process.argv.slice(2)) {
             config.model = next;
             i++;
         }
+        else if (arg === "--sub-model" && next !== undefined) {
+            config.subModel = next;
+            i++;
+        }
         else if (arg === "--effort" && next !== undefined) {
             config.effort = next;
             i++;
@@ -125,6 +129,7 @@ function printHelp(appConfig) {
         "Options:",
         `  --provider <name>    API protocol: openai or anthropic (current default ${appConfig.provider})`,
         `  --model <name>       Model name (current default ${appConfig.model})`,
+        `  --sub-model <name>   Sub-model for lightweight steps (compaction/task; empty = follow main model)`,
         `  --effort <level>     Reasoning effort: none/minimal/low/medium/high/xhigh/max (overrides config.effort)`,
         `  --base-url <url>     Provider API base URL (current default ${appConfig.baseURL})`,
         "  --api-key <key>      API key",

package/dist/deepccc-agent/src/config.js

@@ -12,6 +12,7 @@ export const DEFAULT_CONFIG = {
     apiKey: "",
     baseURL: "https://api.deepseek.com/v1",
     model: "deepseek-v4-pro",
+    subModel: "",
     effort: "",
     streaming: true,
     contextWindow: 1_048_576,
@@ -66,6 +67,7 @@ function loadConfig() {
         apiKey: env("DEEPCCC_API_KEY") ?? env("DEEPSEEK_API_KEY") ?? file.apiKey ?? DEFAULT_CONFIG.apiKey,
         baseURL: env("DEEPCCC_BASE_URL") ?? env("DEEPSEEK_BASE_URL") ?? file.baseURL ?? DEFAULT_CONFIG.baseURL,
         model: env("DEEPCCC_MODEL") ?? env("DEEPSEEK_MODEL") ?? file.model ?? DEFAULT_CONFIG.model,
+        subModel: env("DEEPCCC_SUB_MODEL") ?? file.subModel ?? DEFAULT_CONFIG.subModel,
         effort: env("DEEPCCC_EFFORT") ?? env("DEEPSEEK_EFFORT") ?? file.effort ?? DEFAULT_CONFIG.effort,
         streaming: boolEnv("DEEPCCC_STREAMING") ?? file.streaming ?? DEFAULT_CONFIG.streaming,
         contextWindow: numberEnv("DEEPCCC_CONTEXT_WINDOW") ?? file.contextWindow ?? DEFAULT_CONFIG.contextWindow,

package/dist/deepccc-agent/src/file-tools.js

@@ -22,6 +22,8 @@ const SEARCH_TIMEOUT_MS = 15_000;
 const MAX_COMMAND_OUTPUT_BYTES = 256 * 1024;
 const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;
 const MAX_COMMAND_TIMEOUT_MS = 900_000;
+/** task 子代理工具：子任务结果回传主会话前的最大字符数（防止子代理长输出撑爆主上下文） */
+export const MAX_TASK_OUTPUT_CHARS = 32_000;
 const requireFromHere = createRequire(import.meta.url);
 const FALLBACK_SKIPPED_DIRECTORIES = new Set([".git", "node_modules"]);
 /**
@@ -939,6 +941,7 @@ export async function applyPatchForTool(cwd, input) {
 }
 export function createBuiltinFileTools(cwd, options = {}) {
     const gate = options.permissionGate;
+    const runTask = options.runTask;
     /** 文件路径的候选匹配键：原始路径 + 绝对路径 + 相对 cwd 路径（正/反斜杠双版本，规则可任选其一） */
     const pathKeys = (p) => {
         const abs = resolveToolPath(cwd, p);
@@ -1023,6 +1026,25 @@ export function createBuiltinFileTools(cwd, options = {}) {
                 return runCommandForTool(cwd, input, options.abortSignal);
             },
         }),
+        task: tool({
+            description: "把独立子任务委派给子代理执行：子代理使用子模型、拥有独立上下文，不污染主对话上下文。适合边界清晰、可独立交付的调研/代码生成子任务（如扫描整个仓库、阅读长文档、生成独立模块）。子代理不能再次委派任务（禁止嵌套），结果会截断回传。",
+            inputSchema: jsonSchema({
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    description: { type: "string", description: "子任务描述：目标、约束与交付物。请写清楚子代理需要返回什么。" },
+                    cwd: { type: "string", description: "可选子任务工作目录（绝对路径或相对主会话 cwd），默认继承主会话工作目录。" },
+                },
+                required: ["description"],
+            }),
+            execute: async (input, execOptions) => {
+                if (!runTask) {
+                    throw new Error("task 工具不可用：当前环境未启用子代理执行器");
+                }
+                const result = await runTask(input, execOptions.abortSignal);
+                return { result };
+            },
+        }),
         edit_file: tool({
             description: "通过精确的 oldText -> newText 替换编辑现有 UTF-8 文本文件。可行时使用 SHA-256 前置条件以避免覆盖并发编辑。",
             inputSchema: jsonSchema({

package/dist/deepccc-agent/src/index.js

@@ -8,12 +8,12 @@ import { createAnthropic } from "@ai-sdk/anthropic";
 import { generateText, isLoopFinished, stepCountIs, streamText } from "ai";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { config as appConfig, normalizeDeepCccProvider, RAW_STREAM_LOGS_DIR, } from "./config.js";
 import { createRawStreamLog, } from "./raw-stream-log.js";
 import { buildPersistedAssistantMessage, buildSummaryPrompt, BuiltinContextManager, defaultBuiltinSessionId, } from "./context.js";
-import { createBuiltinFileTools } from "./file-tools.js";
+import { createBuiltinFileTools, MAX_TASK_OUTPUT_CHARS } from "./file-tools.js";
 import { PermissionGate } from "./permissions.js";
 import { buildDefaultSkillDirs, buildSkillsIndexPrompt, scanSkillsDirs, } from "./skills.js";
 import { applyPrivacy, applyPrivacyToJson } from "./privacy.js";
@@ -76,6 +76,15 @@ const COMPACTION_RECOVERY_HINT_DISABLED = [
 ].join("\n");
 export const DEFAULT_COMPACTION_TIMEOUT_MS = 5 * 60 * 1000;
 const MAX_COMPACTION_OUTPUT_TOKENS = 16_384;
+/** task 子代理工具：子代理单轮对话的最大工具步数（防失控循环，结果收敛后即结束） */
+const TASK_MAX_STEPS = 20;
+/** 子代理最终输出截断：保留前 MAX_TASK_OUTPUT_CHARS 字符，尾部注明截断信息 */
+function truncateTaskOutput(text) {
+    if (text.length <= MAX_TASK_OUTPUT_CHARS)
+        return text;
+    return (text.slice(0, MAX_TASK_OUTPUT_CHARS) +
+        `\n…[子代理输出已截断，共 ${text.length} 字符，仅保留前 ${MAX_TASK_OUTPUT_CHARS} 字符]`);
+}
 const ANTHROPIC_TOOL_JSON_COMPATIBILITY_NOTE = [
     "[Protocol compatibility note]",
     "tool-call arguments use JSON encoding; the final reply does not need to be JSON unless the user requests it.",
@@ -217,17 +226,71 @@ function normalizeAnthropicBaseURL(baseURL) {
 }
 export class ChatSession {
     model;
+    /** 子模型实例；未配置 subModel 时与主模型同一实例 */
+    subModel;
     provider;
+    apiKey;
+    baseURL;
+    modelId;
+    subModelId;
     cwd;
     context;
     compactionTimeoutMs;
     maxSteps;
     effort;
+    permissionMode;
+    permissionResolver;
     permissionGate;
     skillDirs;
     customSystemPrompt;
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */
     systemPrompt = "";
+    /**
+     * task 子代理工具执行器：用子模型开独立子会话（独立上下文、独立 cwd）执行子任务，
+     * 回传最终文本（截断 + 隐私替换）。单层：子会话的工具集不包含 runTask，天然禁止嵌套。
+     */
+    runTask = async (input, signal) => {
+        const rawCwd = input.cwd?.trim();
+        const taskCwd = rawCwd ? (isAbsolute(rawCwd) ? rawCwd : resolve(this.cwd, rawCwd)) : this.cwd;
+        const timeoutController = new AbortController();
+        const timeout = setTimeout(() => timeoutController.abort(), this.compactionTimeoutMs);
+        timeout.unref?.();
+        const taskSignal = signal
+            ? AbortSignal.any([signal, timeoutController.signal])
+            : timeoutController.signal;
+        try {
+            const child = new ChatSession({
+                provider: this.provider,
+                apiKey: this.apiKey,
+                baseURL: this.baseURL,
+                model: this.subModelId || this.modelId,
+                effort: this.effort,
+            }, {
+                cwd: taskCwd,
+                persist: false,
+                permissionMode: this.permissionMode,
+                permissionResolver: this.permissionResolver,
+                maxSteps: TASK_MAX_STEPS,
+                compactionTimeoutMs: this.compactionTimeoutMs,
+                skillsDirs: this.skillDirs.map((s) => s.dir),
+            });
+            let full = "";
+            for await (const event of child.chat(input.description, taskSignal)) {
+                if (event.type === "text") {
+                    full += event.text;
+                }
+                else if (event.type === "error") {
+                    throw new Error(`task 子代理执行失败: ${event.message}`);
+                }
+            }
+            if (!full.trim())
+                return "(子代理未返回文本内容)";
+            return applyPrivacy(truncateTaskOutput(full));
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    };
     constructor(overrides = {}, options = {}) {
         const apiKey = overrides.apiKey ?? appConfig.apiKey;
         if (!apiKey) {
@@ -235,28 +298,32 @@ export class ChatSession {
         }
         const baseURL = overrides.baseURL ?? appConfig.baseURL;
         const modelId = overrides.model ?? appConfig.model;
+        this.modelId = modelId;
+        this.subModelId = (overrides.subModel ?? appConfig.subModel ?? "").trim();
         this.provider = normalizeDeepCccProvider(overrides.provider ?? appConfig.provider);
         this.effort = (overrides.effort ?? appConfig.effort ?? "").trim();
-        if (this.provider === "anthropic") {
-            const provider = createAnthropic({
+        this.apiKey = apiKey;
+        this.baseURL = baseURL;
+        const provider = this.provider === "anthropic"
+            ? createAnthropic({
                 baseURL: normalizeAnthropicBaseURL(baseURL),
                 apiKey,
-            });
-            this.model = provider(modelId);
-        }
-        else {
-            const provider = createOpenAICompatible({
+            })
+            : createOpenAICompatible({
                 name: "deepccc",
                 baseURL,
                 apiKey,
                 includeUsage: true,
             });
-            this.model = provider(modelId);
-        }
+        this.model = provider(modelId);
+        // 子模型：留空时与主模型共用同一实例（行为与旧版完全一致，零开销）
+        this.subModel = this.subModelId ? provider(this.subModelId) : this.model;
         this.cwd = options.cwd ?? process.cwd();
         this.maxSteps = normalizeMaxSteps(options.maxSteps);
         this.compactionTimeoutMs = Math.max(1, options.compactionTimeoutMs ?? DEFAULT_COMPACTION_TIMEOUT_MS);
         this.customSystemPrompt = options.systemPrompt ?? "";
+        this.permissionMode = options.permissionMode ?? "ask";
+        this.permissionResolver = options.permissionResolver;
         // 技能目录在构造时确定；技能内容在每次 chat() 前重新扫描（mtime 热加载），
         // 因此创建/修改技能后下一次对话自动生效，无需重启。
         this.skillDirs =
@@ -271,7 +338,7 @@ export class ChatSession {
             compactAtTokens: options.compactAtTokens,
             keepRecentMessages: options.keepRecentMessages,
         });
-        this.permissionGate = new PermissionGate(options.permissionMode ?? "ask", options.permissionResolver);
+        this.permissionGate = new PermissionGate(this.permissionMode, this.permissionResolver);
     }
     /**
      * 组装系统提示词。顺序遵循“稳定性优先”原则（缓存命中友好）：
@@ -360,7 +427,10 @@ export class ChatSession {
                 model: this.model,
                 system,
                 messages: modelMessages,
-                tools: createBuiltinFileTools(this.cwd, { permissionGate: this.permissionGate }),
+                tools: createBuiltinFileTools(this.cwd, {
+                    permissionGate: this.permissionGate,
+                    runTask: this.runTask,
+                }),
                 stopWhen: maxSteps !== undefined ? stepCountIs(maxSteps) : isLoopFinished(),
                 abortSignal: signal,
                 ...(effortProviderOptions ? { providerOptions: effortProviderOptions } : {}),
@@ -500,7 +570,7 @@ export class ChatSession {
             if (!plan)
                 return 0;
             const result = await generateText({
-                model: this.model,
+                model: this.subModel,
                 system: SUMMARY_SYSTEM_PROMPT,
                 messages: [{ role: "user", content: buildSummaryPrompt(plan) }],
                 abortSignal: compactionSignal,

package/dist/src/adapters/ccc-adapter.js

@@ -27,6 +27,7 @@ export function createCccAdapter(options = {}) {
         ...(options.provider !== undefined ? { provider: options.provider } : {}),
         ...(options.baseURL !== undefined ? { baseURL: options.baseURL } : {}),
         ...(options.model !== undefined ? { model: options.model } : {}),
+        ...(options.subModel !== undefined ? { subModel: options.subModel } : {}),
         ...(options.effort !== undefined ? { effort: options.effort } : {}),
     };
     return {

package/dist/src/card-action-parser.js

@@ -0,0 +1,75 @@
+// ---------------------------------------------------------------------------
+// Card action helper: parse button click into text command
+// ---------------------------------------------------------------------------
+import { buildUpdateCommandId, extractFeishuEventId } from "./update-command-guard.js";
+/**
+ * 卡片按钮 value → 文本命令的映射表。
+ *
+ * 新增 help / progress 卡片按钮时，必须同步在此登记，否则点击会被
+ * parseCardAction 判定为未知 cmd 并静默丢弃（按钮无任何响应）。
+ */
+export const CARD_ACTION_CMD_MAP = {
+    stop: "/stop",
+    cancel: "/cancel",
+    new: "/new",
+    "new claude": "/new claude",
+    "new cursor": "/new cursor",
+    "new codex": "/new codex",
+    "new ccc": "/new ccc",
+    restart: "/restart",
+    update: "/update",
+    state: "/state",
+    cd: "/cd",
+    sessions: "/sessions",
+    forget: "/forget",
+};
+/** 把按钮 cmd 映射为文本命令；未登记返回空字符串。 */
+export function cardActionToCommand(cmd) {
+    return CARD_ACTION_CMD_MAP[cmd] ?? "";
+}
+export function parseCardAction(data) {
+    const raw = data?.event ?? data;
+    const action = raw?.action;
+    if (!action?.value)
+        return null;
+    let cmd;
+    if (typeof action.value === "object" && action.value !== null) {
+        cmd = action.value.action;
+    }
+    else if (typeof action.value === "string") {
+        try {
+            let v = JSON.parse(action.value);
+            if (typeof v === "string")
+                v = JSON.parse(v);
+            cmd = v.cmd ?? v.action;
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!cmd)
+        return null;
+    let text = cardActionToCommand(cmd);
+    if (cmd === "cd" && typeof action.value === "object" && action.value !== null) {
+        const path = action.value.path;
+        if (path)
+            text = `/cd ${path}`;
+    }
+    // cmd 本身就是以 / 开头的完整指令时，直接使用（如 /model <name> 动态按钮）
+    if (!text && cmd.startsWith("/"))
+        text = cmd;
+    if (!text)
+        return null;
+    const chatId = raw.open_chat_id ??
+        raw.context?.open_chat_id ??
+        raw.message?.chat_id ??
+        "";
+    const openId = raw.operator?.open_id ??
+        "";
+    return {
+        text,
+        chatId,
+        openId,
+        commandId: buildUpdateCommandId("card", extractFeishuEventId(data)),
+    };
+}

package/dist/src/cards.js

@@ -137,7 +137,7 @@ export function buildHelpCard(userText, opts = {}) {
         "发送 **/new cursor** 创建新 Cursor 会话",
         "发送 **/new codex** 创建新 Codex 会话",
         "发送 **/new ccc** 创建新 CCC Agent 会话",
-        "发送 **/newh** 重置当前会话（沿用当前工作目录，不切换）",
+        "发送 **/forget** 重置当前会话（忘掉上下文，沿用当前工作目录，不切换）",
         "发送 **/plan** 以规划模式提问（只读，不执行写操作）",
         "发送 **/ask** 以问答模式提问（只读，不执行写操作）",
         "发送 **/usage** 查看当前 Agent 的用量或余额",
@@ -329,8 +329,8 @@ export function buildSessionsCard(sessions, opts = {}) {
             { tag: "div", text: { tag: "lark_md", content: lines.join("\n") } },
             { tag: "hr" },
             { tag: "div", text: { tag: "lark_md", content: fixedPrivateSession
-                        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/newh** 可在私聊中原地重置。群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
-                        : "在会话群内发送 **/newh** 可重置当前会话（创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
+                        ? "当前飞书私聊使用专属会话；默认 Agent 变化后，下一条普通消息会自动创建对应 Agent 的新空会话。发送 **/forget** 可在私聊中原地重置（忘掉当前上下文）。群聊会话请回到对应群聊继续，私聊不支持 **/session** 切换。"
+                        : "在会话群内发送 **/forget** 可重置当前会话（忘掉上下文，创建新 Session，保留工作目录和群聊）。\n发送 **/session 数字**（如 `/session 1`）可将当前群聊切换到列表中对应编号的会话。" } },
             { tag: "hr" },
             {
                 tag: "action",

package/dist/src/config.js

@@ -309,6 +309,7 @@ function loadConfig() {
             DEEPSEEK_API_KEY: "",
             DEEPSEEK_BASE_URL: DEFAULT_CCC_DEEPSEEK_BASE_URL,
             model: DEFAULT_CCC_MODEL,
+            subModel: "",
             alternativeModel: "",
             effort: "",
             provider: "",
@@ -501,6 +502,7 @@ function loadConfig() {
                 fallback: DEFAULT_CCC_DEEPSEEK_BASE_URL,
             }),
             model: normalizeOptionalConfigField(cccRaw.model, { label: "ccc.model", fallback: DEFAULT_CCC_MODEL }),
+            subModel: normalizeOptionalConfigField(cccRaw.subModel, { label: "ccc.subModel" }),
             alternativeModel: normalizeOptionalConfigField(cccRaw.alternativeModel, { label: "ccc.alternativeModel" }),
             effort: normalizeOptionalConfigField(cccRaw.effort, { label: "ccc.effort" }),
             provider: normalizeCccProviderOverride(cccRaw.provider),

package/dist/src/index.js

@@ -113,54 +113,8 @@ function getInnerEvent(data) {
     return (data.event ?? data);
 }
 import { formatMessageContent } from "./format-message.js";
-import { buildUpdateCommandId, extractFeishuEventId, } from "./update-command-guard.js";
-function parseCardAction(data) {
-    const raw = data?.event ?? data;
-    const action = raw?.action;
-    if (!action?.value)
-        return null;
-    let cmd;
-    if (typeof action.value === "object" && action.value !== null) {
-        cmd = action.value.action;
-    }
-    else if (typeof action.value === "string") {
-        try {
-            let v = JSON.parse(action.value);
-            if (typeof v === "string")
-                v = JSON.parse(v);
-            cmd = v.cmd ?? v.action;
-        }
-        catch {
-            return null;
-        }
-    }
-    if (!cmd)
-        return null;
-    const CMD_MAP = { stop: "/stop", cancel: "/cancel", new: "/new", "new claude": "/new claude", "new cursor": "/new cursor", "new codex": "/new codex", restart: "/restart", update: "/update", state: "/state", cd: "/cd", sessions: "/sessions", newh: "/newh" };
-    let text = CMD_MAP[cmd] ?? "";
-    if (cmd === "cd" && typeof action.value === "object" && action.value !== null) {
-        const path = action.value.path;
-        if (path)
-            text = `/cd ${path}`;
-    }
-    // cmd 本身就是以 / 开头的完整指令时，直接使用（如 /model <name> 动态按钮）
-    if (!text && cmd.startsWith("/"))
-        text = cmd;
-    if (!text)
-        return null;
-    const chatId = raw.open_chat_id ??
-        raw.context?.open_chat_id ??
-        raw.message?.chat_id ??
-        "";
-    const openId = raw.operator?.open_id ??
-        "";
-    return {
-        text,
-        chatId,
-        openId,
-        commandId: buildUpdateCommandId("card", extractFeishuEventId(data)),
-    };
-}
+import { buildUpdateCommandId } from "./update-command-guard.js";
+import { parseCardAction } from "./card-action-parser.js";
 // ---------------------------------------------------------------------------
 // WebSocket relay broadcast
 // ---------------------------------------------------------------------------

package/dist/src/orchestrator.js

@@ -1021,7 +1021,7 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
         // /new 始终创建独立群聊。飞书私聊自己的常驻 session 不在这里切换。
         if (chatType === "p2p" && platform.kind === "wechat") {
             // 先解绑旧 session（如果存在），避免旧 session 的 display loop
-            // 继续往同一个 chat 推送内容（/newh 走 switchChatBinding 已有此逻辑，
+            // 继续往同一个 chat 推送内容（/forget 走 switchChatBinding 已有此逻辑，
             // 但 /new p2p 之前遗漏了解绑）。
             const oldRegistry = await loadSessionRegistryForBinding();
             const oldRecord = oldRegistry[chatId];
@@ -1056,7 +1056,7 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
                 `直接在这里发消息即可与 ${toolLabel} 对话。\n\n` +
                 `发送 **/cd** 切换新建会话的默认目录。\n` +
                 `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(tool)}\n` +
-                `发送 **/new** 创建新会话，**/newh** 重置当前会话（沿用工作目录）。\n` +
+                `发送 **/new** 创建新会话，**/forget** 重置当前会话（沿用工作目录）。\n` +
                 `发送 **/sessions** 查看所有会话状态。\n` +
                 `发送 \`/git <子命令>\` 在本会话工作目录执行 git，例如 \`/git status\`、\`/git log --oneline -n 5\`。` +
                 usageHelpLine(tool), "green");
@@ -1117,7 +1117,7 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
             `直接在这里发消息即可与 ${toolLabel} 对话。\n\n` +
             `发送 **/cd** 切换新建会话的默认目录。\n` +
             `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(tool)}\n` +
-            `发送 **/new** 创建新会话，**/newh** 重置当前会话（沿用工作目录）。\n` +
+            `发送 **/new** 创建新会话，**/forget** 重置当前会话（沿用工作目录）。\n` +
             `发送 **/sessions** 查看所有会话状态。\n` +
             `发送 \`/git <子命令>\` 在本会话工作目录执行 git，例如 \`/git status\`、\`/git log --oneline -n 5\`。` +
             usageHelpLine(tool), "green");
@@ -1413,12 +1413,12 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
             logTrace(tid, "DONE", { outcome: "sessions", ok, count: cardData.length });
             return;
         }
-        if (isCommandText && textLower === "/newh") {
-            logTrace(tid, "BRANCH", { cmd: "/newh" });
+        if (isCommandText && textLower === "/forget") {
+            logTrace(tid, "BRANCH", { cmd: "/forget" });
             let cwd;
             if (isFeishuP2p(platform, chatType)) {
                 // 飞书私聊不支持切换工作目录。即使 /cd 已为后续 /new 群聊
-                // 保存了其他默认目录，/newh 仍必须在运行 ChatCCC 的用户目录重建。
+                // 保存了其他默认目录，/forget 仍必须在运行 ChatCCC 的用户目录重建。
                 cwd = homedir();
             }
             else {
@@ -1440,7 +1440,7 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
             }
             catch (err) {
                 logTrace(tid, "DONE", {
-                    outcome: "newh_session_fail",
+                    outcome: "forget_session_fail",
                     error: err.message,
                 });
                 await platform.sendCard(chatId, "Error", `Failed to create new session:\n${err.message}`, "red");
@@ -1463,14 +1463,14 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
             });
             if (!switchResult.ok) {
                 logTrace(tid, "DONE", {
-                    outcome: "newh_update_chat_fail",
+                    outcome: "forget_update_chat_fail",
                     error: switchResult.error?.message,
                 });
                 await platform.sendCard(chatId, "Error", `更新群描述失败,会话未切换(新 session 已创建但未启用):\n${switchResult.error?.message}`, "red");
                 return;
             }
             if (chatType !== "p2p") {
-                console.log(`[${ts()}] [NEWH] Group updated: name="${newName}" desc="${descPrefix} ${newSessionId}"`);
+                console.log(`[${ts()}] [FORGET] Group updated: name="${newName}" desc="${descPrefix} ${newSessionId}"`);
             }
             setChatAvatarForSession(platform, chatId, descriptionTool, "new", newSessionId).catch(() => { });
             await platform.sendCard(chatId, `${toolLabel} Session Reset`, `会话已重置为新的 **${toolLabel}** 会话。\n\n` +
@@ -1479,8 +1479,8 @@ export async function handleCommand(platform, text, chatId, openId, msgTimestamp
                 `直接在这里发消息即可继续对话。\n` +
                 `发送 **/cd** 可切换新建会话的默认目录。\n` +
                 `发送 **/model** 查看或切换当前会话的模型。${fastHelpAfterModel(descriptionTool)}`, "green");
-            console.log(`[${ts()}] [NEWH] Session ${sessionId} → ${newSessionId} (same cwd=${cwd})`);
-            logTrace(tid, "DONE", { outcome: "newh", newSessionId, cwd });
+            console.log(`[${ts()}] [FORGET] Session ${sessionId} → ${newSessionId} (same cwd=${cwd})`);
+            logTrace(tid, "DONE", { outcome: "forget", newSessionId, cwd });
             return;
         }
         if (isCommandText && textLower === "/deleteg") {

package/dist/src/session-chat-binding.js

@@ -30,7 +30,7 @@ export function unbindChatFromSession(sessionId, chatId) {
             sessionChatsMap.delete(sessionId);
     }
     // 双保险：lastActiveChatMap 是 sessionId → 最后活跃 chatId 的快照，
-    // 若被解绑的 chatId 正好是该 session 的 lastActive（典型场景：/newh
+    // 若被解绑的 chatId 正好是该 session 的 lastActive（典型场景：/forget
     // 把当前群从旧 session 改嫁到新 session），不清理会让旧 session 的
     // display loop 继续向已离开的群推送卡片。
     if (lastActiveChatMap.get(sessionId)?.chatId === chatId) {
@@ -99,7 +99,7 @@ export function getLastActiveChat(sessionId) {
  * display loop 决定推送目标 chat 的纯函数：
  * 仅当 lastActiveChat 仍然绑定到该 session 时才返回，否则返回 undefined。
  *
- * 修复 bug：用户 `/newh` 把当前群从旧 session 改嫁到新 session 后，旧
+ * 修复 bug：用户 `/forget` 把当前群从旧 session 改嫁到新 session 后，旧
  * session 的 lastActiveChatMap 残留旧 chatId 快照，display loop 会继续
  * 在该群创建/更新卡片。这里通过交叉验证 sessionChatsMap 把这种悬挂记录
  * 排除掉——loop 拿到 undefined 就走"无活跃群"分支自然停推。

package/dist/src/session.js

@@ -533,6 +533,7 @@ export function getAdapterForTool(tool, sessionId) {
             contextWindow: config.ccc.contextWindow,
             // 留空（""）不传 → ChatSession 跟随 DeepCCC 内核配置（~/.deepccc/config.json 或 DEEPCCC_PROVIDER）
             ...(config.ccc.provider ? { provider: config.ccc.provider } : {}),
+            ...(config.ccc.subModel ? { subModel: config.ccc.subModel } : {}),
         });
     }
     else {
@@ -1622,7 +1623,7 @@ export function startUnifiedDisplayLoop() {
                         continue;
                     }
                     // 交叉验证：chat 当前绑定的 session 是否仍是 display 记录的 session。
-                    // 若 chat 已被切换到其他 session（如 /newh），旧 display 必须停推。
+                    // 若 chat 已被切换到其他 session（如 /forget），旧 display 必须停推。
                     const currentSessionForChat = sessionInfoMap.get(chatId)?.sessionId;
                     if (currentSessionForChat && currentSessionForChat !== sessionId) {
                         if (state.status !== "running") {

package/dist/src/web-ui.js

@@ -483,6 +483,10 @@ export function unflattenConfig(flat) {
             result.ccc = result.ccc || {};
             result.ccc.model = val;
         }
+        else if (key === "CHATCCC_CCC_SUB_MODEL") {
+            result.ccc = result.ccc || {};
+            result.ccc.subModel = val;
+        }
         else if (key === "CHATCCC_CCC_ALTERNATIVE_MODEL") {
             result.ccc = result.ccc || {};
             result.ccc.alternativeModel = val;
@@ -864,6 +868,10 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
               <label>模型</label>
               <input type="text" id="field-CHATCCC_CCC_MODEL" placeholder="deepseek-v4-pro">
             </div>
+            <div class="form-group">
+              <label>子模型（选填）</label>
+              <input type="text" id="field-CHATCCC_CCC_SUB_MODEL" placeholder="留空跟随主模型；用于压缩摘要、子代理任务等轻量环节">
+            </div>
             <div class="form-group">
               <label>备选模型（选填）</label>
               <input type="text" id="field-CHATCCC_CCC_ALTERNATIVE_MODEL" placeholder="加入 /model 列表，便于会话内切换">
@@ -1178,6 +1186,7 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
         <div class="config-row"><span class="key">Base URL</span><span class="val" id="cfg-CCC_BASE_URL">-</span></div>
         <div class="config-row"><span class="key">API 协议</span><span class="val" id="cfg-CCC_PROVIDER">-</span></div>
         <div class="config-row"><span class="key">模型</span><span class="val" id="cfg-CCC_MODEL">-</span></div>
+        <div class="config-row"><span class="key">子模型</span><span class="val" id="cfg-CCC_SUB_MODEL">-</span></div>
         <div class="config-row"><span class="key">备选模型</span><span class="val" id="cfg-CCC_ALTERNATIVE_MODEL">-</span></div>
         <label class="agent-default-row" style="margin-top:10px"><input type="checkbox" id="dash-default-ccc" onchange="setDashboardDefaultAgent('ccc', this.checked)"> 设为默认 Agent</label>
         <div class="hint" style="margin-top:6px;line-height:1.6">备选模型仅加入 /model 人工切换列表；保存后下一条消息或下个新会话生效。</div>
@@ -1229,7 +1238,7 @@ const AGENT_FIELDS = {
   claude: ['CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT','CHATCCC_ANTHROPIC_API_KEY','CHATCCC_ANTHROPIC_BASE_URL','CHATCCC_ANTHROPIC_MAX_TURN'],
   cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_ALTERNATIVE_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
   codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_ALTERNATIVE_MODEL','CHATCCC_CODEX_EFFORT','CHATCCC_CODEX_FAST_MODE'],
-  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER','CHATCCC_CCC_CONTEXT_WINDOW']
+  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_SUB_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER','CHATCCC_CCC_CONTEXT_WINDOW']
 };
 const FEISHU_FIELDS = ['CHATCCC_APP_ID','CHATCCC_APP_SECRET'];
 const WEB_UI_FIELDS = ['CHATCCC_WEB_UI_OPEN_ON_START'];
@@ -1616,6 +1625,7 @@ function renderStep2() {
     prefillNested('field-CHATCCC_CCC_BASE_URL', c.ccc.DEEPSEEK_BASE_URL);
     prefillNested('field-CHATCCC_CCC_PROVIDER', c.ccc.provider);
     prefillNested('field-CHATCCC_CCC_MODEL', c.ccc.model);
+    prefillNested('field-CHATCCC_CCC_SUB_MODEL', c.ccc.subModel);
     prefillNested('field-CHATCCC_CCC_ALTERNATIVE_MODEL', c.ccc.alternativeModel);
     prefillNested('field-CHATCCC_CCC_EFFORT', c.ccc.effort);
     prefillContextWindow('field-', c.ccc.contextWindow);
@@ -1802,6 +1812,7 @@ function renderStep3() {
       lines.push('<div class="config-row"><span class="key">API Key</span><span class="val">' + (vars.CHATCCC_CCC_API_KEY ? '***已设置***' : '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Base URL</span><span class="val">' + (vars.CHATCCC_CCC_BASE_URL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_CCC_MODEL || '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">子模型</span><span class="val">' + (vars.CHATCCC_CCC_SUB_MODEL || '(留空，跟随主模型)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CCC_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CCC_EFFORT || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">上下文窗口</span><span class="val">' + contextWindowTokensLabel(vars.CHATCCC_CCC_CONTEXT_WINDOW || 1048576) + '</span></div>');
@@ -2023,6 +2034,7 @@ function updateDashboardUI() {
   document.getElementById('cfg-CCC_BASE_URL').textContent = (c.ccc && c.ccc.DEEPSEEK_BASE_URL) || '(留空)';
   document.getElementById('cfg-CCC_PROVIDER').textContent = (c.ccc && c.ccc.provider) ? c.ccc.provider : '(跟随 DeepCCC 内核配置)';
   document.getElementById('cfg-CCC_MODEL').textContent = (c.ccc && c.ccc.model) || '(留空)';
+  document.getElementById('cfg-CCC_SUB_MODEL').textContent = (c.ccc && c.ccc.subModel) || '(留空，跟随主模型)';
   document.getElementById('cfg-CCC_ALTERNATIVE_MODEL').textContent = (c.ccc && c.ccc.alternativeModel) || '(留空)';
 }
 
@@ -2100,7 +2112,7 @@ function editSection(section) {
     'CHATCCC_CODEX_FAST_MODE': 'Fast 模式',
     'CHATCCC_CCC_API_KEY': 'API Key', 'CHATCCC_CCC_BASE_URL': 'Base URL',
     'CHATCCC_CCC_PROVIDER': 'API 协议（选填）',
-    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort', 'CHATCCC_CCC_CONTEXT_WINDOW': '上下文窗口'
+    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_SUB_MODEL': '子模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort', 'CHATCCC_CCC_CONTEXT_WINDOW': '上下文窗口'
   };
   var hintMap = {
     'CHATCCC_WEB_UI_OPEN_ON_START': '关闭后可继续手动访问 http://localhost:<端口>/；/restart、/update 和 Web UI 重启无论此项为何值都不会自动打开。',
@@ -2108,7 +2120,8 @@ function editSection(section) {
     'CHATCCC_CHROME_DEVTOOLS_PORT': '默认 15166，健康检查端点为 http://127.0.0.1:15166/json/version。',
     'CHATCCC_CHROME_DEVTOOLS_PATH': '选填。留空时自动探测 Google Chrome。',
     'CHATCCC_CCC_PROVIDER': '与 Base URL 强相关：OpenAI 兼容端点选 openai；Anthropic Messages 端点选 anthropic。留空 = 跟随 DeepCCC 内核配置（~/.deepccc/config.json 或 DEEPCCC_PROVIDER），改动需重启 ChatCCC 生效。',
-    'CHATCCC_CCC_CONTEXT_WINDOW': '压缩阈值自动 = 窗口 × 80%（超出即把较早消息压缩为摘要）。⚠️ 超过模型/服务端实际上限时请求会被 API 直接拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 代理的 max_input_tokens）；单位 k = 1024 tokens，1M = 1,048,576 tokens。'
+    'CHATCCC_CCC_CONTEXT_WINDOW': '压缩阈值自动 = 窗口 × 80%（超出即把较早消息压缩为摘要）。⚠️ 超过模型/服务端实际上限时请求会被 API 直接拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 代理的 max_input_tokens）；单位 k = 1024 tokens，1M = 1,048,576 tokens。',
+    'CHATCCC_CCC_SUB_MODEL': '用于 DeepCCC 内部轻量环节（上下文压缩摘要生成、task 子代理任务）。留空 = 跟随主模型；改动需重启 ChatCCC 生效。'
   };
 
   if (section === 'chromeDevtools') {
@@ -2152,6 +2165,7 @@ function editSection(section) {
         else if (key === 'CHATCCC_CCC_BASE_URL') val = state.config.ccc.DEEPSEEK_BASE_URL || '';
         else if (key === 'CHATCCC_CCC_PROVIDER') val = state.config.ccc.provider || '';
         else if (key === 'CHATCCC_CCC_MODEL') val = state.config.ccc.model || '';
+        else if (key === 'CHATCCC_CCC_SUB_MODEL') val = state.config.ccc.subModel || '';
         else if (key === 'CHATCCC_CCC_ALTERNATIVE_MODEL') val = state.config.ccc.alternativeModel || '';
         else if (key === 'CHATCCC_CCC_EFFORT') val = state.config.ccc.effort || '';
         else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') val = state.config.ccc.contextWindow || '1048576';

package/dist/src/wechat-platform.js

@@ -537,7 +537,7 @@ async function handleWechatMessage(message, handler) {
     appendChatLog(chatId, chatId, fullText);
     // 用户回复，重置 claw 连发计数
     consecutiveSendCount.set(chatId, 0);
-    // WeChat 中所有会话都视为 p2p，/new 复用 p2p 路径（等同飞书 /newh 效果）
+    // WeChat 中所有会话都视为 p2p，/new 复用 p2p 路径（等同飞书 /forget 效果）
     // 不 await：避免长 prompt 阻塞后续消息处理（如 /cd、/stop 等命令）
     handler(fullText, chatId, chatId, msgTimestamp, "p2p").catch((err) => {
         platformLog(`消息处理失败: ${err.stack ?? err.message}`);

package/package.json

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