deepccc 0.1.25 → 0.1.26

package/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/dist/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/config.d.ts

@@ -5,6 +5,11 @@ export interface DeepCccConfig {
     apiKey: string;
     baseURL: string;
     model: string;
+    /**
+     * 子模型（可选）：用于内部轻量环节（上下文压缩摘要生成、task 子代理任务）。
+     * 留空（""）时跟随主模型，行为与旧版完全一致。
+     */
+    subModel: string;
     /** Reasoning effort（none/minimal/low/medium/high/xhigh/max），留空不传 reasoning_effort */
     effort: string;
     /** 主对话是否使用流式请求；默认开启 */

package/dist/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/file-tools.d.ts

@@ -1,5 +1,7 @@
 import { type ToolSet } from "ai";
 import { type PermissionGate } from "./permissions.js";
+/** task 子代理工具：子任务结果回传主会话前的最大字符数（防止子代理长输出撑爆主上下文） */
+export declare const MAX_TASK_OUTPUT_CHARS = 32000;
 export interface ReadFileInput {
     path: string;
     startLine?: number;
@@ -155,5 +157,21 @@ export interface BuiltinFileToolsOptions {
         contextDir?: string;
         rawLogsDir?: string;
     };
+    /**
+     * task 子代理工具的执行回调：把独立子任务委派给子会话（使用子模型、独立上下文）。
+     * 未提供时 task 工具不可用（抛出明确错误），主会话之外的工具集不会意外开启子代理。
+     */
+    runTask?: TaskRunner;
+}
+export interface TaskRunnerInput {
+    /** 子任务描述：包含目标、约束与交付物，子代理将以此作为唯一指令。 */
+    description: string;
+    /** 可选子任务工作目录（相对主会话 cwd 或绝对路径），默认继承主会话工作目录。 */
+    cwd?: string;
+}
+export interface TaskRunnerOutput {
+    /** 子代理最终文本回复（已截断到 MAX_TASK_OUTPUT_CHARS，已过隐私替换）。 */
+    result: string;
 }
+export type TaskRunner = (input: TaskRunnerInput, signal?: AbortSignal) => Promise<string>;
 export declare function createBuiltinFileTools(cwd: string, options?: BuiltinFileToolsOptions): ToolSet;

package/dist/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/index.d.ts

@@ -28,6 +28,10 @@ export interface ChatSessionConfig {
     apiKey?: string;
     /** Model id. Defaults to DEEPCCC_MODEL/config. */
     model?: string;
+    /**
+     * 子模型 id（可选）：用于压缩摘要生成与 task 子代理任务。留空跟随主模型。
+     */
+    subModel?: string;
     /**
      * Reasoning effort (none/minimal/low/medium/high/xhigh/max);
      * overrides config.effort; empty omits the reasoning_effort request field.
@@ -115,17 +119,30 @@ interface ChatMessage {
 }
 export declare class ChatSession {
     private model;
+    /** 子模型实例；未配置 subModel 时与主模型同一实例 */
+    private subModel;
     private provider;
+    private apiKey;
+    private baseURL;
+    private modelId;
+    private subModelId;
     private cwd;
     private context;
     private compactionTimeoutMs;
     private maxSteps?;
     private effort;
+    private permissionMode;
+    private permissionResolver?;
     private permissionGate;
     private skillDirs;
     private customSystemPrompt;
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */
     private systemPrompt;
+    /**
+     * task 子代理工具执行器：用子模型开独立子会话（独立上下文、独立 cwd）执行子任务，
+     * 回传最终文本（截断 + 隐私替换）。单层：子会话的工具集不包含 runTask，天然禁止嵌套。
+     */
+    private runTask;
     constructor(overrides?: ChatSessionConfig, options?: ChatSessionOptions);
     /**
      * 组装系统提示词。顺序遵循“稳定性优先”原则（缓存命中友好）：

package/dist/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/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": [