u1s1-cli 1.11.8 → 1.13.0

package/dist/deploy.js

@@ -4,6 +4,7 @@ import { VERSION, u1s1Dir } from "./config.js";
 import { authorizedFetch } from "./device-auth.js";
 import { readJsonResponseCapped } from "./api.js";
 import { markNudge } from "./nudges.js";
+import { tr } from "./i18n.js";
 import { askLine } from "./prompt.js";
 import { sendTelemetryEvent } from "./telemetry.js";
 import { siteLinks, siteOf } from "./site.js";
@@ -68,10 +69,10 @@ function resolveSiteDir(explicit) {
     if (explicit) {
         const dir = resolve(explicit);
         if (!existsSync(dir) || !statSync(dir).isDirectory()) {
-            throw new Error(`目录不存在:${dir}`);
+            throw new Error(tr(`目录不存在:${dir}`, `Directory not found: ${dir}`));
         }
         if (!existsSync(join(dir, "index.html"))) {
-            throw new Error(`${dir} 里没有 index.html,网站需要一个首页`);
+            throw new Error(tr(`${dir} 里没有 index.html,网站需要一个首页`, `${dir} has no index.html; a site needs a home page`));
         }
         return dir;
     }
@@ -82,9 +83,11 @@ function resolveSiteDir(explicit) {
     }
     if (existsSync(join(cwd, "index.html")))
         return cwd;
-    throw new Error("这里找不到能发布的网页(index.html)。\n" +
+    throw new Error(tr("这里找不到能发布的网页(index.html)。\n" +
         "  在网站目录里运行 u1s1 deploy,或指定目录:u1s1 deploy <目录>\n" +
-        "  如果项目需要构建(如 Vite/Next),先跑构建再部署 dist/ 等产物目录");
+        "  如果项目需要构建(如 Vite/Next),先跑构建再部署 dist/ 等产物目录", "No publishable page (index.html) found here.\n" +
+        "  Run u1s1 deploy in your site directory, or pass one: u1s1 deploy <dir>\n" +
+        "  If the project needs a build step (Vite/Next etc.), build first and deploy dist/ or similar"));
 }
 export function collectFiles(root) {
     const files = [];
@@ -133,23 +136,23 @@ export function parseDeployArgs(args) {
         if (arg === "--name" || arg === "-n") {
             const value = args[++i];
             if (!value || value.startsWith("-"))
-                throw new Error(`${arg} 后面需要站点名`);
+                throw new Error(tr(`${arg} 后面需要站点名`, `${arg} needs a site name`));
             parsed.name = value.toLowerCase();
         }
         else if (arg.startsWith("--name=")) {
             parsed.name = arg.slice(7).toLowerCase();
             if (!parsed.name)
-                throw new Error("--name 后面需要站点名");
+                throw new Error(tr("--name 后面需要站点名", "--name needs a site name"));
         }
         else if (arg === "--public" || arg === "--private") {
             const visibility = arg.slice(2);
             if (parsed.visibility && parsed.visibility !== visibility) {
-                throw new Error("--public 和 --private 不能同时使用");
+                throw new Error(tr("--public 和 --private 不能同时使用", "--public and --private can't be used together"));
             }
             parsed.visibility = visibility;
         }
         else if (arg.startsWith("-")) {
-            throw new Error(`不认识的 deploy 参数:${arg}`);
+            throw new Error(tr(`不认识的 deploy 参数:${arg}`, `Unknown deploy option: ${arg}`));
         }
         else {
             parsed.dirArg = arg;
@@ -168,7 +171,7 @@ async function api(cfg, request) {
         });
     }
     catch {
-        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+        throw new Error(tr(`连不上 ${cfg.baseUrl},检查一下网络?`, `Can't reach ${cfg.baseUrl}. Check your network?`));
     }
     const value = await readJsonResponseCapped(resp, MAX_DEPLOY_API_RESPONSE_BYTES).catch(() => null);
     const data = value && typeof value === "object" && !Array.isArray(value)
@@ -180,7 +183,7 @@ async function api(cfg, request) {
             : undefined;
         const message = typeof detail?.message === "string"
             ? detail.message.slice(0, 2_000)
-            : `服务端返回 ${resp.status},稍后再试`;
+            : tr(`服务端返回 ${resp.status},稍后再试`, `Server returned ${resp.status}. Please try again later.`);
         const e = new Error(message);
         if (typeof detail?.code === "string" && detail.code.length <= 100) {
             e.code = detail.code;
@@ -188,7 +191,7 @@ async function api(cfg, request) {
         throw e;
     }
     if (!data)
-        throw new Error("服务端部署响应格式不正确");
+        throw new Error(tr("服务端部署响应格式不正确", "Unexpected deploy response from the server"));
     return data;
 }
 /** 逐个上传,失败重试一次;并发数保守取 6。 */
@@ -218,12 +221,12 @@ async function uploadAll(cfg, start, files) {
             const body = value && typeof value === "object" && !Array.isArray(value) ? value : null;
             const message = body?.error && typeof body.error === "object" && typeof body.error.message === "string"
                 ? body.error.message.slice(0, 2_000)
-                : "网络错误";
-            throw new Error(`上传 ${f.path} 失败:${message}`);
+                : tr("网络错误", "network error");
+            throw new Error(tr(`上传 ${f.path} 失败:${message}`, `Failed to upload ${f.path}: ${message}`));
         }
         void resp.body?.cancel("deploy upload completed").catch(() => { });
         done++;
-        process.stdout.write(`\r  上传中 ${done}/${files.length}  ${f.path.slice(0, 48).padEnd(48)}`);
+        process.stdout.write(tr(`\r  上传中 ${done}/${files.length}  ${f.path.slice(0, 48).padEnd(48)}`, `\r  Uploading ${done}/${files.length}  ${f.path.slice(0, 48).padEnd(48)}`));
     };
     const workers = Array.from({ length: Math.min(6, queue.length) }, async () => {
         for (let f = queue.shift(); f; f = queue.shift())
@@ -238,60 +241,60 @@ async function uploadAll(cfg, start, files) {
     }
 }
 async function promptSiteName(def) {
-    return (await askLine(`  项目名(回车用 ${def}，只需在你的账号内唯一):`, def)).toLowerCase();
+    return (await askLine(tr(`  项目名(回车用 ${def}，只需在你的账号内唯一):`, `  Project name (Enter for ${def}; only needs to be unique in your account): `), def)).toLowerCase();
 }
 async function promptVisibility() {
     if (!process.stdin.isTTY)
         return "private";
     while (true) {
-        const answer = (await askLine("  发布方式  [1] 公开(进入作品社区)  [2] 私密(仅自己登录后可看,默认):")).toLowerCase();
+        const answer = (await askLine(tr("  发布方式  [1] 公开(进入作品社区)  [2] 私密(仅自己登录后可看,默认):", "  Visibility  [1] Public (listed in the community)  [2] Private (only you, when signed in; default): "))).toLowerCase();
         if (!answer || answer === "2" || answer === "private" || answer === "私密")
             return "private";
         if (answer === "1" || answer === "public" || answer === "公开")
             return "public";
-        console.log("  请输入 1 或 2");
+        console.log(tr("  请输入 1 或 2", "  Please enter 1 or 2"));
     }
 }
 async function listDeployments(cfg) {
     const { sites } = await api(cfg, { method: "GET", path: "/deploy/sites" });
     if (!sites.length) {
-        console.log("  还没有部署过站点。在网页目录里跑 u1s1 deploy 试试。");
+        console.log(tr("  还没有部署过站点。在网页目录里跑 u1s1 deploy 试试。", "  No sites deployed yet. Try u1s1 deploy in your site directory."));
         return;
     }
     console.log("");
     for (const site of sites) {
         const visibility = site.visibility === "private"
-            ? "私密"
-            : site.community_listed ? "公开(社区)" : "公开(未展示)";
+            ? tr("私密", "private")
+            : site.community_listed ? tr("公开(社区)", "public (community)") : tr("公开(未展示)", "public (unlisted)");
         console.log(`  ${site.deployed ? "●" : "○"} ${site.url}  ${visibility} · ${fmtBytes(site.total_bytes)} · ${site.updated_at} UTC`);
     }
     console.log("");
 }
 async function confirmRemoval(url) {
-    const answer = (await askLine(`  确定删除 ${url} 吗?网址会立即失效,站点文件会被清除,无法恢复。输入 y 确认:`)).toLowerCase();
+    const answer = (await askLine(tr(`  确定删除 ${url} 吗?网址会立即失效,站点文件会被清除,无法恢复。输入 y 确认:`, `  Delete ${url}? The URL stops working immediately and the files are erased for good. Type y to confirm: `))).toLowerCase();
     return answer === "y" || answer === "yes";
 }
 async function removeDeployment(cfg, args) {
     const yes = args.some((arg) => arg === "--yes" || arg === "-y");
     const positional = args.filter((arg) => !arg.startsWith("-"));
     if (positional.length !== 1) {
-        throw new Error("用法:u1s1 deploy remove <站点名或网址> [--yes]");
+        throw new Error(tr("用法:u1s1 deploy remove <站点名或网址> [--yes]", "Usage: u1s1 deploy remove <site name or URL> [--yes]"));
     }
     const reference = siteReferenceFromInput(positional[0]);
     if (!reference)
-        throw new Error("站点名不能为空");
+        throw new Error(tr("站点名不能为空", "Site name can't be empty"));
     // 先按列表核对,拿到完整网址给确认提示;名字打错在这里就能提前发现
     const { sites } = await api(cfg, { method: "GET", path: "/deploy/sites" });
     const site = sites.find((s) => (s.slug || s.name) === reference || s.name === reference);
     if (!site) {
-        throw new Error(`没有找到站点「${reference}」。运行 u1s1 deploy list 查看已有站点`);
+        throw new Error(tr(`没有找到站点「${reference}」。运行 u1s1 deploy list 查看已有站点`, `Site "${reference}" not found. Run u1s1 deploy list to see your sites`));
     }
     if (!yes) {
         if (!process.stdin.isTTY) {
-            throw new Error("非交互环境下删除站点需要加 --yes 明确确认");
+            throw new Error(tr("非交互环境下删除站点需要加 --yes 明确确认", "Deleting a site non-interactively requires --yes"));
         }
         if (!(await confirmRemoval(site.url))) {
-            console.log("  已取消,站点保留。");
+            console.log(tr("  已取消,站点保留。", "  Cancelled; the site was kept."));
             return;
         }
     }
@@ -301,8 +304,8 @@ async function removeDeployment(cfg, args) {
     });
     forgetSite(site.slug || site.name);
     console.log("");
-    console.log(`  ✓ 已删除 ${site.url}`);
-    console.log("  同一个名字可以再次 u1s1 deploy 重新发布。");
+    console.log(tr(`  ✓ 已删除 ${site.url}`, `  ✓ Deleted ${site.url}`));
+    console.log(tr("  同一个名字可以再次 u1s1 deploy 重新发布。", "  You can publish under the same name again with u1s1 deploy."));
     console.log("");
 }
 async function selectDeployment(args) {
@@ -311,12 +314,12 @@ async function selectDeployment(args) {
     const dir = resolveSiteDir(dirArg);
     const files = collectFiles(dir);
     if (!files.some((file) => file.path === "index.html")) {
-        throw new Error(`${dir} 里没有 index.html,网站需要一个首页`);
+        throw new Error(tr(`${dir} 里没有 index.html,网站需要一个首页`, `${dir} has no index.html; a site needs a home page`));
     }
     const totalBytes = files.reduce((sum, file) => sum + file.bytes, 0);
     console.log("");
-    console.log(`  部署目录  ${dir}`);
-    console.log(`  文件      ${files.length} 个,共 ${fmtBytes(totalBytes)}`);
+    console.log(tr(`  部署目录  ${dir}`, `  Directory  ${dir}`));
+    console.log(tr(`  文件      ${files.length} 个,共 ${fmtBytes(totalBytes)}`, `  Files      ${files.length}, ${fmtBytes(totalBytes)} total`));
     // 站点名:--name > 上次用过的 > 交互询问(默认目录名;dist 等产物目录用项目名)
     const remembered = readDeploys()[dir];
     if (!name && remembered)
@@ -364,44 +367,45 @@ async function startDeployment(cfg, initialName) {
 function validateDeploymentLimits(start, files, totalBytes) {
     const tooBig = files.filter((file) => file.bytes > start.limits.max_file_bytes);
     if (tooBig.length) {
-        throw new Error(`这些文件超过单文件上限 ${fmtBytes(start.limits.max_file_bytes)}:\n` +
+        throw new Error(tr(`这些文件超过单文件上限 ${fmtBytes(start.limits.max_file_bytes)}:\n`, `These files exceed the per-file limit of ${fmtBytes(start.limits.max_file_bytes)}:\n`) +
             tooBig.map((file) => `    ${file.path}(${fmtBytes(file.bytes)})`).join("\n"));
     }
     if (files.length > start.limits.max_files || totalBytes > start.limits.max_total_bytes) {
-        throw new Error(`超出配额:最多 ${start.limits.max_files} 个文件 / ${fmtBytes(start.limits.max_total_bytes)}。` +
-            `当前 ${files.length} 个 / ${fmtBytes(totalBytes)}`);
+        throw new Error(tr(`超出配额:最多 ${start.limits.max_files} 个文件 / ${fmtBytes(start.limits.max_total_bytes)}。` +
+            `当前 ${files.length} 个 / ${fmtBytes(totalBytes)}`, `Over quota: at most ${start.limits.max_files} files / ${fmtBytes(start.limits.max_total_bytes)}. ` +
+            `This deploy has ${files.length} files / ${fmtBytes(totalBytes)}`));
     }
 }
 function printDeploymentResult(result, start, site) {
     const links = siteLinks(site);
-    console.log(`  ✅ 部署完成,${result.file_count} 个文件已上线`);
+    console.log(tr(`  ✅ 部署完成,${result.file_count} 个文件已上线`, `  ✅ Deployed, ${result.file_count} files live`));
     console.log("");
     console.log(`  ${result.visibility === "private" ? "🔒" : "🌐"} ${result.url}`);
     console.log("");
     if ((result.hostname || start.hostname || "").split(".").length > 3) {
-        console.log("  新 hostname 的 HTTPS 证书会由 Total TLS 自动签发，首次访问可能需要等待几分钟。");
+        console.log(tr("  新 hostname 的 HTTPS 证书会由 Total TLS 自动签发，首次访问可能需要等待几分钟。", "  The HTTPS certificate for a new hostname is issued automatically; the first visit may take a few minutes."));
     }
     if (result.visibility === "private") {
-        console.log(`  私密站点仅你可见,请从 ${links.sites} 打开。`);
+        console.log(tr(`  私密站点仅你可见,请从 ${links.sites} 打开。`, `  Private sites are only visible to you; open them from ${links.sites}`));
     }
     else if (result.community_listed) {
-        console.log(`  已进入 ${links.community} ,把网址发给朋友就能看。`);
+        console.log(tr(`  已进入 ${links.community} ,把网址发给朋友就能看。`, `  Listed on ${links.community} — share the URL with friends.`));
     }
     else {
-        console.log("  公开链接可直接访问;运行 u1s1 deploy --public 可明确加入作品社区。");
+        console.log(tr("  公开链接可直接访问;运行 u1s1 deploy --public 可明确加入作品社区。", "  The public link works for anyone; run u1s1 deploy --public to list it in the community."));
     }
-    console.log("  改完代码再跑一次 u1s1 deploy 即可更新。");
+    console.log(tr("  改完代码再跑一次 u1s1 deploy 即可更新。", "  Run u1s1 deploy again after changes to update."));
     console.log("");
 }
 export function printDeployHelp() {
     console.log("");
-    console.log("  u1s1 deploy [目录] [--name 站点名] [--public|--private]");
+    console.log(tr("  u1s1 deploy [目录] [--name 站点名] [--public|--private]", "  u1s1 deploy [dir] [--name site-name] [--public|--private]"));
     console.log("");
-    console.log("    不带参数时自动找构建产物目录(dist/build/out 等),否则用当前目录。");
-    console.log("    首次发布会问项目名和公开/私密,之后记住;再跑一次即为更新。");
+    console.log(tr("    不带参数时自动找构建产物目录(dist/build/out 等),否则用当前目录。", "    With no directory, uses a build output dir (dist/build/out etc.) if found, else the current dir."));
+    console.log(tr("    首次发布会问项目名和公开/私密,之后记住;再跑一次即为更新。", "    The first deploy asks for a name and visibility and remembers them; run it again to update."));
     console.log("");
-    console.log("  u1s1 deploy list                    查看已发布的站点");
-    console.log("  u1s1 deploy remove <站点名或网址>    删除站点(会二次确认,--yes 跳过)");
+    console.log(tr("  u1s1 deploy list                    查看已发布的站点", "  u1s1 deploy list                      List your sites"));
+    console.log(tr("  u1s1 deploy remove <站点名或网址>    删除站点(会二次确认,--yes 跳过)", "  u1s1 deploy remove <name-or-url>      Delete a site (asks to confirm; --yes skips)"));
     console.log("");
 }
 export async function deployCommand(cfg, args) {

package/dist/device-auth.js

@@ -1,6 +1,7 @@
 import { createHash, randomBytes, randomUUID, webcrypto } from "node:crypto";
 import { createServer } from "node:http";
 import { VERSION } from "./config.js";
+import { tr } from "./i18n.js";
 const enc = new TextEncoder();
 const SIGNING_PROXY_REQUEST_LIMIT_BYTES = 32 * 1024 * 1024;
 let cachedPrivate;
@@ -42,7 +43,7 @@ async function privateKey(jwk) {
 }
 export async function dpopHeaders(cfg, method, url) {
     if (!hasDeviceCredential(cfg))
-        throw new Error("当前安装还没有设备凭证，请重新运行 u1s1 login");
+        throw new Error(tr("当前安装还没有设备凭证，请重新运行 u1s1 login", "This install has no device credential yet. Run u1s1 login again."));
     const token = cfg.deviceToken;
     const header = b64url(JSON.stringify({
         typ: "dpop+jwt",
@@ -76,7 +77,7 @@ export async function authorizedFetch(cfg, input, init = {}) {
         headers.set("authorization", `Bearer ${cfg.apiKey}`);
     }
     else {
-        throw new Error("还没有登录，请运行 u1s1 login");
+        throw new Error(tr("还没有登录，请运行 u1s1 login", "Not signed in. Run u1s1 login."));
     }
     return fetch(url, { ...init, headers });
 }
@@ -214,7 +215,7 @@ function clientSurface(fallback) {
  */
 export async function ensureSigningProxy(cfg, fallbackClient = "terminal", attestationSource) {
     if (!hasDeviceCredential(cfg))
-        throw new Error("当前安装需要重新登录，以创建设备凭证");
+        throw new Error(tr("当前安装需要重新登录，以创建设备凭证", "Please sign in again to create a device credential for this install."));
     const client = clientSurface(fallbackClient);
     const current = signingProxy;
     if (current && current.token === cfg.deviceToken && current.client === client) {
@@ -286,10 +287,11 @@ export async function ensureSigningProxy(cfg, fallbackClient = "terminal", attes
             if (res.headersSent)
                 return void res.destroy(error);
             res.writeHead(502, { "content-type": "application/json" });
-            // 中文说明放前面给用户看;原始英文错误保留在括号里,pi 的重试分类正则
+            // 说明放前面给用户看;原始英文错误保留在括号里,pi 的重试分类正则
             // (fetch failed / timeout 等)和排查都还认得
             const raw = error instanceof Error ? error.message : "signing proxy failed";
-            res.end(JSON.stringify({ error: { message: `连不上 u1s1 服务器,检查一下网络?(${raw})` } }));
+            const message = tr(`连不上 u1s1 服务器,检查一下网络?(${raw})`, `Can't reach the u1s1 server. Check your network? (${raw})`);
+            res.end(JSON.stringify({ error: { message } }));
         }
     });
     await new Promise((resolve, reject) => {

package/dist/error-humanize.d.ts

@@ -16,6 +16,7 @@ import { type Site } from "./site.js";
  * 额度用尽(reason=exhausted)且今天已打卡时网关还带 error.resets_at(下次可打卡时刻,
  * 即北京时间 0 点,ISO),这里换算成「距下次可打卡还有 N 小时 M 分」接在正文后:比
  * 「北京时间 0 点」更省用户脑子。今天没打卡时网关不带 resets_at(现在就能领)。
+ * 国际站没有打卡/免费包(网关也不带 resets_at),英文界面一律不给这句。
  */
 export declare function quotaResetHint(resetsAt: unknown, now?: number): string;
 /** 只取错误里的 request_id(纯函数,给 request-trace 记「最近一次请求编号」用)。 */

package/dist/error-humanize.js

@@ -1,4 +1,5 @@
 import { activeSite } from "./config.js";
+import { isEnglish, tr } from "./i18n.js";
 import { siteLinks } from "./site.js";
 /**
  * 模型调用失败时,网关的中文说明会被 OpenAI SDK + pi-ai 包成
@@ -17,8 +18,11 @@ import { siteLinks } from "./site.js";
  * 额度用尽(reason=exhausted)且今天已打卡时网关还带 error.resets_at(下次可打卡时刻,
  * 即北京时间 0 点,ISO),这里换算成「距下次可打卡还有 N 小时 M 分」接在正文后:比
  * 「北京时间 0 点」更省用户脑子。今天没打卡时网关不带 resets_at(现在就能领)。
+ * 国际站没有打卡/免费包(网关也不带 resets_at),英文界面一律不给这句。
  */
 export function quotaResetHint(resetsAt, now = Date.now()) {
+    if (isEnglish())
+        return "";
     if (typeof resetsAt !== "string")
         return "";
     const at = Date.parse(resetsAt);
@@ -72,10 +76,10 @@ function humanizeOpaqueError(raw, site) {
         return undefined;
     const n = Number(status);
     const body = n >= 500
-        ? `服务暂时不可用,稍等再试;持续出现可看状态页 ${siteLinks(site).status}`
+        ? tr(`服务暂时不可用,稍等再试;持续出现可看状态页 ${siteLinks(site).status}`, `The service is temporarily unavailable. Please try again shortly; if it keeps happening, check the status page: ${siteLinks(site).status}`)
         : n === 429
-            ? "请求太频繁,稍等再试"
-            : "请求被拒绝,重试仍失败可运行 u1s1 feedback 反馈";
+            ? tr("请求太频繁,稍等再试", "Too many requests. Please wait a moment and try again.")
+            : tr("请求被拒绝,重试仍失败可运行 u1s1 feedback 反馈", "The request was rejected. If retrying doesn't help, run u1s1 feedback to report it.");
     return `${body} (HTTP ${status})`;
 }
 export function humanizeModelError(raw, now = Date.now(), site) {
@@ -91,13 +95,21 @@ export function humanizeModelError(raw, now = Date.now(), site) {
     const type = typeof err["type"] === "string" ? err["type"] : "";
     const status = /(?:^|\s|\()(\d{3})\b/.exec(raw.slice(0, jsonStart))?.[1];
     const requestId = typeof err["request_id"] === "string" ? err["request_id"] : "";
+    const insufficient = type === "insufficient_quota" || code === "quota_exceeded";
     const tags = [
         status ? `HTTP ${status}` : "",
-        type === "insufficient_quota" || code === "quota_exceeded" ? "insufficient_quota" : code,
-        requestId ? `请求编号 ${requestId}` : "",
+        insufficient ? "insufficient_quota" : code,
+        requestId ? tr(`请求编号 ${requestId}`, `request ID ${requestId}`) : "",
     ].filter(Boolean);
     const resetHint = err["reason"] === "exhausted" ? quotaResetHint(err["resets_at"], now) : "";
-    const body = resetHint ? `${message}〔${resetHint}〕` : message;
+    let body = resetHint ? `${message}〔${resetHint}〕` : message;
+    // 国际站(英文界面)余额不足:网关正文本该带充值链接;老网关/个别路由没带时补一句,指向本站充值卡片。
+    // 中文界面不动(中国站网关文案自带仪表盘链接,另有免费包等分流说明)
+    if (insufficient && isEnglish()) {
+        const links = siteLinks(site ?? activeSite());
+        if (!message.includes(links.dashboard))
+            body = `${body} Top up to continue → ${links.topup}`;
+    }
     const friendly = tags.length ? `${body} (${tags.join(" · ")})` : body;
     return friendly === raw ? undefined : friendly;
 }

package/dist/feedback.js

@@ -1,6 +1,7 @@
 import { readJsonResponseCapped } from "./api.js";
 import { activeSite, loadConfig, PROVIDER_ID, resolvePreferredModel, VERSION } from "./config.js";
 import { authorizedFetch, hasDeviceCredential } from "./device-auth.js";
+import { tr } from "./i18n.js";
 import { askLine } from "./prompt.js";
 import { lastRequestId } from "./request-trace.js";
 import { siteLinks, siteOf } from "./site.js";
@@ -10,13 +11,14 @@ import { siteLinks, siteOf } from "./site.js";
  * 走 POST /v1/support/tickets(设备签名),201 返回 {id, url}。
  */
 export const FEEDBACK_CATEGORIES = ["question", "bug", "billing", "suggestion", "other"];
-const CATEGORY_LABELS = {
-    question: "提问",
-    bug: "故障",
-    billing: "计费",
-    suggestion: "建议",
-    other: "其他",
-};
+// 用时求值:模块加载时还不知道站点/语言
+const categoryLabels = () => ({
+    question: tr("提问", "question"),
+    bug: tr("故障", "bug"),
+    billing: tr("计费", "billing"),
+    suggestion: tr("建议", "suggestion"),
+    other: tr("其他", "other"),
+});
 export const FEEDBACK_SUBJECT_MAX = 50;
 export const FEEDBACK_MESSAGE_MAX = 4_000;
 /** 当前站点仪表盘的工单/留言区,提交失败或服务端没回链接时的兜底入口。 */
@@ -36,7 +38,7 @@ export function parseFeedbackArgs(args) {
             continue;
         }
         if (arg.startsWith("--"))
-            throw new Error(`不认识的 feedback 参数:${arg}(可用 --bug --question --suggestion --billing)`);
+            throw new Error(tr(`不认识的 feedback 参数:${arg}(可用 --bug --question --suggestion --billing)`, `Unknown feedback option: ${arg} (use --bug --question --suggestion --billing)`));
         words.push(arg);
     }
     return { category, text: words.join(" ").trim() };
@@ -45,7 +47,7 @@ export function parseFeedbackArgs(args) {
 export function buildFeedbackRequest(input) {
     const message = input.text.replace(/\r\n?/g, "\n").trim();
     if (!message)
-        throw new Error("反馈内容不能为空");
+        throw new Error(tr("反馈内容不能为空", "Feedback can't be empty"));
     const firstLine = message.split("\n").find((l) => l.trim())?.replace(/\s+/g, " ").trim() ?? message;
     const subject = firstLine.length > FEEDBACK_SUBJECT_MAX
         ? `${firstLine.slice(0, FEEDBACK_SUBJECT_MAX - 1)}…`
@@ -90,7 +92,7 @@ export async function submitFeedback(cfg, body) {
         });
     }
     catch {
-        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+        throw new Error(tr(`连不上 ${cfg.baseUrl},检查一下网络?`, `Can't reach ${cfg.baseUrl}. Check your network?`));
     }
     const value = await readJsonResponseCapped(resp, MAX_TICKET_RESPONSE_BYTES).catch(() => null);
     const data = value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -106,7 +108,7 @@ export async function submitFeedback(cfg, body) {
 function createdOutcome(status, data, site) {
     const id = typeof data?.id === "string" || typeof data?.id === "number" ? String(data.id) : "";
     if (!id)
-        return { ok: false, status, message: "服务端工单响应格式不正确" };
+        return { ok: false, status, message: tr("服务端工单响应格式不正确", "Unexpected support ticket response from the server") };
     const url = typeof data?.url === "string" && data.url.startsWith("https://") ? data.url : supportUrl(site);
     return { ok: true, id, url };
 }
@@ -121,32 +123,40 @@ function retryAfterSeconds(resp, data) {
 function failureMessage(status, data) {
     if (typeof data?.error?.message === "string")
         return data.error.message.slice(0, 500);
-    return status === 401 ? "登录已失效,请重新运行 u1s1 login" : `服务端返回 ${status},稍后再试`;
+    return status === 401
+        ? tr("登录已失效,请重新运行 u1s1 login", "Your session has expired. Run u1s1 login to sign in again.")
+        : tr(`服务端返回 ${status},稍后再试`, `Server returned ${status}. Please try again later.`);
 }
 /** 结果措辞,终端与会话内共用(每项一行)。 */
 export function feedbackOutcomeLines(outcome, site = activeSite()) {
     if (outcome.ok) {
         return [
-            `✅ 反馈已提交,工单编号 ${outcome.id}。`,
-            `进度与回复在这里看:${outcome.url}`,
-            "我们通常会在 24 小时内回复到你的注册邮箱。",
+            tr(`✅ 反馈已提交,工单编号 ${outcome.id}。`, `✅ Feedback sent. Ticket #${outcome.id}.`),
+            tr(`进度与回复在这里看:${outcome.url}`, `Track progress and replies here: ${outcome.url}`),
+            tr("我们通常会在 24 小时内回复到你的注册邮箱。", "We usually reply to your account email within 24 hours."),
         ];
     }
     if (outcome.status === 429) {
         const wait = outcome.retryAfterSeconds
-            ? `请等 ${Math.ceil(outcome.retryAfterSeconds / 60) || 1} 分钟后再试`
-            : "请稍等几分钟再试";
-        return [`提交太频繁了,${wait}。`, `等不及的话直接到后台留言:${supportUrl(site)}`];
+            ? tr(`请等 ${Math.ceil(outcome.retryAfterSeconds / 60) || 1} 分钟后再试`, `please wait ${Math.ceil(outcome.retryAfterSeconds / 60) || 1} min and try again`)
+            : tr("请稍等几分钟再试", "please wait a few minutes and try again");
+        return [
+            tr(`提交太频繁了,${wait}。`, `Too many submissions; ${wait}.`),
+            tr(`等不及的话直接到后台留言:${supportUrl(site)}`, `Or leave a message on the dashboard: ${supportUrl(site)}`),
+        ];
     }
-    return [`提交失败:${outcome.message}`, `可以直接到后台留言:${supportUrl(site)}`];
+    return [
+        tr(`提交失败:${outcome.message}`, `Submission failed: ${outcome.message}`),
+        tr(`可以直接到后台留言:${supportUrl(site)}`, `You can leave a message on the dashboard instead: ${supportUrl(site)}`),
+    ];
 }
 export function printFeedbackHelp() {
     console.log("");
-    console.log("  u1s1 feedback [--bug|--question|--suggestion|--billing] [一句话描述]");
+    console.log(tr("  u1s1 feedback [--bug|--question|--suggestion|--billing] [一句话描述]", "  u1s1 feedback [--bug|--question|--suggestion|--billing] [short description]"));
     console.log("");
-    console.log("    不带描述时会问你一行;分类不写默认「其他」。");
-    console.log("    会自动附上版本、平台、最近一次报错的请求编号,方便我们定位。");
-    console.log(`    也可以在后台留言:${supportUrl()}`);
+    console.log(tr("    不带描述时会问你一行;分类不写默认「其他」。", "    Without a description you'll be asked for one line; the category defaults to \"other\"."));
+    console.log(tr("    会自动附上版本、平台、最近一次报错的请求编号,方便我们定位。", "    Your version, platform and the request ID of the last error are attached automatically to help us debug."));
+    console.log(tr(`    也可以在后台留言:${supportUrl()}`, `    You can also leave a message on the dashboard: ${supportUrl()}`));
     console.log("");
 }
 /** 终端命令入口。 */
@@ -158,16 +168,16 @@ export async function feedbackCommand(args) {
     }
     const cfg = loadConfig();
     if (!hasDeviceCredential(cfg)) {
-        console.error("还没登录,先跑 u1s1 login");
+        console.error(tr("还没登录,先跑 u1s1 login", "Not signed in. Run u1s1 login first."));
         process.exitCode = 1;
         return;
     }
     let text = parsed.text;
     if (!text) {
-        text = await askLine(`  想反馈什么?(${CATEGORY_LABELS[parsed.category]},一行说清即可):`);
+        text = await askLine(tr(`  想反馈什么?(${categoryLabels()[parsed.category]},一行说清即可):`, `  What's your feedback? (${categoryLabels()[parsed.category]}, one line is enough): `));
     }
     if (!text) {
-        console.error("反馈内容不能为空。用法:u1s1 feedback \"一句话描述\"");
+        console.error(tr("反馈内容不能为空。用法:u1s1 feedback \"一句话描述\"", "Feedback can't be empty. Usage: u1s1 feedback \"short description\""));
         process.exitCode = 1;
         return;
     }
@@ -191,13 +201,17 @@ export async function feedbackCommand(args) {
 export async function feedbackInSession(rawArgs, model) {
     const parsed = parseFeedbackArgs(rawArgs.split(/\s+/).filter(Boolean));
     if (parsed.help) {
-        return ["/feedback [--bug|--question|--suggestion|--billing] 一句话描述", `或到后台留言:${supportUrl()}`];
+        return [
+            tr("/feedback [--bug|--question|--suggestion|--billing] 一句话描述", "/feedback [--bug|--question|--suggestion|--billing] short description"),
+            tr(`或到后台留言:${supportUrl()}`, `Or leave a message on the dashboard: ${supportUrl()}`),
+        ];
     }
     const cfg = loadConfig();
     if (!hasDeviceCredential(cfg))
-        return ["还没登录,先在终端运行 u1s1 login"];
-    if (!parsed.text)
-        return ["反馈内容不能为空,例如:/feedback --bug 生成的网页打不开"];
+        return [tr("还没登录,先在终端运行 u1s1 login", "Not signed in. Run u1s1 login in your terminal first.")];
+    if (!parsed.text) {
+        return [tr("反馈内容不能为空,例如:/feedback --bug 生成的网页打不开", "Feedback can't be empty, e.g. /feedback --bug the generated page won't open")];
+    }
     const body = buildFeedbackRequest({
         text: parsed.text,
         category: parsed.category,
@@ -207,6 +221,9 @@ export async function feedbackInSession(rawArgs, model) {
         return feedbackOutcomeLines(await submitFeedback(cfg, body), siteOf(cfg));
     }
     catch (e) {
-        return [e instanceof Error ? e.message : String(e), `可以直接到后台留言:${supportUrl(siteOf(cfg))}`];
+        return [
+            e instanceof Error ? e.message : String(e),
+            tr(`可以直接到后台留言:${supportUrl(siteOf(cfg))}`, `You can leave a message on the dashboard instead: ${supportUrl(siteOf(cfg))}`),
+        ];
     }
 }

package/dist/i18n.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 界面语言跟站点走:国际站(u1s1.dev)英文,中国站中文;不提供语言切换
+ * (运营者 2026-10-01 定「国际版只要英文」)。站点按下载渠道定,见 site.ts。
+ *
+ * 文案就地写成 tr("中文", "English"),不做 key 表:两种语言挨着,改一处顺手改另一处。
+ * 模块顶层常量不能直接调 tr —— 那时配置可能还没读,要写成函数在用时求值。
+ *
+ * 本模块不 import 任何本地模块:config.ts 在加载时用 setLangResolver 注册「按当前站点
+ * 判定」,saveConfig 后 resetLang(),`u1s1 login --site` 切站后同进程立即换语言。
+ */
+export type Lang = "zh" | "en";
+export declare function setLangResolver(fn: () => Lang): void;
+/** 配置变了(换站)后调用,下次 lang() 重新判定。 */
+export declare function resetLang(): void;
+/**
+ * 当前界面语言。U1S1_LANG=en|zh 可强制(测试用;CLI 拉起 pi 前也写它,
+ * 让 pi 补丁里的文案跟着走,见 patches/ 与 scripts/patch-pi.js)。
+ */
+export declare function lang(): Lang;
+export declare function isEnglish(): boolean;
+export declare function tr(zh: string, en: string): string;

package/dist/i18n.js

@@ -0,0 +1,46 @@
+/**
+ * 界面语言跟站点走:国际站(u1s1.dev)英文,中国站中文;不提供语言切换
+ * (运营者 2026-10-01 定「国际版只要英文」)。站点按下载渠道定,见 site.ts。
+ *
+ * 文案就地写成 tr("中文", "English"),不做 key 表:两种语言挨着,改一处顺手改另一处。
+ * 模块顶层常量不能直接调 tr —— 那时配置可能还没读,要写成函数在用时求值。
+ *
+ * 本模块不 import 任何本地模块:config.ts 在加载时用 setLangResolver 注册「按当前站点
+ * 判定」,saveConfig 后 resetLang(),`u1s1 login --site` 切站后同进程立即换语言。
+ */
+let resolver;
+let cached;
+export function setLangResolver(fn) {
+    resolver = fn;
+    cached = undefined;
+}
+/** 配置变了(换站)后调用,下次 lang() 重新判定。 */
+export function resetLang() {
+    cached = undefined;
+}
+/**
+ * 当前界面语言。U1S1_LANG=en|zh 可强制(测试用;CLI 拉起 pi 前也写它,
+ * 让 pi 补丁里的文案跟着走,见 patches/ 与 scripts/patch-pi.js)。
+ */
+export function lang() {
+    const forced = process.env["U1S1_LANG"];
+    if (forced === "en" || forced === "zh")
+        return forced;
+    if (cached)
+        return cached;
+    if (!resolver)
+        return "zh"; // config.ts 还没加载:不缓存,免得把默认值钉死
+    try {
+        cached = resolver();
+    }
+    catch {
+        cached = "zh";
+    }
+    return cached;
+}
+export function isEnglish() {
+    return lang() === "en";
+}
+export function tr(zh, en) {
+    return lang() === "en" ? en : zh;
+}