@ai-zen/agents-sdk 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/scope/plugins/builtin/GenerateImageTool.js

@@ -15,25 +15,25 @@ export class GenerateImageTool extends SdkCallbackTool {
     }
     function = {
         name: "generate_image",
-        description: "根据文字描述生成图片，返回图片 URL 列表（JSON）。如需查看图片内容，请用 view_image 工具（传入图片 URL）；如需保存到本地，用 download_file 下载。",
+        description: "Generate an image from a text description and return a list of image URLs (JSON). To inspect the image content, use the view_image tool (pass the image URL); to save it locally, use download_file.",
         parameters: {
             type: "object",
             properties: {
                 prompt: {
                     type: "string",
-                    description: "所需图像的文本描述，应详细描述画面内容、风格、构图等",
+                    description: "Text description of the desired image; describe the subject, style, composition and other details",
                 },
                 model: {
                     type: "string",
-                    description: "图片模型 ID，不指定则使用配置中的默认图片模型；若指定的模型不存在，本工具会返回当前可用的模型列表。",
+                    description: "Image model ID. Defaults to the configured default image model; if the given model does not exist, this tool returns the list of currently available models.",
                 },
                 size: {
                     type: "string",
-                    description: '图片尺寸。不指定则使用模型的默认尺寸。cogview系列: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440。glm-image: 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728。',
+                    description: 'Image size. Defaults to the model default size. cogview series: 1024x1024, 768x1344, 864x1152, 1344x768, 1152x864, 1440x720, 720x1440. glm-image: 1280x1280, 1568x1056, 1056x1568, 1472x1088, 1088x1472, 1728x960, 960x1728.',
                 },
                 quality: {
                     type: "string",
-                    description: "图像质量。hd: 精细(约20秒), standard: 快速(约5-10秒)",
+                    description: "Image quality. hd: fine (about 20 seconds), standard: fast (about 5-10 seconds)",
                     enum: ["hd", "standard"],
                 },
             },
@@ -49,7 +49,7 @@ export class GenerateImageTool extends SdkCallbackTool {
         try {
             const prompt = input.prompt;
             if (!prompt || !prompt.trim()) {
-                return JSON.stringify({ success: false, error: "prompt 不能为空" });
+                return JSON.stringify({ success: false, error: "prompt must not be empty" });
             }
             const config = this.env.config;
             const imageModels = config.imageModels;
@@ -57,7 +57,7 @@ export class GenerateImageTool extends SdkCallbackTool {
             if (!imageModels || imageModels.length === 0) {
                 return JSON.stringify({
                     success: false,
-                    error: "未配置图片生成模型。请在配置中添加 imageModels。",
+                    error: "No image generation model configured. Add imageModels to the configuration.",
                 });
             }
             const modelId = input.model || defaultImageModel;
@@ -67,20 +67,20 @@ export class GenerateImageTool extends SdkCallbackTool {
             if (!imageModel) {
                 return JSON.stringify({
                     success: false,
-                    error: `图片模型 "${modelId}" 不存在。可用的图片模型: ${imageModels.map((m) => m.id).join(", ")}`,
+                    error: `Image model "${modelId}" does not exist. Available image models: ${imageModels.map((m) => m.id).join(", ")}`,
                 });
             }
             const endpoint = config.endpoints.find((e) => e.id === imageModel.endpointId);
             if (!endpoint) {
                 return JSON.stringify({
                     success: false,
-                    error: `图片模型 "${imageModel.name}" 对应的端点 "${imageModel.endpointId}" 未配置`,
+                    error: `Endpoint "${imageModel.endpointId}" for image model "${imageModel.name}" is not configured`,
                 });
             }
             if (!endpoint.apiKey) {
                 return JSON.stringify({
                     success: false,
-                    error: `端点 "${endpoint.name}" 的 API Key 未设置`,
+                    error: `API Key for endpoint "${endpoint.name}" is not set`,
                 });
             }
             const client = new OpenAI({
@@ -107,7 +107,7 @@ export class GenerateImageTool extends SdkCallbackTool {
                 modelId: imageModel.id,
                 created: result.created,
                 images: urls.map((url, i) => ({ index: i, url })),
-                note: "图片临时链接有效期为30天。如需查看图片内容，可用 view_image 工具（传入图片 URL）；如需保存，可用 download_file 下载。",
+                note: "Image links are temporary and expire after 30 days. To inspect the image content, use the view_image tool (pass the image URL); to save it, use download_file.",
             }, null, 2);
         }
         catch (error) {
@@ -116,12 +116,12 @@ export class GenerateImageTool extends SdkCallbackTool {
                 return JSON.stringify({
                     success: false,
                     aborted: true,
-                    error: "图片生成被中断（aborted）",
+                    error: "Image generation aborted",
                 });
             }
             return JSON.stringify({
                 success: false,
-                error: error instanceof Error ? error.message : "图片生成失败",
+                error: error instanceof Error ? error.message : "Image generation failed",
             });
         }
     }

package/dist/scope/plugins/builtin/GlobTool.js

@@ -4,7 +4,7 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard
 export class GlobTool extends SdkCallbackTool {
     function = {
         name: "glob",
-        description: "使用 glob 模式递归扫描和查找文件。这是进行文件系统搜索的首选工具，功能远优于简单的 'ls' 列表命令。当你需要查找特定类型的文件、遍历目录树或需要排除特定文件时，请优先使用此函数。",
+        description: "Recursively scan for and find files using a glob pattern. This is the preferred tool for file system searches, far better than a plain 'ls' listing. Prefer this tool when you need to find files of a specific type, walk a directory tree, or exclude specific files.",
         parameters: {
             type: "object",
             properties: {
@@ -68,9 +68,9 @@ export class GlobTool extends SdkCallbackTool {
                 const preview = headPreview(json);
                 return JSON.stringify({
                     outputTooLarge: true,
-                    warning: `输出过大：匹配结果共 ${json.length} 字符，超过上限 ${limit} 字符。` +
-                        `完整结果已落盘（result.json），可用 read 分批读取；` +
-                        `也可用更精确的 pattern 或 exclude 缩小范围后重新查找。`,
+                    warning: `Output too large: the matches total ${json.length} characters, exceeding the limit of ${limit} characters. ` +
+                        `The full result has been written to disk (result.json) and can be read in chunks with read; ` +
+                        `alternatively, narrow the scope with a more precise pattern or exclude and search again.`,
                     files: ctx.files,
                     chars: json.length,
                     ...preview,

package/dist/scope/plugins/builtin/InspectFileTool.js

@@ -12,17 +12,17 @@ import { DEFAULT_MAX_TOOL_OUTPUT } from "./outputGuard.js";
 export class InspectFileTool extends SdkCallbackTool {
     function = {
         name: "inspect_file",
-        description: "勘察文件的结构概况：总行数、总字符数、最长行的列数及其行索引、平均列数、行尾类型（LF/CRLF）。可选返回每行的列数映射。适用于在 read 之前先了解文件规模，再决定用 range 读取哪一段。仅做流式扫描，不受 read 的 300KB 读取阈值限制。",
+        description: "Inspect a file's structural overview: total lines, total characters, the longest line's column count and its line index, average column count, and line ending type (LF/CRLF). Optionally returns a per-line column count map. Useful for sizing up a file before reading it, so you can decide which range to read. Streaming scan only, not subject to the 300KB read threshold of read.",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 withColCountMap: {
                     type: "boolean",
-                    description: "是否返回每行列数映射（对象：行索引 → 列数，行索引从 0 开始）。默认 false。行数很多时该映射可能过大，此时将只返回概况字段。",
+                    description: "Whether to return a per-line column count map (object: line index → column count, line index is 0-based). Default false. When there are many lines the map may be too large; in that case only the overview fields are returned.",
                     default: false,
                 },
             },
@@ -38,7 +38,7 @@ export class InspectFileTool extends SdkCallbackTool {
             const filePath = this.resolve(input.path);
             const stats = await fsp.stat(filePath);
             if (!stats.isFile()) {
-                return `"${filePath}" 不是文件`;
+                return `"${filePath}" is not a file`;
             }
             const withColCountMap = input.withColCountMap ?? false;
             const result = await scan(filePath, withColCountMap);
@@ -61,9 +61,9 @@ export class InspectFileTool extends SdkCallbackTool {
                 return JSON.stringify({
                     ...summary,
                     colCountMapOmitted: true,
-                    warning: `行长度明细过大：概况与 colCountMap 合计 ${payload.length} 字符，` +
-                        `超过上限 ${limit} 字符，未落盘返回。文件规模超出可处理范围，` +
-                        `建议改用 find_text 定位后再按 range 分段读取。`,
+                    warning: `Line length details too large: overview plus colCountMap total ${payload.length} characters, ` +
+                        `exceeding the limit of ${limit} characters; not written to disk. The file is beyond the supported size, ` +
+                        `so use find_text to locate the target and then read it in chunks by range.`,
                 });
             }
             return payload;

package/dist/scope/plugins/builtin/LsTool.js

@@ -4,13 +4,13 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput, headPreview } from "./outputGuard
 export class LsTool extends SdkCallbackTool {
     function = {
         name: "ls",
-        description: "列出目录",
+        description: "List a directory",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "目录路径",
+                    description: "Directory path",
                 },
             },
             required: ["path"],
@@ -35,9 +35,9 @@ export class LsTool extends SdkCallbackTool {
                     const preview = headPreview(json);
                     return JSON.stringify({
                         outputTooLarge: true,
-                        warning: `输出过大：目录条目共 ${entries.length} 项、${json.length} 字符，超过上限 ${limit} 字符。` +
-                            `完整列表已落盘（result.json），可用 read 分批读取；` +
-                            `也可改用 glob 按模式筛选。`,
+                        warning: `Output too large: ${entries.length} directory entries, ${json.length} characters in total, exceeding the limit of ${limit} characters. ` +
+                            `The full list has been written to disk (result.json) and can be read in chunks with read; ` +
+                            `alternatively, use glob to filter by pattern.`,
                         files: ctx.files,
                         chars: json.length,
                         ...preview,

package/dist/scope/plugins/builtin/MkdirTool.js

@@ -3,17 +3,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class MkdirTool extends SdkCallbackTool {
     function = {
         name: "mkdir",
-        description: "创建目录",
+        description: "Create a directory",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "目录路径",
+                    description: "Directory path",
                 },
                 recursive: {
                     type: "boolean",
-                    description: "是否递归创建子目录",
+                    description: "Whether to create parent directories recursively",
                 },
             },
             required: ["path"],

package/dist/scope/plugins/builtin/ReadTool.js

@@ -4,18 +4,18 @@ import { DEFAULT_MAX_TOOL_OUTPUT, guardOutput } from "./outputGuard.js";
 export class ReadTool extends SdkCallbackTool {
     function = {
         name: "read",
-        description: "读取文件",
+        description: "Read a file",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 range: {
                     type: "array",
-                    description: "读取范围 [起始行, 起始列, 结束行, 结束列]，行列均从 0 开始，-1 表示末位；" +
-                        "例如 [0, 0, 100, -1] 表示从第 0 行第 0 列读到第 100 行最后一列。省略则读取整个文件。",
+                    description: "Read range [startLine, startCol, endLine, endCol]; rows and columns are 0-based, -1 means the last position. " +
+                        "For example, [0, 0, 100, -1] reads from line 0, column 0 through the last column of line 100; omit it to read the whole file.",
                     items: {
                         type: "number",
                     },
@@ -34,7 +34,7 @@ export class ReadTool extends SdkCallbackTool {
             const stats = await fsp.stat(filePath);
             // 读取阈值：文件过大时拒绝读取（与输出阈值 maxToolOutput 无关）
             if (stats.size > 300 * 1024) {
-                throw new Error(`文件过大，无法读取，当前文件大小 ${stats.size} 字节`);
+                throw new Error(`File too large to read: ${stats.size} bytes`);
             }
             const content = await fsp.readFile(filePath, "utf-8");
             const output = input.range ? sliceByRange(content, input.range) : content;
@@ -44,9 +44,9 @@ export class ReadTool extends SdkCallbackTool {
                 tool: "read",
                 content: output,
                 isOverLimit: (text) => text.length > limit,
-                buildWarning: () => `读取内容过大：本次输出 ${output.length} 字符，超过上限 ${limit} 字符，未落盘。` +
-                    `文件共 ${countLines(content)} 行、${content.length} 字符，` +
-                    `请用 range 参数分范围读取（形如 [起始行, 起始列, 结束行, 结束列]，行列从 0 开始，-1 表示末位）。`,
+                buildWarning: () => `Output too large: this read returned ${output.length} characters, exceeding the limit of ${limit} characters; not written to disk. ` +
+                    `The file has ${countLines(content)} lines and ${content.length} characters. ` +
+                    `Use the range parameter to read it in chunks (format [startLine, startCol, endLine, endCol], 0-based, -1 means the last position).`,
             });
         }
         catch (error) {

package/dist/scope/plugins/builtin/RenameTool.js

@@ -3,17 +3,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class RenameTool extends SdkCallbackTool {
     function = {
         name: "rename",
-        description: "重命名或移动文件/目录（相当于 mv 命令）",
+        description: "Rename or move a file/directory (equivalent to the mv command)",
         parameters: {
             type: "object",
             properties: {
                 oldPath: {
                     type: "string",
-                    description: "原路径",
+                    description: "Original path",
                 },
                 newPath: {
                     type: "string",
-                    description: "新路径",
+                    description: "New path",
                 },
             },
             required: ["oldPath", "newPath"],

package/dist/scope/plugins/builtin/RmTool.js

@@ -3,17 +3,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class RmTool extends SdkCallbackTool {
     function = {
         name: "rm",
-        description: "删除文件或目录",
+        description: "Delete a file or directory",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件或目录路径",
+                    description: "File or directory path",
                 },
                 recursive: {
                     type: "boolean",
-                    description: "是否递归删除子目录",
+                    description: "Whether to delete subdirectories recursively",
                 },
             },
             required: ["path"],

package/dist/scope/plugins/builtin/SleepTool.js

@@ -2,13 +2,13 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class SleepTool extends SdkCallbackTool {
     function = {
         name: "sleep",
-        description: "等待指定的时间（毫秒）。用于需要延迟执行的场景，例如等待其他操作完成、操作间隔控制等。注意：过长的等待时间会影响响应速度，建议不超过 30000 毫秒（30 秒）。",
+        description: "Wait for the specified time in milliseconds. Use it when a delay is needed, for example to wait for another operation to finish or to space out actions. Note: long waits slow down responses; keep it at or below 30000 milliseconds (30 seconds).",
         parameters: {
             type: "object",
             properties: {
                 ms: {
                     type: "number",
-                    description: "等待的毫秒数（1 秒 = 1000 毫秒）。建议不超过 30000（30 秒）。",
+                    description: "Milliseconds to wait (1 second = 1000 milliseconds). Values above 30000 (30 seconds) are not recommended.",
                 },
             },
             required: ["ms"],
@@ -23,14 +23,14 @@ export class SleepTool extends SdkCallbackTool {
         if (typeof ms !== "number" || !Number.isFinite(ms) || ms < 0) {
             return JSON.stringify({
                 success: false,
-                error: "ms 必须是正整数",
+                error: "ms must be a positive integer",
             });
         }
         if (ms > 300_000) {
             // 超过 5 分钟给出警告
             return JSON.stringify({
                 success: false,
-                error: `等待时间 ${ms}ms 过长，建议不超过 300000ms（5 分钟）。如需长时间等待请分段执行。`,
+                error: `Wait time ${ms}ms is too long, keep it at or below 300000ms (5 minutes). For longer waits, split them into shorter steps`,
             });
         }
         // 若 signal 已处于 aborted，直接返回中断结果，避免不必要的等待
@@ -53,14 +53,14 @@ export class SleepTool extends SdkCallbackTool {
             return JSON.stringify({
                 success: false,
                 aborted: true,
-                error: "等待被中断（aborted）",
+                error: "Wait aborted",
             });
         }
         return JSON.stringify({
             success: true,
             waitedMs: ms,
             waitedSeconds: (ms / 1000).toFixed(1),
-            message: `已等待 ${ms}ms（${(ms / 1000).toFixed(1)} 秒）`,
+            message: `Waited ${ms}ms (${(ms / 1000).toFixed(1)} seconds)`,
         });
     }
 }

package/dist/scope/plugins/builtin/SpawnTool.js

@@ -3,21 +3,21 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class SpawnTool extends SdkCallbackTool {
     function = {
         name: "spawn",
-        description: "异步执行命令，启动程序后立即返回，不等待执行结果。适用于启动长期运行的进程（如服务器、监听程序、GUI应用等）或不需要等待结果的命令。注意：该工具本身不捕获命令的输出；若需获取/留存输出，可在命令中使用 shell 重定向写入文件（如 `> /path/file`，支持 `>>` 追加、`|` 管道）。命令经 shell 解析执行。",
+        description: "Spawn a command asynchronously and return immediately without waiting for the result. Use it for long-running processes (servers, watchers, GUI apps, etc.) or commands whose result you do not need to wait for. Note: this tool does not capture the command's output itself; to retain or inspect output, use shell redirection to a file inside the command (e.g. `> /path/file`; `>>` append and `|` pipes are supported). The command is parsed and executed by the shell.",
         parameters: {
             type: "object",
             properties: {
                 command: {
                     type: "string",
-                    description: "要执行的命令（含参数）",
+                    description: "Command to execute (including arguments)",
                 },
                 cwd: {
                     type: "string",
-                    description: "工作目录（可选，默认当前工作目录）",
+                    description: "Working directory (optional, defaults to the current working directory)",
                 },
                 detached: {
                     type: "boolean",
-                    description: "是否完全脱离当前进程组（可选，默认 false）。设为 true 时，即使当前 Agent 进程退出，启动的程序仍会继续运行。适用于需要独立运行的守护进程或 GUI 程序。",
+                    description: "Whether to fully detach from the current process group (optional, defaults to false). When true, the spawned program keeps running even after the current Agent process exits. Use it for daemons or GUI programs that must run independently.",
                 },
             },
             required: ["command"],
@@ -48,7 +48,7 @@ export class SpawnTool extends SdkCallbackTool {
                 resolve(JSON.stringify({
                     success: false,
                     pid: null,
-                    message: `启动失败: ${err.message}`,
+                    message: `Failed to start: ${err.message}`,
                 }));
             });
             child.on("spawn", () => {
@@ -58,7 +58,7 @@ export class SpawnTool extends SdkCallbackTool {
                 resolve(JSON.stringify({
                     success: true,
                     pid: child.pid ?? null,
-                    message: `进程已启动 (PID: ${child.pid ?? "unknown"})`,
+                    message: `Process started (PID: ${child.pid ?? "unknown"})`,
                 }));
             });
             child.on("exit", (code) => {
@@ -70,8 +70,8 @@ export class SpawnTool extends SdkCallbackTool {
                     pid: child.pid ?? null,
                     exitCode: code,
                     message: code === null
-                        ? `进程已退出 (PID: ${child.pid ?? "unknown"})`
-                        : `进程已退出 (PID: ${child.pid ?? "unknown"}, 退出码: ${code})`,
+                        ? `Process exited (PID: ${child.pid ?? "unknown"})`
+                        : `Process exited (PID: ${child.pid ?? "unknown"}, exit code: ${code})`,
                 }));
             });
             const timeout = setTimeout(() => {
@@ -81,7 +81,7 @@ export class SpawnTool extends SdkCallbackTool {
                 resolve(JSON.stringify({
                     success: true,
                     pid: child.pid ?? null,
-                    message: `进程已启动 (PID: ${child.pid ?? "unknown"})`,
+                    message: `Process started (PID: ${child.pid ?? "unknown"})`,
                 }));
             }, 500);
             const cleanup = () => {

package/dist/scope/plugins/builtin/ViewImageTool.js

@@ -35,13 +35,13 @@ export class ViewImageTool extends SdkCallbackTool {
     }
     function = {
         name: "view_image",
-        description: "查看一张图片并分析其内容。传入本地图片路径或 http(s) 图片 URL。本地图片优先上传（端点支持 Files API 时）否则以 base64 内联引用，网络图片直接引用。不支持本地 URL（如 file:// 协议、指向本机 localhost/127.0.0.1 的 http(s) 地址），本地图片请使用文件路径。适合识别图片文字、描述图片内容、分析图表等。",
+        description: "View an image and analyze its content. Pass a local image path or an http(s) image URL. Local images are uploaded when the endpoint supports the Files API and are otherwise referenced as inline base64; remote images are referenced directly. Local URLs are not supported (such as the file:// protocol, or http(s) addresses pointing to localhost/127.0.0.1 on this machine); use a file path for local images. Suitable for reading text in images, describing image content and analyzing charts.",
         parameters: {
             type: "object",
             properties: {
                 path_or_url: {
                     type: "string",
-                    description: "本地图片路径（相对/绝对）或 http(s) 图片 URL。支持的格式：JPEG、PNG、GIF、WebP。不支持本地 URL（如 file:// 协议、指向本机 localhost/127.0.0.1 的 http(s) 地址），本地图片请使用文件路径。",
+                    description: "Local image path (relative or absolute) or an http(s) image URL. Supported formats: JPEG, PNG, GIF, WebP. Local URLs are not supported (such as the file:// protocol, or http(s) addresses pointing to localhost/127.0.0.1 on this machine); use a file path for local images.",
                 },
             },
             required: ["path_or_url"],
@@ -55,12 +55,12 @@ export class ViewImageTool extends SdkCallbackTool {
         const signal = ctx?.signal;
         const target = input?.path_or_url;
         if (!target || !target.trim()) {
-            return "view_image 需要提供 path_or_url 参数（本地图片路径或 http(s) URL）。";
+            return "view_image requires the path_or_url parameter (a local image path or an http(s) URL)";
         }
         const value = target.trim();
         // 拒绝服务商无法访问的"本地 URL"：file:// 等本地协议，或指向本机回环地址的 http(s) 地址
         if (isLocalUrl(value)) {
-            return "不支持本地 URL（API 服务商无法下载访问）。本地图片请使用文件路径，而不是本地链接。";
+            return "Local URLs are not supported (the API provider cannot download them). Use a file path for local images, not a local link";
         }
         // 按当前模型定位端点：决定走 Files API 上传还是 base64 内联
         const { model, endpoint } = resolveModelAndEndpoint(this.env.config, ctx?.agent?.model);
@@ -74,11 +74,11 @@ export class ViewImageTool extends SdkCallbackTool {
                     await fs.stat(abs);
                 }
                 catch {
-                    return `本地图片不存在: ${abs}`;
+                    return `Local image not found: ${abs}`;
                 }
                 const mime = mimeOf(abs);
                 if (!mime || !mime.startsWith("image/")) {
-                    return `不支持的图片格式 "${path.extname(abs) || "(无扩展名)"}"。支持的格式：JPEG、PNG、GIF、WebP。`;
+                    return `Unsupported image format "${path.extname(abs) || "(no extension)"}". Supported formats: JPEG, PNG, GIF, WebP`;
                 }
             }
             const result = await fileToContentSection({
@@ -87,21 +87,21 @@ export class ViewImageTool extends SdkCallbackTool {
                 model,
                 signal,
             });
-            const label = isUrl ? `已获取网络图片：${value}` : `已获取本地图片（${path.basename(value)}）`;
+            const label = isUrl ? `Fetched remote image: ${value}` : `Fetched local image (${path.basename(value)})`;
             const how = result.transport === "files-api"
-                ? `，已上传至 Files API（file_id: ${result.section.file_id ?? "?"}）`
+                ? `, uploaded to the Files API (file_id: ${result.section.file_id ?? "?"})`
                 : result.transport === "inline"
-                    ? `，已按 base64 内联（${(result.bytes / 1024).toFixed(0)} KB）`
+                    ? `, inlined as base64 (${(result.bytes / 1024).toFixed(0)} KB)`
                     : "";
-            const extra = result.warning ? `（降级说明：${result.warning}）` : "";
+            const extra = result.warning ? ` (fallback: ${result.warning})` : "";
             return [{ type: "text", text: `${label}${how}${extra}` }, result.section];
         }
         catch (error) {
             // 中断（abort）时返回明确的中断结果
             if (signal?.aborted) {
-                return "图片查看被中断（aborted）";
+                return "Image view aborted";
             }
-            return `查看图片失败: ${error instanceof Error ? error.message : String(error)}`;
+            return `Failed to view image: ${error instanceof Error ? error.message : String(error)}`;
         }
     }
 }

package/dist/scope/plugins/builtin/WriteTool.js

@@ -4,17 +4,17 @@ import { SdkCallbackTool } from "./SdkCallbackTool.js";
 export class WriteTool extends SdkCallbackTool {
     function = {
         name: "write",
-        description: "写入文件",
+        description: "Write a file",
         parameters: {
             type: "object",
             properties: {
                 path: {
                     type: "string",
-                    description: "文件路径",
+                    description: "File path",
                 },
                 content: {
                     type: "string",
-                    description: "文件内容",
+                    description: "File content",
                 },
             },
             required: ["path", "content"],

package/dist/scope/plugins/mcp/McpConnectionManager.js

@@ -141,7 +141,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                getLogger().error(`[McpConnectionManager] 获取 "${name}" 工具列表失败: ${err?.message ?? err}`);
+                getLogger().error(`[McpConnectionManager] Failed to list tools for "${name}": ${err?.message ?? err}`);
             }
         }
         if (serverCaps?.resources) {
@@ -155,7 +155,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                getLogger().error(`[McpConnectionManager] 获取 "${name}" 资源列表失败: ${err?.message ?? err}`);
+                getLogger().error(`[McpConnectionManager] Failed to list resources for "${name}": ${err?.message ?? err}`);
             }
         }
         if (serverCaps?.prompts) {
@@ -167,7 +167,7 @@ export class McpConnectionManager {
                 }));
             }
             catch (err) {
-                getLogger().error(`[McpConnectionManager] 获取 "${name}" 提示列表失败: ${err?.message ?? err}`);
+                getLogger().error(`[McpConnectionManager] Failed to list prompts for "${name}": ${err?.message ?? err}`);
             }
         }
         const entry = this.servers.get(name) ?? { state: "connecting" };
@@ -190,7 +190,7 @@ export class McpConnectionManager {
         }
         if (config.transport === "stdio") {
             if (!config.command) {
-                throw new Error(`MCP stdio server 缺少 command`);
+                throw new Error(`MCP stdio server is missing command`);
             }
             return new StdioClientTransport({
                 command: config.command,
@@ -201,7 +201,7 @@ export class McpConnectionManager {
         // http 使用 Streamable HTTP 传输（POST + 可选 SSE 流）
         if (config.transport === "http") {
             if (!config.url) {
-                throw new Error(`MCP http server 缺少 url`);
+                throw new Error(`MCP http server is missing url`);
             }
             return new StreamableHTTPClientTransport(new URL(config.url), {
                 requestInit: config.headers ? { headers: config.headers } : undefined,
@@ -210,13 +210,13 @@ export class McpConnectionManager {
         // sse 使用旧版 HTTP+SSE 传输（GET 建立 SSE 流，POST 发送消息）
         if (config.transport === "sse") {
             if (!config.url) {
-                throw new Error(`MCP sse server 缺少 url`);
+                throw new Error(`MCP sse server is missing url`);
             }
             return new SSEClientTransport(new URL(config.url), {
                 requestInit: config.headers ? { headers: config.headers } : undefined,
             });
         }
-        throw new Error(`不支持的 MCP transport 类型: ${config.transport}`);
+        throw new Error(`Unsupported MCP transport type: ${config.transport}`);
     }
     // ---- 断开 ----
     async disconnect(name) {

package/dist/scope/plugins/mcp/discover.js

@@ -82,7 +82,7 @@ export async function discoverMcpServers(paths) {
             }
         }
         catch (err) {
-            getLogger().warn(`[sdk] 解析 MCP 配置失败: ${path} — ${err?.message ?? err}`);
+            getLogger().warn(`[sdk] Failed to parse MCP config: ${path} — ${err?.message ?? err}`);
         }
     }
     return items;