u1s1-cli 0.13.2 → 0.13.4

package/dist/agent-setup.d.ts

@@ -1,6 +1,7 @@
 import { type CliConfig, type CustomEndpoint, type ModelDef } from "./config.js";
+import type { ShellDoctorResult } from "./shell-doctor.js";
 /** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
-export declare function ensureBrandPrompt(): void;
+export declare function ensureBrandPrompt(shell: ShellDoctorResult): void;
 /** Defaults that don't overwrite values the user already set. */
 export declare function ensureDefaultSettings(): void;
 /** ≤0.4.0 wrote u1s1-dark/u1s1-light into the pi themes dir; remove them. */

package/dist/agent-setup.js

@@ -10,12 +10,44 @@ const BRAND_APPEND = `## u1s1
 - 改动前先说明打算做什么,改完用一两句话总结改了哪里。
 - 用户描述模糊时,先猜最可能的意图并确认,不要长篇追问。
 `;
+const EXEC_RULES = `
+## 命令执行
+
+- 能用 bash 工具执行的命令,自己执行并展示输出,不要让用户手动执行。
+- 只有需要管理员权限、交互式输入(登录、装系统组件等),或必须开新终端窗口的操作,才让用户执行,并给出可直接粘贴的完整命令。
+`;
+/**
+ * pi 的系统提示不含任何 OS/平台信息,模型只能拿 uname 之类盲探,Windows 上
+ * 第一步就撞墙。这里按 shell 体检结果告诉模型:系统是什么、命令实际跑在哪、
+ * 坏了该怎么引导用户修(而不是反复重试)。
+ */
+function envSection(shell) {
+    if (shell.status === "posix") {
+        return `\n## 运行环境\n\n- 操作系统: ${process.platform === "darwin" ? "macOS" : "Linux"}。\n`;
+    }
+    const lines = ["", "## 运行环境", "", "- 操作系统: Windows。环境信息以本节为准,不要用 uname 探测。"];
+    switch (shell.status) {
+        case "bash":
+            lines.push(`- 命令通过 bash 执行(${shell.shellPath}),ls/grep/curl 等 POSIX 工具可用。`, '- 查 Windows 原生信息或调 Windows 程序,用 cmd.exe /c "..." 或 powershell.exe -NoProfile -Command "..."。', "- 默认在 Windows 本机干活;只有用户要求或任务确实需要 Linux 时才考虑 WSL。");
+            break;
+        case "wsl":
+            lines.push("- 注意:命令通过 WSL 的 bash 执行,实际跑在 Linux 发行版里,不是 Windows 本机。", "- 访问 Windows 文件用 /mnt/c/... 路径;调 Windows 程序用带 .exe 的名字(cmd.exe、powershell.exe)。", "- 适时提醒用户:安装 Git for Windows(PowerShell 运行 winget install --id Git.Git)并重启 u1s1,命令就能回到 Windows 本机执行。");
+            break;
+        case "none":
+            lines.push("- 严重:当前没有可用的 bash,bash 工具执行任何命令都会立刻失败,反复重试没有意义。", "- 第一要务是引导用户修复:让用户在 PowerShell 运行 winget install --id Git.Git 安装 Git for Windows,装完重启 u1s1。", "- 修复之前只用读写文件等其他工具帮用户。");
+            break;
+        case "unknown":
+            break;
+    }
+    return lines.join("\n") + "\n";
+}
 /** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
-export function ensureBrandPrompt() {
+export function ensureBrandPrompt(shell) {
     mkdirSync(agentDir, { recursive: true });
+    const content = BRAND_APPEND + envSection(shell) + EXEC_RULES;
     const p = join(agentDir, "APPEND_SYSTEM.md");
-    if (!existsSync(p) || readFileSync(p, "utf8") !== BRAND_APPEND) {
-        writeFileSync(p, BRAND_APPEND);
+    if (!existsSync(p) || readFileSync(p, "utf8") !== content) {
+        writeFileSync(p, content);
     }
 }
 /** Defaults that don't overwrite values the user already set. */

package/dist/index.js

@@ -1,20 +1,28 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
+import { execSync, spawnSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
 import { cleanupBrandThemes, endpointKeyEnv, endpointProviderEntry, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, scrubForeignProviderEnv, toProviderModels, writeWebToolsExtension, } from "./agent-setup.js";
 import { printConsoleBanner } from "./brand.js";
 import { agentDir, apiModelToDef, CUSTOM_ENDPOINTS, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, refValid, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
 import { ensureSearchTools } from "./search-tools.js";
+import { ensureUsableShell } from "./shell-doctor.js";
 import { applyBrandUi, setUpdateNotice } from "./style.js";
 import { offerStarterTemplates } from "./templates.js";
 import { fetchModels, loadCustomEndpoints } from "./api.js";
 const PACKAGE_NAME = "u1s1-cli";
+/** 启动时检测到的可自动安装的新版;TUI 退出后才装(见 installPendingUpdate)。 */
+let pendingUpdate;
 /**
- * 启动时自动检查 npm 最新版:autoUpdate 开着就静默安装,关着也在启动横幅的
+ * 启动时自动检查 npm 最新版:autoUpdate 开着就记下退出后安装,关着也在启动横幅的
  * 版本号后面提示一句(u1s1 vX.Y.Z 后跟升级状态,见 setUpdateNotice)。
  * 不阻塞启动流程,失败也不报错(留到手动 `u1s1 update`)。
+ *
+ * 绝不能边跑 TUI 边后台 npm install -g 原地更新:npm 会整棵重铺
+ * u1s1-cli/node_modules,而 pi-ai 的 API 适配器要到首次模型调用才按路径懒加载
+ * (openai-completions.lazy.js),路径被砸掉就 ERR_MODULE_NOT_FOUND 当场炸
+ * (0.13.2 之前云端沙箱首任务必崩的现场)。所以这里只记 pending,退出后再装。
  */
-async function checkAndAutoUpdate() {
+async function checkForUpdate() {
     let latest;
     try {
         const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
@@ -59,19 +67,29 @@ async function checkAndAutoUpdate() {
             : userAgent.startsWith("bun") ? "bun"
                 : "npm";
     const installCmd = pm === "npm"
-        ? `npm install -g ${PACKAGE_NAME}@latest`
+        ? `npm install -g --loglevel=error ${PACKAGE_NAME}@latest`
         : `${pm} add -g ${PACKAGE_NAME}@latest`;
-    setUpdateNotice(`⬆ 发现新版 v${latest},自动更新中…`);
+    pendingUpdate = { latest, installCmd };
+    setUpdateNotice(`⬆ 发现新版 v${latest},退出后自动更新`);
+}
+/**
+ * TUI 退出后前台安装新版:此刻不再有模型调用和懒加载,重铺 node_modules 才安全。
+ * 不设 timeout——半路杀掉 npm 会留下残缺的全局安装,之后连启动都起不来;
+ * stdio 直通,装多久用户看得见。(同机另开的 u1s1 实例仍会被重铺波及,属残余
+ * 风险,但远好于更新自己脚下这棵树。)
+ */
+function installPendingUpdate() {
+    if (!pendingUpdate)
+        return;
+    const { latest, installCmd } = pendingUpdate;
+    console.log(`\n⬆ 正在更新到 v${latest}…`);
     try {
-        // 异步安装:execSync 会卡死事件循环,TUI 打字会冻住
-        const { exec } = await import("node:child_process");
-        const { promisify } = await import("node:util");
-        await promisify(exec)(installCmd, { timeout: 60_000 });
-        setUpdateNotice(`✨ 已更新到 v${latest},重启后生效`);
+        execSync(installCmd, { stdio: "inherit" });
+        console.log(`✅ 已更新到 v${latest},下次运行 u1s1 生效。`);
     }
     catch {
-        // 自动更新失败不阻塞，用户可手动 `u1s1 update`
-        setUpdateNotice(`⬆ 新版 v${latest} 可用 · u1s1 update 升级`);
+        // 失败不挡退出,下次启动还会再试;也可手动 `u1s1 update`
+        console.error("自动更新失败。可稍后手动运行:u1s1 update");
     }
 }
 /**
@@ -116,7 +134,7 @@ function ensureTmuxKeyboardProtocol() {
 }
 async function runAgent(cfg, args) {
     cleanupBrandThemes();
-    ensureBrandPrompt();
+    ensureBrandPrompt(ensureUsableShell());
     ensureDefaultSettings();
     // 预 seed fd/rg(国内直连 GitHub 不通,pi 自己下不动);与取模型列表并行,
     // 但必须在进 pi 之前就位,否则 pi 会自己去 GitHub 下载
@@ -160,13 +178,14 @@ async function runAgent(cfg, args) {
             if (data === "\r" || data === "\n") {
                 const text = this.getText().trim();
                 if (text.startsWith("/login")) {
-                    console.log("  u1s1 不需要额外登录,直接用 /model 切换模型即可");
+                    console.log("  切换模型用 /model;要换 u1s1 账号的话,先 /exit 退出,再在终端运行:");
+                    console.log("  u1s1 logout && u1s1 login(浏览器里选要用的账号)");
                     this.setText("");
                     this.addToHistory?.(text);
                     return;
                 }
                 if (text === "/logout") {
-                    console.log("  u1s1 统一使用同一个 API Key,不需要单独登出");
+                    console.log("  退出登录请先 /exit 回到终端,再运行:u1s1 logout");
                     this.setText("");
                     this.addToHistory?.(text);
                     return;
@@ -308,8 +327,10 @@ async function run() {
     const { ensureAuth } = await import("./login.js");
     const cfg = await ensureAuth();
     // 在后台检查更新（非阻塞，不影响启动速度）
-    void checkAndAutoUpdate();
+    void checkForUpdate();
     await runAgent(cfg, args);
+    // autoUpdate 开着且启动时发现了新版:现在装(TUI 已退出,原地重铺安全)
+    installPendingUpdate();
 }
 run().catch((e) => {
     console.error(e instanceof Error ? e.message : e);

package/dist/shell-doctor.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Windows shell 体检。pi 的 shell 兜底顺序是 Program Files 的 Git Bash →
+ * PATH 上第一个 bash.exe,后者经常命中 System32 的 WSL 转发器:默认发行版
+ * 没有 /bin/bash 时(装过 Docker Desktop 的机器把 docker-desktop 当默认很
+ * 常见),所有命令 0.1s 内失败,stderr 还是 UTF-16 乱码,模型只能干瞪眼。
+ * 这里在进 pi 之前把一个「验过活」的 bash 写进 settings.json 的 shellPath;
+ * 找不到就当场把修复指引打给用户,并让品牌 prompt 告知模型别撞墙。
+ */
+export type ShellDoctorResult = {
+    status: "posix";
+} | {
+    status: "bash";
+    shellPath: string;
+} | {
+    status: "wsl";
+    shellPath: string;
+} | {
+    status: "none";
+} | {
+    status: "unknown";
+};
+export declare function ensureUsableShell(): ShellDoctorResult;

package/dist/shell-doctor.js

@@ -0,0 +1,129 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { agentDir, agentSettingsFile } from "./config.js";
+/** System32/Sysnative 的 bash.exe 是 WSL 转发器,不是真 bash(与 pi 同款判断)。 */
+function isWslRelayBash(p) {
+    const normalized = p.replace(/\//g, "\\").toLowerCase();
+    return /^[a-z]:\\windows\\(?:system32|sysnative)\\bash\.exe$/.test(normalized);
+}
+/** 真跑一条 echo 验活。WSL 转发器不支持 -c 传参(pi 对它走 stdin),探活同款。 */
+function bashWorks(bashPath) {
+    const viaStdin = isWslRelayBash(bashPath);
+    try {
+        const res = spawnSync(bashPath, viaStdin ? ["-s"] : ["-c", "echo u1s1-shell-ok"], {
+            input: viaStdin ? "echo u1s1-shell-ok\n" : undefined,
+            encoding: "utf-8",
+            timeout: 5000,
+            windowsHide: true,
+        });
+        // WSL 转发器可能按 UTF-16LE 输出(ASCII 字符间夹 NUL),剔掉再找标记
+        return res.status === 0 && (res.stdout ?? "").replace(/\u0000/g, "").includes("u1s1-shell-ok");
+    }
+    catch {
+        return false;
+    }
+}
+function runWhere(name) {
+    try {
+        const res = spawnSync("where", [name], { encoding: "utf-8", timeout: 5000, windowsHide: true });
+        if (res.status !== 0 || !res.stdout)
+            return [];
+        return res.stdout
+            .trim()
+            .split(/\r?\n/)
+            .map((l) => l.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Git Bash 候选位置:pi 只认 Program Files 两处,漏掉 winget 默认的用户级
+ * 安装(%LOCALAPPDATA%\Programs\Git)和 scoop;再从 git.exe 反推兜住
+ * portable 安装。只返回磁盘上真实存在的路径。
+ */
+function candidateGitBashPaths() {
+    const out = [];
+    const add = (p) => {
+        if (!out.includes(p))
+            out.push(p);
+    };
+    for (const [envKey, ...rest] of [
+        ["ProgramFiles", "Git", "bin", "bash.exe"],
+        ["ProgramFiles(x86)", "Git", "bin", "bash.exe"],
+        ["LOCALAPPDATA", "Programs", "Git", "bin", "bash.exe"],
+        ["USERPROFILE", "scoop", "apps", "git", "current", "bin", "bash.exe"],
+    ]) {
+        const base = process.env[envKey];
+        if (base)
+            add(join(base, ...rest));
+    }
+    // git.exe 在 <root>\cmd、<root>\bin 或 <root>\mingw64\bin 下,向上找 root
+    for (const gitPath of runWhere("git.exe")) {
+        const dir = dirname(gitPath);
+        for (const root of [dirname(dir), dirname(dirname(dir))]) {
+            add(join(root, "bin", "bash.exe"));
+            add(join(root, "usr", "bin", "bash.exe"));
+        }
+    }
+    return out.filter((p) => existsSync(p));
+}
+export function ensureUsableShell() {
+    if (process.platform !== "win32")
+        return { status: "posix" };
+    mkdirSync(agentDir, { recursive: true });
+    let settings = {};
+    if (existsSync(agentSettingsFile)) {
+        try {
+            settings = JSON.parse(readFileSync(agentSettingsFile, "utf8"));
+        }
+        catch {
+            return { status: "unknown" }; // 不动损坏的文件,pi 启动时会自己报
+        }
+    }
+    // 已配置且文件还在:信它,不每次启动都探活(坏了 pi 会在会话里报错)
+    const configured = settings["shellPath"];
+    if (typeof configured === "string" && configured && existsSync(configured)) {
+        return isWslRelayBash(configured)
+            ? { status: "wsl", shellPath: configured }
+            : { status: "bash", shellPath: configured };
+    }
+    // shellPath 缺失或指向已卸载的文件:探测 + 验活,找到就固定下来
+    for (const candidate of candidateGitBashPaths()) {
+        if (bashWorks(candidate)) {
+            settings["shellPath"] = candidate;
+            writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
+            if (typeof configured === "string") {
+                console.error(`  原 shellPath 已失效,自动改用: ${candidate}`);
+            }
+            return { status: "bash", shellPath: candidate };
+        }
+    }
+    // 没有 Git Bash:看 PATH 上还有什么(与 pi 的兜底一致,但这里要验活)
+    const fallback = runWhere("bash.exe").find((p) => existsSync(p));
+    if (fallback && bashWorks(fallback)) {
+        if (isWslRelayBash(fallback)) {
+            // 能用但跑在 Linux 里。不写进 settings:一旦用户装了 Git Bash,
+            // 下次启动就能自动切回 Windows 本机执行。
+            console.error("  ⚠ 未找到 Git Bash,将使用 WSL 的 bash:命令会在 WSL 的 Linux 里执行,不是 Windows 本机。");
+            console.error("    建议安装 Git for Windows(PowerShell 运行: winget install --id Git.Git)后重启 u1s1。");
+            return { status: "wsl", shellPath: fallback };
+        }
+        settings["shellPath"] = fallback;
+        writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
+        return { status: "bash", shellPath: fallback };
+    }
+    if (fallback) {
+        console.error(`  ⚠ 检测到的 bash(${fallback})无法执行命令,u1s1 的命令工具会全部失败。`);
+        if (isWslRelayBash(fallback)) {
+            console.error("    它是 WSL 转发器,当前默认发行版里没有 /bin/bash(docker-desktop 被设为默认时就会这样)。");
+        }
+    }
+    else {
+        console.error("  ⚠ 没找到 bash,u1s1 无法执行命令。");
+    }
+    console.error("    修复:PowerShell 里运行 winget install --id Git.Git 安装 Git for Windows,装完重启 u1s1。");
+    return { status: "none" };
+}

package/dist/web.js

@@ -5,6 +5,7 @@ import { dirname, join } from "node:path";
 import { cleanupBrandThemes, endpointKeyEnv, ensureAuthCredential, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, scrubForeignProviderEnv, writeWebToolsExtension, } from "./agent-setup.js";
 import { agentDir, apiModelToDef, resolvePreferredModel, setModelsFromApi, u1s1Dir, writeAgentDefaultModel, } from "./config.js";
 import { ensureSearchTools } from "./search-tools.js";
+import { ensureUsableShell } from "./shell-doctor.js";
 import { applyWebUiBranding, applyWebUiFrontend } from "./webui-brand.js";
 import { fetchModels, loadCustomEndpoints } from "./api.js";
 const require = createRequire(import.meta.url);
@@ -20,7 +21,7 @@ const require = createRequire(import.meta.url);
  */
 export async function prepareWebEnv(cfg) {
     cleanupBrandThemes();
-    ensureBrandPrompt();
+    ensureBrandPrompt(ensureUsableShell());
     ensureDefaultSettings();
     // 网页版/App 的 agent 会话同样依赖 fd/rg(同一个 agentDir);与取模型列表并行
     const searchToolsReady = ensureSearchTools(cfg);

package/package.json

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