deepccc 0.1.27 → 0.1.28

package/README.md

@@ -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,10 +79,18 @@ $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,
+  "git": {
+    "coAuthor": {
+      "enabled": true,
+      "name": "DeepCCC",
+      "email": "20184052+wzj998@users.noreply.github.com"
+    }
+  },
   "rawStreamLogs": {
     "enabled": true,
     "maxBytesPerTurn": 1048576,
@@ -88,14 +100,24 @@ $env:DEEPCCC_STREAMING="true"
 }
 ```
 
+`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 +188,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.js

@@ -65,6 +65,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 +135,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",

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,6 +21,13 @@ export interface DeepCccConfig {
      * 上下文压缩阈值自动 = contextWindow × 0.8；超过模型/服务端实际上限会被 API 拒绝。
      */
     contextWindow: number;
+    git: {
+        coAuthor: {
+            enabled: boolean;
+            name: string;
+            email: string;
+        };
+    };
     rawStreamLogs: {
         enabled: boolean;
         maxBytesPerTurn: number;

package/dist/config.js

@@ -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。
@@ -49,6 +56,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";
@@ -62,6 +75,8 @@ function loadConfig() {
     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 : {};
     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,8 +84,17 @@ 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,

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,8 @@ 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;
 }
 export interface ChatSessionOptions {
     /** Session working directory. */
@@ -78,6 +80,8 @@ export interface ChatSessionOptions {
      * 调用）自动拒绝高危命令，常规文件操作与低危命令不受影响。
      */
     permissionResolver?: PermissionResolver;
+    /** Overrides ~/.deepccc/config.json git.coAuthor.enabled for this integration. */
+    gitCoAuthor?: boolean;
 }
 /**
  * 流式响应事件
@@ -136,9 +140,11 @@ export declare class ChatSession {
     private compactionTimeoutMs;
     private maxSteps?;
     private effort;
+    private maxOutputTokens?;
     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,11 @@ export class ChatSession {
     compactionTimeoutMs;
     maxSteps;
     effort;
+    maxOutputTokens;
     permissionMode;
     permissionResolver;
     permissionGate;
+    gitCoAuthorEnabled;
     skillDirs;
     customSystemPrompt;
     /** 最近一次 chat() 使用的 system prompt（供 history 等读取） */
@@ -266,6 +277,7 @@ export class ChatSession {
                 baseURL: this.baseURL,
                 model: this.subModelId || this.modelId,
                 effort: this.effort,
+                maxOutputTokens: this.maxOutputTokens,
             }, {
                 cwd: taskCwd,
                 persist: false,
@@ -303,6 +315,7 @@ 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.apiKey = apiKey;
         this.baseURL = baseURL;
         const provider = this.provider === "anthropic"
@@ -311,7 +324,7 @@ export class ChatSession {
                 apiKey,
             })
             : createOpenAICompatible({
-                name: "deepccc",
+                name: OPENAI_COMPATIBLE_PROVIDER_NAME,
                 baseURL,
                 apiKey,
                 includeUsage: true,
@@ -325,6 +338,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 +427,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 +443,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) {
@@ -624,7 +645,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()) {

package/package.json

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