u1s1-cli 1.11.7 → 1.12.0

package/dist/site.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 双站点表:中国站(cn)与国际站(intl)。见 docs/region-split-architecture-2026-09-26.md 第 3 节。
+ *
+ * 站点在分发时就定好(从哪个站下载就连哪个站),界面里不放选站入口;运行时一律按
+ * 当前 baseUrl 所在站点取域名/链接,CLI 里不再散落 u1s1.io 字面量。
+ *
+ * 本模块不 import 任何本地模块:config.ts 依赖它(DEFAULT_BASE_URL、老配置迁移),
+ * 反向依赖会成环。「当前生效站点」要读配置,放在 config.ts 的 activeSite()。
+ */
+export type SiteId = "cn" | "intl";
+export interface Site {
+    id: SiteId;
+    /** 主站 origin,站内页面链接都挂在这里 */
+    origin: string;
+    /** API 根,形如 https://api.<host>/v1(由 origin 派生) */
+    apiBase: string;
+    /** 发布件(安装脚本/SHA256SUMS/便携包)所在 origin */
+    releaseOrigin: string;
+    /** 申诉/联系邮箱 */
+    contactEmail: string;
+    /** 认作本站的主机名(baseUrl 落在这些主机上即判定为本站) */
+    hosts: readonly string[];
+}
+/**
+ * 中国站当前主域(P1 起为备案域 u1s1app.com,原主域 u1s1.io 的页面 308 过来、API/下载原地服务)。
+ * apiBase / releaseOrigin / 安装命令 / 站内链接全部随之派生,老配置里的
+ * api.u1s1.io 由 migrateStoredBaseUrl 在下次保存时改写到新 apiBase。
+ */
+export declare const CN_ORIGIN = "https://u1s1app.com";
+/** origin → https://api.<host>/v1 */
+export declare function apiBaseForOrigin(origin: string): string;
+export declare const SITES: Readonly<Record<SiteId, Site>>;
+/**
+ * 历代中国站 API 根。配置文件里存的是其中之一、但不是当前中国站 apiBase 时,
+ * 读配置时换成当前值(见 migrateStoredBaseUrl),把流量逐步挪到新主域。
+ */
+export declare const LEGACY_CN_API_BASES: readonly string[];
+/** baseUrl 属于哪个站;自定义网关/localhost/解析不了的一律按中国站处理(与现状一致)。 */
+export declare function siteForBaseUrl(baseUrl: string | undefined): SiteId;
+/** baseUrl 是否落在该站(含历史主域)的主机上;自定义网关/localhost 不算,不能假定账号相通。 */
+export declare function isSiteUrl(baseUrl: string | undefined, site: SiteId): boolean;
+/** 有 cfg 在手时直接用它的 baseUrl 定站(结构类型,免得 import config.ts)。 */
+export declare function siteOf(cfg: {
+    baseUrl?: string;
+}): Site;
+/**
+ * 老配置迁移:存的是历代中国站 API 根、且与当前中国站 apiBase 不同 → 换成当前值;
+ * 其余(国际站、自定义网关、当前值)原样返回。currentCnApiBase 可注入,便于测试
+ * P1 之后的行为(P0 两者相等,这里是 no-op)。
+ */
+export declare function migrateStoredBaseUrl(stored: string | undefined, currentCnApiBase?: string): string | undefined;
+/** `u1s1 login --site <值>`:cn/china → 中国站;global/intl → 国际站;其它返回 undefined。 */
+export declare function parseSiteArg(value: string | undefined): SiteId | undefined;
+export interface SiteLinks {
+    home: string;
+    dashboard: string;
+    /** 仪表盘充值卡片深链 */
+    topup: string;
+    /** 仪表盘工单/留言区 */
+    support: string;
+    /** 仪表盘「我的站点」 */
+    sites: string;
+    guides: string;
+    status: string;
+    community: string;
+    /** 官网下载区(Desktop App) */
+    download: string;
+}
+export declare function siteLinks(site: Site | SiteId): SiteLinks;
+/** 本站官网安装命令:sh = curl … | bash(Linux/macOS),ps1 = irm … | iex(PowerShell)。 */
+export declare function installCommand(site: Site | SiteId, shell: "sh" | "ps1"): string;

package/dist/site.js

@@ -0,0 +1,123 @@
+/**
+ * 双站点表:中国站(cn)与国际站(intl)。见 docs/region-split-architecture-2026-09-26.md 第 3 节。
+ *
+ * 站点在分发时就定好(从哪个站下载就连哪个站),界面里不放选站入口;运行时一律按
+ * 当前 baseUrl 所在站点取域名/链接,CLI 里不再散落 u1s1.io 字面量。
+ *
+ * 本模块不 import 任何本地模块:config.ts 依赖它(DEFAULT_BASE_URL、老配置迁移),
+ * 反向依赖会成环。「当前生效站点」要读配置,放在 config.ts 的 activeSite()。
+ */
+/**
+ * 中国站当前主域(P1 起为备案域 u1s1app.com,原主域 u1s1.io 的页面 308 过来、API/下载原地服务)。
+ * apiBase / releaseOrigin / 安装命令 / 站内链接全部随之派生,老配置里的
+ * api.u1s1.io 由 migrateStoredBaseUrl 在下次保存时改写到新 apiBase。
+ */
+export const CN_ORIGIN = "https://u1s1app.com";
+const INTL_ORIGIN = "https://u1s1.dev";
+/** origin → https://api.<host>/v1 */
+export function apiBaseForOrigin(origin) {
+    const url = new URL(origin);
+    return `${url.protocol}//api.${url.host}/v1`;
+}
+export const SITES = {
+    cn: {
+        id: "cn",
+        origin: CN_ORIGIN,
+        apiBase: apiBaseForOrigin(CN_ORIGIN),
+        releaseOrigin: CN_ORIGIN,
+        // 邮件域已切到 u1s1app.com(2026-09-30);contact@u1s1.io 仍能收信,老版本照旧可用
+        contactEmail: "contact@u1s1app.com",
+        hosts: ["u1s1.io", "www.u1s1.io", "api.u1s1.io", "u1s1app.com", "www.u1s1app.com", "api.u1s1app.com"],
+    },
+    intl: {
+        id: "intl",
+        origin: INTL_ORIGIN,
+        apiBase: apiBaseForOrigin(INTL_ORIGIN),
+        releaseOrigin: INTL_ORIGIN,
+        contactEmail: "contact@u1s1.dev",
+        hosts: ["u1s1.dev", "www.u1s1.dev", "api.u1s1.dev"],
+    },
+};
+/**
+ * 历代中国站 API 根。配置文件里存的是其中之一、但不是当前中国站 apiBase 时,
+ * 读配置时换成当前值(见 migrateStoredBaseUrl),把流量逐步挪到新主域。
+ */
+export const LEGACY_CN_API_BASES = ["https://api.u1s1.io/v1", "https://api.u1s1app.com/v1"];
+/** baseUrl 属于哪个站;自定义网关/localhost/解析不了的一律按中国站处理(与现状一致)。 */
+export function siteForBaseUrl(baseUrl) {
+    if (!baseUrl)
+        return "cn";
+    let host;
+    try {
+        host = new URL(baseUrl).hostname.toLowerCase();
+    }
+    catch {
+        return "cn";
+    }
+    return SITES.intl.hosts.includes(host) ? "intl" : "cn";
+}
+/** baseUrl 是否落在该站(含历史主域)的主机上;自定义网关/localhost 不算,不能假定账号相通。 */
+export function isSiteUrl(baseUrl, site) {
+    if (!baseUrl)
+        return false;
+    try {
+        return SITES[site].hosts.includes(new URL(baseUrl).hostname.toLowerCase());
+    }
+    catch {
+        return false;
+    }
+}
+/** 有 cfg 在手时直接用它的 baseUrl 定站(结构类型,免得 import config.ts)。 */
+export function siteOf(cfg) {
+    return SITES[siteForBaseUrl(cfg.baseUrl)];
+}
+function resolveSite(site) {
+    return typeof site === "string" ? SITES[site] : site;
+}
+/**
+ * 老配置迁移:存的是历代中国站 API 根、且与当前中国站 apiBase 不同 → 换成当前值;
+ * 其余(国际站、自定义网关、当前值)原样返回。currentCnApiBase 可注入,便于测试
+ * P1 之后的行为(P0 两者相等,这里是 no-op)。
+ */
+export function migrateStoredBaseUrl(stored, currentCnApiBase = SITES.cn.apiBase) {
+    if (!stored)
+        return stored;
+    const normalized = stored.replace(/\/+$/, "");
+    if (LEGACY_CN_API_BASES.includes(normalized) && normalized !== currentCnApiBase)
+        return currentCnApiBase;
+    return stored;
+}
+/** `u1s1 login --site <值>`:cn/china → 中国站;global/intl → 国际站;其它返回 undefined。 */
+export function parseSiteArg(value) {
+    switch (value?.trim().toLowerCase()) {
+        case "cn":
+        case "china":
+            return "cn";
+        case "global":
+        case "intl":
+            return "intl";
+        default:
+            return undefined;
+    }
+}
+export function siteLinks(site) {
+    const { origin } = resolveSite(site);
+    return {
+        home: origin,
+        dashboard: `${origin}/dashboard`,
+        topup: `${origin}/dashboard#usage-topup-card`,
+        support: `${origin}/dashboard#sec-support`,
+        sites: `${origin}/dashboard#sec-sites`,
+        guides: `${origin}/guides`,
+        status: `${origin}/status`,
+        community: `${origin}/community`,
+        download: `${origin}/#download`,
+    };
+}
+/** 本站官网安装命令:sh = curl … | bash(Linux/macOS),ps1 = irm … | iex(PowerShell)。 */
+export function installCommand(site, shell) {
+    const { releaseOrigin } = resolveSite(site);
+    return shell === "ps1"
+        ? `irm ${releaseOrigin}/releases/install.ps1 | iex`
+        : `curl -fsSL ${releaseOrigin}/releases/install.sh | bash`;
+}

package/dist/subagent.js

@@ -1,4 +1,5 @@
 import { createAgentSession, DefaultResourceLoader, getAgentDir, hasTrustRequiringProjectResources, ModelRuntime, ProjectTrustStore, SessionManager, SettingsManager, } from "@earendil-works/pi-coding-agent";
+import { tr } from "./i18n.js";
 // ---- 子 agent spawn 基础设施:spawn_subagent 工具与 workflow runner 共用 ----
 /** 同时在跑的子 agent 上限;超额排队,防止打爆网关。 */
 export const SUBAGENT_CONCURRENCY = 4;
@@ -20,7 +21,7 @@ export function resolveStoredProjectTrust(cwd, agentDir = getAgentDir()) {
     return new ProjectTrustStore(agentDir).get(cwd) === true;
 }
 function cancelledError(signal) {
-    return new Error("已取消", { cause: signal.reason });
+    return new Error(tr("已取消", "Cancelled"), { cause: signal.reason });
 }
 /**
  * Run one prompt while preserving the reason that stopped it. AgentSession.abort()
@@ -54,7 +55,7 @@ export async function promptSubagentSession(session, task, options) {
     if (options.signal?.aborted)
         throw cancelledError(options.signal);
     if (timedOut)
-        throw new Error(`子任务超时(${options.timeoutMs}ms)`, { cause: promptError });
+        throw new Error(tr(`子任务超时(${options.timeoutMs}ms)`, `Subtask timed out (${options.timeoutMs}ms)`), { cause: promptError });
     if (promptError)
         throw promptError;
 }
@@ -72,7 +73,7 @@ function extractFinalText(messages) {
         if (text)
             return text;
     }
-    return "(子 agent 结束但没有文本输出)";
+    return tr("(子 agent 结束但没有文本输出)", "(sub-agent finished without any text output)");
 }
 /**
  * 汇总会话内全部 assistant 消息的 token 与费用。
@@ -123,7 +124,7 @@ export async function runSubagent(opts) {
             sharedModelRuntime.getModel(providerId, modelId) ??
                 (slash === -1 ? sharedModelRuntime.getModel("u1s1", opts.model) : undefined);
         if (!model)
-            throw new Error(`找不到模型 "${opts.model}"(可用 /model 查看已配置的模型)`);
+            throw new Error(tr(`找不到模型 "${opts.model}"(可用 /model 查看已配置的模型)`, `Model "${opts.model}" not found (use /model to see configured models)`));
     }
     else if (opts.parentModel) {
         // 继承主会话模型;解析不到(端点被删等)就落回默认,不硬失败

package/dist/tools.js

@@ -5,6 +5,7 @@ import { contextProjectTrust, runPool, runSubagent, SUBAGENT_CONCURRENCY, SUBAGE
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import { generateImage, renderPage, searchWeb } from "./api.js";
+import { tr } from "./i18n.js";
 const FETCH_TIMEOUT_MS = 20_000;
 const MAX_FETCH_BYTES = 2_000_000;
 const MAX_TEXT_CHARS = 30_000;
@@ -38,7 +39,7 @@ function htmlToText(html) {
 export function truncate(text) {
     if (text.length <= MAX_TEXT_CHARS)
         return text;
-    return `${text.slice(0, MAX_TEXT_CHARS)}\n\n…（内容过长已截断，共 ${text.length} 字符）`;
+    return `${text.slice(0, MAX_TEXT_CHARS)}\n\n${tr(`…（内容过长已截断，共 ${text.length} 字符）`, `… (truncated; ${text.length} characters total)`)}`;
 }
 /**
  * 长网页按 30k 字符开窗返回:光截断而不给「怎么读下一段」,模型会拿前 30k 硬答
@@ -50,10 +51,10 @@ export function windowText(text, offset) {
     const body = text.slice(start, end);
     if (start === 0 && end === text.length)
         return { text: body, truncated: false, nextOffset: null };
-    const head = start > 0 ? `（从第 ${start} 字符起继续）\n\n` : "";
+    const head = start > 0 ? tr(`（从第 ${start} 字符起继续）\n\n`, `(continuing from character ${start})\n\n`) : "";
     const tail = end < text.length
-        ? `\n\n…（内容过长已截断：本次为第 ${start}–${end} 字符，共 ${text.length} 字符；要继续读取，用同一 url 再调一次 web_fetch 并传 offset=${end}）`
-        : `\n\n（已到末尾：第 ${start}–${end} 字符，共 ${text.length} 字符）`;
+        ? tr(`\n\n…（内容过长已截断：本次为第 ${start}–${end} 字符，共 ${text.length} 字符；要继续读取，用同一 url 再调一次 web_fetch 并传 offset=${end}）`, `\n\n… (truncated: this is characters ${start}–${end} of ${text.length}; to keep reading, call web_fetch again with the same url and offset=${end})`)
+        : tr(`\n\n（已到末尾：第 ${start}–${end} 字符，共 ${text.length} 字符）`, `\n\n(end of page: characters ${start}–${end} of ${text.length})`);
     return { text: `${head}${body}${tail}`, truncated: end < text.length, nextOffset: end < text.length ? end : null };
 }
 /** 同一页面带 offset 续读时直接命中,不再重新抓取(云端渲染是按次计费的)。 */
@@ -159,7 +160,7 @@ const SEARCH_QUERY_MAX_CHARS = 100;
 export function createSearchTool(cfg) {
     return defineTool({
         name: "web_search",
-        label: "联网搜索",
+        label: tr("联网搜索", "Web search"),
         description: "Search the web for current information. Use it for anything time-sensitive or outside the codebase: library docs, error messages, latest versions, recent events. Returns a short answer plus ranked results with URLs and snippets. Follow up with web_fetch to read a promising result in full.",
         promptSnippet: "Search the internet for up-to-date information (docs, errors, versions, current events)",
         promptGuidelines: [
@@ -181,8 +182,8 @@ export function createSearchTool(cfg) {
             const [result, options, theme, context] = args;
             const d = result.details;
             const q = d?.query ? `"${previewLine(d.query, 80)}"` : "…";
-            const n = typeof d?.count === "number" ? ` · ${d.count} 条结果` : "";
-            return compactResultRender({ result, options, theme, context, summaryLine: `🔍 搜索 ${q}${n}` });
+            const n = typeof d?.count === "number" ? tr(` · ${d.count} 条结果`, ` · ${d.count} result${d.count === 1 ? "" : "s"}`) : "";
+            return compactResultRender({ result, options, theme, context, summaryLine: tr(`🔍 搜索 ${q}${n}`, `🔍 Search ${q}${n}`) });
         },
         async execute(_toolCallId, params, signal) {
             const data = await searchWeb(cfg, { query: params.query, maxResults: params.maxResults, signal });
@@ -215,7 +216,7 @@ const SUBAGENT_MAX_TASKS = 10;
 export function createSubagentTool(getParentModel) {
     return defineTool({
         name: "spawn_subagent",
-        label: "子任务",
+        label: tr("子任务", "Subtask"),
         description: "Spawn an independent sub-agent with its own context window to complete a self-contained task, then return its final answer. " +
             "Pass `tasks` (array) to run N sub-agents concurrently — ideal for embarrassingly parallel work like translating many locale files, " +
             "reviewing several files, or researching multiple directions at once. Each sub-agent can read/write files and run commands. " +
@@ -250,10 +251,10 @@ export function createSubagentTool(getParentModel) {
             const [result, options, theme, context] = args;
             const d = result.details;
             const summary = d && typeof d.count === "number"
-                ? `🤖 子任务 ×${d.count}` +
+                ? tr(`🤖 子任务 ×${d.count}`, `🤖 Subtasks ×${d.count}`) +
                     (typeof d.ok === "number" && d.failed ? ` · ✓${d.ok} ✗${d.failed}` : "") +
                     (typeof d.seconds === "number" ? ` · ${d.seconds}s` : "")
-                : "🤖 子任务";
+                : tr("🤖 子任务", "🤖 Subtask");
             return compactResultRender({ result, options, theme, context, summaryLine: summary });
         },
         async execute(_toolCallId, params, signal, _onUpdate, ctx) {
@@ -264,7 +265,7 @@ export function createSubagentTool(getParentModel) {
                 .filter(Boolean)
                 .slice(0, SUBAGENT_MAX_TASKS);
             if (list.length === 0) {
-                throw new Error("task 和 tasks 至少填一个");
+                throw new Error(tr("task 和 tasks 至少填一个", "Provide at least one of task or tasks"));
             }
             const parentModel = getParentModel();
             const timeoutMs = Math.min(60, params.timeout_minutes ?? SUBAGENT_TIMEOUT_MS / 60_000) * 60_000;
@@ -299,10 +300,13 @@ export function createSubagentTool(getParentModel) {
                     details: { ...details, seconds: undefined },
                 };
             }
-            const lines = [`共 ${list.length} 个子任务,✓${details.ok} ✗${details.failed},用时 ${seconds}s`, ""];
+            const lines = [
+                tr(`共 ${list.length} 个子任务,✓${details.ok} ✗${details.failed},用时 ${seconds}s`, `${list.length} subtasks, ✓${details.ok} ✗${details.failed}, took ${seconds}s`),
+                "",
+            ];
             outcomes.forEach((o, i) => {
-                lines.push(`## 任务 ${i + 1}/${list.length} ${o?.ok ? "✅" : "❌"}`, "");
-                lines.push(o?.ok ? o.text : `失败:${o?.text ?? "未知错误"}`, "", "---", "");
+                lines.push(tr(`## 任务 ${i + 1}/${list.length} ${o?.ok ? "✅" : "❌"}`, `## Task ${i + 1}/${list.length} ${o?.ok ? "✅" : "❌"}`), "");
+                lines.push(o?.ok ? o.text : tr(`失败:${o?.text ?? "未知错误"}`, `Failed: ${o?.text ?? "unknown error"}`), "", "---", "");
             });
             return {
                 content: [{ type: "text", text: truncate(lines.join("\n").trim()) }],
@@ -333,12 +337,13 @@ function refImageToPayload(ref) {
         return s;
     const path = resolve(s);
     if (!existsSync(path))
-        throw new Error(`参考图不存在: ${s}`);
+        throw new Error(tr(`参考图不存在: ${s}`, `Reference image not found: ${s}`));
     const mime = REF_IMAGE_MIME[extname(path).toLowerCase()];
-    if (!mime)
-        throw new Error(`参考图格式不支持: ${s}(支持 png/jpg/jpeg/webp/bmp/gif)`);
+    if (!mime) {
+        throw new Error(tr(`参考图格式不支持: ${s}(支持 png/jpg/jpeg/webp/bmp/gif)`, `Unsupported reference image format: ${s} (supported: png/jpg/jpeg/webp/bmp/gif)`));
+    }
     if (statSync(path).size > MAX_REF_IMAGE_BYTES)
-        throw new Error(`参考图超过 10MB: ${s}`);
+        throw new Error(tr(`参考图超过 10MB: ${s}`, `Reference image exceeds 10MB: ${s}`));
     return `data:${mime};base64,${readFileSync(path).toString("base64")}`;
 }
 /** 结果落盘路径:模型没指定时按时间戳起名,已存在就加序号,不覆盖旧图。 */
@@ -380,12 +385,16 @@ async function abortableDelay(ms, signal) {
 }
 class GeneratedImageTooLargeError extends Error {
 }
+function imageTooLargeMessage(maxBytes) {
+    const mib = Math.floor(maxBytes / 1024 / 1024);
+    return tr(`图片文件超过下载上限 ${mib} MiB`, `the image file exceeds the ${mib} MiB download limit`);
+}
 async function readGeneratedImageBody(resp, maxBytes) {
     const declaredLength = Number(resp.headers.get("content-length"));
     if (Number.isFinite(declaredLength) && declaredLength > maxBytes) {
         if (resp.body)
             void resp.body.cancel("generated image body limit reached").catch(() => { });
-        throw new GeneratedImageTooLargeError(`图片文件超过下载上限 ${Math.floor(maxBytes / 1024 / 1024)} MiB`);
+        throw new GeneratedImageTooLargeError(imageTooLargeMessage(maxBytes));
     }
     if (!resp.body)
         return new Uint8Array();
@@ -399,7 +408,7 @@ async function readGeneratedImageBody(resp, maxBytes) {
                 break;
             if (total + value.byteLength > maxBytes) {
                 void reader.cancel("generated image body limit reached").catch(() => { });
-                throw new GeneratedImageTooLargeError(`图片文件超过下载上限 ${Math.floor(maxBytes / 1024 / 1024)} MiB`);
+                throw new GeneratedImageTooLargeError(imageTooLargeMessage(maxBytes));
             }
             chunks.push(value);
             total += value.byteLength;
@@ -444,21 +453,22 @@ export async function downloadGeneratedImage(url, signal, options = {}) {
             if (signal.aborted)
                 throw error;
             if (error instanceof GeneratedImageTooLargeError) {
-                throw new Error(`图片已经生成,但${error.message}。不要重新调用 generate_image,可在 24 小时内手动下载: ${url}`, { cause: error });
+                throw new Error(tr(`图片已经生成,但${error.message}。不要重新调用 generate_image,可在 24 小时内手动下载: ${url}`, `The image was generated, but ${error.message}. Do not call generate_image again; it can be downloaded manually within 24 hours: ${url}`), { cause: error });
             }
             lastError = error;
             if (attempt < attempts)
                 await abortableDelay(retryDelayMs * attempt, signal);
         }
     }
-    throw new Error(`图片已经生成,但下载失败(同一地址已重试 ${attempts} 次): ${errorDetail(lastError)}。` +
-        `不要重新调用 generate_image,可在 24 小时内手动下载: ${url}`, { cause: lastError });
+    throw new Error(tr(`图片已经生成,但下载失败(同一地址已重试 ${attempts} 次): ${errorDetail(lastError)}。` +
+        `不要重新调用 generate_image,可在 24 小时内手动下载: ${url}`, `The image was generated, but downloading it failed (retried the same URL ${attempts} times): ${errorDetail(lastError)}. ` +
+        `Do not call generate_image again; it can be downloaded manually within 24 hours: ${url}`), { cause: lastError });
 }
 /** 生图工具:走 u1s1 网关代理火山方舟 Seedream,上游 key 不落到用户机器上。 */
 export function createImageTool(cfg) {
     return defineTool({
         name: "generate_image",
-        label: "生成图片",
+        label: tr("生成图片", "Generate image"),
         description: "Generate an image from a text prompt, or edit/compose existing images, using the Seedream image model. " +
             "Saves the result as a local image file and displays it directly in supported chat UIs. " +
             "Pass local file paths or http(s) URLs in `images` to edit an image or use references (style transfer, adding elements, combining up to 10 images). " +
@@ -499,7 +509,9 @@ export function createImageTool(cfg) {
             const sizeNote = result.size ? ` (${result.size})` : "";
             const mimeType = REF_IMAGE_MIME[urlExt] ?? "image/jpeg";
             return {
-                content: [{ type: "text", text: `图片已保存并在对话中展示: ${path}${sizeNote}` }],
+                content: [
+                    { type: "text", text: tr(`图片已保存并在对话中展示: ${path}${sizeNote}`, `Image saved and shown in the chat: ${path}${sizeNote}`) },
+                ],
                 // displayImage 只给 UI 预览，不放进 content：避免每轮都把整张 2K/4K
                 // 图片送回模型占用 context。pi-web-ui 会从 tool details 序列化它。
                 details: {
@@ -541,16 +553,16 @@ async function fetchDirect(url, signal) {
         // 用户主动打断不算失败,直接往外抛,不去碰云端渲染
         if (signal?.aborted)
             throw e;
-        throw new DirectFetchError(`打不开 ${url.href}: ${e.message}`, true);
+        throw new DirectFetchError(tr(`打不开 ${url.href}: ${e.message}`, `Couldn't open ${url.href}: ${e.message}`), true);
     }
     if (!resp.ok) {
         void resp.body?.cancel("web fetch rejected HTTP response").catch(() => undefined);
-        throw new DirectFetchError(`${url.href} 返回 ${resp.status} ${resp.statusText}`, RENDER_WORTHY_STATUS.has(resp.status));
+        throw new DirectFetchError(tr(`${url.href} 返回 ${resp.status} ${resp.statusText}`, `${url.href} returned ${resp.status} ${resp.statusText}`), RENDER_WORTHY_STATUS.has(resp.status));
     }
     const type = resp.headers.get("content-type") ?? "";
     if (!/text\/|json|xml|javascript/i.test(type)) {
         void resp.body?.cancel("web fetch rejected non-text response").catch(() => undefined);
-        throw new DirectFetchError(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`, false);
+        throw new DirectFetchError(tr(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`, `${url.href} is not text content (${type || "unknown"}); can't read it`), false);
     }
     let bytes;
     try {
@@ -560,7 +572,7 @@ async function fetchDirect(url, signal) {
         if (signal?.aborted)
             throw error;
         const detail = error instanceof Error ? error.message : String(error);
-        throw new DirectFetchError(`${url.href} 正文读取失败: ${detail}`, true);
+        throw new DirectFetchError(tr(`${url.href} 正文读取失败: ${detail}`, `Failed to read the body of ${url.href}: ${detail}`), true);
     }
     const raw = decodeBody(bytes, type);
     const isHtml = /html|xml/i.test(type);
@@ -580,7 +592,7 @@ export function createFetchTool(cfg) {
     }
     return defineTool({
         name: "web_fetch",
-        label: "读取网页",
+        label: tr("读取网页", "Fetch page"),
         description: "Fetch a URL and return its readable text content (HTML is stripped to text; JSON and plain text are returned as-is). Use it to read a page found via web_search, or any URL the user pasted. If the direct fetch fails or the page needs JavaScript, it automatically retries through a cloud browser that can also clear bot-check interstitials. Long pages are returned in 30,000-character windows: when the result says it was truncated, call again with the same url and the offset it gives to read the next part.",
         promptSnippet: "Fetch a URL and convert it to readable text",
         promptGuidelines: [
@@ -602,9 +614,13 @@ export function createFetchTool(cfg) {
             const [result, options, theme, context] = args;
             const d = result.details;
             const u = previewLine(d?.url ?? "…", 90);
-            const n = typeof d?.chars === "number" ? ` · ${d.chars} 字符` : "";
-            const win = d?.offset ? ` · 从第 ${d.offset} 字符续读` : d?.truncated ? " · 只读了开头" : "";
-            const cloud = d?.via === "render" ? " · ☁ 浏览器渲染" : "";
+            const n = typeof d?.chars === "number" ? tr(` · ${d.chars} 字符`, ` · ${d.chars} chars`) : "";
+            const win = d?.offset
+                ? tr(` · 从第 ${d.offset} 字符续读`, ` · continued from char ${d.offset}`)
+                : d?.truncated
+                    ? tr(" · 只读了开头", " · first part only")
+                    : "";
+            const cloud = d?.via === "render" ? tr(" · ☁ 浏览器渲染", " · ☁ browser render") : "";
             return compactResultRender({ result, options, theme, context, summaryLine: `🌐 ${u}${n}${win}${cloud}` });
         },
         async execute(_toolCallId, params, signal) {
@@ -614,15 +630,15 @@ export function createFetchTool(cfg) {
                 url = new URL(params.url.trim().replace(/^@/, ""));
             }
             catch {
-                throw new Error(`不是合法的网址: ${params.url}`);
+                throw new Error(tr(`不是合法的网址: ${params.url}`, `Not a valid URL: ${params.url}`));
             }
             if (url.protocol !== "http:" && url.protocol !== "https:") {
-                throw new Error(`只支持 http/https,收到 ${url.protocol}`);
+                throw new Error(tr(`只支持 http/https,收到 ${url.protocol}`, `Only http/https is supported; got ${url.protocol}`));
             }
             const offset = Math.max(0, Math.floor(params.offset ?? 0));
             const ok = (text, via, contentType) => {
                 rememberPage(url.href, { text, via, contentType });
-                const win = windowText(text || "(空白页面)", offset);
+                const win = windowText(text || tr("(空白页面)", "(empty page)"), offset);
                 return {
                     content: [{ type: "text", text: `# ${url.href}\n\n${win.text}` }],
                     details: { url: url.href, contentType, via, chars: text.length, offset, truncated: win.truncated, nextOffset: win.nextOffset },
@@ -643,7 +659,7 @@ export function createFetchTool(cfg) {
                     return ok(await renderViaGateway(url, signal), "render", "text/markdown");
                 }
                 catch (re) {
-                    throw new Error(`${e.message}；云端浏览器渲染也失败: ${re.message}`, { cause: re });
+                    throw new Error(tr(`${e.message}；云端浏览器渲染也失败: ${re.message}`, `${e.message}; cloud browser rendering also failed: ${re.message}`), { cause: re });
                 }
             }
             // 直连 200 但正文近乎空:大概率是 JS 渲染的 SPA,换浏览器再试;渲染失败就退回空壳