npm - u1s1-cli - Versions diffs - 1.6.0 → 1.7.1 - Mend

u1s1-cli 1.6.0 → 1.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/dist/agent-setup.js CHANGED Viewed

@@ -377,6 +377,10 @@ export default async function (pi) {
   // ---- 汇总统计 ----
   let counts = {};
   let errors = 0;
+  // 工具调用被折叠后,这一行摘要是新手了解「AI 刚才做了什么」的唯一入口,内置工具名给人话
+  const TOOL_SUMMARY_LABELS: Record<string, string> = {
+    read: "读文件", write: "写文件", edit: "改文件", bash: "跑命令", grep: "搜内容", find: "找文件", ls: "列目录",
+  };
   pi.on("agent_start", async () => {
     counts = {};
     errors = 0;
@@ -392,14 +396,14 @@ export default async function (pi) {
     if (total === 0) return;
     const parts = Object.entries(counts)
       .sort((a, b) => b[1] - a[1])
-      .map(([name, n]) => name + "×" + n);
+      .map(([name, n]) => (TOOL_SUMMARY_LABELS[name] ?? name) + "×" + n);
     if (errors > 0) parts.push("✗ " + errors);
     pi.appendEntry("tool-summary", { total, summary: parts.join(" · ") });
   });
   pi.registerEntryRenderer("tool-summary", (entry, _opts, theme) => {
     const d = entry.data;
     let text = theme.fg("muted", "⚙ ");
-    text += theme.fg("toolTitle", theme.bold(d.total + " tool" + (d.total > 1 ? "s" : "")));
+    text += theme.fg("toolTitle", theme.bold(d.total + " 次工具调用"));
     text += theme.fg("dim", " · " + d.summary);
     return new Text(text, 0, 0);
   });

package/dist/api.d.ts CHANGED Viewed

@@ -24,6 +24,8 @@ export interface MeResponse {
     packages?: MePackage[];
     /** 可领取的免费包:'first' 首月包 / 'renew' 年度包 / null 已有生效中的 */
     free_claim?: "first" | "renew" | null;
+    /** 支付通道是否开放;老网关没有该字段,按开放处理(保留充值入口) */
+    pay_enabled?: boolean;
 }
 export interface MePackage {
     id: number;
@@ -63,6 +65,9 @@ export interface ModelsResponse {
 /** 401:凭证失效(设备被移除/换过钥匙),调用方应引导重新登录而不是继续硬跑。 */
 export declare class AuthError extends Error {
 }
+/** 403:登录着但被服务端拒绝(封禁/停用/设备不受信任),重新登录也没用,进 TUI 每条消息都会失败。 */
+export declare class AccessDeniedError extends Error {
+}
 export declare function fetchModels(cfg: CliConfig): Promise<ModelsResponse>;
 /**
  * 会话内公告轮询用的轻量接口:免鉴权、服务端有缓存,回的就是 /v1/models 里的 announcement

package/dist/api.js CHANGED Viewed

@@ -57,6 +57,9 @@ export async function readJsonResponseCapped(resp, maxBytes = MAX_API_RESPONSE_B
 /** 401:凭证失效(设备被移除/换过钥匙),调用方应引导重新登录而不是继续硬跑。 */
 export class AuthError extends Error {
 }
+/** 403:登录着但被服务端拒绝(封禁/停用/设备不受信任),重新登录也没用,进 TUI 每条消息都会失败。 */
+export class AccessDeniedError extends Error {
+}
 /** 网关错误壳统一是 { error: { message } };解析不出来时回退到状态码提示。 */
 async function errorMessageFromResponse(resp, fallback) {
     const body = jsonRecord(await readJsonResponseCapped(resp, MAX_API_ERROR_BYTES).catch(() => null));
@@ -76,6 +79,8 @@ export async function fetchModels(cfg) {
     }
     if (resp.status === 401)
         throw new AuthError("登录已失效,请重新运行 u1s1 login");
+    if (resp.status === 403)
+        throw new AccessDeniedError(await errorMessageFromResponse(resp, "账号当前无法使用 u1s1"));
     if (!resp.ok)
         throw new Error(await errorMessageFromResponse(resp, `服务端返回 ${resp.status},稍后再试`));
     const body = await readJsonResponseCapped(resp);

package/dist/brand.js CHANGED Viewed

@@ -54,7 +54,7 @@ function starterLines(theme) {
         ` ${theme.fg("text", "「做一个自我介绍网页,做完帮我发布出去」")}`,
         ` ${theme.fg("text", "「做一个给朋友的生日祝福页面,要有点小动画」")}`,
         ` ${theme.fg("text", "「写一个把文件夹里照片按日期重命名的小工具」")}`,
-        ` ${theme.fg("muted", "网页做好后,运行 u1s1 deploy --public 一键上线,拿到可分享的链接发给朋友")}`,
+        ` ${theme.fg("muted", "网页做好后,输入 /exit 回到终端,运行 u1s1 deploy --public 一键上线,拿到可分享的链接发给朋友")}`,
     ];
 }
 /**

package/dist/error-humanize.js CHANGED Viewed

@@ -55,10 +55,30 @@ export function extractRequestId(raw) {
     const id = payload?.err["request_id"];
     return typeof id === "string" && id.length > 0 && id.length <= 128 ? id : undefined;
 }
+/**
+ * 非 JSON 的失败体(Cloudflare 5xx HTML 页、纯文本网关错误)原样直出就是
+ * `Error: 503 <!DOCTYPE html>…` 一大坨。只认得出状态码就给一句人话,
+ * 状态码数字保留在尾巴里,pi 的重试分类(5xx/429 可重试)不受影响。
+ */
+function humanizeOpaqueError(raw) {
+    const status = /^\s*(\d{3})\b/.exec(raw)?.[1];
+    if (!status)
+        return undefined;
+    const opaque = /<\s*(?:!doctype|html)/i.test(raw) || raw.length > 400;
+    if (!opaque)
+        return undefined;
+    const n = Number(status);
+    const body = n >= 500
+        ? "服务暂时不可用,稍等再试;持续出现可看状态页 https://u1s1.io/status"
+        : n === 429
+            ? "请求太频繁,稍等再试"
+            : "请求被拒绝,重试仍失败可运行 u1s1 feedback 反馈";
+    return `${body} (HTTP ${status})`;
+}
 export function humanizeModelError(raw, now = Date.now()) {
     const payload = parseErrorPayload(raw);
     if (!payload)
-        return undefined;
+        return humanizeOpaqueError(raw);
     const { err, jsonStart } = payload;
     const message = typeof err["message"] === "string" ? err["message"].trim() : "";
     if (!message)

package/dist/import/index.js CHANGED Viewed

@@ -126,7 +126,7 @@ function parseFlags(args) {
 }
 function printHelp() {
     console.log("");
-    console.log("  把 Claude Code / Codex 的历史对话导入 u1s1");
+    console.log("  把 Claude Code / Codex 的历史对话和技能导入 u1s1");
     console.log("");
     console.log("  用法:");
     console.log("    u1s1 import              导入当前目录的对话");
@@ -136,6 +136,7 @@ function printHelp() {
     console.log("    u1s1 import --cwd 目录     指定项目目录(默认当前目录)");
     console.log("    u1s1 import --dry-run    只看会导哪些,不写盘");
     console.log("    u1s1 import --force      已经导过的也再导一遍");
+    console.log("    u1s1 import skills       导入 Claude Code / Codex 等工具的技能(SKILL.md),详见 u1s1 import skills -h");
     console.log("");
     console.log("  导入后在对应项目里跑 u1s1,输入 /resume 就能看到。");
     console.log("");
@@ -255,6 +256,11 @@ function printImportSummary(summary) {
     console.log("");
 }
 export async function importCommand(args) {
+    if (args[0] === "skills" || args[0] === "skill") {
+        const { importSkillsCommand } = await import("./skills.js");
+        await importSkillsCommand(args.slice(1));
+        return;
+    }
     if (args.includes("-h") || args.includes("--help")) {
         printHelp();
         return;

package/dist/import/skills.d.ts ADDED Viewed

@@ -0,0 +1,89 @@
+/**
+ * `u1s1 import skills`: 把 Claude Code / Codex(以及任意 --from 目录)里的
+ * Agent Skills(SKILL.md)复制进 ~/.u1s1/agent/skills。pi 用同一套 SKILL.md
+ * 规范,所以只需要按 pi 自己的加载器校验一遍,合规的原样复制,不合规的列出来跳过。
+ */
+export type SkillTool = "claude" | "codex" | "custom";
+export interface SkillSource {
+    tool: SkillTool;
+    label: string;
+    dir: string;
+    scope: "user" | "project" | "custom";
+}
+export interface DiscoveredSkill {
+    name: string;
+    description: string;
+    tool: SkillTool;
+    label: string;
+    /** SKILL.md 所在目录;单文件技能时为该 .md 文件所在目录。 */
+    baseDir: string;
+    skillFile: string;
+    /** 单文件技能(skills 根目录直接放 foo.md)只复制那一个文件。 */
+    singleFile: boolean;
+    files: number;
+    bytes: number;
+    hints: string[];
+}
+export interface SkillProblem {
+    path: string;
+    reason: string;
+}
+export interface SkillImportRecord {
+    name: string;
+    tool: SkillTool;
+    sourcePath: string;
+    destPath: string;
+    importedAt: string;
+}
+export interface SkillImportIndex {
+    version: 1;
+    items: Record<string, SkillImportRecord>;
+}
+export interface SkillImportPlan {
+    pending: DiscoveredSkill[];
+    /** 已由本命令导过、这次不重复导(--force 可重导)。 */
+    alreadyImported: DiscoveredSkill[];
+    /** 目标目录已有同名技能但不是本命令导入的,不覆盖。 */
+    conflicts: DiscoveredSkill[];
+    /** 多个来源同名,只保留先发现的那个。 */
+    duplicates: DiscoveredSkill[];
+}
+export interface SkillImportResultItem {
+    name: string;
+    status: "imported" | "error";
+    destPath?: string;
+    detail?: string;
+}
+/** 超过这个体积的技能目录多半塞了数据集或依赖,先不动。 */
+export declare const MAX_SKILL_BYTES: number;
+export declare function skillsDestDir(): string;
+export declare function skillIndexPath(): string;
+/** Claude Code / Codex 各自约定的技能目录;项目级排在用户级前面,先发现的同名技能优先。 */
+export declare function defaultSkillSources(cwd: string, home?: string): SkillSource[];
+export declare function customSkillSource(dir: string): SkillSource;
+/**
+ * 用 pi 自己的加载器扫一遍来源目录:能被 pi 认出来、且没有任何告警(名称/说明不合规)
+ * 的才算兼容,其他的进 problems 并带上 pi 给的原因。
+ */
+export declare function discoverSkills(sources: SkillSource[]): {
+    skills: DiscoveredSkill[];
+    problems: SkillProblem[];
+};
+export declare function loadSkillIndex(path?: string): SkillImportIndex;
+export declare function planSkillImport(skills: DiscoveredSkill[], opts: {
+    destDir: string;
+    index: SkillImportIndex;
+    force: boolean;
+}): SkillImportPlan;
+/** 复制到 <destDir>/<name>;单文件技能落成 <name>/SKILL.md,这样 --remove 只需删一个目录。 */
+export declare function copySkill(skill: DiscoveredSkill, destDir: string): string;
+export declare function runSkillImport(pending: DiscoveredSkill[], index: SkillImportIndex, destDir: string): SkillImportResultItem[];
+/** 只删本命令导入过的技能,别人手放进去的同名目录不碰。 */
+export declare function removeImportedSkill(name: string, index: SkillImportIndex, destDir: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function printSkillsHelp(): void;
+export declare function importSkillsCommand(args: string[]): Promise<void>;

package/dist/import/skills.js ADDED Viewed

@@ -0,0 +1,492 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join, resolve } from "node:path";
+import { loadSkillsFromDir, parseFrontmatter } from "@earendil-works/pi-coding-agent";
+import { formatHomePath } from "../brand.js";
+import { agentDir } from "../config.js";
+import { asRecord, asString, formatBytes, listHomeClaudeDirs, oneLine, uniqueExistingDirs } from "./util.js";
+import { readJsonIfExists, writeJson } from "./write.js";
+const TOOL_LABEL = {
+    claude: "Claude Code",
+    codex: "Codex",
+    custom: "自定义目录",
+};
+const SCRIPT_EXTENSIONS = new Set([".sh", ".bash", ".zsh", ".ps1", ".bat", ".cmd", ".py", ".js", ".mjs", ".cjs", ".ts", ".rb", ".pl"]);
+/** 超过这个体积的技能目录多半塞了数据集或依赖,先不动。 */
+export const MAX_SKILL_BYTES = 20 * 1024 * 1024;
+const MAX_SKILL_FILES = 2000;
+const LARGE_SKILL_BYTES = 1024 * 1024;
+export function skillsDestDir() {
+    return join(agentDir, "skills");
+}
+export function skillIndexPath() {
+    return join(agentDir, "imported-skills.json");
+}
+/** Claude Code / Codex 各自约定的技能目录;项目级排在用户级前面,先发现的同名技能优先。 */
+export function defaultSkillSources(cwd, home = homedir()) {
+    const candidates = [
+        { tool: "claude", scope: "project", dir: join(cwd, ".claude", "skills") },
+        { tool: "codex", scope: "project", dir: join(cwd, ".agents", "skills") },
+        ...listHomeClaudeDirs(home).map((dir) => ({ tool: "claude", scope: "user", dir: join(dir, "skills") })),
+        { tool: "codex", scope: "user", dir: join(home, ".codex", "skills") },
+        { tool: "codex", scope: "user", dir: join(home, ".agents", "skills") },
+    ];
+    const seen = new Set();
+    const out = [];
+    for (const c of candidates) {
+        const [dir] = uniqueExistingDirs([c.dir]);
+        if (!dir || seen.has(dir))
+            continue;
+        seen.add(dir);
+        out.push({ tool: c.tool, label: TOOL_LABEL[c.tool], dir, scope: c.scope });
+    }
+    return out;
+}
+export function customSkillSource(dir) {
+    return { tool: "custom", label: TOOL_LABEL.custom, dir: resolve(dir), scope: "custom" };
+}
+function walkStats(dir, stats, depth = 0) {
+    if (stats.truncated || depth > 16)
+        return;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name === "node_modules" || entry.name === ".git")
+            continue;
+        const full = join(dir, entry.name);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            walkStats(full, stats, depth + 1);
+        }
+        else if (st.isFile()) {
+            stats.files += 1;
+            stats.bytes += st.size;
+            const dot = entry.name.lastIndexOf(".");
+            const ext = dot >= 0 ? entry.name.slice(dot).toLowerCase() : "";
+            const executable = process.platform !== "win32" && (st.mode & 0o111) !== 0;
+            if (SCRIPT_EXTENSIONS.has(ext) || executable)
+                stats.scripts += 1;
+        }
+        if (stats.files > MAX_SKILL_FILES || stats.bytes > MAX_SKILL_BYTES) {
+            stats.truncated = true;
+            return;
+        }
+    }
+}
+function skillHints(stats) {
+    const hints = [];
+    if (stats.scripts > 0)
+        hints.push(`含 ${stats.scripts} 个脚本,只导可信来源`);
+    if (stats.bytes > LARGE_SKILL_BYTES)
+        hints.push(`体积 ${formatBytes(stats.bytes)}`);
+    return hints;
+}
+const SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** 单文件技能(skills 根目录直接放 foo.md)没写 name 时 pi 会拿父目录名,导入后按文件名落目录更合理。 */
+function singleFileSkillName(filePath, fallback) {
+    try {
+        const { frontmatter } = parseFrontmatter(readFileSync(filePath, "utf8"));
+        const declared = frontmatter["name"];
+        if (typeof declared === "string" && declared.trim())
+            return declared.trim();
+    }
+    catch {
+        return fallback;
+    }
+    return basename(filePath).replace(/\.md$/i, "");
+}
+/**
+ * 用 pi 自己的加载器扫一遍来源目录:能被 pi 认出来、且没有任何告警(名称/说明不合规)
+ * 的才算兼容,其他的进 problems 并带上 pi 给的原因。
+ */
+export function discoverSkills(sources) {
+    const skills = [];
+    const problems = [];
+    for (const source of sources) {
+        let result;
+        try {
+            result = loadSkillsFromDir({ dir: source.dir, source: source.label });
+        }
+        catch (e) {
+            problems.push({ path: source.dir, reason: e instanceof Error ? e.message : String(e) });
+            continue;
+        }
+        const reasons = new Map();
+        for (const diag of result.diagnostics) {
+            if (diag.type === "collision")
+                continue;
+            const key = diag.path ?? source.dir;
+            reasons.set(key, [...(reasons.get(key) ?? []), diag.message]);
+        }
+        for (const [path, list] of reasons)
+            problems.push({ path, reason: list.join("; ") });
+        for (const skill of result.skills) {
+            if (reasons.has(skill.filePath))
+                continue;
+            const singleFile = basename(skill.filePath) !== "SKILL.md";
+            const name = singleFile ? singleFileSkillName(skill.filePath, skill.name) : skill.name;
+            if (!SKILL_NAME_RE.test(name) || name.length > 64) {
+                problems.push({ path: skill.filePath, reason: `技能名「${name}」不合规:只能用小写字母、数字和连字符` });
+                continue;
+            }
+            const stats = { files: 0, bytes: 0, scripts: 0, truncated: false };
+            if (singleFile) {
+                try {
+                    stats.files = 1;
+                    stats.bytes = statSync(skill.filePath).size;
+                }
+                catch {
+                    stats.files = 0;
+                }
+            }
+            else {
+                walkStats(skill.baseDir, stats);
+            }
+            if (stats.truncated) {
+                problems.push({
+                    path: singleFile ? skill.filePath : skill.baseDir,
+                    reason: `技能目录太大(超过 ${formatBytes(MAX_SKILL_BYTES)} 或 ${MAX_SKILL_FILES} 个文件),先跳过`,
+                });
+                continue;
+            }
+            skills.push({
+                name,
+                description: skill.description,
+                tool: source.tool,
+                label: source.label,
+                baseDir: skill.baseDir,
+                skillFile: skill.filePath,
+                singleFile,
+                files: stats.files,
+                bytes: stats.bytes,
+                hints: skillHints(stats),
+            });
+        }
+    }
+    return { skills, problems };
+}
+export function loadSkillIndex(path = skillIndexPath()) {
+    const rec = asRecord(readJsonIfExists(path));
+    const items = asRecord(rec?.["items"]);
+    const out = { version: 1, items: {} };
+    if (!items)
+        return out;
+    for (const [key, value] of Object.entries(items)) {
+        const item = asRecord(value);
+        if (!item)
+            continue;
+        const name = asString(item["name"]);
+        const tool = asString(item["tool"]);
+        const sourcePath = asString(item["sourcePath"]);
+        const destPath = asString(item["destPath"]);
+        const importedAt = asString(item["importedAt"]);
+        if (!name || !sourcePath || !destPath || !importedAt)
+            continue;
+        if (tool !== "claude" && tool !== "codex" && tool !== "custom")
+            continue;
+        out.items[key] = { name, tool, sourcePath, destPath, importedAt };
+    }
+    return out;
+}
+export function planSkillImport(skills, opts) {
+    const plan = { pending: [], alreadyImported: [], conflicts: [], duplicates: [] };
+    const seen = new Set();
+    for (const skill of skills) {
+        if (seen.has(skill.name)) {
+            plan.duplicates.push(skill);
+            continue;
+        }
+        seen.add(skill.name);
+        const dest = join(opts.destDir, skill.name);
+        const record = opts.index.items[skill.name];
+        const destExists = existsSync(dest);
+        if (record && destExists && !opts.force) {
+            plan.alreadyImported.push(skill);
+            continue;
+        }
+        if (!record && destExists) {
+            plan.conflicts.push(skill);
+            continue;
+        }
+        plan.pending.push(skill);
+    }
+    return plan;
+}
+/** 复制到 <destDir>/<name>;单文件技能落成 <name>/SKILL.md,这样 --remove 只需删一个目录。 */
+export function copySkill(skill, destDir) {
+    const dest = join(destDir, skill.name);
+    if (resolve(skill.baseDir) === resolve(dest))
+        throw new Error("来源就是目标目录");
+    mkdirSync(destDir, { recursive: true });
+    rmSync(dest, { recursive: true, force: true });
+    if (skill.singleFile) {
+        mkdirSync(dest, { recursive: true });
+        cpSync(skill.skillFile, join(dest, "SKILL.md"));
+    }
+    else {
+        cpSync(skill.baseDir, dest, {
+            recursive: true,
+            dereference: true,
+            filter: (src) => {
+                const name = basename(src);
+                return name !== "node_modules" && name !== ".git";
+            },
+        });
+    }
+    return dest;
+}
+export function runSkillImport(pending, index, destDir) {
+    const items = [];
+    for (const skill of pending) {
+        try {
+            const destPath = copySkill(skill, destDir);
+            index.items[skill.name] = {
+                name: skill.name,
+                tool: skill.tool,
+                sourcePath: skill.singleFile ? skill.skillFile : skill.baseDir,
+                destPath,
+                importedAt: new Date().toISOString(),
+            };
+            items.push({ name: skill.name, status: "imported", destPath });
+        }
+        catch (e) {
+            items.push({ name: skill.name, status: "error", detail: e instanceof Error ? e.message : String(e) });
+        }
+    }
+    return items;
+}
+/** 只删本命令导入过的技能,别人手放进去的同名目录不碰。 */
+export function removeImportedSkill(name, index, destDir) {
+    const record = index.items[name];
+    if (!record)
+        return { ok: false, reason: "不是 u1s1 import skills 导入的技能,请手动处理" };
+    const expected = join(destDir, name);
+    if (resolve(record.destPath) !== resolve(expected)) {
+        return { ok: false, reason: `记录的位置 ${record.destPath} 与技能目录不一致,请手动处理` };
+    }
+    try {
+        if (existsSync(expected) && lstatSync(expected).isDirectory())
+            rmSync(expected, { recursive: true, force: true });
+    }
+    catch (e) {
+        return { ok: false, reason: e instanceof Error ? e.message : String(e) };
+    }
+    delete index.items[name];
+    return { ok: true };
+}
+function parseSkillsArgs(args) {
+    const opts = {
+        cwd: process.cwd(),
+        from: [],
+        tools: undefined,
+        dryRun: false,
+        force: false,
+        yes: false,
+        list: false,
+        remove: [],
+    };
+    const needValue = (flag, i) => {
+        const next = args[i + 1];
+        if (!next || next.startsWith("-")) {
+            console.error(`  ${flag} 后面要跟一个值`);
+            process.exit(1);
+        }
+        return next;
+    };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === "--dry-run")
+            opts.dryRun = true;
+        else if (a === "--force" || a === "--update")
+            opts.force = true;
+        else if (a === "-y" || a === "--yes")
+            opts.yes = true;
+        else if (a === "--list")
+            opts.list = true;
+        else if (a === "--from")
+            opts.from.push(needValue(a, i++));
+        else if (a === "--cwd")
+            opts.cwd = needValue(a, i++);
+        else if (a === "--remove")
+            opts.remove.push(needValue(a, i++));
+        else if (a.startsWith("-")) {
+            console.error(`  不认识参数 ${a}`);
+            process.exit(1);
+        }
+        else {
+            const tool = parseToolArg(a);
+            opts.tools = opts.tools ? [...opts.tools, tool] : [tool];
+        }
+    }
+    return opts;
+}
+function parseToolArg(raw) {
+    const aliases = {
+        claude: "claude",
+        "claude-code": "claude",
+        cc: "claude",
+        anthropic: "claude",
+        codex: "codex",
+        openai: "codex",
+    };
+    const tool = aliases[raw.toLowerCase()];
+    if (!tool) {
+        console.error(`  不认识来源「${raw}」,可选: claude / codex;其他工具用 --from 目录`);
+        process.exit(1);
+    }
+    return tool;
+}
+export function printSkillsHelp() {
+    console.log("");
+    console.log("  把 Claude Code / Codex 等工具的技能(SKILL.md)导入 u1s1");
+    console.log("");
+    console.log("  用法:");
+    console.log("    u1s1 import skills                自动找本机 Claude Code / Codex 的技能");
+    console.log("    u1s1 import skills claude         只导 Claude Code 的");
+    console.log("    u1s1 import skills codex          只导 Codex 的");
+    console.log("    u1s1 import skills --from 目录     其他工具:指定放 SKILL.md 的目录(可重复)");
+    console.log("    u1s1 import skills --cwd 目录      项目级技能按这个目录找(默认当前目录)");
+    console.log("    u1s1 import skills --dry-run      只看会导哪些,不写盘");
+    console.log("    u1s1 import skills --update       已导过的重新复制一遍(同 --force)");
+    console.log("    u1s1 import skills --list         看已导入的技能");
+    console.log("    u1s1 import skills --remove 名称   删掉某个导入的技能");
+    console.log("");
+    console.log(`  技能会复制到 ${formatHomePath(skillsDestDir())},下次进对话就能用:`);
+    console.log("  模型会按说明自动调用,也可以在会话里输入 /skill:名称 手动调用。");
+    console.log("");
+}
+async function confirm(question) {
+    if (!input.isTTY || !output.isTTY)
+        return true;
+    const rl = createInterface({ input, output });
+    try {
+        const ans = (await rl.question(question)).trim().toLowerCase();
+        return ans === "" || ans === "y" || ans === "yes" || ans === "是";
+    }
+    finally {
+        rl.close();
+    }
+}
+function describeSource(skill) {
+    return formatHomePath(skill.singleFile ? skill.skillFile : skill.baseDir);
+}
+function printList(index) {
+    const items = Object.values(index.items).sort((a, b) => a.name.localeCompare(b.name));
+    console.log("");
+    if (items.length === 0) {
+        console.log("  还没导入过技能。跑 u1s1 import skills 试试。");
+        console.log("");
+        return;
+    }
+    console.log(`  已导入 ${items.length} 个技能(${formatHomePath(skillsDestDir())}):`);
+    for (const item of items) {
+        const missing = existsSync(item.destPath) ? "" : "(目录已不在)";
+        console.log(`    · ${item.name}  [${TOOL_LABEL[item.tool]}] ${missing}`);
+        console.log(`      来自 ${formatHomePath(item.sourcePath)}`);
+    }
+    console.log("");
+}
+function printPreview(skills, plan, problems, sources) {
+    console.log("");
+    console.log(`  在 ${sources.length} 个目录里找到 ${skills.length} 个技能:`);
+    for (const source of sources)
+        console.log(`    ${formatHomePath(source.dir)}  [${source.label}]`);
+    console.log("");
+    for (const skill of plan.pending) {
+        console.log(`    + ${skill.name}  [${skill.label}]  ${oneLine(skill.description, 60)}`);
+        console.log(`      ${describeSource(skill)}${skill.hints.length ? `  ⚠ ${skill.hints.join(";")}` : ""}`);
+    }
+    for (const skill of plan.alreadyImported)
+        console.log(`    · ${skill.name}  已导过(加 --update 重导)`);
+    for (const skill of plan.conflicts) {
+        console.log(`    · ${skill.name}  目标目录已有同名技能(不是本命令导的),不覆盖`);
+    }
+    for (const skill of plan.duplicates)
+        console.log(`    · ${skill.name}  与前面同名,只保留先发现的(${describeSource(skill)})`);
+    for (const problem of problems) {
+        console.log(`    × ${formatHomePath(problem.path)}  不兼容,跳过: ${oneLine(problem.reason, 80)}`);
+    }
+}
+export async function importSkillsCommand(args) {
+    if (args.includes("-h") || args.includes("--help")) {
+        printSkillsHelp();
+        return;
+    }
+    const opts = parseSkillsArgs(args);
+    const destDir = skillsDestDir();
+    const index = loadSkillIndex();
+    if (opts.remove.length > 0) {
+        for (const name of opts.remove) {
+            const result = removeImportedSkill(name, index, destDir);
+            if (result.ok)
+                console.log(`  ✓ 已删除技能 ${name}`);
+            else
+                console.log(`  × ${name}: ${result.reason}`);
+        }
+        writeJson(skillIndexPath(), index);
+        return;
+    }
+    if (opts.list) {
+        printList(index);
+        return;
+    }
+    const sources = [
+        ...opts.from.map(customSkillSource),
+        ...defaultSkillSources(opts.cwd).filter((s) => !opts.tools || opts.tools.includes(s.tool)),
+    ];
+    const missingFrom = opts.from.filter((dir) => !existsSync(dir));
+    for (const dir of missingFrom)
+        console.log(`  --from 目录不存在: ${dir}`);
+    if (sources.length === 0) {
+        console.log("");
+        console.log("  没找到 Claude Code / Codex 的技能目录(~/.claude/skills、~/.codex/skills、项目里的 .claude/skills 或 .agents/skills)。");
+        console.log("  其他工具的技能可以用 --from 指定目录,只要里面有 SKILL.md。");
+        console.log("");
+        return;
+    }
+    const { skills, problems } = discoverSkills(sources);
+    const plan = planSkillImport(skills, { destDir, index, force: opts.force });
+    printPreview(skills, plan, problems, sources);
+    if (plan.pending.length === 0) {
+        console.log("");
+        console.log(skills.length === 0 ? "  这些目录里没有能用的技能。" : "  没有新的可导。想重导一遍就加 --update。");
+        console.log("");
+        return;
+    }
+    if (opts.dryRun) {
+        console.log("");
+        console.log(`  预演结束,以上 ${plan.pending.length} 个还没真正导入。`);
+        console.log("");
+        return;
+    }
+    if (!opts.yes && !(await confirm(`  导入这 ${plan.pending.length} 个技能?(回车=好 / n=取消) `))) {
+        console.log("  已取消。");
+        return;
+    }
+    const results = runSkillImport(plan.pending, index, destDir);
+    writeJson(skillIndexPath(), index);
+    const imported = results.filter((r) => r.status === "imported").length;
+    const errors = results.filter((r) => r.status === "error");
+    console.log("");
+    console.log(`  ✓ 导入 ${imported} 个技能到 ${formatHomePath(destDir)}${errors.length ? `,失败 ${errors.length}` : ""}。`);
+    for (const item of errors)
+        console.log(`    × ${item.name}: ${item.detail ?? "失败"}`);
+    if (imported > 0) {
+        console.log("  下次进 u1s1 对话就能用:模型会按说明自动调用,或输入 /skill:名称 手动调用。");
+        console.log(`  管理: u1s1 import skills --list / --update / --remove 名称`);
+    }
+    console.log("");
+}

package/dist/import/util.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ export declare const MAX_TOOL_RESULT_CHARS = 80000;
 export declare const MAX_TEXT_CHARS = 200000;
 export declare const PREVIEW_TITLE_CHARS = 48;
 export declare function resolveExistingDir(path: string): string | undefined;
-export declare function listHomeClaudeDirs(): string[];
+export declare function listHomeClaudeDirs(home?: string): string[];
 export declare function uniqueExistingDirs(paths: Array<string | undefined>): string[];
 export declare function encodeClaudeProjectDir(cwd: string): string;
 export declare function samePath(a: string, b: string): boolean;

package/dist/import/util.js CHANGED Viewed

@@ -15,8 +15,7 @@ export function resolveExistingDir(path) {
         return undefined;
     }
 }
-export function listHomeClaudeDirs() {
-    const home = homedir();
+export function listHomeClaudeDirs(home = homedir()) {
     const out = [];
     try {
         for (const name of readdirSync(home)) {

package/dist/index.js CHANGED Viewed

@@ -9,7 +9,7 @@ import { registerLoopCommand } from "./loop.js";
 import { ensureSearchTools } from "./search-tools.js";
 import { ensureUsableShell } from "./shell-doctor.js";
 import { applyBrandUi, setAnnouncement, setUpdateNotice } from "./style.js";
-import { AuthError, fetchModels, loadCustomEndpoints, readJsonResponseCapped } from "./api.js";
+import { AccessDeniedError, AuthError, fetchModels, loadCustomEndpoints, readJsonResponseCapped } from "./api.js";
 import { ensureSigningProxy } from "./device-auth.js";
 import { installChildEnvGuard } from "./secret-env.js";
 import { DEPLOY_HINT_TEXT, markNudge, shouldShowDeployHint } from "./nudges.js";
@@ -93,6 +93,7 @@ function installPendingUpdate() {
         return;
     const { latest, installCmd } = pendingUpdate;
     console.log(`\n⬆ 正在更新到 v${latest}…`);
+    console.log("  (可能需要几分钟,期间请不要关闭窗口或按 Ctrl+C,中途打断会装出半截)");
     try {
         execSync(installCmd, { stdio: "inherit" });
         console.log(`✅ 已更新到 v${latest},下次运行 u1s1 生效。`);
@@ -200,6 +201,12 @@ async function runAgent(cfg, args) {
                 return undefined;
             });
         }
+        else if (e instanceof AccessDeniedError) {
+            // 封禁/停用/设备不受信任:进 TUI 后每条消息都会失败,不如现在就把原因说清楚并退出
+            console.error(`  ${e.message}`);
+            console.error("  这个账号当前无法使用 u1s1。如有疑问可发邮件到 contact@u1s1.io,或在 https://u1s1.io/dashboard 提交工单。");
+            process.exit(1);
+        }
         else {
             console.error("  获取模型列表失败,使用内置列表:", e.message);
         }
@@ -529,7 +536,7 @@ async function run() {
         console.log("   u1s1 deploy list       查看已发布的站点");
         console.log("   u1s1 deploy remove     删除已发布的站点");
         console.log("   u1s1 feedback \"一句话\"  反馈问题或建议(自动建工单,--bug/--question…)");
-        console.log("   u1s1 import            导入历史会话");
+        console.log("   u1s1 import            导入历史会话(import skills 导入技能)");
         console.log("   u1s1 bench             模型编码能力评测");
         console.log("   u1s1 --version         查看版本");
         console.log("");
@@ -543,6 +550,12 @@ async function run() {
         process.exitCode = 1;
         return;
     }
+    // `u1s1 login --help` 不该真的去登录、`logout --help` 不该真的退出:先看是不是在问用法
+    if (cmd && SIMPLE_COMMAND_HELP[cmd] && (args[1] === "--help" || args[1] === "-h")) {
+        for (const line of SIMPLE_COMMAND_HELP[cmd])
+            console.log(line);
+        return;
+    }
     if (cmd === "deploy") {
         const { deployCommand, printDeployHelp } = await import("./deploy.js");
         // --help 不该先被拽去登录
@@ -622,8 +635,9 @@ async function run() {
     }
     // 拼错的子命令(如 `u1s1 depoly`)不该被静默当成第一条消息发给模型白烧 token。
     // 只拦「单个短英文词 + 与已知命令编辑距离很近」的情况,正常 prompt 不受影响。
+    // `u1s1 delpoy list` 这类带参数的拼错也拦;长句(≥4 个词)才当 prompt 放行
     if (cmd
-        && args.length === 1
+        && args.length <= 3
         && /^[a-z][a-z0-9-]{1,15}$/.test(cmd)
         && !KNOWN_COMMANDS.includes(cmd)) {
         const near = KNOWN_COMMANDS.find((k) => editDistance(k, cmd) <= (k.length <= 4 ? 1 : 2));
@@ -642,7 +656,28 @@ async function run() {
     // autoUpdate 开着且启动时发现了新版:现在装(TUI 已退出,原地重铺安全)
     installPendingUpdate();
 }
-const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "bench", "feedback", "help", "web"];
+const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "bench", "feedback", "help"];
+/** 没有自己 --help 处理的简单子命令:问用法时只打印说明,不执行任何动作。 */
+const SIMPLE_COMMAND_HELP = {
+    login: [
+        "用法: u1s1 login",
+        "  在浏览器里批准这台设备登录 u1s1;没有账号会引导注册。",
+        "  登录信息保存在 ~/.u1s1/config.json,退出登录用 u1s1 logout。",
+    ],
+    logout: [
+        "用法: u1s1 logout",
+        "  退出本机登录,并注销这台设备在服务端的授权(连不上服务器时只清本机)。",
+    ],
+    usage: [
+        "用法: u1s1 usage",
+        "  查看剩余额度:免费包、已购用量包与余额。会话内也可输入 /usage。",
+    ],
+    update: [
+        "用法: u1s1 update",
+        "  检查并升级到最新版;npm 安装的走 npm,便携版原地自更新。",
+        "  不想每次退出自动更新:在 ~/.u1s1/agent/settings.json 设 \"autoUpdate\": false",
+    ],
+};
 /** 经典 Levenshtein,命令名都很短,O(nm) 足够。 */
 function editDistance(a, b) {
     const dp = Array.from({ length: a.length + 1 }, (_, i) => i);

package/dist/login.js CHANGED Viewed

@@ -149,6 +149,8 @@ export async function login(keyArg) {
     printConsoleBanner(VERSION);
     const origin = apiOrigin(cfg);
     const failure = {};
+    // 慢网下这一步最长 15 秒,横幅之后一片安静像是卡死;先说一声在连
+    console.log("  正在连接 u1s1 服务器…");
     const start = await startDeviceLogin(origin, failure);
     if (!start) {
         if (failure.message) {

package/dist/nudges.d.ts CHANGED Viewed

@@ -18,4 +18,4 @@ 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;
-export declare const DEPLOY_HINT_TEXT = "\u505A\u597D\u4E86\u60F3\u7ED9\u670B\u53CB\u770B\uFF1F\u8FD0\u884C u1s1 deploy \u4E00\u952E\u4E0A\u7EBF";
+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";

package/dist/nudges.js CHANGED Viewed

@@ -37,4 +37,4 @@ export function shouldShowDeployHint(file = nudgesFile) {
     const state = readNudges(file);
     return state.deploy_hint_shown === undefined && state.deploy_done === undefined;
 }
-export const DEPLOY_HINT_TEXT = "做好了想给朋友看？运行 u1s1 deploy 一键上线";
+export const DEPLOY_HINT_TEXT = "做好了想给朋友看？输入 /exit 回到终端,运行 u1s1 deploy 一键上线";

package/dist/update.js CHANGED Viewed

@@ -147,6 +147,7 @@ async function portableSelfUpdate(latest) {
         process.exit(0);
     }
     console.log(`正在下载安装脚本并升级到 v${latest}…`);
+    console.log("(可能需要几分钟,期间请不要关闭窗口)");
     let script;
     try {
         const download = await downloadInstallScript();

package/dist/usage.d.ts CHANGED Viewed

@@ -1,7 +1,11 @@
 import { type MeResponse } from "./api.js";
 export declare const TOPUP_URL = "https://u1s1.io/dashboard#usage-topup-card";
-/** 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。 */
-export declare function usageCtaLines(): string[];
+/**
+ * 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。
+ * 支付通道关闭时充值是死路(仪表盘会报「支付通道未开放」),改说即将上线并指向
+ * 仪表盘的加量包/打卡入口;老网关没有 pay_enabled 字段,按开放处理。
+ */
+export declare function usageCtaLines(me?: Pick<MeResponse, "pay_enabled">): string[];
 /** 额度报告正文(不含首尾空行),终端 `u1s1 usage` 和会话内 /usage 共用。 */
 export declare function usageReportLines(me: MeResponse): string[];
 /** 会话内 /usage 用:拉取额度并打包成 entry data,错误转成中文提示而不是抛出。 */

package/dist/usage.js CHANGED Viewed

@@ -94,7 +94,7 @@ function packageUsageLines(me, tokensPerUsd) {
     lines.push("  其他模型(如 DeepSeek V4 Pro)不走免费包，可用余额或全模型包 → https://u1s1.io/dashboard");
     lines.push("  Token 数按默认模型单价折算,为约数;用更贵的模型时消耗更快。");
     lines.push("");
-    lines.push(...usageCtaLines());
+    lines.push(...usageCtaLines(me));
     return lines;
 }
 function legacyUsageLines(me, tokensPerUsd) {
@@ -118,15 +118,22 @@ function legacyUsageLines(me, tokensPerUsd) {
         lines.push(`  本月成本   $${me.mtd_usd.toFixed(2)}`);
     }
     lines.push("");
-    lines.push(...usageCtaLines());
+    lines.push(...usageCtaLines(me));
     return lines;
 }
 export const TOPUP_URL = "https://u1s1.io/dashboard#usage-topup-card";
-/** 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。 */
-export function usageCtaLines() {
+/**
+ * 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。
+ * 支付通道关闭时充值是死路(仪表盘会报「支付通道未开放」),改说即将上线并指向
+ * 仪表盘的加量包/打卡入口;老网关没有 pay_enabled 字段,按开放处理。
+ */
+export function usageCtaLines(me) {
+    const payClosed = me?.pay_enabled === false;
     return [
         "  免费额度每天自动恢复；邀请朋友双方各得永久加量 → https://u1s1.io/dashboard",
-        `  额度不够用?充值 → ${TOPUP_URL}`,
+        payClosed
+            ? "  充值通道即将开放；额度不够先到仪表盘领加量包、每日打卡 → https://u1s1.io/dashboard"
+            : `  额度不够用?充值 → ${TOPUP_URL}`,
     ];
 }
 /** 额度报告正文(不含首尾空行),终端 `u1s1 usage` 和会话内 /usage 共用。 */

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "1.6.0",
+  "version": "1.7.1",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {

package/scripts/patch-pi.js CHANGED Viewed

@@ -271,6 +271,156 @@ function patchCompactUi() {
   }
 }
+// ---- TUI 零散英文汉化(与 pnpm coding-agent patch 同步,patch-pi.test.ts 校验双轨一致) ----
+// 新手最常撞见的几句:Esc 中断后的 "Operation aborted"、每条报错前缀 "Error:"、
+// 每轮都在转的 "Working..."、选择器脚注的 "navigate/select/cancel"、/model 列表只显示 id
+// 看不到免费/价格提示、/settings 整页英文。行为不变,只换文案;选择器改为渲染 name(带提示)。
+const ASSISTANT_TEXT_REPLACEMENTS = [
+  ['theme.fg("error", "Response was truncated before completion.")', 'theme.fg("error", "回复超出单次长度上限被截断了,输入「继续」可以接着写。")'],
+  [': "Operation aborted";', ': "已中断";'],
+  ['const errorMsg = message.errorMessage || "Unknown error";', 'const errorMsg = message.errorMessage || "未知错误(反复出现可运行 u1s1 feedback 反馈)";'],
+  ['theme.fg("error", `Error: ${errorMsg}`)', 'theme.fg("error", `出错:${errorMsg}`)'],
+];
+const WORKING_TEXT_REPLACEMENTS = [
+  ['defaultWorkingMessage = "Working...";', 'defaultWorkingMessage = "思考中…";'],
+  ['defaultHiddenThinkingLabel = "Thinking...";', 'defaultHiddenThinkingLabel = "思考中…";'],
+];
+// 脚注提示(↑↓ navigate · enter select · esc cancel …)在十几个组件里各写各的,
+// 在 keyHint/rawKeyHint 出口处统一查表翻译,新组件加进来也能覆盖到。
+const KEY_HINT_REPLACEMENTS = [
+  [
+    'export function keyHint(keybinding, description) {',
+    'const U1S1_HINTS = { cancel: "取消", "to cancel": "取消", "to cancel,": "取消,", navigate: "上下选择", submit: "提交", "to submit": "提交", save: "保存", select: "选择", confirm: "确认", scope: "切换范围", "to expand": "展开", "to collapse": "收起", "to run bash": "直接跑命令", "to run bash (no context)": "跑命令(不进上下文)", toggle: "切换", "cycle inherit/+/-": "循环 继承/+/-", "for commands": "输入命令", commands: "命令", bash: "命令", close: "关闭", "to close": "关闭", "to attach": "拖入文件即附加", "skip setup": "跳过设置", "switch mode": "切换模式", newline: "换行", "to delete to end": "删到行尾", sort: "排序", named: "只看已命名", rename: "重命名", delete: "删除", "to exit": "退出", "to cycle models": "切换模型", "external editor": "外部编辑器", "clear/exit": "清空/退出" };\nconst u1s1Hint = (d) => U1S1_HINTS[d] ?? d;\nexport function keyHint(keybinding, description) {',
+  ],
+  { from: 'theme.fg("muted", ` ${description}`)', to: 'theme.fg("muted", ` ${u1s1Hint(description)}`)', expected: 2 },
+];
+const MODEL_SELECTOR_REPLACEMENTS = [
+  // 两处 modelText(有/无两空格缩进)同一规则覆盖;测试的空白折叠匹配不认双空格
+  { from: '${item.id}`;', to: '${item.model.name || item.id}`;', expected: 2 },
+  ['Model Name: ${selected.model.name}`)', '模型 ID: ${selected.model.id}`)'],
+  ['No matching models")', '没有匹配的模型")'],
+  ['theme.fg("muted", " · default")', 'theme.fg("muted", " · 默认")'],
+  ['const allText = this.scope === "all" ? theme.fg("accent", "all") : theme.fg("muted", "all");', 'const allText = this.scope === "all" ? theme.fg("accent", "全部") : theme.fg("muted", "全部");'],
+  ['const scopedText = this.scope === "scoped" ? theme.fg("accent", "scoped") : theme.fg("muted", "scoped");', 'const scopedText = this.scope === "scoped" ? theme.fg("accent", "已配置") : theme.fg("muted", "已配置");'],
+  ['theme.fg("muted", "Scope: ")', 'theme.fg("muted", "范围: ")'],
+  ['theme.fg("muted", " (all/scoped)")', 'theme.fg("muted", " (全部/已配置)")'],
+  ['refreshStatusMessage = "Refreshing model catalogs…";', 'refreshStatusMessage = "正在刷新模型列表…";'],
+  ['"Model catalogs refreshed."', '"模型列表已刷新。"'],
+  ['const hintText = "Only showing models from configured providers. Use /login to add providers.";', 'const hintText = "只显示已配置渠道的模型。";'],
+];
+const SETTINGS_REPLACEMENTS = [
+  ['off: "No reasoning",', 'off: "不推理",'],
+  ['minimal: "Very brief reasoning (~1k tokens)",', 'minimal: "极简推理(约 1k token)",'],
+  ['low: "Light reasoning (~2k tokens)",', 'low: "轻度推理(约 2k token)",'],
+  ['medium: "Moderate reasoning (~8k tokens)",', 'medium: "中等推理(约 8k token)",'],
+  ['high: "Deep reasoning (~16k tokens)",', 'high: "深度推理(约 16k token)",'],
+  ['xhigh: "Extra-high reasoning (~32k tokens)",', 'xhigh: "超深推理(约 32k token)",'],
+  ['max: "Maximum reasoning",', 'max: "最大推理",'],
+  ['ask: "Ask",', 'ask: "每次询问",'],
+  ['always: "Always trust",', 'always: "始终信任",'],
+  ['never: "Never trust",', 'never: "从不信任",'],
+  ['new SelectSubmenu("Theme", "Select a theme, or choose Automatic to follow terminal appearance."', 'new SelectSubmenu("主题", "选择一个主题,或选「自动」跟随终端明暗。"'],
+  ['label: "Automatic",', 'label: "自动",'],
+  ['description: "Use separate themes for light and dark terminal appearance",', 'description: "终端明暗各用一套主题",'],
+  ['theme.fg("accent", "Automatic Theme")', 'theme.fg("accent", "自动主题")'],
+  ['theme.fg("muted", "Choose themes for terminal light and dark appearance.")', 'theme.fg("muted", "分别为终端的浅色/深色外观选主题。")'],
+  ['theme.fg("muted", "Light/dark detection requires terminal support.")', 'theme.fg("muted", "明暗检测需要终端支持。")'],
+  ['label: "Light theme",', 'label: "浅色主题",'],
+  ['description: "Theme to use in automatic mode when the terminal is light",', 'description: "自动模式下终端为浅色时使用的主题",'],
+  ['label: "Dark theme",', 'label: "深色主题",'],
+  ['description: "Theme to use in automatic mode when the terminal is dark",', 'description: "自动模式下终端为深色时使用的主题",'],
+  ['label: "Apply",', 'label: "应用",'],
+  ['description: "Save and go back",', 'description: "保存并返回",'],
+  ['label: "Change mode",', 'label: "切换模式",'],
+  ['description: "Switch to one theme for light and dark",', 'description: "明暗共用一个主题",'],
+  ['label: "Auto-compact",', 'label: "自动压缩上下文",'],
+  ['description: "Automatically compact context when it gets too large",', 'description: "上下文过长时自动压缩",'],
+  ['label: "Steering mode",', 'label: "插话模式",'],
+  ['description: "Enter while streaming queues steering messages. \'one-at-a-time\': deliver one, wait for response. \'all\': deliver all at once.",', 'description: "回复进行中按 Enter 发送插话。one-at-a-time:发一条等回复;all:一次全发。",'],
+  ['label: "Follow-up mode",', 'label: "追问模式",'],
+  ['description: `${followUpKey} queues follow-up messages until agent stops. \'one-at-a-time\': deliver one, wait for response. \'all\': deliver all at once.`,', 'description: `${followUpKey} 把追问排队到本轮结束再发。one-at-a-time:发一条等回复;all:一次全发。`,'],
+  ['label: "Transport",', 'label: "传输方式",'],
+  ['description: "Preferred transport for providers that support multiple transports",', 'description: "支持多种传输方式的渠道优先用哪种",'],
+  ['label: "HTTP idle timeout",', 'label: "HTTP 空闲超时",'],
+  ['description: "Maximum idle gap while waiting for HTTP headers or body chunks. Disable for local models that pause longer than five minutes.",', 'description: "等待响应头或数据块的最长空闲间隔;本地模型停顿超过五分钟可关闭。",'],
+  ['label: "Hide thinking",', 'label: "隐藏思考过程",'],
+  ['description: "Hide thinking blocks in assistant responses",', 'description: "不显示回复里的思考块",'],
+  ['label: "Mermaid diagrams",', 'label: "Mermaid 图表",'],
+  ['description: "Render Mermaid code blocks as Unicode diagrams",', 'description: "把 Mermaid 代码块渲染成字符图",'],
+  ['label: "Cache miss notices",', 'label: "缓存未命中提示",'],
+  ['description: "Show transcript notices for significant prompt-cache misses and compaction costs",', 'description: "提示明显的提示词缓存未命中与压缩开销",'],
+  ['label: "Collapse changelog",', 'label: "折叠更新日志",'],
+  ['description: "Show condensed changelog after updates",', 'description: "更新后只显示精简的更新日志",'],
+  ['label: "Quiet startup",', 'label: "安静启动",'],
+  ['description: "Disable verbose printing at startup",', 'description: "启动时不打印冗长信息",'],
+  ['label: "Install telemetry",', 'label: "安装统计",'],
+  ['description: "Send an anonymous version/update ping after changelog-detected updates",', 'description: "更新后匿名上报一次版本信息",'],
+  ['label: "Default project trust",', 'label: "默认项目信任",'],
+  ['description: "Fallback behavior when no extension or saved trust decision decides project trust",', 'description: "没有扩展或已保存决定时,项目信任的兜底行为",'],
+  ['label: "Double-escape action",', 'label: "双击 Esc 动作",'],
+  ['description: "Action when pressing Escape twice with empty editor",', 'description: "输入框为空时连按两次 Esc 的动作",'],
+  ['label: "Tree filter mode",', 'label: "会话树筛选",'],
+  ['description: "Default filter when opening /tree",', 'description: "打开 /tree 时的默认筛选",'],
+  ['label: "Warnings",', 'label: "警告提示",'],
+  ['description: "Enable or disable individual warnings",', 'description: "逐项开关各类警告",'],
+  ['label: "Default thinking level per model",', 'label: "各模型默认推理强度",'],
+  ['description: `Override the default thinking level for specific models. ${cycleThinkingKey} cycles in-session.`,', 'description: `按模型覆盖默认推理强度;会话内用 ${cycleThinkingKey} 切换。`,'],
+  ['description: "Select a model to configure",', 'description: "选择要设置的模型",'],
+  ['label: "No models available",', 'label: "没有可用模型",'],
+  ['description: "Log in to a provider or configure an API key first",', 'description: "请先登录",'],
+  ['description: "Select default thinking level for this model",', 'description: "选择这个模型的默认推理强度",'],
+  ['label: "(clear override)",', 'label: "(清除覆盖)",'],
+  ['description: `Revert to global default (${config.thinkingLevel})`,', 'description: `恢复为全局默认(${config.thinkingLevel})`,'],
+  ['label: "TUI mode",', 'label: "界面模式",'],
+  ['description: "Interface layout; fullscreen mode is experimental",', 'description: "界面布局;全屏模式为实验功能",'],
+  ['label: "Fullscreen exit output",', 'label: "退出全屏时的输出",'],
+  ['description: "Print the transcript or only a session resume hint when exiting fullscreen mode",', 'description: "退出全屏时打印完整对话,还是只留一条恢复会话提示",'],
+  ['label: "Fullscreen scrollbar",', 'label: "全屏滚动条",'],
+  ['description: "Scrollbar behavior in fullscreen mode; has no effect in regular mode",', 'description: "全屏模式下的滚动条行为;普通模式无效",'],
+  ['label: "Fullscreen copy on select",', 'label: "全屏选中即复制",'],
+  ['description: "Automatically copy selected text in fullscreen mode; disable to copy selections with Ctrl+X",', 'description: "全屏模式下选中文字自动复制;关闭后用 Ctrl+X 复制",'],
+  ['label: "Theme",', 'label: "主题",'],
+  ['description: "Color theme for the interface",', 'description: "界面配色主题",'],
+];
+const TUI_TEXT_TARGETS = [
+  [["modes", "interactive", "components", "assistant-message.js"], ASSISTANT_TEXT_REPLACEMENTS, "回复状态文案"],
+  [["modes", "interactive", "interactive-mode.js"], WORKING_TEXT_REPLACEMENTS, "工作中提示"],
+  [["modes", "interactive", "components", "keybinding-hints.js"], KEY_HINT_REPLACEMENTS, "按键脚注"],
+  [["modes", "interactive", "components", "model-selector.js"], MODEL_SELECTOR_REPLACEMENTS, "模型选择器"],
+  [["modes", "interactive", "components", "settings-selector.js"], SETTINGS_REPLACEMENTS, "设置菜单"],
+];
+function patchTuiText() {
+  for (const piDir of findPackageDirs("@earendil-works/pi-coding-agent")) {
+    for (const [parts, rules, label] of TUI_TEXT_TARGETS) {
+      const target = join(piDir, "dist", ...parts);
+      try {
+        let text = readFileSync(target, "utf8");
+        let applied = 0;
+        for (const rule of rules) {
+          const { from, to, expected } = Array.isArray(rule) ? { from: rule[0], to: rule[1], expected: 1 } : rule;
+          if (text.includes(to)) {
+            applied++;
+            continue;
+          }
+          if (text.split(from).length !== expected + 1) continue;
+          text = text.split(from).join(to);
+          applied++;
+        }
+        if (applied < rules.length) {
+          console.log(
+            `[u1s1] 提示: pi 版本可能已更新，${label}汉化补丁只应用了 ${applied}/${rules.length} 处（不影响使用）`,
+          );
+        }
+        writeFileSync(target, text);
+      } catch {
+        continue;
+      }
+    }
+  }
+}
 function patchMainScreenAutowrap() {
   const tuiDirs = findTuiDirs();
   if (tuiDirs.length === 0) {
@@ -329,6 +479,7 @@ try {
   patchSlashCommands();
   patchExtensionError();
   patchHotkeys();
+  patchTuiText();
   patchMainScreenAutowrap();
 } catch (err) {
   console.log(`[u1s1] 提示: pi 运行时补丁未生效（${err?.message ?? err}），不影响安装`);