u1s1-cli 1.11.7 → 1.12.0

package/dist/mcp/command.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 import { formatHomePath } from "../brand.js";
+import { isEnglish, tr } from "../i18n.js";
 import { McpClient } from "./client.js";
 import { loadMcpConfig, loadMcpToolCache, maskSecret, MCP_SERVER_NAME_RE, mcpConfigPath, normalizeServerConfig, parseKeyValue, saveMcpConfig, saveMcpToolCache, } from "./config.js";
 import { mcpToolName } from "./tools.js";
@@ -10,6 +11,27 @@ import { mcpToolName } from "./tools.js";
  * add 时先连一次拉工具清单再落盘,坏配置不会拖慢每次启动。
  */
 export function printMcpHelp() {
+    if (isEnglish()) {
+        console.log("");
+        console.log("  Configure third-party MCP servers so their tools (search, databases, browsers…) are available in chat");
+        console.log("");
+        console.log("  Usage:");
+        console.log("    u1s1 mcp add <name> <command> [args...]  Local command server (stdio), e.g.:");
+        console.log("        u1s1 mcp add tavily --env TAVILY_API_KEY=tvly-xxx npx -y tavily-mcp");
+        console.log("    u1s1 mcp add <name> --url <url>          HTTP server (Streamable HTTP), e.g.:");
+        console.log("        u1s1 mcp add exa --url https://mcp.exa.ai/mcp --header \"Authorization: Bearer xxx\"");
+        console.log("        --env K=V / --header \"K: V\" can be repeated; --force saves even if connecting fails");
+        console.log("    u1s1 mcp list                            List configured servers and their tools");
+        console.log("    u1s1 mcp test <name>                     Connect once and list the tools it provides");
+        console.log("    u1s1 mcp remove <name>                   Remove a server");
+        console.log("    u1s1 mcp import [--dry-run]              Import from Claude Code config (~/.claude.json, project .mcp.json)");
+        console.log("");
+        console.log(`  Config is stored in ${formatHomePath(mcpConfigPath())} (same format as Claude Code's mcpServers; safe to edit by hand).`);
+        console.log("  It stays on this machine and is never uploaded. Tools are available from your next chat, named mcp_<name>_<tool>.");
+        console.log("  Command servers run locally with your permissions; only add sources you trust.");
+        console.log("");
+        return;
+    }
     console.log("");
     console.log("  配置第三方 MCP 服务,让它提供的工具(搜索、数据库、浏览器…)在对话里直接可用");
     console.log("");
@@ -55,7 +77,7 @@ async function probe(name, server) {
 }
 function printTools(name, tools) {
     if (tools.length === 0) {
-        console.log("  (该服务没有提供任何工具)");
+        console.log(tr("  (该服务没有提供任何工具)", "  (this server provides no tools)"));
         return;
     }
     for (const t of tools) {
@@ -86,24 +108,24 @@ function applyAddOption(arg, args, cursor, opts) {
     else if (arg === "--url" || arg.startsWith("--url=")) {
         opts.url = optionValue(arg, "--url=", args, cursor);
         if (!opts.url)
-            fail("--url 后面要跟地址");
+            fail(tr("--url 后面要跟地址", "--url requires a URL"));
     }
     else if (arg === "--env" || arg === "-e" || arg.startsWith("--env=")) {
         const raw = optionValue(arg, "--env=", args, cursor);
         const kv = raw ? parseKeyValue(raw, "=") : undefined;
         if (!kv)
-            fail(`--env 要写成 KEY=VALUE:${raw ?? ""}`);
+            fail(tr(`--env 要写成 KEY=VALUE:${raw ?? ""}`, `--env must be KEY=VALUE: ${raw ?? ""}`));
         opts.env[kv[0]] = kv[1];
     }
     else if (arg === "--header" || arg === "-H" || arg.startsWith("--header=")) {
         const raw = optionValue(arg, "--header=", args, cursor);
         const kv = raw ? parseKeyValue(raw, ":") : undefined;
         if (!kv)
-            fail(`--header 要写成 "Name: value":${raw ?? ""}`);
+            fail(tr(`--header 要写成 "Name: value":${raw ?? ""}`, `--header must be "Name: value": ${raw ?? ""}`));
         opts.headers[kv[0]] = kv[1];
     }
     else if (arg.startsWith("-") && arg.length > 1) {
-        fail(`不认识的选项 ${arg}(命令自己的参数请放在命令后面,或用 -- 隔开)`);
+        fail(tr(`不认识的选项 ${arg}(命令自己的参数请放在命令后面,或用 -- 隔开)`, `Unknown option ${arg} (put the command's own arguments after the command, or separate them with --)`));
     }
     else {
         opts.command = arg;
@@ -113,26 +135,26 @@ function applyAddOption(arg, args, cursor, opts) {
 function serverFromAddOptions(name, opts) {
     const { url, command, force } = opts;
     if (url && command)
-        fail("--url 和命令只能二选一");
+        fail(tr("--url 和命令只能二选一", "Use either --url or a command, not both"));
     if (url) {
         if (!/^https?:\/\//i.test(url))
-            fail(`--url 必须是 http(s) 地址:${url}`);
+            fail(tr(`--url 必须是 http(s) 地址:${url}`, `--url must be an http(s) URL: ${url}`));
         if (Object.keys(opts.env).length)
-            fail("HTTP 型服务不支持 --env,鉴权请用 --header");
+            fail(tr("HTTP 型服务不支持 --env,鉴权请用 --header", "HTTP servers don't support --env; use --header for auth"));
         return { name, server: { type: "http", url, headers: opts.headers }, force };
     }
     if (!command)
-        fail("请给出启动命令(如 npx -y some-mcp-server)或 --url 地址");
+        fail(tr("请给出启动命令(如 npx -y some-mcp-server)或 --url 地址", "Provide a start command (e.g. npx -y some-mcp-server) or --url"));
     if (Object.keys(opts.headers).length)
-        fail("命令型服务不支持 --header,请用 --env 传密钥");
+        fail(tr("命令型服务不支持 --header,请用 --env 传密钥", "Command servers don't support --header; pass secrets with --env"));
     return { name, server: { type: "stdio", command, args: opts.commandArgs, env: opts.env }, force };
 }
 export function parseAddArgs(args) {
     const name = args[0];
     if (!name || name.startsWith("-"))
-        fail("请给服务起个名字,例:u1s1 mcp add tavily npx -y tavily-mcp");
+        fail(tr("请给服务起个名字,例:u1s1 mcp add tavily npx -y tavily-mcp", "Give the server a name, e.g. u1s1 mcp add tavily npx -y tavily-mcp"));
     if (!MCP_SERVER_NAME_RE.test(name))
-        fail(`服务名只能用小写字母、数字、- 和 _,且以字母或数字开头(最长 32 位):${name}`);
+        fail(tr(`服务名只能用小写字母、数字、- 和 _,且以字母或数字开头(最长 32 位):${name}`, `Server names may only use lowercase letters, digits, - and _, must start with a letter or digit, and be at most 32 characters: ${name}`));
     const opts = { commandArgs: [], env: {}, headers: {}, force: false };
     const cursor = { i: 1 };
     for (; cursor.i < args.length; cursor.i++) {
@@ -145,7 +167,7 @@ export function parseAddArgs(args) {
             opts.command = args[cursor.i + 1];
             opts.commandArgs.push(...args.slice(cursor.i + 2));
             if (opts.command === undefined)
-                fail("-- 后面要跟命令");
+                fail(tr("-- 后面要跟命令", "-- must be followed by a command"));
             break;
         }
         applyAddOption(a, args, cursor, opts);
@@ -156,8 +178,8 @@ async function addCommand(args) {
     const { name, server, force } = parseAddArgs(args);
     const config = loadMcpConfig();
     const existed = Boolean(config.mcpServers[name]);
-    console.log(`${existed ? "更新" : "添加"} MCP 服务 ${name}:${describeServer(server)}`);
-    console.log("连接中…");
+    console.log(tr(`${existed ? "更新" : "添加"} MCP 服务 ${name}:${describeServer(server)}`, `${existed ? "Updating" : "Adding"} MCP server ${name}: ${describeServer(server)}`));
+    console.log(tr("连接中…", "Connecting…"));
     let tools = [];
     let serverName;
     let probed = false;
@@ -167,54 +189,57 @@ async function addCommand(args) {
     }
     catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        if (!force)
-            fail(`连接失败,未保存:${message}\n  确认命令/地址和密钥无误后重试;想先保存加 --force`);
-        console.error(`⚠ 连接失败:${message}\n  已按 --force 保存,进对话前请用 u1s1 mcp test ${name} 确认可用`);
+        if (!force) {
+            fail(tr(`连接失败,未保存:${message}\n  确认命令/地址和密钥无误后重试;想先保存加 --force`, `Connection failed; nothing saved: ${message}\n  Check the command/URL and keys, then retry. To save anyway, add --force`));
+        }
+        console.error(tr(`⚠ 连接失败:${message}\n  已按 --force 保存,进对话前请用 u1s1 mcp test ${name} 确认可用`, `⚠ Connection failed: ${message}\n  Saved anyway (--force). Run u1s1 mcp test ${name} before using it in chat`));
     }
     config.mcpServers[name] = server;
     saveMcpConfig(config);
     if (probed) {
         cacheTools(name, tools, serverName);
-        console.log(`✓ 已连接${serverName ? ` ${serverName}` : ""},提供 ${tools.length} 个工具:`);
+        console.log(tr(`✓ 已连接${serverName ? ` ${serverName}` : ""},提供 ${tools.length} 个工具:`, `✓ Connected${serverName ? ` to ${serverName}` : ""}, ${tools.length} tool(s):`));
         printTools(name, tools);
     }
     else {
         dropCache(name);
     }
-    console.log(`✓ 已保存到 ${formatHomePath(mcpConfigPath())},下次进入对话即可使用`);
-    if (server.type === "stdio")
-        console.log("  提示:命令型服务会以你的权限在本机运行,只添加可信来源。");
+    console.log(tr(`✓ 已保存到 ${formatHomePath(mcpConfigPath())},下次进入对话即可使用`, `✓ Saved to ${formatHomePath(mcpConfigPath())}; available from your next chat`));
+    if (server.type === "stdio") {
+        console.log(tr("  提示:命令型服务会以你的权限在本机运行,只添加可信来源。", "  Note: command servers run locally with your permissions; only add sources you trust."));
+    }
 }
 function listCommand() {
     const config = loadMcpConfig();
     const names = Object.keys(config.mcpServers);
     if (names.length === 0) {
-        console.log("还没有配置 MCP 服务。用 u1s1 mcp add 添加,或 u1s1 mcp import 从 Claude Code 导入。");
+        console.log(tr("还没有配置 MCP 服务。用 u1s1 mcp add 添加,或 u1s1 mcp import 从 Claude Code 导入。", "No MCP servers configured yet. Add one with u1s1 mcp add, or import from Claude Code with u1s1 mcp import."));
         return;
     }
     const cache = loadMcpToolCache();
-    console.log(`已配置 ${names.length} 个 MCP 服务(${formatHomePath(mcpConfigPath())}):`);
+    console.log(tr(`已配置 ${names.length} 个 MCP 服务(${formatHomePath(mcpConfigPath())}):`, `${names.length} MCP server(s) configured (${formatHomePath(mcpConfigPath())}):`));
     for (const name of names) {
         const server = config.mcpServers[name];
         const cached = cache.servers[name];
         console.log("");
         console.log(`${name}  [${server.type}]  ${describeServer(server)}`);
         if (!cached) {
-            console.log("  工具清单尚未获取(进对话时会自动连一次;也可 u1s1 mcp test 看看)");
+            console.log(tr("  工具清单尚未获取(进对话时会自动连一次;也可 u1s1 mcp test 看看)", "  Tool list not fetched yet (fetched automatically when you start a chat, or run u1s1 mcp test)"));
             continue;
         }
-        console.log(`  ${cached.tools.length} 个工具(${cached.fetchedAt.slice(0, 16).replace("T", " ")} 获取):`);
+        const fetched = cached.fetchedAt.slice(0, 16).replace("T", " ");
+        console.log(tr(`  ${cached.tools.length} 个工具(${fetched} 获取):`, `  ${cached.tools.length} tool(s) (fetched ${fetched}):`));
         printTools(name, cached.tools);
     }
 }
 async function testCommand(name) {
     if (!name)
-        fail("用法:u1s1 mcp test 名称");
+        fail(tr("用法:u1s1 mcp test 名称", "Usage: u1s1 mcp test <name>"));
     const config = loadMcpConfig();
     const server = config.mcpServers[name];
     if (!server)
-        fail(`没有叫 ${name} 的 MCP 服务,u1s1 mcp list 看看已有的`);
-    console.log(`连接 ${name}:${describeServer(server)}`);
+        fail(tr(`没有叫 ${name} 的 MCP 服务,u1s1 mcp list 看看已有的`, `No MCP server named ${name}; run u1s1 mcp list to see configured servers`));
+    console.log(tr(`连接 ${name}:${describeServer(server)}`, `Connecting to ${name}: ${describeServer(server)}`));
     const started = Date.now();
     let tools;
     let serverName;
@@ -222,22 +247,24 @@ async function testCommand(name) {
         ({ tools, serverName } = await probe(name, server));
     }
     catch (err) {
-        fail(`连接失败:${err instanceof Error ? err.message : String(err)}`);
+        const message = err instanceof Error ? err.message : String(err);
+        fail(tr(`连接失败:${message}`, `Connection failed: ${message}`));
     }
     cacheTools(name, tools, serverName);
-    console.log(`✓ 连接成功${serverName ? `(${serverName})` : ""},${Date.now() - started} ms,提供 ${tools.length} 个工具:`);
+    const ms = Date.now() - started;
+    console.log(tr(`✓ 连接成功${serverName ? `(${serverName})` : ""},${ms} ms,提供 ${tools.length} 个工具:`, `✓ Connected${serverName ? ` (${serverName})` : ""} in ${ms} ms, ${tools.length} tool(s):`));
     printTools(name, tools);
 }
 function removeCommand(name) {
     if (!name)
-        fail("用法:u1s1 mcp remove 名称");
+        fail(tr("用法:u1s1 mcp remove 名称", "Usage: u1s1 mcp remove <name>"));
     const config = loadMcpConfig();
     if (!config.mcpServers[name])
-        fail(`没有叫 ${name} 的 MCP 服务`);
+        fail(tr(`没有叫 ${name} 的 MCP 服务`, `No MCP server named ${name}`));
     delete config.mcpServers[name];
     saveMcpConfig(config);
     dropCache(name);
-    console.log(`✓ 已删除 ${name}`);
+    console.log(tr(`✓ 已删除 ${name}`, `✓ Removed ${name}`));
 }
 /** Claude Code 的 MCP 配置:~/.claude.json(用户级 + 各项目)与项目 .mcp.json */
 export function collectClaudeMcpServers(home = homedir(), cwd = process.cwd()) {
@@ -253,11 +280,11 @@ export function collectClaudeMcpServers(home = homedir(), cwd = process.cwd()) {
                 continue;
             const server = normalizeServerConfig(raw);
             if (!server) {
-                unsupported.push(`${name}(${source})`);
+                unsupported.push(tr(`${name}(${source})`, `${name} (${source})`));
                 continue;
             }
             if (!MCP_SERVER_NAME_RE.test(name)) {
-                unsupported.push(`${name}(${source},名字不合规)`);
+                unsupported.push(tr(`${name}(${source},名字不合规)`, `${name} (${source}, invalid name)`));
                 continue;
             }
             seen.add(key);
@@ -282,7 +309,7 @@ export function collectClaudeMcpServers(home = homedir(), cwd = process.cwd()) {
     if (projects && typeof projects === "object") {
         const entry = projects[resolve(cwd)];
         if (entry && typeof entry === "object")
-            take(entry["mcpServers"], "~/.claude.json 项目配置");
+            take(entry["mcpServers"], tr("~/.claude.json 项目配置", "~/.claude.json project config"));
     }
     take(user?.["mcpServers"], "~/.claude.json");
     return { candidates, unsupported };
@@ -291,32 +318,32 @@ async function importCommand(args) {
     const dryRun = args.includes("--dry-run");
     const { candidates, unsupported } = collectClaudeMcpServers();
     for (const u of unsupported)
-        console.log(`⚠ 跳过 ${u}:只支持命令型(stdio)和 HTTP 型服务`);
+        console.log(tr(`⚠ 跳过 ${u}:只支持命令型(stdio)和 HTTP 型服务`, `⚠ Skipped ${u}: only command (stdio) and HTTP servers are supported`));
     if (candidates.length === 0) {
-        console.log("没有在 Claude Code 的配置里找到可导入的 MCP 服务。");
+        console.log(tr("没有在 Claude Code 的配置里找到可导入的 MCP 服务。", "No importable MCP servers found in Claude Code's config."));
         return;
     }
     const config = loadMcpConfig();
-    console.log(`找到 ${candidates.length} 个 MCP 服务:`);
+    console.log(tr(`找到 ${candidates.length} 个 MCP 服务:`, `Found ${candidates.length} MCP server(s):`));
     for (const c of candidates) {
-        const tag = config.mcpServers[c.name] ? "(已存在,将覆盖)" : "";
+        const tag = config.mcpServers[c.name] ? tr("(已存在,将覆盖)", "(exists, will be overwritten)") : "";
         console.log(`  ${c.name}  ${describeServer(c.server)}  ← ${c.source} ${tag}`);
     }
     if (dryRun) {
-        console.log("--dry-run:未写盘");
+        console.log(tr("--dry-run:未写盘", "--dry-run: nothing written"));
         return;
     }
     for (const c of candidates)
         config.mcpServers[c.name] = c.server;
     saveMcpConfig(config);
-    console.log(`✓ 已保存到 ${formatHomePath(mcpConfigPath())}`);
+    console.log(tr(`✓ 已保存到 ${formatHomePath(mcpConfigPath())}`, `✓ Saved to ${formatHomePath(mcpConfigPath())}`));
     let failed = 0;
     for (const c of candidates) {
-        process.stdout.write(`连接 ${c.name}… `);
+        process.stdout.write(tr(`连接 ${c.name}… `, `Connecting to ${c.name}… `));
         try {
             const { tools, serverName } = await probe(c.name, c.server);
             cacheTools(c.name, tools, serverName);
-            console.log(`✓ ${tools.length} 个工具`);
+            console.log(tr(`✓ ${tools.length} 个工具`, `✓ ${tools.length} tool(s)`));
         }
         catch (err) {
             failed += 1;
@@ -324,8 +351,9 @@ async function importCommand(args) {
             console.log(`✗ ${(err instanceof Error ? err.message : String(err)).split("\n")[0]}`);
         }
     }
-    if (failed)
-        console.log(`${failed} 个服务连接失败,进对话前请用 u1s1 mcp test 名称 排查(失败的服务不会影响其他工具)`);
+    if (failed) {
+        console.log(tr(`${failed} 个服务连接失败,进对话前请用 u1s1 mcp test 名称 排查(失败的服务不会影响其他工具)`, `${failed} server(s) failed to connect; run u1s1 mcp test <name> before chatting (failed servers don't affect other tools)`));
+    }
 }
 export async function mcpCommand(args) {
     const sub = args[0];
@@ -344,7 +372,7 @@ export async function mcpCommand(args) {
             return removeCommand(args[1]);
         if (sub === "import")
             return await importCommand(args.slice(1));
-        fail(`不认识的子命令 ${sub},u1s1 mcp --help 看用法`);
+        fail(tr(`不认识的子命令 ${sub},u1s1 mcp --help 看用法`, `Unknown subcommand ${sub}; see u1s1 mcp --help`));
     }
     catch (err) {
         if (err instanceof McpUsageError) {

package/dist/mcp/extension.js

@@ -1,4 +1,5 @@
 import { loadMcpConfig, loadMcpToolCache, sameToolList, saveMcpToolCache, } from "./config.js";
+import { tr } from "../i18n.js";
 import { McpClient } from "./client.js";
 import { createMcpToolSet } from "./tools.js";
 /**
@@ -63,7 +64,7 @@ export async function registerMcpServers(pi) {
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
             result.failed.push({ server, error: message });
-            warnings.push(`MCP 服务 ${server} 连接失败,本次会话不可用:${message.split("\n")[0]}\n  用 u1s1 mcp test ${server} 排查`);
+            warnings.push(tr(`MCP 服务 ${server} 连接失败,本次会话不可用:${message.split("\n")[0]}\n  用 u1s1 mcp test ${server} 排查`, `MCP server ${server} failed to connect and is unavailable this session: ${message.split("\n")[0]}\n  Run u1s1 mcp test ${server} to troubleshoot`));
         }
     }));
     if (cacheDirty) {
@@ -123,6 +124,7 @@ async function refreshCache(config, cache, warn) {
         }
         catch { }
     }
-    if (changed.length)
-        warn(`MCP 服务 ${changed.join("、")} 的工具列表有变化,重新进入会话后生效`);
+    if (changed.length) {
+        warn(tr(`MCP 服务 ${changed.join("、")} 的工具列表有变化,重新进入会话后生效`, `Tool list changed for MCP server ${changed.join(", ")}; takes effect in your next session`));
+    }
 }

package/dist/mcp/tools.js

@@ -1,4 +1,5 @@
 import { Text } from "@earendil-works/pi-tui";
+import { tr } from "../i18n.js";
 import { compactResultRender } from "../tools.js";
 import { McpClient } from "./client.js";
 /**
@@ -15,7 +16,7 @@ export function mcpToolName(server, tool) {
 export function truncateMcpText(text, max = MCP_MAX_TEXT_CHARS) {
     if (text.length <= max)
         return text;
-    return `${text.slice(0, max)}\n\n…（MCP 工具返回内容过长已截断，共 ${text.length} 字符，保留前 ${max} 字符）`;
+    return `${text.slice(0, max)}\n\n${tr(`…（MCP 工具返回内容过长已截断，共 ${text.length} 字符，保留前 ${max} 字符）`, `… (MCP tool output too long, truncated: ${text.length} chars total, first ${max} kept)`)}`;
 }
 /** 模型 API 只认 object 顶层;$schema 之类元字段去掉,缺 properties 补空 */
 export function toParameterSchema(inputSchema) {
@@ -46,12 +47,12 @@ export function createMcpToolSet(server, config, tools, opts = {}) {
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
             // 进程退出 / 连接断了:丢掉旧客户端,下次调用重新拉起
-            if (/已退出|已关闭|stdin/.test(message)) {
+            if (/已退出|已关闭|exited|closed|stdin/.test(message)) {
                 const old = client;
                 client = new McpClient(server, config, opts);
                 old.close().catch(() => { });
             }
-            throw new Error(`MCP 服务 ${server} 调用 ${tool.name} 失败:${message}`, { cause: err });
+            throw new Error(tr(`MCP 服务 ${server} 调用 ${tool.name} 失败:${message}`, `MCP server ${server}: calling ${tool.name} failed: ${message}`), { cause: err });
         }
     }
     for (const tool of tools) {
@@ -69,14 +70,14 @@ export function createMcpToolSet(server, config, tools, opts = {}) {
             renderResult(result, options, theme, context) {
                 const d = result.details;
                 const args = d?.args ? ` ${d.args}` : "";
-                const n = typeof d?.chars === "number" ? ` · ${d.chars} 字符${d.truncated ? "(已截断)" : ""}` : "";
+                const n = typeof d?.chars === "number" ? ` · ${tr(`${d.chars} 字符`, `${d.chars} chars`)}${d.truncated ? tr("(已截断)", " (truncated)") : ""}` : "";
                 return compactResultRender({ result, options, theme, context, summaryLine: `🔌 ${server}:${tool.name}${args}${n}` });
             },
             async execute(_toolCallId, params, signal) {
                 const args = (params && typeof params === "object" ? params : {});
                 const res = await call(tool, args, signal);
                 if (res.isError)
-                    throw new Error(`MCP 服务 ${server} 的 ${tool.name} 返回错误:${res.text || "(无详情)"}`);
+                    throw new Error(tr(`MCP 服务 ${server} 的 ${tool.name} 返回错误:${res.text || "(无详情)"}`, `MCP server ${server}: ${tool.name} returned an error: ${res.text || "(no details)"}`));
                 const text = res.text || "(empty result)";
                 return {
                     content: [{ type: "text", text: truncateMcpText(text) }],

package/dist/model.js

@@ -1,11 +1,13 @@
 import { fetchModels, loadCustomEndpoints } from "./api.js";
 import { apiModelToDef, CUSTOM_ENDPOINTS, findModel, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, resolvePreferredModel, setModelsFromApi, } from "./config.js";
+import { siteLinks, siteOf } from "./site.js";
+import { tr } from "./i18n.js";
 /** Refresh official models while preserving the built-in list as an explicit offline fallback. */
 export async function refreshOfficialModels(cfg, fetcher = fetchModels) {
     try {
         const { models } = await fetcher(cfg);
         if (models.length === 0)
-            return "线上模型列表为空";
+            return tr("线上模型列表为空", "the online model list is empty");
         setModelsFromApi(models.map(apiModelToDef));
         return null;
     }
@@ -24,7 +26,7 @@ export async function modelCommand(nameOrAlias) {
         loadCustomEndpoints(cfg),
     ]);
     if (officialModelsError) {
-        console.error(`  获取线上模型列表失败，使用内置列表：${officialModelsError}`);
+        console.error(tr(`  获取线上模型列表失败，使用内置列表：${officialModelsError}`, `  Couldn't fetch the online model list; using the built-in list: ${officialModelsError}`));
     }
     const current = resolvePreferredModel(cfg);
     if (!nameOrAlias) {
@@ -33,26 +35,26 @@ export async function modelCommand(nameOrAlias) {
             const mark = current.provider === PROVIDER_ID && m.id === current.id ? "●" : " ";
             console.log(`  ${mark} ${m.aliases[0].padEnd(10)} ${m.name}`);
             // 价格来自网关目录;离线兜底目录不带价格,只列名字与提示
-            const price = m.cost ? `$${m.cost.input}/$${m.cost.output} 每百万 token` : "";
+            const price = m.cost ? tr(`$${m.cost.input}/$${m.cost.output} 每百万 token`, `$${m.cost.input}/$${m.cost.output} per 1M tokens`) : "";
             const detail = [m.note, price].filter(Boolean).join(" · ");
             if (detail)
                 console.log(`               ${detail}`);
         }
         for (const ep of CUSTOM_ENDPOINTS) {
             console.log("");
-            console.log(`  ─ 自定义端点 ${ep.name}(${ep.baseUrl},走本地直连不计费)`);
+            console.log(tr(`  ─ 自定义端点 ${ep.name}(${ep.baseUrl},走本地直连不计费)`, `  ─ Custom endpoint ${ep.name} (${ep.baseUrl}, direct connection, not billed)`));
             for (const m of ep.models) {
                 const mark = current.provider === ep.id && m.id === current.id ? "●" : " ";
                 console.log(`  ${mark} ${m.id.padEnd(10)} ${m.name === m.id ? "" : m.name}`);
             }
         }
         console.log("");
-        console.log("  切换:u1s1 model <model-id>(对话里 /model 同样会记住)");
+        console.log(tr("  切换:u1s1 model <model-id>(对话里 /model 同样会记住)", "  Switch: u1s1 model <model-id> (/model in a session is remembered too)"));
         if (CUSTOM_ENDPOINTS.length) {
-            console.log("  端点模型重名时可加限定:u1s1 model 端点名:模型id");
+            console.log(tr("  端点模型重名时可加限定:u1s1 model 端点名:模型id", "  If endpoint model names clash, qualify them: u1s1 model <endpoint>:<model-id>"));
         }
         else {
-            console.log("  想接自己的 API(含本机 Ollama)?去 https://u1s1.io/dashboard 配「自定义模型端点」");
+            console.log(tr(`  想接自己的 API(含本机 Ollama)?去 ${siteLinks(siteOf(cfg)).dashboard} 配「自定义模型端点」`, `  Want to use your own API (including local Ollama)? Add a custom model endpoint at ${siteLinks(siteOf(cfg)).dashboard}`));
         }
         console.log("");
         return;
@@ -61,14 +63,14 @@ export async function modelCommand(nameOrAlias) {
     if (!m) {
         const custom = CUSTOM_ENDPOINTS.flatMap((e) => e.models.map((x) => x.id));
         const all = [...MODELS.map((x) => x.aliases[0]), ...custom];
-        console.error(`  没有叫「${nameOrAlias}」的模型,可选:${all.join(" / ")}`);
+        console.error(tr(`  没有叫「${nameOrAlias}」的模型,可选:${all.join(" / ")}`, `  No model named "${nameOrAlias}". Available: ${all.join(" / ")}`));
         process.exit(1);
     }
     persistPreferredModel(cfg, m.provider, m.id);
     if (m.provider === PROVIDER_ID) {
-        console.log(`  ✓ 默认模型已切到 ${m.model.name}${m.model.note ? `(${m.model.note})` : ""}`);
+        console.log(tr(`  ✓ 默认模型已切到 ${m.model.name}${m.model.note ? `(${m.model.note})` : ""}`, `  ✓ Default model set to ${m.model.name}${m.model.note ? ` (${m.model.note})` : ""}`));
     }
     else {
-        console.log(`  ✓ 默认模型已切到 ${m.model.name}(自定义端点 ${m.providerName},本地直连不计费)`);
+        console.log(tr(`  ✓ 默认模型已切到 ${m.model.name}(自定义端点 ${m.providerName},本地直连不计费)`, `  ✓ Default model set to ${m.model.name} (custom endpoint ${m.providerName}, direct connection, not billed)`));
     }
 }

package/dist/nudges.d.ts

@@ -1,3 +1,4 @@
+import type { SiteId } from "./site.js";
 /**
  * 「只提示一次」的机器级标记,落在 ~/.u1s1/nudges.json,CLI 与桌面版共用
  * (桌面版经 u1s1-cli/embed 拿到同一份 helper)。值是 ISO 时间戳,便于事后
@@ -16,6 +17,11 @@ export declare const nudgesFile: string;
 export declare function readNudges(file?: string): NudgeState;
 export declare function hasNudge(key: NudgeKey, file?: string): boolean;
 export declare function markNudge(key: NudgeKey, file?: string): void;
-/** 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。 */
-export declare function shouldShowDeployHint(file?: string): boolean;
+/**
+ * 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。
+ * 国际站没有站点托管(网关拒绝 deploy),一律不提示。
+ */
+export declare function shouldShowDeployHint(file?: string, site?: SiteId): boolean;
+/** 老导出,固定中文;新代码用 deployHintText()(按当前语言现取)。 */
 export declare const DEPLOY_HINT_TEXT = "\u505A\u597D\u4E86\u60F3\u7ED9\u670B\u53CB\u770B\uFF1F\u8F93\u5165 /exit \u56DE\u5230\u7EC8\u7AEF,\u8FD0\u884C u1s1 deploy \u4E00\u952E\u4E0A\u7EBF";
+export declare function deployHintText(): string;

package/dist/nudges.js

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { u1s1Dir } from "./config.js";
+import { activeSite, u1s1Dir } from "./config.js";
+import { tr } from "./i18n.js";
 export const nudgesFile = join(u1s1Dir, "nudges.json");
 export function readNudges(file = nudgesFile) {
     try {
@@ -32,9 +33,27 @@ export function markNudge(key, file = nudgesFile) {
         // ignore
     }
 }
-/** 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。 */
-export function shouldShowDeployHint(file = nudgesFile) {
+/**
+ * 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。
+ * 国际站没有站点托管(网关拒绝 deploy),一律不提示。
+ */
+export function shouldShowDeployHint(file = nudgesFile, site) {
+    let siteId = site;
+    if (!siteId) {
+        try {
+            siteId = activeSite().id;
+        }
+        catch {
+            siteId = "cn";
+        }
+    }
+    if (siteId === "intl")
+        return false;
     const state = readNudges(file);
     return state.deploy_hint_shown === undefined && state.deploy_done === undefined;
 }
+/** 老导出,固定中文;新代码用 deployHintText()(按当前语言现取)。 */
 export const DEPLOY_HINT_TEXT = "做好了想给朋友看？输入 /exit 回到终端,运行 u1s1 deploy 一键上线";
+export function deployHintText() {
+    return tr(DEPLOY_HINT_TEXT, "Want to show it off? Type /exit to return to the terminal, then run u1s1 deploy to publish it.");
+}

package/dist/search-tools.js

@@ -5,6 +5,7 @@ import { join } from "node:path";
 import { Readable, Transform } from "node:stream";
 import { pipeline } from "node:stream/promises";
 import { agentDir } from "./config.js";
+import { tr } from "./i18n.js";
 /**
  * 预 seed pi 的搜索组件(fd / ripgrep)到 ~/.u1s1/agent/bin。
  *
@@ -104,7 +105,7 @@ function findBinary(root, name) {
 async function install(tool, baseUrl, binName) {
     const asset = tool.asset(tool.version);
     if (!asset)
-        throw new Error(`不支持的平台 ${platform()}/${arch()}`);
+        throw new Error(tr(`不支持的平台 ${platform()}/${arch()}`, `Unsupported platform ${platform()}/${arch()}`));
     mkdirSync(binDir, { recursive: true });
     const res = await fetch(new URL(`/tools/${asset}`, baseUrl), {
         signal: AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS),
@@ -114,7 +115,7 @@ async function install(tool, baseUrl, binName) {
     const declaredLength = Number(res.headers.get("content-length"));
     if (Number.isFinite(declaredLength) && declaredLength > MAX_TOOL_ARCHIVE_BYTES) {
         void res.body.cancel("tool archive exceeded limit").catch(() => { });
-        throw new Error(`下载文件超过 ${MAX_TOOL_ARCHIVE_BYTES} bytes`);
+        throw new Error(tr(`下载文件超过 ${MAX_TOOL_ARCHIVE_BYTES} bytes`, `Download exceeds ${MAX_TOOL_ARCHIVE_BYTES} bytes`));
     }
     const archive = join(binDir, asset);
     // fd/rg 并行安装,解压目录按工具名+pid 隔离,避免互踩
@@ -130,10 +131,10 @@ async function install(tool, baseUrl, binName) {
         await pipeline(Readable.fromWeb(res.body), limiter, createWriteStream(archive));
         mkdirSync(extractDir, { recursive: true });
         if (!extract(archive, extractDir))
-            throw new Error(`解压失败 ${asset}`);
+            throw new Error(tr(`解压失败 ${asset}`, `Failed to extract ${asset}`));
         const found = findBinary(extractDir, binName);
         if (!found)
-            throw new Error(`包内没有 ${binName}`);
+            throw new Error(tr(`包内没有 ${binName}`, `${binName} not found in the archive`));
         renameSync(found, join(binDir, binName));
         if (platform() !== "win32")
             chmodSync(join(binDir, binName), 0o755);
@@ -151,10 +152,10 @@ export async function ensureSearchTools(cfg) {
         if (missing.length === 0)
             return;
         // 这是新手首启最早看到的输出之一:说清是首次准备、不用管;fd/rg 等术语不外露
-        console.log("  首次运行,正在准备文件搜索组件(只需一次)…");
+        console.log(tr("  首次运行,正在准备文件搜索组件(只需一次)…", "  First run: setting up file search components (one-time)…"));
         const results = await Promise.allSettled(missing.map((t) => install(t, cfg.baseUrl, t.bin + ext)));
         if (results.some((r) => r.status === "rejected")) {
-            console.log("  部分搜索组件暂时没装上,不影响使用,之后会自动重试。");
+            console.log(tr("  部分搜索组件暂时没装上,不影响使用,之后会自动重试。", "  Some search components couldn't be installed yet. You can keep working; we'll retry automatically later."));
         }
     }
     catch {

package/dist/shell-doctor.js

@@ -2,6 +2,7 @@ import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, win32 } from "node:path";
 import { agentDir, agentSettingsFile } from "./config.js";
+import { tr } from "./i18n.js";
 /** System32/Sysnative 的 bash.exe 是 WSL 转发器,不是真 bash(与 pi 同款判断)。 */
 function isWslRelayBash(p) {
     const normalized = p.replace(/\//g, "\\").toLowerCase();
@@ -139,8 +140,8 @@ function persistShellPath(p) {
     return true;
 }
 function adviseInstallGitBash() {
-    console.error("  ⚠ 未找到 Git Bash,将使用 WSL 的 bash:命令会在 WSL 的 Linux 里执行,不是 Windows 本机。");
-    console.error("    建议安装 Git for Windows(PowerShell 运行: winget install --id Git.Git)后重启 u1s1。");
+    console.error(tr("  ⚠ 未找到 Git Bash,将使用 WSL 的 bash:命令会在 WSL 的 Linux 里执行,不是 Windows 本机。", "  ⚠ Git Bash not found; using WSL's bash. Commands will run inside WSL's Linux, not natively on Windows."));
+    console.error(tr("    建议安装 Git for Windows(PowerShell 运行: winget install --id Git.Git)后重启 u1s1。", "    We recommend installing Git for Windows (in PowerShell: winget install --id Git.Git), then restarting u1s1."));
 }
 export async function ensureUsableShell() {
     if (process.platform !== "win32")
@@ -164,7 +165,7 @@ export async function ensureUsableShell() {
         const candidate = await findUsableGitBash();
         if (candidate) {
             persistShellPath(candidate);
-            console.error(`  检测到 Git Bash,命令改回 Windows 本机执行: ${candidate}`);
+            console.error(tr(`  检测到 Git Bash,命令改回 Windows 本机执行: ${candidate}`, `  Found Git Bash; commands will run natively on Windows again: ${candidate}`));
             return { status: "bash", shellPath: candidate };
         }
         adviseInstallGitBash();
@@ -175,7 +176,7 @@ export async function ensureUsableShell() {
     const adopt = (candidate) => {
         persistShellPath(candidate);
         if (typeof configured === "string") {
-            console.error(`  原 shellPath 已失效,自动改用: ${candidate}`);
+            console.error(tr(`  原 shellPath 已失效,自动改用: ${candidate}`, `  The configured shellPath no longer works; switched to: ${candidate}`));
         }
         return { status: "bash", shellPath: candidate };
     };
@@ -195,14 +196,14 @@ export async function ensureUsableShell() {
         return { status: "bash", shellPath: fallback };
     }
     if (fallback) {
-        console.error(`  ⚠ 检测到的 bash(${fallback})无法执行命令,u1s1 的命令工具会全部失败。`);
+        console.error(tr(`  ⚠ 检测到的 bash(${fallback})无法执行命令,u1s1 的命令工具会全部失败。`, `  ⚠ The bash found (${fallback}) can't run commands, so all of u1s1's command tools will fail.`));
         if (isWslRelayBash(fallback)) {
-            console.error("    它是 WSL 转发器,当前默认发行版里没有 /bin/bash(docker-desktop 被设为默认时就会这样)。");
+            console.error(tr("    它是 WSL 转发器,当前默认发行版里没有 /bin/bash(docker-desktop 被设为默认时就会这样)。", "    It's the WSL relay, and the default distro has no /bin/bash (this happens when docker-desktop is the default)."));
         }
     }
     else {
-        console.error("  ⚠ 没找到 bash,u1s1 无法执行命令。");
+        console.error(tr("  ⚠ 没找到 bash,u1s1 无法执行命令。", "  ⚠ No bash found; u1s1 can't run commands."));
     }
-    console.error("    修复:PowerShell 里运行 winget install --id Git.Git 安装 Git for Windows,装完重启 u1s1。");
+    console.error(tr("    修复:PowerShell 里运行 winget install --id Git.Git 安装 Git for Windows,装完重启 u1s1。", "    Fix: in PowerShell, run winget install --id Git.Git to install Git for Windows, then restart u1s1."));
     return { status: "none" };
 }