u1s1-cli 0.6.0 → 0.7.2

package/dist/agent-setup.js

@@ -0,0 +1,104 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { agentDir, MODELS, PROVIDER_ID } from "./config.js";
+const BRAND_APPEND = `## u1s1
+
+你是 u1s1(有一说一) —— 说人话的 AI 编程搭子,一个面向编程新手的中文 AI 编程助手。用户很可能不熟悉编程术语:
+- 自我介绍或被问「你是谁」时,自称 u1s1(有一说一),不要自称 pi;只有用户明确问底层实现时才提 pi 引擎。
+- 默认用中文回复;代码、命令、报错原文保持英文。
+- 解释问题时说人话,别堆术语;必要时用一句话打比方。
+- 改动前先说明打算做什么,改完用一两句话总结改了哪里。
+- 用户描述模糊时,先猜最可能的意图并确认,不要长篇追问。
+`;
+/** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
+export function ensureBrandPrompt() {
+    mkdirSync(agentDir, { recursive: true });
+    const p = join(agentDir, "APPEND_SYSTEM.md");
+    if (!existsSync(p) || readFileSync(p, "utf8") !== BRAND_APPEND) {
+        writeFileSync(p, BRAND_APPEND);
+    }
+}
+/** Defaults that don't overwrite values the user already set. */
+export function ensureDefaultSettings() {
+    mkdirSync(agentDir, { recursive: true });
+    const p = join(agentDir, "settings.json");
+    let settings = {};
+    if (existsSync(p)) {
+        try {
+            settings = JSON.parse(readFileSync(p, "utf8"));
+        }
+        catch {
+            return;
+        }
+    }
+    let changed = false;
+    // Pi default is one-at-a-time (one queued message per turn). u1s1 delivers
+    // all queued messages together so burst typing isn't split across turns.
+    // Only fill in missing keys so an explicit /settings choice still sticks.
+    for (const key of ["steeringMode", "followUpMode"]) {
+        if (!(key in settings)) {
+            settings[key] = "all";
+            changed = true;
+        }
+    }
+    if (!("hideThinkingBlock" in settings)) {
+        settings["hideThinkingBlock"] = true;
+        changed = true;
+    }
+    // ≤0.4.0 shipped branded themes and forced them as default; the files are
+    // gone now, so a settings.json still pointing at them must fall back to
+    // pi's default theme.
+    if (typeof settings.theme === "string" && settings.theme.includes("u1s1-")) {
+        delete settings.theme;
+        changed = true;
+    }
+    if (changed)
+        writeFileSync(p, JSON.stringify(settings, null, 2) + "\n");
+}
+/** ≤0.4.0 wrote u1s1-dark/u1s1-light into the pi themes dir; remove them. */
+export function cleanupBrandThemes() {
+    for (const name of ["u1s1-dark", "u1s1-light"]) {
+        rmSync(join(agentDir, "themes", `${name}.json`), { force: true });
+    }
+}
+/**
+ * u1s1 provider for SDK-based frontends (`u1s1 web`): pi composes
+ * <agentDir>/models.json above registered providers, so this exposes the same
+ * models as the TUI's in-process extension without patching the frontend.
+ * apiKey stays an env reference — the launcher sets U1S1_API_KEY, the file
+ * itself holds no secret. Rewritten on every launch so baseUrl/model changes
+ * propagate; other providers a user may have added are preserved.
+ */
+export function ensureProviderModels(cfg) {
+    mkdirSync(agentDir, { recursive: true });
+    const p = join(agentDir, "models.json");
+    let root = {};
+    if (existsSync(p)) {
+        try {
+            root = JSON.parse(readFileSync(p, "utf8"));
+        }
+        catch {
+            root = {};
+        }
+    }
+    const providers = typeof root["providers"] === "object" && root["providers"] !== null
+        ? root["providers"]
+        : {};
+    providers[PROVIDER_ID] = {
+        name: "u1s1",
+        baseUrl: cfg.baseUrl,
+        api: "openai-completions",
+        apiKey: "$U1S1_API_KEY",
+        models: MODELS.map((m) => ({
+            id: m.id,
+            name: m.name,
+            reasoning: m.reasoning,
+            input: ["text"],
+            cost: m.cost,
+            contextWindow: m.contextWindow,
+            maxTokens: m.maxTokens,
+        })),
+    };
+    root["providers"] = providers;
+    writeFileSync(p, JSON.stringify(root, null, 2) + "\n");
+}

package/dist/api.js

@@ -1,3 +1,20 @@
+export async function fetchModels(cfg) {
+    let resp;
+    try {
+        resp = await fetch(`${cfg.baseUrl}/models`, {
+            headers: { authorization: `Bearer ${cfg.apiKey}` },
+        });
+    }
+    catch {
+        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+    }
+    if (resp.status === 401)
+        throw new Error("这把 Key 不对或已失效,去 https://u1s1.io/dashboard 看看");
+    if (!resp.ok)
+        throw new Error(`服务端返回 ${resp.status},稍后再试`);
+    const body = (await resp.json());
+    return body.data;
+}
 export async function fetchMe(cfg) {
     if (!cfg.apiKey)
         throw new Error("没有配置 API Key");

package/dist/config.js

@@ -3,6 +3,34 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 export const DEFAULT_BASE_URL = "https://api.u1s1.io/v1";
 export const PROVIDER_ID = "u1s1";
+/** Make a short alias from a model id by stripping common prefixes. */
+function defaultAliases(id) {
+    const short = id.replace(/^[^/]+\./, "").replace(/^[^/]+\//, "");
+    const parts = short.split(/[-_.:]/);
+    const aliases = [short, ...parts.filter((p) => p.length > 1)];
+    return [...new Set(aliases)];
+}
+/**
+ * Convert an API model response to our internal ModelDef.
+ * Aliases are derived from the short id; note is left empty (filled by /model command).
+ */
+export function apiModelToDef(m) {
+    return {
+        id: m.id,
+        name: m.name,
+        aliases: defaultAliases(m.id),
+        reasoning: m.reasoning,
+        contextWindow: m.context_length,
+        maxTokens: m.max_tokens,
+        cost: {
+            input: m.price.input,
+            output: m.price.output,
+            cacheRead: m.price.cache_read ?? 0,
+            cacheWrite: 0,
+        },
+        note: "",
+    };
+}
 export const MODELS = [
     {
         id: "deepseek/deepseek-v4-flash",
@@ -25,6 +53,11 @@ export const MODELS = [
         note: "更强 · 但烧额度快约 20 倍,难题再用",
     },
 ];
+/** Replace MODELS with a fresh list fetched from server (e.g. at startup). */
+export function setModelsFromApi(apiModels) {
+    MODELS.length = 0;
+    MODELS.push(...apiModels);
+}
 export const DEFAULT_MODEL_ID = MODELS[0].id;
 export function resolveModel(nameOrAlias) {
     const q = nameOrAlias.trim().toLowerCase();

package/dist/index.js

@@ -1,73 +1,14 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
+import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, } from "./agent-setup.js";
 import { printConsoleBanner } from "./brand.js";
-import { agentDir, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, resolvePreferredModel, } from "./config.js";
+import { agentDir, apiModelToDef, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, resolvePreferredModel, setModelsFromApi, } from "./config.js";
 import { applyBrandUi } from "./style.js";
+import { fetchModels } from "./api.js";
 const require = createRequire(import.meta.url);
 const VERSION = require("../package.json").version;
-const BRAND_APPEND = `## u1s1
-
-你是 u1s1(有一说一) —— 说人话的 AI 编程搭子,一个面向编程新手的中文 AI 编程助手。用户很可能不熟悉编程术语:
-- 自我介绍或被问「你是谁」时,自称 u1s1(有一说一),不要自称 pi;只有用户明确问底层实现时才提 pi 引擎。
-- 默认用中文回复;代码、命令、报错原文保持英文。
-- 解释问题时说人话,别堆术语;必要时用一句话打比方。
-- 改动前先说明打算做什么,改完用一两句话总结改了哪里。
-- 用户描述模糊时,先猜最可能的意图并确认,不要长篇追问。
-`;
-/** pi auto-appends <agentDir>/APPEND_SYSTEM.md to its system prompt — our branding hook. */
-function ensureBrandPrompt() {
-    mkdirSync(agentDir, { recursive: true });
-    const p = join(agentDir, "APPEND_SYSTEM.md");
-    if (!existsSync(p) || readFileSync(p, "utf8") !== BRAND_APPEND) {
-        writeFileSync(p, BRAND_APPEND);
-    }
-}
-/** Defaults that don't overwrite values the user already set. */
-function ensureDefaultSettings() {
-    mkdirSync(agentDir, { recursive: true });
-    const p = join(agentDir, "settings.json");
-    let settings = {};
-    if (existsSync(p)) {
-        try {
-            settings = JSON.parse(readFileSync(p, "utf8"));
-        }
-        catch {
-            return;
-        }
-    }
-    let changed = false;
-    // Pi default is one-at-a-time (one queued message per turn). u1s1 delivers
-    // all queued messages together so burst typing isn't split across turns.
-    // Only fill in missing keys so an explicit /settings choice still sticks.
-    for (const key of ["steeringMode", "followUpMode"]) {
-        if (!(key in settings)) {
-            settings[key] = "all";
-            changed = true;
-        }
-    }
-    if (!("hideThinkingBlock" in settings)) {
-        settings["hideThinkingBlock"] = true;
-        changed = true;
-    }
-    // ≤0.4.0 shipped branded themes and forced them as default; the files are
-    // gone now, so a settings.json still pointing at them must fall back to
-    // pi's default theme.
-    if (typeof settings.theme === "string" && settings.theme.includes("u1s1-")) {
-        delete settings.theme;
-        changed = true;
-    }
-    if (changed)
-        writeFileSync(p, JSON.stringify(settings, null, 2) + "\n");
-}
-/** ≤0.4.0 wrote u1s1-dark/u1s1-light into the pi themes dir; remove them. */
-function cleanupBrandThemes() {
-    for (const name of ["u1s1-dark", "u1s1-light"]) {
-        rmSync(join(agentDir, "themes", `${name}.json`), { force: true });
-    }
-}
 /**
  * tmux 默认不转发键盘修饰键,会把 Shift+Enter 当成普通回车发出去,消息没写完就被发送。
  * 只开 extended-keys 不够:默认 terminal-features 里 xterm* 没有 extkeys,tmux 根本不会
@@ -112,6 +53,15 @@ async function runAgent(cfg, args) {
     cleanupBrandThemes();
     ensureBrandPrompt();
     ensureDefaultSettings();
+    // Fetch model list from server; fall back to built-in MODELS on error.
+    try {
+        const apiModels = await fetchModels(cfg);
+        setModelsFromApi(apiModels.map(apiModelToDef));
+    }
+    catch (e) {
+        console.error("  获取模型列表失败,使用内置列表:", e.message);
+    }
+    ensureProviderModels(cfg);
     ensureTmuxKeyboardProtocol();
     // must be set before pi reads them (getAgentDir() reads at call time, env at import is fine too)
     process.env["PI_CODING_AGENT_DIR"] = agentDir;
@@ -124,6 +74,22 @@ async function runAgent(cfg, args) {
     // Shift+Enter,输入框就会换行,真·Alt+Enter(\x1b[13;3u)不受影响。
     class ShiftEnterEditor extends CustomEditor {
         handleInput(data) {
+            // 拦截 /login 和 /logout,不让 pi 弹出内置供应商列表
+            if (data === "\r" || data === "\n") {
+                const text = this.getText().trim();
+                if (text.startsWith("/login")) {
+                    console.log("  u1s1 不需要额外登录,直接用 /model 切换模型即可");
+                    this.setText("");
+                    this.addToHistory?.(text);
+                    return;
+                }
+                if (text === "/logout") {
+                    console.log("  u1s1 统一使用同一个 API Key,不需要单独登出");
+                    this.setText("");
+                    this.addToHistory?.(text);
+                    return;
+                }
+            }
             super.handleInput(data === "\x1b\r" ? "\x1b[13;2u" : data);
         }
     }
@@ -195,6 +161,21 @@ async function run() {
     }
     if (cmd === "--help" || cmd === "-h") {
         printConsoleBanner(VERSION);
+        console.log(" u1s1 命令:web(浏览器网页版)· web shortcut(桌面图标)· login / logout · model · usage · update · import");
+        console.log("");
+    }
+    if (cmd === "web") {
+        // shortcut 不需要登录:安装脚本装完立刻调用,不能在这里卡住 device login
+        if (args[1] === "shortcut") {
+            const { createWebShortcut } = await import("./shortcut.js");
+            createWebShortcut();
+            return;
+        }
+        const { ensureAuth } = await import("./login.js");
+        const cfg = await ensureAuth();
+        const { webCommand } = await import("./web.js");
+        await webCommand(cfg, args.slice(1));
+        return;
     }
     if (cmd === "login") {
         const { login } = await import("./login.js");

package/dist/login.js

@@ -67,6 +67,12 @@ async function pollDeviceLogin(origin, start) {
     return null;
 }
 async function promptForKey() {
+    // 桌面图标双击启动时没有可交互的终端,rl.question 会无声挂死;
+    // 走到这个兜底说明 device login 不可用(网关太老/断网),只能明确报错。
+    if (!process.stdin.isTTY) {
+        console.error("  无法完成浏览器登录(网络问题或网关不可用),请稍后重试。");
+        process.exit(1);
+    }
     console.log("  需要一把 API Key(免费):");
     console.log(`  1. 打开 ${DASHBOARD_URL} 注册/登录(30 秒,送 $10 额度)`);
     console.log("  2. 复制你的 API Key,粘贴到下面");

package/dist/model.js

@@ -7,7 +7,12 @@ export async function modelCommand(nameOrAlias) {
         for (const m of MODELS) {
             const mark = m.id === current ? "●" : " ";
             console.log(`  ${mark} ${m.aliases[0].padEnd(10)} ${m.name}`);
-            console.log(`               ${m.note} · $${m.cost.input}/$${m.cost.output} 每百万 token`);
+            if (m.note) {
+                console.log(`               ${m.note} · $${m.cost.input}/$${m.cost.output} 每百万 token`);
+            }
+            else {
+                console.log(`               $${m.cost.input}/$${m.cost.output} 每百万 token`);
+            }
         }
         console.log("");
         console.log("  切换:u1s1 model grok / u1s1 model deepseek(对话里 /model 同样会记住)");

package/dist/shortcut.js

@@ -0,0 +1,106 @@
+import { spawnSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * `u1s1 web shortcut` — 在桌面创建「u1s1 网页版」图标,双击即启动网页版。
+ * 面向完全不用终端的用户:安装脚本会自动调用,之后的登录(浏览器 device flow)、
+ * 聊天全程不需要终端知识。
+ *
+ * 图标里嵌的是 node 与 CLI 入口的绝对路径 —— GUI 双击环境(macOS .command、
+ * Linux .desktop、Windows .lnk)拿不到 npm 全局 bin 的 PATH。
+ * 工作目录固定 ~/u1s1(自动创建):给新手一个可预期的「我的项目」目录,
+ * 网页里仍可切换;有历史工作区时 UI 会自己恢复上次的。
+ */
+const SHORTCUT_NAME = "u1s1 网页版";
+function cliEntry() {
+    return fileURLToPath(new URL("./index.js", import.meta.url));
+}
+function defaultWorkspace() {
+    const dir = join(homedir(), "u1s1");
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function linuxDesktopDir() {
+    const out = spawnSync("xdg-user-dir", ["DESKTOP"], { encoding: "utf8", timeout: 3000 });
+    const dir = out.status === 0 ? out.stdout.trim() : "";
+    return dir && dir !== homedir() ? dir : join(homedir(), "Desktop");
+}
+function createLinux(node, entry, cwd) {
+    const desktop = `[Desktop Entry]
+Type=Application
+Name=${SHORTCUT_NAME}
+Comment=有一说一 — 说人话的 AI 编程搭子(浏览器版)
+Exec="${node}" "${entry}" web --cwd "${cwd}"
+Terminal=true
+Categories=Development;
+`;
+    const appsDir = join(homedir(), ".local", "share", "applications");
+    mkdirSync(appsDir, { recursive: true });
+    const appFile = join(appsDir, "u1s1-web.desktop");
+    writeFileSync(appFile, desktop);
+    chmodSync(appFile, 0o755);
+    const desktopDir = linuxDesktopDir();
+    let placed = appFile;
+    if (existsSync(desktopDir)) {
+        placed = join(desktopDir, "u1s1-web.desktop");
+        writeFileSync(placed, desktop);
+        chmodSync(placed, 0o755);
+        // GNOME 桌面图标需要 trusted 标记才可双击;失败无妨(应用菜单入口仍可用)
+        spawnSync("gio", ["set", placed, "metadata::trusted", "true"], { timeout: 3000 });
+    }
+    return placed;
+}
+function createMac(node, entry, cwd) {
+    const file = join(homedir(), "Desktop", `${SHORTCUT_NAME}.command`);
+    writeFileSync(file, `#!/bin/bash
+# 双击启动 u1s1 网页版;关闭这个窗口即停止
+exec "${node}" "${entry}" web --cwd "${cwd}"
+`);
+    chmodSync(file, 0o755);
+    return file;
+}
+function createWindows(node, entry, cwd) {
+    // Desktop 路径交给 .NET 解析(兼容 OneDrive 重定向);.lnk 目标是 node.exe。
+    const psQuote = (s) => `'${s.replace(/'/g, "''")}'`;
+    const script = [
+        `$desktop = [Environment]::GetFolderPath('Desktop')`,
+        `$lnk = Join-Path $desktop ${psQuote(`${SHORTCUT_NAME}.lnk`)}`,
+        `$ws = New-Object -ComObject WScript.Shell`,
+        `$s = $ws.CreateShortcut($lnk)`,
+        `$s.TargetPath = ${psQuote(node)}`,
+        `$s.Arguments = ('"' + ${psQuote(entry)} + '" web --cwd "' + ${psQuote(cwd)} + '"')`,
+        `$s.WorkingDirectory = ${psQuote(cwd)}`,
+        `$s.Description = ${psQuote("有一说一 — 说人话的 AI 编程搭子(浏览器版)")}`,
+        `$s.Save()`,
+        `Write-Output $lnk`,
+    ].join("; ");
+    const out = spawnSync("powershell", ["-NoProfile", "-NonInteractive", "-Command", script], {
+        encoding: "utf8",
+        timeout: 20_000,
+    });
+    if (out.status !== 0) {
+        throw new Error(`PowerShell 创建快捷方式失败:${(out.stderr || "").trim().slice(0, 200)}`);
+    }
+    return out.stdout.trim().split(/\r?\n/).pop() ?? "桌面";
+}
+export function createWebShortcut() {
+    const node = process.execPath;
+    const entry = cliEntry();
+    const cwd = defaultWorkspace();
+    try {
+        const placed = process.platform === "darwin"
+            ? createMac(node, entry, cwd)
+            : process.platform === "win32"
+                ? createWindows(node, entry, cwd)
+                : createLinux(node, entry, cwd);
+        console.log(`✓ 已在桌面创建「${SHORTCUT_NAME}」图标:${placed}`);
+        console.log("  双击即可在浏览器里使用 u1s1;项目文件默认放在 ~/u1s1 文件夹。");
+    }
+    catch (e) {
+        console.error(`创建桌面图标失败:${e instanceof Error ? e.message : String(e)}`);
+        console.error("可以先手动使用:打开终端输入 u1s1 web");
+        process.exitCode = 1;
+    }
+}

package/dist/web.js

@@ -0,0 +1,87 @@
+import { spawn, spawnSync } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, } from "./agent-setup.js";
+import { agentDir, apiModelToDef, resolvePreferredModel, setModelsFromApi, u1s1Dir, writeAgentDefaultModel, } from "./config.js";
+import { applyWebUiBranding } from "./webui-brand.js";
+import { fetchModels } from "./api.js";
+const require = createRequire(import.meta.url);
+/**
+ * `u1s1 web` — 浏览器网页版。薄包装 pi-web-ui 的服务器:注入我们的 agentDir
+ * (品牌 prompt / models.json / 会话与 TUI 共享)和登录 key,其余原样透传
+ * (--port / --cwd / --no-browser)。
+ */
+export async function webCommand(cfg, args) {
+    // pi-web-ui 的 server install/shortcut 生成的服务定义只固化 PORT/CWD,不带
+    // PI_CODING_AGENT_DIR 和 U1S1_API_KEY —— 装出来的自启服务是坏的(丢登录态、
+    // 会话落到 ~/.pi)。在上游支持透传 env 或我们自己生成服务定义前,直接拦掉。
+    if (args[0] === "server") {
+        console.error("u1s1 web 暂不支持 server 子命令(开机自启/桌面图标),后续版本会加上。");
+        console.error("现在请直接运行 u1s1 web,Ctrl+C 停止。");
+        process.exitCode = 1;
+        return;
+    }
+    // pi-web-ui 是 optionalDependency:装 CLI 时它编译/下载失败不会拖垮整个安装,
+    // 代价是这里可能不存在 —— 给出人话指引而不是 Cannot find module。
+    let bin;
+    try {
+        bin = require.resolve("pi-web-ui/bin/pi-web-ui.mjs");
+    }
+    catch {
+        console.error("网页版组件(pi-web-ui)没有安装成功,通常是安装时网络不稳或缺少编译工具。");
+        console.error("请重新安装试试:npm install -g u1s1-cli");
+        console.error("Linux 用户可能还需要:sudo apt install -y build-essential(或对应发行版的 gcc/make)");
+        process.exitCode = 1;
+        return;
+    }
+    // 终端面板依赖原生模块 node-pty。Windows/macOS 走官方 prebuilds 一定在;
+    // Linux 便携包/无 gcc 环境可能缺编译产物,而服务器是顶层 import —— 缺了会
+    // 整个起不来。先探测,坏了就说人话。
+    const probe = spawnSync(process.execPath, ["-e", "require(require.resolve('node-pty',{paths:[process.argv[1]]}))", dirname(bin)], { timeout: 10_000 });
+    if (probe.status !== 0) {
+        console.error("网页版的终端组件(node-pty)在这台机器上没有编译成功,网页版暂时起不来。");
+        console.error("Linux 用户先装编译工具再重装:sudo apt install -y build-essential && npm install -g u1s1-cli");
+        process.exitCode = 1;
+        return;
+    }
+    cleanupBrandThemes();
+    ensureBrandPrompt();
+    ensureDefaultSettings();
+    // Fetch model list from server; fall back to built-in MODELS on error.
+    try {
+        const apiModels = await fetchModels(cfg);
+        setModelsFromApi(apiModels.map(apiModelToDef));
+    }
+    catch (e) {
+        console.error("  获取模型列表失败,使用内置列表:", e.message);
+    }
+    ensureProviderModels(cfg);
+    // 网页版新会话从 settings.json 的 defaultModel 取模型(TUI 是每次传 --model),
+    // 确保它有值;resolvePreferredModel 优先尊重已有的 in-session 选择,不会回退覆盖。
+    writeAgentDefaultModel(resolvePreferredModel(cfg.model));
+    const dataDir = join(u1s1Dir, "web");
+    mkdirSync(dataDir, { recursive: true });
+    applyWebUiBranding(bin);
+    console.log("u1s1 网页版启动中… 浏览器会自动打开;关闭请回到这里按 Ctrl+C。");
+    const child = spawn(process.execPath, [bin, ...args], {
+        stdio: "inherit",
+        env: {
+            ...process.env,
+            PI_CODING_AGENT_DIR: agentDir,
+            U1S1_API_KEY: cfg.apiKey,
+            PI_WEB_DATA_DIR: dataDir,
+        },
+    });
+    // Ctrl+C 由子进程负责优雅停机(同进程组,信号会直达);父进程只等退出码,
+    // 避免父进程先死导致孤儿服务器。
+    const ignore = () => { };
+    process.on("SIGINT", ignore);
+    process.on("SIGTERM", ignore);
+    await new Promise((resolve) => {
+        child.on("exit", (code) => {
+            process.exitCode = code ?? 0;
+            resolve();
+        });
+    });
+}

package/dist/webui-brand.js

@@ -0,0 +1,52 @@
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+/**
+ * pi-web-ui 前端产物的启动时品牌补丁。不 fork 上游,只在每次 `u1s1 web` 启动前
+ * 改它 web/dist 里的静态文件:重写 <title>、换 favicon、注入一段小脚本把页面
+ * chrome 上的 π / pi-web-ui 字样换成 u1s1。
+ *
+ * - 幂等:index.html 里有版本化标记则跳过;pi-web-ui 升级后文件是新的,自动重打。
+ * - 写文件前先 rmSync 断开硬链接 —— pnpm 的 node_modules 是全局 store 的硬链接,
+ *   原地写会污染 store;unlink 后新写的是独立 inode,npm 平铺安装则无所谓。
+ */
+const PATCH_MARK = "u1s1-brand-v1";
+const PAGE_TITLE = "u1s1 网页版 — 有一说一";
+const FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+<rect width="64" height="64" rx="14" fill="#101418"/>
+<text x="32" y="42" font-family="ui-monospace,Menlo,Consolas,monospace" font-size="26" font-weight="700" fill="#4ea1ff" text-anchor="middle">u1</text>
+</svg>
+`;
+/** 页面 chrome 品牌替换:改 .brand-logo/.brand-name,盯住 title(React 可能改回去)。 */
+const BRAND_JS = `(function(){
+  var NAME = "u1s1", LOGO = "\\u273b"; // ✻,与 TUI 品牌一致
+  function apply(){
+    if (document.title.indexOf("pi") !== -1 || document.title.indexOf("π") !== -1) document.title = ${JSON.stringify(PAGE_TITLE)};
+    var logo = document.querySelector(".brand-logo");
+    if (logo && logo.textContent !== LOGO) logo.textContent = LOGO;
+    var name = document.querySelector(".brand-name");
+    if (name && name.textContent !== NAME) name.textContent = NAME;
+  }
+  apply();
+  new MutationObserver(apply).observe(document.documentElement, { childList: true, subtree: true });
+})();
+`;
+function replaceFile(path, content) {
+    rmSync(path, { force: true });
+    writeFileSync(path, content);
+}
+/** binPath = <pkg>/bin/pi-web-ui.mjs → 前端产物在 <pkg>/web/dist。 */
+export function applyWebUiBranding(binPath) {
+    const dist = join(dirname(binPath), "..", "web", "dist");
+    const indexHtml = join(dist, "index.html");
+    if (!existsSync(indexHtml))
+        return; // 上游布局变了就跳过,页面保持原样也能用
+    let html = readFileSync(indexHtml, "utf8");
+    if (html.includes(PATCH_MARK))
+        return;
+    replaceFile(join(dist, "u1s1-brand.js"), BRAND_JS);
+    replaceFile(join(dist, "favicon.svg"), FAVICON_SVG);
+    html = html
+        .replace(/<title>[^<]*<\/title>/, `<title>${PAGE_TITLE}</title>`)
+        .replace("</head>", `  <!-- ${PATCH_MARK} -->\n    <script defer src="/u1s1-brand.js"></script>\n  </head>`);
+    replaceFile(indexHtml, html);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "0.6.0",
+  "version": "0.7.2",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {
@@ -34,6 +34,9 @@
     "@earendil-works/pi-coding-agent": "0.84.2",
     "@earendil-works/pi-tui": "0.84.2"
   },
+  "optionalDependencies": {
+    "pi-web-ui": "0.20.1"
+  },
   "devDependencies": {
     "@types/node": "^22.15.0",
     "tsx": "^4.20.0",