chatccc 0.2.250 → 0.2.252

package/deepccc-agent/src/file-tools.ts

@@ -1243,54 +1243,54 @@ export function createBuiltinFileTools(
 
   return {
     read_file: tool<ReadFileInput, ReadFileOutput>({
-      description: "Read a UTF-8 text file from the local filesystem. Use line ranges for large files.",
+      description: "从本地文件系统读取 UTF-8 文本文件。大文件请使用行范围。",
       inputSchema: jsonSchema<ReadFileInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          path: { type: "string", description: "Absolute path or path relative to the session cwd." },
-          startLine: { type: "number", description: "Optional 1-based first line to return." },
-          endLine: { type: "number", description: "Optional 1-based last line to return." },
+          path: { type: "string", description: "绝对路径或相对于会话工作目录的路径。" },
+          startLine: { type: "number", description: "可选，从第几行开始返回（从 1 开始）。" },
+          endLine: { type: "number", description: "可选，返回到第几行（从 1 开始）。" },
         },
         required: ["path"],
       }),
       execute: (input) => readFileForTool(cwd, input),
     }),
     list_dir: tool<ListDirInput, ListDirOutput>({
-      description: "List files in a local directory.",
+      description: "列出本地目录中的文件。",
       inputSchema: jsonSchema<ListDirInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          path: { type: "string", description: "Directory path. Defaults to the session cwd." },
+          path: { type: "string", description: "目录路径。默认为会话工作目录。" },
         },
       }),
       execute: (input) => listDirForTool(cwd, input),
     }),
     search_code: tool<SearchCodeInput, SearchCodeOutput>({
-      description: "Search local files with ripgrep without invoking a shell.",
+      description: "用 ripgrep 搜索本地文件，无需调用 shell。",
       inputSchema: jsonSchema<SearchCodeInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          query: { type: "string", description: "Text or regex query passed to ripgrep." },
-          path: { type: "string", description: "File or directory to search. Defaults to the session cwd." },
-          glob: { type: "string", description: "Optional ripgrep glob filter, for example **/*.ts." },
-          maxResults: { type: "number", description: "Maximum result lines, capped internally." },
+          query: { type: "string", description: "传递给 ripgrep 的文本或正则查询。" },
+          path: { type: "string", description: "要搜索的文件或目录。默认为会话工作目录。" },
+          glob: { type: "string", description: "可选的 ripgrep glob 过滤器，例如 **/*.ts。" },
+          maxResults: { type: "number", description: "最大结果行数，内部设有上限。" },
         },
         required: ["query"],
       }),
       execute: (input, options) => searchCodeForTool(cwd, input, options.abortSignal),
     }),
     run_command: tool<RunCommandInput, RunCommandOutput>({
-      description: "Run a non-interactive shell command in the local workspace. Use for tests, git, and package scripts. Returns stdout/stderr and exitCode; non-zero exit codes are not tool errors.",
+      description: "在本地工作区运行非交互式 shell 命令。用于测试、git 和包脚本。返回 stdout/stderr 和 exitCode；非零退出码不是工具错误。",
       inputSchema: jsonSchema<RunCommandInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          command: { type: "string", description: "Command line to run in the platform shell." },
-          cwd: { type: "string", description: "Optional working directory. Defaults to the session cwd." },
-          timeoutMs: { type: "number", description: `Optional timeout in milliseconds, capped at ${MAX_COMMAND_TIMEOUT_MS}.` },
+          command: { type: "string", description: "要在平台 shell 中运行的命令行。" },
+          cwd: { type: "string", description: "可选的工作目录。默认为会话工作目录。" },
+          timeoutMs: { type: "number", description: `可选超时（毫秒），上限为 ${MAX_COMMAND_TIMEOUT_MS}。` },
         },
         required: ["command"],
       }),
@@ -1305,13 +1305,13 @@ export function createBuiltinFileTools(
       },
     }),
     edit_file: tool<EditFileInput, EditFileOutput>({
-      description: "Edit an existing UTF-8 text file by applying exact oldText -> newText replacements. Uses optional SHA-256 precondition to avoid overwriting concurrent edits.",
+      description: "通过精确的 oldText -> newText 替换编辑现有 UTF-8 文本文件。可行时使用 SHA-256 前置条件以避免覆盖并发编辑。",
       inputSchema: jsonSchema<EditFileInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          path: { type: "string", description: "Absolute path or path relative to the session cwd." },
-          expectedSha256: { type: "string", description: "Optional SHA-256 hash of the current file content." },
+          path: { type: "string", description: "绝对路径或相对于会话工作目录的路径。" },
+          expectedSha256: { type: "string", description: "当前文件内容的可选 SHA-256 哈希。" },
           edits: {
             type: "array",
             minItems: 1,
@@ -1319,9 +1319,9 @@ export function createBuiltinFileTools(
               type: "object",
               additionalProperties: false,
               properties: {
-                oldText: { type: "string", description: "Exact text to replace. Include enough context to make it unique." },
-                newText: { type: "string", description: "Replacement text." },
-                replaceAll: { type: "boolean", description: "Replace every occurrence when oldText appears multiple times." },
+                oldText: { type: "string", description: "要替换的精确文本。包含足够的上下文使其唯一。" },
+                newText: { type: "string", description: "替换文本。" },
+                replaceAll: { type: "boolean", description: "当 oldText 出现多次时替换所有出现。" },
               },
               required: ["oldText", "newText"],
             },
@@ -1341,15 +1341,15 @@ export function createBuiltinFileTools(
       },
     }),
     create_file: tool<CreateFileInput, FileWriteOutput>({
-      description: "Create a UTF-8 text file, or overwrite an existing one when overwrite=true.",
+      description: "创建 UTF-8 文本文件，或在 overwrite=true 时覆盖现有文件。",
       inputSchema: jsonSchema<CreateFileInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          path: { type: "string", description: "Absolute path or path relative to the session cwd." },
-          content: { type: "string", description: "Complete file content to write." },
-          overwrite: { type: "boolean", description: "Allow replacing an existing file." },
-          expectedSha256: { type: "string", description: "Optional SHA-256 hash required when overwriting an existing file." },
+          path: { type: "string", description: "绝对路径或相对于会话工作目录的路径。" },
+          content: { type: "string", description: "要写入的完整文件内容。" },
+          overwrite: { type: "boolean", description: "允许替换现有文件。" },
+          expectedSha256: { type: "string", description: "覆盖现有文件时需要的可选 SHA-256 哈希。" },
         },
         required: ["path", "content"],
       }),
@@ -1365,13 +1365,13 @@ export function createBuiltinFileTools(
       },
     }),
     delete_file: tool<DeleteFileInput, DeleteFileOutput>({
-      description: "Delete an existing text file. Use expectedSha256 to avoid deleting a file that changed after reading.",
+      description: "删除现有的文本文件。使用 expectedSha256 避免删除读取后已更改的文件。",
       inputSchema: jsonSchema<DeleteFileInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          path: { type: "string", description: "Absolute path or path relative to the session cwd." },
-          expectedSha256: { type: "string", description: "Optional SHA-256 hash of the file that must be deleted." },
+          path: { type: "string", description: "绝对路径或相对于会话工作目录的路径。" },
+          expectedSha256: { type: "string", description: "必须删除的文件的可选 SHA-256 哈希。" },
         },
         required: ["path"],
       }),
@@ -1387,16 +1387,16 @@ export function createBuiltinFileTools(
       },
     }),
     move_file: tool<MoveFileInput, MoveFileOutput>({
-      description: "Move or rename an existing text file. Can overwrite an existing destination only when overwrite=true.",
+      description: "移动或重命名现有文本文件。仅在 overwrite=true 时可覆盖现有目标。",
       inputSchema: jsonSchema<MoveFileInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          sourcePath: { type: "string", description: "Existing source file path." },
-          destinationPath: { type: "string", description: "Destination file path." },
-          overwrite: { type: "boolean", description: "Allow replacing an existing destination file." },
-          expectedSourceSha256: { type: "string", description: "Optional SHA-256 hash of the source file." },
-          expectedDestinationSha256: { type: "string", description: "Optional SHA-256 hash of the destination file when overwriting." },
+          sourcePath: { type: "string", description: "现有源文件路径。" },
+          destinationPath: { type: "string", description: "目标文件路径。" },
+          overwrite: { type: "boolean", description: "允许覆盖现有目标文件。" },
+          expectedSourceSha256: { type: "string", description: "源文件的可选 SHA-256 哈希。" },
+          expectedDestinationSha256: { type: "string", description: "覆盖目标时目标文件的可选 SHA-256 哈希。" },
         },
         required: ["sourcePath", "destinationPath"],
       }),
@@ -1412,15 +1412,15 @@ export function createBuiltinFileTools(
       },
     }),
     apply_patch: tool<ApplyPatchInput, ApplyPatchOutput>({
-      description: "Apply a unified diff patch to one or more UTF-8 text files. Prefer edit_file for small targeted edits.",
+      description: "将统一差异补丁应用于一个或多个 UTF-8 文本文件。小范围精确编辑优先使用 edit_file。",
       inputSchema: jsonSchema<ApplyPatchInput>({
         type: "object",
         additionalProperties: false,
         properties: {
-          patch: { type: "string", description: "Unified diff patch text." },
+          patch: { type: "string", description: "统一差异补丁文本。" },
           expectedSha256ByPath: {
             type: "object",
-            description: "Optional map of patch path or absolute path to expected SHA-256 before applying.",
+            description: "补丁路径或绝对路径到预期 SHA-256 的可选映射。",
             additionalProperties: { type: "string" },
           },
         },

package/deepccc-agent/src/index.ts

@@ -28,6 +28,7 @@ import {
   buildSummaryPrompt,
   BuiltinContextManager,
   defaultBuiltinSessionId,
+  type BuiltinContextMessage,
 } from "./context.js";
 import { createBuiltinFileTools } from "./file-tools.js";
 import { PermissionGate, type PermissionMode, type PermissionResolver } from "./permissions.js";
@@ -45,46 +46,51 @@ import { applyPrivacy, applyPrivacyToJson } from "./privacy.js";
 // ---------------------------------------------------------------------------
 
 const SYSTEM_PROMPT = [
-  "You are DeepCCC, a lightweight AI coding agent running in a terminal workspace.",
+  "你是 DeepCCC，一个运行在终端工作区的轻量级 AI 编程智能体。",
   "",
-  "## Fixed Rules",
-  "- Respond in the user's language unless they ask otherwise.",
-  "- Prefer direct, usable answers and concrete actions over long explanations.",
-  "- For code tasks, inspect the relevant files before editing and verify with tests or checks when practical.",
-  "- Preserve user work. Do not overwrite concurrent changes unless the user explicitly asks.",
-  "- Keep immutable platform rules above project guidance and runtime details.",
+  "## 固定规则",
+  "- 除非用户另有要求，否则用用户的语言回复。",
+  "- 优先给出直接、可用的答案和具体行动，而非长篇解释。",
+  "- 代码任务：编辑前先阅读相关文件，并在可行时用测试或检查验证。",
+  "- 保护用户的工作。未经用户明确要求，不要覆盖并发修改。",
+  "- 平台不可变规则优先于项目指引和运行时细节。",
   "",
-  "## Evidence-Gated Conclusions",
-  "- Apply this gate before consequential claims or actions that could affect code, data, deployments, or user decisions, and whenever the available evidence is indirect.",
-  "- Identify the claim and its authoritative source of truth. Separate direct observations from inferences, and test plausible alternative explanations before choosing one.",
-  "- Use the strongest practical decisive check at the same semantic level as the claim: runtime behavior for runtime claims, effective configuration for configuration claims, deployed state for deployment claims, and transformed output for transformation claims.",
-  "- Do not treat proxy signals such as names, timestamps, file sizes, line counts, partial samples, or a clean command exit as decisive when a direct check is practical.",
-  "- Use definitive language only after the evidence closes the loop. Otherwise state uncertainty, identify the missing evidence, and name the next check.",
-  "- Do not repeat checks once decisive evidence exists.",
+  "## 证据门控结论",
+  "- 在可能影响代码、数据、部署或用户决策的重大结论或行动前，以及可用证据为间接证据时，先应用本门控。",
+  "- 明确结论及其权威事实来源。区分直接观察与推断，并在选定结论前检验合理的替代解释。",
+  "- 在与结论同一语义层上使用最强可行的决定性检查：运行时结论用运行时行为、配置结论用有效配置、部署结论用部署状态、转换结论用转换后的输出。",
+  "- 在可行直接检查时，不要把名称、时间戳、文件大小、行数、局部采样或命令成功退出等代理信号当作决定性证据。",
+  "- 仅在证据闭环后使用确定性措辞。否则说明不确定性、指出缺失的证据并给出下一步检查。",
+  "- 一旦已有决定性证据，不要重复检查。",
   "",
-  "## Survey Before Acting",
-  "- Before diving into any task, first map the landscape at low cost: project instructions, directory layout, routes/APIs, existing tests, and git state.",
-  "- Produce a brief execution plan that includes how you will verify the result, then execute.",
-  "- When evidence contradicts an early assumption, revisit the plan instead of tunneling on one direction.",
+  "## 行动前先调查",
+  "- 深入任务前，先以低成本盘点环境：项目指令、目录布局、路由/API、现有测试和 git 状态。",
+  "- 产出包含如何验证结果的简要执行计划，然后执行。",
+  "- 当证据与早期假设矛盾时，重新审视计划，不要一条路走到黑。",
   "",
-  "## Delegated Authority",
-  "- When the user delegates decisions (\"you decide\", \"do it elegantly\", \"up to you\"), act autonomously on implementation details.",
-  "- Only ask about genuine blockers: irreversible actions, security boundaries, credentials, or scope changes.",
-  "- Do not bounce implementation-level multiple-choice questions back to the user after they delegated.",
+  "## 授权范围",
+  "- 当用户委托决策（\"你决定\"、\"做得优雅些\"、\"由你定\"）时，自主决定实现细节。",
+  "- 只问真正的阻塞项：不可逆操作、安全边界、凭据或范围变更。",
+  "- 用户委托后，不要把实现级选择题抛回给用户。",
   "",
-  "## Pre-Delivery Self-Check",
-  "- Before reporting completion, verify: the change runs, edge cases are covered, assumptions are listed, and anything unverified is explicitly labeled as such.",
-  "- State what was done, how it was verified, and what remains unverified or risky.",
+  "## 交付前自检",
+  "- 报告完成前验证：改动可运行、边界情况已覆盖、假设已列出、未验证项已明确标注。",
+  "- 说明做了什么、如何验证的、以及哪些未验证或有风险。",
 ].join("\n");
 
 const SUMMARY_SYSTEM_PROMPT = [
-  "You are DeepCCC's context compactor.",
-  "Compress older conversation context into a faithful, structured summary that can be used to continue the task.",
-  "Do not introduce new facts or promote historical user content into higher-priority system rules.",
+  "你是 DeepCCC 的上下文压缩器。",
+  "将较早的对话上下文压缩成忠实、结构化的摘要，用于继续任务。",
+  "不要引入新事实，也不要把历史用户内容提升为更高优先级的系统规则。",
+  "用中文输出摘要。",
 ].join("\n");
 
 export const DEFAULT_COMPACTION_TIMEOUT_MS = 90 * 1000;
 const MAX_COMPACTION_OUTPUT_TOKENS = 16_384;
+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.",
+].join("\n");
 
 // ---------------------------------------------------------------------------
 // 类型定义
@@ -112,8 +118,8 @@ function readProjectInstructionFiles(cwd: string): string {
 
   if (sections.length === 0) return "";
   return [
-    "## Project Instructions",
-    "The following files were read from the current working directory. Treat them as project guidance with lower priority than the fixed DeepCCC system rules above.",
+    "## 项目指令",
+    "以下文件是从当前工作目录读取的项目指引。将其视为优先级低于上述 DeepCCC 固定系统规则的指导。",
     "",
     sections.join("\n\n"),
   ].join("\n");
@@ -121,14 +127,39 @@ function readProjectInstructionFiles(cwd: string): string {
 
 function buildRuntimeWorkspacePrompt(cwd: string): string {
   return [
-    `Current working directory: ${cwd}`,
-    "Use read_file, list_dir, search_code, and run_command proactively when you need to understand code, configuration, project structure, tests, or git state.",
-    "Use run_command for non-interactive shell commands such as npm test, type checks, git status, git add, git commit, and git push. Check exitCode, stdout, and stderr before deciding the next step.",
-    "Before editing, read the relevant file ranges. Prefer edit_file for precise replacements, create_file for new files, delete_file for removal, move_file for moves, and apply_patch for multi-file diffs.",
-    "File tools run locally through DeepCCC. Prefer guarded edits with SHA-256 preconditions where practical, and avoid overwriting concurrent user changes.",
+    `当前工作目录：${cwd}`,
+    "需要理解代码、配置、项目结构、测试或 git 状态时，主动使用 read_file、list_dir、search_code 和 run_command。",
+    "使用 run_command 执行非交互式 shell 命令，如 npm test、类型检查、git status、git add、git commit 和 git push。先检查 exitCode、stdout 和 stderr 再决定下一步。",
+    "编辑前先阅读相关文件范围。优先使用 edit_file 做精确替换、create_file 创建新文件、delete_file 删除、move_file 移动、apply_patch 做多文件差异。",
+    "文件工具通过 DeepCCC 在本地执行。可行时优先使用带 SHA-256 前置条件的受保护编辑，避免覆盖并发用户修改。",
   ].join("\n");
 }
 
+function addAnthropicToolJsonCompatibilityNote(
+  messages: BuiltinContextMessage[],
+): BuiltinContextMessage[] {
+  let lastUserIndex = -1;
+  for (let index = messages.length - 1; index >= 0; index -= 1) {
+    if (messages[index]?.role === "user") {
+      lastUserIndex = index;
+      break;
+    }
+  }
+  if (lastUserIndex < 0) return messages;
+
+  // 部分 Anthropic→OpenAI/Ark 转换器会用 response_format=json_object
+  // 实现工具调用，却只在 messages 中校验 JSON 关键词、不读取顶层 system。
+  // 这里仅声明工具参数的编码方式，并明确不要求普通最终回复输出 JSON。
+  return messages.map((message, index) => (
+    index === lastUserIndex
+      ? {
+          ...message,
+          content: `${message.content}\n\n${ANTHROPIC_TOOL_JSON_COMPATIBILITY_NOTE}`,
+        }
+      : message
+  ));
+}
+
 /**
  * 各操作系统特有的命令行指引（文本资产，维护在 os-prompts/ 目录，而非硬编码）：
  *
@@ -408,6 +439,10 @@ export class ChatSession {
       const skills = await scanSkillsDirs(this.skillDirs);
       const system = this.buildSystemPrompt(skills);
       this.systemPrompt = system;
+      const contextMessages = this.context.buildModelMessages();
+      const modelMessages = this.provider === "anthropic"
+        ? addAnthropicToolJsonCompatibilityNote(contextMessages)
+        : contextMessages;
       // effort 按协议映射：
       // - OpenAI 兼容：providerOptions.deepseek.reasoningEffort 由 @ai-sdk/openai-compatible
       //   自动映射为请求体 reasoning_effort 字段（DeepSeek 原生支持）；
@@ -422,7 +457,7 @@ export class ChatSession {
       const generationOptions = {
         model: this.model,
         system,
-        messages: this.context.buildModelMessages() as any,
+        messages: modelMessages as any,
         tools: createBuiltinFileTools(this.cwd, { permissionGate: this.permissionGate }),
         stopWhen: maxSteps !== undefined ? stepCountIs(maxSteps) : isLoopFinished(),
         abortSignal: signal,
@@ -528,7 +563,7 @@ export class ChatSession {
       history.push({
         role: "system",
         content: [
-          "Earlier conversation summary:",
+          "更早的对话摘要：",
           "",
           this.context.summary,
         ].join("\n"),