deepccc 0.1.27 → 0.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 `deepccc` 是一个轻量级本地编程 Agent，针对 DeepSeek 使用体验做了优化，同时支持其他 OpenAI-compatible 模型接口。
 
-它提供交互式命令行、JSONL 流式输出、本地文件工具、命令执行、项目提示词自动注入和持久化上下文。
+它提供本地 Web UI、交互式命令行、JSONL 流式输出、本地文件工具、命令执行、项目提示词自动注入和持久化上下文。
 
 ## 当前状态
 
@@ -46,8 +46,10 @@ deepccc 的本地缓存优化实测命中率 **96.7%**，有效降低重复请
 ```bash
 export DEEPCCC_API_KEY="sk-..."
 export DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-export DEEPCCC_MODEL="deepseek-v4-pro"
-export DEEPCCC_STREAMING="true"
+export DEEPCCC_MODEL="deepseek-v4-pro"
+export DEEPCCC_EFFORT="high"
+export DEEPCCC_MAX_OUTPUT_TOKENS="32768"
+export DEEPCCC_STREAMING="true"
 ```
 
 Windows PowerShell：
@@ -56,8 +58,10 @@ Windows PowerShell：
 $env:DEEPCCC_API_KEY="sk-..."
 $env:DEEPCCC_PROVIDER="openai"
 $env:DEEPCCC_BASE_URL="https://api.deepseek.com/v1"
-$env:DEEPCCC_MODEL="deepseek-v4-pro"
-$env:DEEPCCC_STREAMING="true"
+$env:DEEPCCC_MODEL="deepseek-v4-pro"
+$env:DEEPCCC_EFFORT="high"
+$env:DEEPCCC_MAX_OUTPUT_TOKENS="32768"
+$env:DEEPCCC_STREAMING="true"
 ```
 
 也兼容这些 DeepSeek 别名：
@@ -75,27 +79,64 @@ $env:DEEPCCC_STREAMING="true"
   "apiKey": "sk-...",
   "baseURL": "https://api.deepseek.com/v1",
   "model": "deepseek-v4-pro",
-  "subModel": "",
-  "effort": "",
-  "streaming": true,
+  "subModel": "",
+  "effort": "",
+  "maxOutputTokens": null,
+  "streaming": true,
   "contextWindow": 1048576,
-  "rawStreamLogs": {
+  "git": {
+    "coAuthor": {
+      "enabled": true,
+      "name": "DeepCCC",
+      "email": "20184052+wzj998@users.noreply.github.com"
+    }
+  },
+  "rawStreamLogs": {
     "enabled": true,
     "maxBytesPerTurn": 1048576,
     "retentionDays": 7,
-    "keepCompleted": false
-  }
-}
-```
+    "keepCompleted": false
+  },
+  "web": {
+    "port": 28080,
+    "openOnStart": true
+  }
+}
+```
+
+## Web UI
+
+全局安装后可以直接启动本地网页版：
+
+```bash
+deepccc web
+```
+
+默认只监听 `http://127.0.0.1:28080/`，不会暴露到局域网。可在
+`~/.deepccc/config.json` 的 `web.port` 修改端口，`web.openOnStart` 控制启动时是否自动打开浏览器；也可以临时使用 `deepccc web --port 28081 --no-open`。
+
+Web UI 支持新建、恢复、重命名和删除多会话，多个会话可以同时运行，即使它们指向同一个工作目录。每个会话可独立选择 model、subModel 和 effort，并持续复用 CLI 已保存的历史。注意：当前版本不自动创建 Git worktree；同目录的多个运行中 Agent 直接修改同一组文件，页面会提示覆盖与冲突风险。
+
+API 设置采用单一 Provider 配置，支持 OpenAI-compatible 与 Anthropic Messages。完整 API Key 只保存在本机 `~/.deepccc/config.json`，浏览器读取设置时仅返回掩码。高风险命令会在网页中暂停并请求“拒绝、允许一次、本会话允许、永久允许”，浏览器断开或审批超时默认拒绝。
+
+`git.coAuthor.enabled` 默认开启。DeepCCC 通过 `run_command` 创建 Git 提交时会保留用户为
+主 Author，并追加 `Co-authored-by: DeepCCC <20184052+wzj998@users.noreply.github.com>`。
+可设为 `false` 或用 `DEEPCCC_GIT_COAUTHOR=false` 全局关闭。ChatCCC 的
+`ccc.gitCoAuthor` 是三态 override：`null`/缺失跟随这里，`true` 强制开启，`false` 强制关闭。
 
 `provider` 可选 `openai` 或 `anthropic`，默认 `openai`，也可以通过
 `DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖：
 
 - `openai` 使用 OpenAI-compatible Chat Completions 协议，兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
-- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` **完全按填写值使用，不自动补 `/v1`**，请填写到完整版本化地址，例如 DeepSeek 官方 Anthropic 端点为 `https://api.deepseek.com/anthropic/v1`（官方 Anthropic SDK 使用的 `https://api.deepseek.com/anthropic` 基址会拼接为 `.../anthropic/v1/messages`）。`effort` 是 OpenAI/DeepSeek 扩展参数，在 Anthropic 模式下不会发送。
+- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` **完全按填写值使用，不自动补 `/v1`**，请填写到完整版本化地址，例如 DeepSeek 官方 Anthropic 端点为 `https://api.deepseek.com/anthropic/v1`（官方 Anthropic SDK 使用的 `https://api.deepseek.com/anthropic` 基址会拼接为 `.../anthropic/v1/messages`）。`effort` 在 OpenAI-compatible 模式映射为 `reasoning_effort`，在 Anthropic 模式映射为 `output_config.effort`；目标服务不支持时应留空。
 
-`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
-`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+`streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
+`DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
+
+`maxOutputTokens` 限制主对话单次最大输出 token，默认不配置（`null`/缺失），此时不向
+Provider 发送 `max_tokens`，使用模型服务端默认值。可通过 `DEEPCCC_MAX_OUTPUT_TOKENS`
+或命令行 `--max-output-tokens` 覆盖；只接受正整数。该限制会同时覆盖模型思考内容、
+工具参数和最终回答，设置过小可能导致工具调用或长回复被截断。
 
 `contextWindow` 是模型上下文窗口（token），默认 `1048576`（1M，DeepSeek V4 Pro/Flash
 原生规格）；上下文压缩阈值自动 = `contextWindow × 0.8`（超出即把较早消息压缩为摘要）。
@@ -166,7 +207,15 @@ deepccc --max-steps 20
 deepccc --effort high
 ```
 
-可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
+可选值：`none` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`（留空则不传 `reasoning_effort` 请求字段）。
+
+限制主对话最大输出 token：
+
+```bash
+deepccc --max-output-tokens 8192
+```
+
+不设置时使用 Provider 默认值。
 
 ## 权限机制
 

package/dist/cli.d.ts

@@ -5,6 +5,7 @@
  *   node bin/deepccc.mjs
  *   node bin/deepccc.mjs --model deepseek-v4-pro
  *   node bin/deepccc.mjs --stream-json --prompt "hello"
+ *   node bin/deepccc.mjs web
  *
  * 交互模式（TTY）下，单轮回复渲染为固定"过程区块"：状态行 + 折叠工具行 +
  * 原地更新正文，不再滚屏刷 JSON；完成/停止/异常后定型留在屏幕上。

package/dist/cli.js

@@ -5,6 +5,7 @@
  *   node bin/deepccc.mjs
  *   node bin/deepccc.mjs --model deepseek-v4-pro
  *   node bin/deepccc.mjs --stream-json --prompt "hello"
+ *   node bin/deepccc.mjs web
  *
  * 交互模式（TTY）下，单轮回复渲染为固定"过程区块"：状态行 + 折叠工具行 +
  * 原地更新正文，不再滚屏刷 JSON；完成/停止/异常后定型留在屏幕上。
@@ -65,6 +66,10 @@ function parseArgs(argv = process.argv.slice(2)) {
             config.effort = next;
             i++;
         }
+        else if (arg === "--max-output-tokens" && next !== undefined) {
+            config.maxOutputTokens = parsePositiveIntegerOption("--max-output-tokens", next);
+            i++;
+        }
         else if (arg === "--base-url" && next !== undefined) {
             config.baseURL = next;
             i++;
@@ -131,6 +136,7 @@ function printHelp(appConfig) {
         `  --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)`,
+        `  --max-output-tokens <n>  Maximum output tokens (unset = Provider default)`,
         `  --base-url <url>     Provider API base URL (current default ${appConfig.baseURL})`,
         "  --api-key <key>      API key",
         "  --cwd <path>         Working directory",
@@ -140,6 +146,7 @@ function printHelp(appConfig) {
         "  --stream-json        One-shot mode: write JSONL events to stdout",
         "  --prompt <text>      Prompt text for --stream-json",
         "  --plain              Force plain streaming output (no progress block renderer)",
+        "  web                   Start the local Web UI (default http://127.0.0.1:28080)",
         "  --dangerously-bypass-permissions  Skip all permission prompts (aligns with chatccc's bypass mode)",
         "  --help, -h           Show help",
         "",
@@ -603,6 +610,21 @@ function runSkillCreate(argv) {
     console.log("hot reload: 下一次对话自动生效，无需重启");
 }
 async function main() {
+    if (process.argv[2] === "web") {
+        const webArgs = process.argv.slice(3);
+        const portIndex = webArgs.indexOf("--port");
+        const port = portIndex >= 0 && webArgs[portIndex + 1] ? Number(webArgs[portIndex + 1]) : undefined;
+        if (port !== undefined && (!Number.isInteger(port) || port < 1 || port > 65_535)) {
+            throw new Error("--port must be an integer between 1 and 65535");
+        }
+        const { startDeepCccWebServer } = await import("./web-server.js");
+        const handle = await startDeepCccWebServer({
+            ...(port ? { port } : {}),
+            ...(webArgs.includes("--no-open") ? { openBrowser: false } : {}),
+        });
+        console.log(`DeepCCC Web UI: ${handle.url}${handle.reused ? " (reused existing server)" : ""}`);
+        return;
+    }
     // skill create 子命令：deepccc skill create <name> [--scope global|project] [--description "..."]
     // 默认创建在全局 ~/.deepccc/skills（Codex 目录结构），--scope project 创建到 <cwd>/.deepccc/skills。
     if (process.argv[2] === "skill" && process.argv[3] === "create") {

package/dist/config.d.ts

@@ -12,6 +12,8 @@ export interface DeepCccConfig {
     subModel: string;
     /** Reasoning effort（none/minimal/low/medium/high/xhigh/max），留空不传 reasoning_effort */
     effort: string;
+    /** 主对话最大输出 token；未配置时不传，使用 Provider 默认值。 */
+    maxOutputTokens?: number;
     /** 主对话是否使用流式请求；默认开启 */
     streaming: boolean;
     /**
@@ -19,19 +21,38 @@ export interface DeepCccConfig {
      * 上下文压缩阈值自动 = contextWindow × 0.8；超过模型/服务端实际上限会被 API 拒绝。
      */
     contextWindow: number;
+    git: {
+        coAuthor: {
+            enabled: boolean;
+            name: string;
+            email: string;
+        };
+    };
     rawStreamLogs: {
         enabled: boolean;
         maxBytesPerTurn: number;
         retentionDays: number;
         keepCompleted: boolean;
     };
+    web: {
+        port: number;
+        openOnStart: boolean;
+    };
 }
 export declare const DEEPCCC_HOME: string;
 export declare const RAW_STREAM_LOGS_DIR: string;
+export declare const CONFIG_PATH: string;
 /**
  * 默认配置（不读环境/文件）。导出供测试断言默认值；运行时请用 loadConfig 结果。
  */
 export declare const DEFAULT_CONFIG: DeepCccConfig;
+export declare function readConfigFile(): Partial<DeepCccConfig>;
 export declare function normalizeDeepCccProvider(value: unknown): DeepCccProvider;
+export declare function loadConfig(): DeepCccConfig;
 export declare function ensureConfigDir(): void;
+export type DeepCccConfigPatch = Partial<Pick<DeepCccConfig, "provider" | "apiKey" | "baseURL" | "model" | "subModel" | "effort" | "maxOutputTokens" | "streaming" | "contextWindow">> & {
+    web?: Partial<DeepCccConfig["web"]>;
+};
+/** Persist only user-editable Web fields while preserving advanced configuration. */
+export declare function saveConfigPatch(patch: DeepCccConfigPatch): DeepCccConfig;
 export declare const config: DeepCccConfig;

package/dist/config.js

@@ -1,9 +1,9 @@
-import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 export const DEEPCCC_HOME = join(homedir(), ".deepccc");
 export const RAW_STREAM_LOGS_DIR = join(DEEPCCC_HOME, "raw-stream-logs");
-const CONFIG_PATH = join(DEEPCCC_HOME, "config.json");
+export const CONFIG_PATH = join(DEEPCCC_HOME, "config.json");
 /**
  * 默认配置（不读环境/文件）。导出供测试断言默认值；运行时请用 loadConfig 结果。
  */
@@ -16,6 +16,13 @@ export const DEFAULT_CONFIG = {
     effort: "",
     streaming: true,
     contextWindow: 1_048_576,
+    git: {
+        coAuthor: {
+            enabled: true,
+            name: "DeepCCC",
+            email: "20184052+wzj998@users.noreply.github.com",
+        },
+    },
     rawStreamLogs: {
         // 默认开启：压缩后可通过 session_search（include_raw_logs=true）找回原文。
         // 如需关闭，在 ~/.deepccc/config.json 中设置 rawStreamLogs.enabled=false。
@@ -24,8 +31,12 @@ export const DEFAULT_CONFIG = {
         retentionDays: 7,
         keepCompleted: false,
     },
+    web: {
+        port: 28_080,
+        openOnStart: true,
+    },
 };
-function readConfigFile() {
+export function readConfigFile() {
     if (!existsSync(CONFIG_PATH))
         return {};
     const raw = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
@@ -49,6 +60,12 @@ function numberEnv(name) {
     const value = Number(env(name));
     return Number.isFinite(value) && value >= 0 ? value : undefined;
 }
+function optionalPositiveInteger(value) {
+    if (value === undefined || value === null || value === "")
+        return undefined;
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
 export function normalizeDeepCccProvider(value) {
     if (value === undefined || value === null || String(value).trim() === "")
         return "openai";
@@ -57,11 +74,14 @@ export function normalizeDeepCccProvider(value) {
         return normalized;
     throw new Error(`DEEPCCC_PROVIDER/provider must be "openai" or "anthropic", received: ${String(value)}`);
 }
-function loadConfig() {
+export function loadConfig() {
     const file = readConfigFile();
     const rawLogs = file.rawStreamLogs && typeof file.rawStreamLogs === "object"
         ? file.rawStreamLogs
         : {};
+    const git = file.git && typeof file.git === "object" ? file.git : {};
+    const coAuthor = git.coAuthor && typeof git.coAuthor === "object" ? git.coAuthor : {};
+    const web = file.web && typeof file.web === "object" ? file.web : {};
     return {
         provider: normalizeDeepCccProvider(env("DEEPCCC_PROVIDER") ?? file.provider ?? DEFAULT_CONFIG.provider),
         apiKey: env("DEEPCCC_API_KEY") ?? env("DEEPSEEK_API_KEY") ?? file.apiKey ?? DEFAULT_CONFIG.apiKey,
@@ -69,17 +89,66 @@ function loadConfig() {
         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,
+        maxOutputTokens: optionalPositiveInteger(env("DEEPCCC_MAX_OUTPUT_TOKENS"))
+            ?? optionalPositiveInteger(file.maxOutputTokens),
         streaming: boolEnv("DEEPCCC_STREAMING") ?? file.streaming ?? DEFAULT_CONFIG.streaming,
         contextWindow: numberEnv("DEEPCCC_CONTEXT_WINDOW") ?? file.contextWindow ?? DEFAULT_CONFIG.contextWindow,
+        git: {
+            coAuthor: {
+                enabled: boolEnv("DEEPCCC_GIT_COAUTHOR") ?? coAuthor.enabled ?? DEFAULT_CONFIG.git.coAuthor.enabled,
+                name: coAuthor.name?.trim() || DEFAULT_CONFIG.git.coAuthor.name,
+                email: coAuthor.email?.trim() || DEFAULT_CONFIG.git.coAuthor.email,
+            },
+        },
         rawStreamLogs: {
             enabled: boolEnv("DEEPCCC_RAW_STREAM_LOGS") ?? rawLogs.enabled ?? DEFAULT_CONFIG.rawStreamLogs.enabled,
             maxBytesPerTurn: numberEnv("DEEPCCC_RAW_STREAM_MAX_BYTES") ?? rawLogs.maxBytesPerTurn ?? DEFAULT_CONFIG.rawStreamLogs.maxBytesPerTurn,
             retentionDays: numberEnv("DEEPCCC_RAW_STREAM_RETENTION_DAYS") ?? rawLogs.retentionDays ?? DEFAULT_CONFIG.rawStreamLogs.retentionDays,
             keepCompleted: boolEnv("DEEPCCC_RAW_STREAM_KEEP_COMPLETED") ?? rawLogs.keepCompleted ?? DEFAULT_CONFIG.rawStreamLogs.keepCompleted,
         },
+        web: {
+            port: normalizeWebPort(web.port),
+            openOnStart: web.openOnStart ?? DEFAULT_CONFIG.web.openOnStart,
+        },
     };
 }
 export function ensureConfigDir() {
     mkdirSync(dirname(CONFIG_PATH), { recursive: true });
 }
+/** Persist only user-editable Web fields while preserving advanced configuration. */
+export function saveConfigPatch(patch) {
+    const existing = readConfigFile();
+    const { web: webPatch, ...flatPatch } = patch;
+    const next = {
+        ...existing,
+        ...flatPatch,
+        ...(webPatch ? { web: { ...DEFAULT_CONFIG.web, ...(existing.web ?? {}), ...webPatch } } : {}),
+    };
+    if (patch.provider !== undefined)
+        next.provider = normalizeDeepCccProvider(patch.provider);
+    if (patch.baseURL !== undefined && !patch.baseURL.trim())
+        throw new Error("baseURL must not be empty");
+    if (patch.model !== undefined && !patch.model.trim())
+        throw new Error("model must not be empty");
+    if (patch.effort !== undefined && !["", "none", "minimal", "low", "medium", "high", "xhigh", "max"].includes(patch.effort)) {
+        throw new Error(`Unsupported effort: ${patch.effort}`);
+    }
+    if (patch.contextWindow !== undefined && (!Number.isInteger(patch.contextWindow) || patch.contextWindow <= 0)) {
+        throw new Error("contextWindow must be a positive integer");
+    }
+    if (webPatch?.port !== undefined) {
+        next.web = { ...(next.web ?? DEFAULT_CONFIG.web), port: normalizeWebPort(webPatch.port) };
+    }
+    ensureConfigDir();
+    const tempPath = `${CONFIG_PATH}.${process.pid}.tmp`;
+    writeFileSync(tempPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+    renameSync(tempPath, CONFIG_PATH);
+    return loadConfig();
+}
+function normalizeWebPort(value) {
+    const parsed = Number(value ?? DEFAULT_CONFIG.web.port);
+    if (!Number.isInteger(parsed) || parsed < 1 || parsed > 65_535)
+        return DEFAULT_CONFIG.web.port;
+    return parsed;
+}
 export const config = loadConfig();

package/dist/context.d.ts

@@ -66,6 +66,7 @@ export declare function normalizeBuiltinSessionId(value: string): string;
 export declare function defaultBuiltinSessionId(cwd?: string): string;
 export declare function newBuiltinSessionId(now?: Date, suffix?: string): string;
 export declare function getBuiltinContextSession(sessionId: string, contextDir?: string): BuiltinContextSessionInfo | null;
+export declare function readBuiltinContextState(sessionId: string, contextDir?: string): BuiltinContextState | null;
 export declare function listBuiltinContextSessions(contextDir?: string): BuiltinContextSessionInfo[];
 export declare function latestBuiltinSessionForCwd(cwd: string, contextDir?: string): BuiltinContextSessionInfo | null;
 /**

package/dist/context.js

@@ -135,6 +135,18 @@ function readSessionInfo(contextDir, sessionId) {
 export function getBuiltinContextSession(sessionId, contextDir = DEFAULT_BUILTIN_CONTEXT_DIR) {
     return readSessionInfo(contextDir, sessionId);
 }
+export function readBuiltinContextState(sessionId, contextDir = DEFAULT_BUILTIN_CONTEXT_DIR) {
+    const normalizedSessionId = normalizeBuiltinSessionId(sessionId);
+    const filePath = contextFilePath(contextDir, normalizedSessionId);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return normalizeState(JSON.parse(readFileSync(filePath, "utf8")), normalizedSessionId);
+    }
+    catch {
+        return null;
+    }
+}
 export function listBuiltinContextSessions(contextDir = DEFAULT_BUILTIN_CONTEXT_DIR) {
     if (!existsSync(contextDir))
         return [];

package/dist/file-tools.d.ts

@@ -71,6 +71,13 @@ export interface RunCommandOutput {
     truncated: boolean;
     durationMs: number;
 }
+export interface GitCoAuthorOptions {
+    enabled: boolean;
+    name: string;
+    email: string;
+}
+/** Adds DeepCCC attribution to git commit commands without replacing the user's author. */
+export declare function withGitCoAuthor(command: string, coAuthor?: GitCoAuthorOptions): string;
 export interface FileEdit {
     oldText: string;
     newText: string;
@@ -143,7 +150,7 @@ export declare function expandHomePath(value: string): string;
 export declare function readFileForTool(cwd: string, input: ReadFileInput): Promise<ReadFileOutput>;
 export declare function listDirForTool(cwd: string, input?: ListDirInput): Promise<ListDirOutput>;
 export declare function searchCodeForTool(cwd: string, input: SearchCodeInput, signal?: AbortSignal, runtimeOptions?: SearchCodeRuntimeOptions): Promise<SearchCodeOutput>;
-export declare function runCommandForTool(cwd: string, input: RunCommandInput, abortSignal?: AbortSignal): Promise<RunCommandOutput>;
+export declare function runCommandForTool(cwd: string, input: RunCommandInput, abortSignal?: AbortSignal, coAuthor?: GitCoAuthorOptions): Promise<RunCommandOutput>;
 export declare function editFileForTool(cwd: string, input: EditFileInput): Promise<EditFileOutput>;
 export declare function createFileForTool(cwd: string, input: CreateFileInput): Promise<FileWriteOutput>;
 export declare function deleteFileForTool(cwd: string, input: DeleteFileInput): Promise<DeleteFileOutput>;
@@ -152,6 +159,8 @@ export declare function applyPatchForTool(cwd: string, input: ApplyPatchInput):
 export interface BuiltinFileToolsOptions {
     /** 权限门控：副作用工具（run_command/文件写操作）执行前会先经过 gate.check */
     permissionGate?: PermissionGate;
+    /** Git commits created by DeepCCC receive this Co-authored-by trailer when enabled. */
+    gitCoAuthor?: GitCoAuthorOptions;
     /** session_search 工具的会话/原始日志目录（默认 ~/.deepccc/sessions 与 raw-stream-logs；测试可注入） */
     sessionSearch?: {
         contextDir?: string;

package/dist/file-tools.js

@@ -26,6 +26,13 @@ const MAX_COMMAND_TIMEOUT_MS = 900_000;
 export const MAX_TASK_OUTPUT_CHARS = 32_000;
 const requireFromHere = createRequire(import.meta.url);
 const FALLBACK_SKIPPED_DIRECTORIES = new Set([".git", "node_modules"]);
+/** Adds DeepCCC attribution to git commit commands without replacing the user's author. */
+export function withGitCoAuthor(command, coAuthor) {
+    if (!coAuthor?.enabled || command.includes(coAuthor.email))
+        return command;
+    const trailer = ` --trailer "Co-authored-by: ${coAuthor.name} <${coAuthor.email}>"`;
+    return command.replace(/(^|(?:&&|\|\||;|\|)\s*)(git\s+commit)\b/g, (_match, prefix, gitCommit) => `${prefix}${gitCommit}${trailer}`);
+}
 /**
  * 把 `~` / `~/x`（含反斜杠 `~\\x`）展开为用户主目录绝对路径。
  * `~user/x` 形式不展开（Node 无内置支持），保持原样交给后续解析。
@@ -676,8 +683,8 @@ export async function searchCodeForTool(cwd, input, signal, runtimeOptions = {})
             : fallback.truncated,
     };
 }
-export async function runCommandForTool(cwd, input, abortSignal) {
-    const command = input.command?.trim();
+export async function runCommandForTool(cwd, input, abortSignal, coAuthor) {
+    const command = withGitCoAuthor(input.command?.trim(), coAuthor);
     if (!command)
         throw new Error("command is required");
     const commandCwd = resolveToolPath(cwd, input.cwd);
@@ -1016,14 +1023,14 @@ export function createBuiltinFileTools(cwd, options = {}) {
                 },
                 required: ["command"],
             }),
-            execute: async (input, options) => {
+            execute: async (input, execOptions) => {
                 await guard({
                     tool: "run_command",
                     action: input.command,
                     reason: isDangerousCommand(input.command) ? "high-risk" : "rule",
                     detail: `运行命令: ${input.command}`,
                 });
-                return runCommandForTool(cwd, input, options.abortSignal);
+                return runCommandForTool(cwd, input, execOptions.abortSignal, options.gitCoAuthor);
             },
         }),
         task: tool({

package/dist/index.d.ts

@@ -37,6 +37,10 @@ export interface ChatSessionConfig {
      * overrides config.effort; empty omits the reasoning_effort request field.
      */
     effort?: string;
+    /** Maximum output tokens for the main conversation; unset uses the Provider default. */
+    maxOutputTokens?: number;
+    /** Override whether the main conversation uses streaming requests. */
+    streaming?: boolean;
 }
 export interface ChatSessionOptions {
     /** Session working directory. */
@@ -78,6 +82,8 @@ export interface ChatSessionOptions {
      * 调用）自动拒绝高危命令，常规文件操作与低危命令不受影响。
      */
     permissionResolver?: PermissionResolver;
+    /** Overrides ~/.deepccc/config.json git.coAuthor.enabled for this integration. */
+    gitCoAuthor?: boolean;
 }
 /**
  * 流式响应事件
@@ -136,9 +142,12 @@ export declare class ChatSession {
     private compactionTimeoutMs;
     private maxSteps?;
     private effort;
+    private maxOutputTokens?;
+    private streaming;
     private permissionMode;
     private permissionResolver?;
     private permissionGate;
+    private gitCoAuthorEnabled;
     private skillDirs;
     private customSystemPrompt;
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */

package/dist/index.js

@@ -77,6 +77,7 @@ const COMPACTION_RECOVERY_HINT_DISABLED = [
 ].join("\n");
 export const DEFAULT_COMPACTION_TIMEOUT_MS = 5 * 60 * 1000;
 const MAX_COMPACTION_OUTPUT_TOKENS = 16_384;
+const OPENAI_COMPATIBLE_PROVIDER_NAME = "deepccc";
 /** task 子代理工具：子代理单轮对话的最大工具步数（防失控循环，结果收敛后即结束） */
 const TASK_MAX_STEPS = 20;
 /** 子代理最终输出截断：保留前 MAX_TASK_OUTPUT_CHARS 字符，尾部注明截断信息 */
@@ -219,6 +220,14 @@ function normalizeMaxSteps(value) {
     }
     return value;
 }
+function normalizeMaxOutputTokens(value) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value <= 0) {
+        throw new Error("maxOutputTokens must be a positive integer when provided");
+    }
+    return value;
+}
 function normalizeAnthropicBaseURL(baseURL) {
     // 完全按用户填写的地址使用，不自动补 /v1（AI SDK 仅对官方 api.anthropic.com
     // 特判补一次 /v1，其他地址原样拼接 /messages）。
@@ -239,9 +248,12 @@ export class ChatSession {
     compactionTimeoutMs;
     maxSteps;
     effort;
+    maxOutputTokens;
+    streaming;
     permissionMode;
     permissionResolver;
     permissionGate;
+    gitCoAuthorEnabled;
     skillDirs;
     customSystemPrompt;
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */
@@ -266,6 +278,7 @@ export class ChatSession {
                 baseURL: this.baseURL,
                 model: this.subModelId || this.modelId,
                 effort: this.effort,
+                maxOutputTokens: this.maxOutputTokens,
             }, {
                 cwd: taskCwd,
                 persist: false,
@@ -303,6 +316,8 @@ export class ChatSession {
         this.subModelId = (overrides.subModel ?? appConfig.subModel ?? "").trim();
         this.provider = normalizeDeepCccProvider(overrides.provider ?? appConfig.provider);
         this.effort = (overrides.effort ?? appConfig.effort ?? "").trim();
+        this.maxOutputTokens = normalizeMaxOutputTokens(overrides.maxOutputTokens ?? appConfig.maxOutputTokens);
+        this.streaming = overrides.streaming ?? appConfig.streaming;
         this.apiKey = apiKey;
         this.baseURL = baseURL;
         const provider = this.provider === "anthropic"
@@ -311,7 +326,7 @@ export class ChatSession {
                 apiKey,
             })
             : createOpenAICompatible({
-                name: "deepccc",
+                name: OPENAI_COMPATIBLE_PROVIDER_NAME,
                 baseURL,
                 apiKey,
                 includeUsage: true,
@@ -325,6 +340,7 @@ export class ChatSession {
         this.customSystemPrompt = options.systemPrompt ?? "";
         this.permissionMode = options.permissionMode ?? "ask";
         this.permissionResolver = options.permissionResolver;
+        this.gitCoAuthorEnabled = options.gitCoAuthor ?? appConfig.git.coAuthor.enabled;
         // 技能目录在构造时确定；技能内容在每次 chat() 前重新扫描（mtime 热加载），
         // 因此创建/修改技能后下一次对话自动生效，无需重启。
         this.skillDirs =
@@ -413,14 +429,14 @@ export class ChatSession {
                 ? addAnthropicToolJsonCompatibilityNote(hintedMessages)
                 : hintedMessages;
             // effort 按协议映射：
-            // - OpenAI 兼容：providerOptions.deepseek.reasoningEffort 由 @ai-sdk/openai-compatible
-            //   自动映射为请求体 reasoning_effort 字段（DeepSeek 原生支持）；
+            // - OpenAI 兼容：providerOptions 的 key 必须与 createOpenAICompatible.name 一致；
+            //   reasoningEffort 由 SDK 映射为请求体 reasoning_effort 字段；
             // - Anthropic：providerOptions.anthropic.effort 由 @ai-sdk/anthropic 组装为请求体
             //   output_config.effort（官方 Effort API，见 platform.claude.com/docs/en/build-with-claude/effort）
             let effortProviderOptions;
             if (this.effort) {
                 effortProviderOptions = this.provider === "openai"
-                    ? { deepseek: { reasoningEffort: this.effort } }
+                    ? { [OPENAI_COMPATIBLE_PROVIDER_NAME]: { reasoningEffort: this.effort } }
                     : { anthropic: { effort: this.effort } };
             }
             const baseGenerationOptions = {
@@ -429,9 +445,16 @@ export class ChatSession {
                 tools: createBuiltinFileTools(this.cwd, {
                     permissionGate: this.permissionGate,
                     runTask: this.runTask,
+                    gitCoAuthor: {
+                        ...appConfig.git.coAuthor,
+                        enabled: this.gitCoAuthorEnabled,
+                    },
                 }),
                 stopWhen: maxSteps !== undefined ? stepCountIs(maxSteps) : isLoopFinished(),
                 abortSignal: signal,
+                ...(this.maxOutputTokens !== undefined
+                    ? { maxOutputTokens: this.maxOutputTokens }
+                    : {}),
                 ...(effortProviderOptions ? { providerOptions: effortProviderOptions } : {}),
             };
             for (let attempt = 0; attempt < 2; attempt += 1) {
@@ -449,7 +472,7 @@ export class ChatSession {
                     messages: attemptMessages,
                 };
                 let stream;
-                if (appConfig.streaming) {
+                if (this.streaming) {
                     const result = streamText(generationOptions);
                     stream = result.fullStream ?? textStreamToFullStream(result.textStream);
                 }
@@ -624,7 +647,7 @@ export class ChatSession {
                 // output_config.effort=low），避免继承主对话的高 effort 拖慢"压缩上下文中"阶段。
                 maxOutputTokens: MAX_COMPACTION_OUTPUT_TOKENS,
                 providerOptions: this.provider === "openai"
-                    ? { deepseek: { reasoningEffort: "none" } }
+                    ? { [OPENAI_COMPATIBLE_PROVIDER_NAME]: { reasoningEffort: "none" } }
                     : { anthropic: { effort: "low" } },
             });
             if (!result.text.trim()) {