u1s1-cli 1.11.8 → 1.13.0

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,换浏览器再试;渲染失败就退回空壳

package/dist/update.js

@@ -6,6 +6,7 @@ import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { activeSite, isPortableInstall } from "./config.js";
+import { tr } from "./i18n.js";
 import { installCommand } from "./site.js";
 import { readJsonResponseCapped, readResponseTextCapped } from "./api.js";
 const require = createRequire(import.meta.url);
@@ -81,7 +82,7 @@ export function buildWindowsUpdateLauncherScript() {
         "$inner = '-NoProfile -ExecutionPolicy Bypass -NoExit -File \"' + $PSScriptRoot + '\\update.ps1\"'",
         "$ps = (Get-Command pwsh -ErrorAction SilentlyContinue).Source",
         "if (-not $ps) { $ps = (Get-Command powershell -ErrorAction SilentlyContinue).Source }",
-        "if (-not $ps) { throw '找不到可用的 PowerShell' }",
+        tr("if (-not $ps) { throw '找不到可用的 PowerShell' }", "if (-not $ps) { throw 'No usable PowerShell found' }"),
         "Start-Process -FilePath $ps -ArgumentList $inner",
         "",
     ].join("\n");
@@ -90,7 +91,7 @@ export function buildWindowsUpdateLauncherScript() {
 export async function fetchReleaseText(name, maxBytes, timeoutMs = 30_000) {
     const url = new URL(`/releases/${name}`, releaseOrigin());
     if (url.protocol !== "https:")
-        throw new Error(`拒绝非 https 发布源: ${url.href}`);
+        throw new Error(tr(`拒绝非 https 发布源: ${url.href}`, `Refusing non-https release source: ${url.href}`));
     const res = await fetch(url, { redirect: "error", signal: AbortSignal.timeout(timeoutMs) });
     if (!res.ok)
         throw new Error(`${name}: HTTP ${res.status}`);
@@ -125,7 +126,7 @@ export async function downloadInstallScript() {
     ]);
     const check = verifyInstallScript(script, sums);
     if (check === "mismatch")
-        throw new Error("安装脚本与发布清单的 SHA256 不符,已拒绝执行");
+        throw new Error(tr("安装脚本与发布清单的 SHA256 不符,已拒绝执行", "Install script SHA256 doesn't match the release manifest; refusing to run it"));
     return { script, verified: check === "verified" };
 }
 /**
@@ -140,9 +141,9 @@ export async function downloadInstallScript() {
 async function portableSelfUpdate(latest) {
     const site = activeSite();
     if (process.platform === "win32") {
-        console.log(`正在打开更新窗口(升级到 v${latest})…`);
-        console.log("更新在新窗口里进行,本窗口会退出;装完后重新打开终端运行 u1s1 即可。");
-        console.log(`若新窗口没有出现,可手动在 PowerShell 运行: ${installCommand(site, "ps1")}`);
+        console.log(tr(`正在打开更新窗口(升级到 v${latest})…`, `Opening the update window (updating to v${latest})…`));
+        console.log(tr("更新在新窗口里进行,本窗口会退出;装完后重新打开终端运行 u1s1 即可。", "The update runs in a new window and this one will exit. When it's done, open a new terminal and run u1s1."));
+        console.log(tr(`若新窗口没有出现,可手动在 PowerShell 运行: ${installCommand(site, "ps1")}`, `If no window appears, run this in PowerShell: ${installCommand(site, "ps1")}`));
         // 不走 `cmd /c start`:start 只把**带引号**的首参当窗口标题,而 node 对
         // 无空格参数不加引号,标题会被当成命令执行(0.13.1 翻车现场)。也不走
         // spawn detached:Windows 上 detached 是 DETACHED_PROCESS——子进程**没有**
@@ -156,25 +157,25 @@ async function portableSelfUpdate(latest) {
         writeFileSync(join(dir, "launch.ps1"), buildWindowsUpdateLauncherScript());
         const res = spawnSync("powershell.exe", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", join(dir, "launch.ps1")], { stdio: "ignore", windowsHide: true, timeout: 30_000 });
         if (res.error || res.status !== 0) {
-            console.error("无法拉起更新窗口。请手动在 PowerShell 里运行:");
+            console.error(tr("无法拉起更新窗口。请手动在 PowerShell 里运行:", "Couldn't open the update window. Run this in PowerShell:"));
             console.error(`  ${installCommand(site, "ps1")}`);
             process.exit(1);
         }
         // 立刻退出释放 node.exe 的文件锁,让安装器能替换安装目录
         process.exit(0);
     }
-    console.log(`正在下载安装脚本并升级到 v${latest}…`);
-    console.log("(可能需要几分钟,期间请不要关闭窗口)");
+    console.log(tr(`正在下载安装脚本并升级到 v${latest}…`, `Downloading the install script and updating to v${latest}…`));
+    console.log(tr("(可能需要几分钟,期间请不要关闭窗口)", "(This may take a few minutes; please keep this window open)"));
     let script;
     try {
         const download = await downloadInstallScript();
         script = download.script;
         if (!download.verified) {
-            console.log("⚠ 发布清单里没有安装脚本的校验和(旧版发布),跳过脚本校验;安装包本身仍会校验。");
+            console.log(tr("⚠ 发布清单里没有安装脚本的校验和(旧版发布),跳过脚本校验;安装包本身仍会校验。", "⚠ The release manifest has no checksum for the install script (older release); skipping that check. The package itself is still verified."));
         }
     }
     catch (e) {
-        console.error(`安装脚本下载失败:${e.message}。请手动运行:`);
+        console.error(tr(`安装脚本下载失败:${e.message}。请手动运行:`, `Couldn't download the install script: ${e.message}. Run this manually:`));
         console.error(`  ${installCommand(site, "sh")}`);
         process.exit(1);
     }
@@ -185,7 +186,7 @@ async function portableSelfUpdate(latest) {
     }
     catch {
         // 安装脚本已经打印了失败原因与重试提示(多半是到官网的链路慢),这里不再重复一整段
-        console.error("\n自动升级没有完成,稍后重试 u1s1 update 即可;已安装版本不受影响。");
+        console.error(tr("\n自动升级没有完成,稍后重试 u1s1 update 即可;已安装版本不受影响。", "\nThe update didn't finish. Try u1s1 update again later; your installed version is unaffected."));
         process.exit(1);
     }
     // 脚本退出码 0 ≠ 升级成功:安装脚本认的是官网 LATEST 版本源,它若认为
@@ -200,27 +201,27 @@ async function portableSelfUpdate(latest) {
         // 老版布局没这文件,确认不了就不下结论
     }
     if (installedVer === latest) {
-        console.log(`\n✅ 已升级到 v${latest},重新运行 u1s1 生效。`);
+        console.log(tr(`\n✅ 已升级到 v${latest},重新运行 u1s1 生效。`, `\n✅ Updated to v${latest}. Restart u1s1 to use it.`));
     }
     else {
-        console.error(`\n⚠ 安装脚本跑完了,但没装上 v${latest}(官网版本源可能滞后,当前仍是 v${installedVer ?? VERSION})。`);
-        console.error("  请稍后重试 u1s1 update,或手动运行:");
+        console.error(tr(`\n⚠ 安装脚本跑完了,但没装上 v${latest}(官网版本源可能滞后,当前仍是 v${installedVer ?? VERSION})。`, `\n⚠ The install script finished but v${latest} wasn't installed (the release feed may lag; still on v${installedVer ?? VERSION}).`));
+        console.error(tr("  请稍后重试 u1s1 update,或手动运行:", "  Try u1s1 update again later, or run:"));
         console.error(`  ${installCommand(site, "sh")}`);
         process.exit(1);
     }
 }
 export async function update() {
-    console.log("正在检查更新…");
+    console.log(tr("正在检查更新…", "Checking for updates…"));
     const latest = await getLatestVersion();
     if (!latest) {
-        console.error("无法获取最新版本。请检查网络连接后重试。");
+        console.error(tr("无法获取最新版本。请检查网络连接后重试。", "Couldn't get the latest version. Check your connection and try again."));
         process.exit(1);
     }
     if (compareVersions(latest, VERSION) <= 0) {
-        console.log(`当前 v${VERSION} 已是最新版本 ✓`);
+        console.log(tr(`当前 v${VERSION} 已是最新版本 ✓`, `v${VERSION} is the latest version ✓`));
         return;
     }
-    console.log(`发现新版本 v${latest} (当前 v${VERSION})`);
+    console.log(tr(`发现新版本 v${latest} (当前 v${VERSION})`, `New version v${latest} available (current v${VERSION})`));
     // 便携版:npm 装到全局目录,但 PATH 先命中便携目录,怎么更都还是旧版。
     // 正确方式是重跑官网安装脚本整包替换 —— 这里直接替用户跑,不再让人手抄命令。
     if (isPortableInstall()) {
@@ -233,31 +234,31 @@ export async function update() {
     const required = requiredNodeVersion();
     if (required && compareVersions(process.versions.node, required) < 0) {
         const cmd = process.platform === "win32"
-            ? `${installCommand(activeSite(), "ps1")}   (在 PowerShell 里运行)`
+            ? tr(`${installCommand(activeSite(), "ps1")}   (在 PowerShell 里运行)`, `${installCommand(activeSite(), "ps1")}   (run in PowerShell)`)
             : installCommand(activeSite(), "sh");
         console.log("");
-        console.log(`⚠ 你电脑的 Node.js 是 v${process.versions.node},新版 u1s1 建议 v${required} 或更新。`);
-        console.log("  推荐用官网安装命令重装,自带合适的 Node,一步到位:");
+        console.log(tr(`⚠ 你电脑的 Node.js 是 v${process.versions.node},新版 u1s1 建议 v${required} 或更新。`, `⚠ Your Node.js is v${process.versions.node}; the new u1s1 recommends v${required} or later.`));
+        console.log(tr("  推荐用官网安装命令重装,自带合适的 Node,一步到位:", "  We recommend reinstalling with the official installer, which bundles a suitable Node:"));
         console.log(`    ${cmd}`);
-        console.log("  下面仍会继续用 npm 更新;更新后如果运行异常,再用上面的命令重装即可。");
+        console.log(tr("  下面仍会继续用 npm 更新;更新后如果运行异常,再用上面的命令重装即可。", "  Continuing with the npm update anyway; if u1s1 misbehaves afterwards, reinstall with the command above."));
         console.log("");
     }
-    console.log(`正在用 ${pm} 更新 ${PACKAGE_NAME}…`);
+    console.log(tr(`正在用 ${pm} 更新 ${PACKAGE_NAME}…`, `Updating ${PACKAGE_NAME} with ${pm}…`));
     try {
         // npm 压掉 EBADENGINE 等警告墙,对新手只有噪音;出错时 error 仍会显示
         const args = pm === "npm"
             ? ["install", "-g", "--loglevel=error", `${PACKAGE_NAME}@latest`]
             : ["add", "-g", `${PACKAGE_NAME}@latest`];
         execFileSync(pm, args, { stdio: "inherit" });
-        console.log(`\n✅ 已更新到 v${latest}，重启 u1s1 后生效。`);
+        console.log(tr(`\n✅ 已更新到 v${latest}，重启 u1s1 后生效。`, `\n✅ Updated to v${latest}. Restart u1s1 to use it.`));
     }
     catch {
         // 再让用户手抄同一条命令多半还是失败(最常见是全局目录没写权限),
         // 直接给能跳出循环的路:官网安装脚本(装进用户目录,不需要管理员权限)
-        console.error("\n更新失败(上面是包管理器的报错,常见原因是全局目录没有写权限)。");
-        console.error("推荐改用官网安装脚本重装,不需要管理员权限,一步到位:");
+        console.error(tr("\n更新失败(上面是包管理器的报错,常见原因是全局目录没有写权限)。", "\nUpdate failed (see the package manager error above; usually no write access to the global directory)."));
+        console.error(tr("推荐改用官网安装脚本重装,不需要管理员权限,一步到位:", "We recommend reinstalling with the official installer instead; no admin rights needed:"));
         console.error(process.platform === "win32"
-            ? `  ${installCommand(activeSite(), "ps1")}   (在 PowerShell 里运行)`
+            ? tr(`  ${installCommand(activeSite(), "ps1")}   (在 PowerShell 里运行)`, `  ${installCommand(activeSite(), "ps1")}   (run in PowerShell)`)
             : `  ${installCommand(activeSite(), "sh")}`);
         process.exit(1);
     }

package/dist/usage.d.ts

@@ -11,7 +11,7 @@ export declare function topupUrl(site?: Site): string;
 export declare function usageCtaLines(me?: Pick<MeResponse, "pay_enabled">, site?: Site): string[];
 /** 额度报告正文(不含首尾空行),终端 `u1s1 usage` 和会话内 /usage 共用。 */
 export declare function usageReportLines(me: MeResponse, site?: Site): string[];
-/** 会话内 /usage 用:拉取额度并打包成 entry data,错误转成中文提示而不是抛出。 */
+/** 会话内 /usage 用:拉取额度并打包成 entry data,错误转成提示文字而不是抛出。 */
 export declare function usageEntryData(): Promise<{
     lines?: string[];
     error?: string;