u1s1-cli 0.1.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # u1s1 — 有一说一,最省心的 AI 编程搭子
 
-在终端里用中文说需求,AI 帮你读文件、改代码、跑命令。不用买模型、不用配 API、不用懂那些名词,注册就送**每月 $2 免费额度**(普通人根本用不完)。
+在终端里用中文说需求,AI 帮你读文件、改代码、跑命令。不用买模型、不用配 API、不用懂那些名词,注册就送**$10 免费额度**(一次性,用完不补)。
 
 ## 三步开始
 
@@ -22,13 +22,15 @@ u1s1
 |---|---|
 | `u1s1` | 进入交互模式,直接开聊 |
 | `u1s1 -p "把 README 里的错别字修一下"` | 一句话模式,干完就退出 |
-| `u1s1 usage` | 看本月额度用了多少 |
+| `u1s1 usage` | 看额度用了多少 |
+| `u1s1 model` | 看/切默认模型:`u1s1 model grok` 切 Grok 4.6,`u1s1 model deepseek` 切回(对话里 `/model` 同样会记住) |
+| `u1s1 update` | 升级 u1s1 到最新版 |
 | `u1s1 login` / `u1s1 logout` | 登录 / 退出 |
 
 ## 有一说一
 
-- **背后模型**:DeepSeek V4 Flash,1M 超长上下文,写代码很能打,成本只有大牌模型的约 1/50。
-- **怎么收费**:额度按 API 实际成本扣,不加价;每月 1 号自动重置。
+- **背后模型**:默认 DeepSeek V4 Flash(1M 上下文,便宜大碗);难题可随时 `u1s1 model grok` 切 Grok 4.6(更强,但烧额度快约 20 倍)。对话里 `/model` 也会记住,下次启动还是这个。
+- **怎么收费**:额度按 API 实际成本扣,不加价;新用户一次性送 $10,用完不补。
 - **额度不够**:邀请朋友,你俩各得 $1 加量,永不过期 → [u1s1.io/dashboard](https://u1s1.io/dashboard)
 - **内核**:基于开源的 [pi](https://pi.dev) coding agent,会话管理、斜杠命令、皮肤等能力全都有。
 

package/dist/brand.js

@@ -0,0 +1,41 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+export const BRAND_NAME = "u1s1";
+export const BRAND_CN = "有一说一";
+export const BRAND_TAGLINE = "说人话的 AI 编程搭子";
+export const DASHBOARD_URL = "https://u1s1.io/dashboard";
+export function formatHomePath(path) {
+    const home = homedir();
+    const resolved = resolve(path);
+    if (resolved === home)
+        return "~";
+    if (resolved.startsWith(`${home}/`) || resolved.startsWith(`${home}\\`)) {
+        return `~${resolved.slice(home.length)}`;
+    }
+    return path;
+}
+/** Compact Claude-like startup header. */
+export function renderBrandHeader(theme, version, cwd) {
+    const diamond = theme.fg("accent", "◆");
+    const name = theme.bold(theme.fg("text", BRAND_NAME));
+    const cn = theme.fg("muted", BRAND_CN);
+    const meta = theme.fg("dim", `${BRAND_TAGLINE}  ·  v${version}`);
+    const dir = theme.fg("muted", formatHomePath(cwd));
+    const hints = [
+        theme.fg("accent", "/help"),
+        theme.fg("dim", "命令"),
+        theme.fg("dim", "·"),
+        theme.fg("accent", "Shift+Enter"),
+        theme.fg("dim", "换行"),
+        theme.fg("dim", "·"),
+        theme.fg("accent", "Esc"),
+        theme.fg("dim", "中断"),
+    ].join(" ");
+    return ["", `  ${diamond}  ${name}  ${cn}`, `     ${meta}`, "", `     ${dir}`, `     ${hints}`, ""];
+}
+export function printConsoleBanner(version) {
+    console.log("");
+    console.log(`  ◆  ${BRAND_NAME}  ${BRAND_CN}`);
+    console.log(`     ${BRAND_TAGLINE}  ·  v${version}`);
+    console.log("");
+}

package/dist/config.js

@@ -2,25 +2,83 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "n
 import { homedir } from "node:os";
 import { join } from "node:path";
 export const DEFAULT_BASE_URL = "https://api.u1s1.io/v1";
-export const MODEL_ID = "deepseek/deepseek-v4-flash";
 export const PROVIDER_ID = "u1s1";
+export const MODELS = [
+    {
+        id: "deepseek/deepseek-v4-flash",
+        name: "DeepSeek V4 Flash (u1s1)",
+        aliases: ["deepseek", "flash", "v4-flash"],
+        reasoning: false,
+        contextWindow: 1_048_576,
+        maxTokens: 65_536,
+        cost: { input: 0.14, output: 0.28, cacheRead: 0, cacheWrite: 0 },
+        note: "默认 · 便宜大碗,日常写代码首选",
+    },
+    {
+        id: "x-ai/grok-4.6",
+        name: "Grok 4.6 (u1s1)",
+        aliases: ["grok", "grok4.6", "grok-4.6"],
+        reasoning: true,
+        contextWindow: 500_000,
+        maxTokens: 65_536,
+        cost: { input: 2, output: 6, cacheRead: 0, cacheWrite: 0 },
+        note: "更强 · 但烧额度快约 20 倍,难题再用",
+    },
+];
+export const DEFAULT_MODEL_ID = MODELS[0].id;
+export function resolveModel(nameOrAlias) {
+    const q = nameOrAlias.trim().toLowerCase();
+    return MODELS.find((m) => m.id.toLowerCase() === q || m.aliases.includes(q));
+}
 export const u1s1Dir = join(homedir(), ".u1s1");
 const configFile = join(u1s1Dir, "config.json");
 /** pi keeps auth/models/settings/sessions under this dir — isolated from any real pi install. */
 export const agentDir = join(u1s1Dir, "agent");
-export function loadConfig() {
-    let file = {};
-    if (existsSync(configFile)) {
-        try {
-            file = JSON.parse(readFileSync(configFile, "utf8"));
-        }
-        catch {
-            // corrupted config falls back to defaults; login rewrites it
-        }
+const agentSettingsFile = join(agentDir, "settings.json");
+function readJsonFile(path) {
+    if (!existsSync(path))
+        return undefined;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
     }
+}
+/** Model last chosen in-session via /model (pi writes this). */
+export function readAgentDefaultModel() {
+    const settings = readJsonFile(agentSettingsFile);
+    if (!settings)
+        return undefined;
+    if (settings["defaultProvider"] !== PROVIDER_ID)
+        return undefined;
+    const id = settings["defaultModel"];
+    return typeof id === "string" && resolveModel(id) ? id : undefined;
+}
+/** Keep pi's settings.json in sync so /model and `u1s1 model` share one default. */
+export function writeAgentDefaultModel(modelId) {
+    mkdirSync(agentDir, { recursive: true });
+    const settings = readJsonFile(agentSettingsFile) ?? {};
+    if (settings["defaultProvider"] === PROVIDER_ID && settings["defaultModel"] === modelId)
+        return;
+    settings["defaultProvider"] = PROVIDER_ID;
+    settings["defaultModel"] = modelId;
+    writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
+}
+/**
+ * After this fix both stores stay in sync. If they still disagree (old installs),
+ * prefer the in-session /model value — that's the one users thought they had set.
+ */
+export function resolvePreferredModel(configModel) {
+    const agentModel = readAgentDefaultModel();
+    return agentModel ?? configModel ?? DEFAULT_MODEL_ID;
+}
+export function loadConfig() {
+    const file = (readJsonFile(configFile) ?? {});
     return {
         apiKey: process.env["U1S1_API_KEY"] || file.apiKey,
         baseUrl: process.env["U1S1_BASE_URL"] || file.baseUrl || DEFAULT_BASE_URL,
+        model: file.model && resolveModel(file.model) ? file.model : undefined,
     };
 }
 export function saveConfig(cfg) {
@@ -28,3 +86,10 @@ export function saveConfig(cfg) {
     writeFileSync(configFile, JSON.stringify(cfg, null, 2) + "\n");
     chmodSync(configFile, 0o600);
 }
+/** Persist the user's preferred model to both stores. */
+export function persistPreferredModel(cfg, modelId) {
+    const next = { ...cfg, model: modelId };
+    saveConfig(next);
+    writeAgentDefaultModel(modelId);
+    return next;
+}

package/dist/index.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
+import { spawnSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { createRequire } from "node:module";
-import { agentDir, loadConfig, MODEL_ID, PROVIDER_ID } from "./config.js";
+import { printConsoleBanner } from "./brand.js";
+import { agentDir, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, resolvePreferredModel, } from "./config.js";
+import { applyBrandUi } from "./style.js";
+import { DEFAULT_THEME_SETTING, ensureBrandThemes } from "./themes.js";
 const require = createRequire(import.meta.url);
 const VERSION = require("../package.json").version;
 const BRAND_APPEND = `## u1s1
@@ -21,38 +25,149 @@ function ensureBrandPrompt() {
         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;
+    if (!("hideThinkingBlock" in settings)) {
+        settings.hideThinkingBlock = true;
+        changed = true;
+    }
+    // Default / leftover Pi themes → u1s1 Claude-like pair. Custom names stay put.
+    const theme = settings.theme;
+    if (theme === undefined || theme === "dark" || theme === "light") {
+        settings.theme = DEFAULT_THEME_SETTING;
+        changed = true;
+    }
+    if (changed)
+        writeFileSync(p, JSON.stringify(settings, null, 2) + "\n");
+}
+/**
+ * tmux 默认不转发键盘修饰键,会把 Shift+Enter 当成普通回车发出去,消息没写完就被发送。
+ * 只开 extended-keys 不够:默认 terminal-features 里 xterm* 没有 extkeys,tmux 根本不会
+ * 向外层终端要 modifyOtherKeys,S-Enter 绑定也就永远触发不了。
+ * 启动时自动做这些事(运行时生效,不写用户 tmux.conf;失败则静默忽略,仍可用 Ctrl+J 换行):
+ * 1. 开启 extended-keys,并给当前终端补上 extkeys;
+ * 2. tmux 3.5+ 再切到 csi-u(3.4 及以下没有这个选项,忽略即可);
+ * 3. 兜底把 S-Enter / C-Enter 原样转成 pi 认得的 CSI-u 序列。
+ */
+function ensureTmuxKeyboardProtocol() {
+    if (!process.env.TMUX)
+        return;
+    const run = (args) => spawnSync("tmux", args, { timeout: 1500, encoding: "utf8" });
+    if (run(["-V"]).status !== 0)
+        return; // tmux 不可用(如沙箱)则跳过
+    // 当前会话 + 全局默认都开,避免只改 -g 时已有会话仍是 off
+    run(["set-option", "-g", "extended-keys", "on"]);
+    run(["set-option", "extended-keys", "on"]);
+    // 3.5+; 3.4 会失败,忽略
+    run(["set-option", "-g", "extended-keys-format", "csi-u"]);
+    run(["set-option", "extended-keys-format", "csi-u"]);
+    const features = run(["show", "-gv", "terminal-features"]);
+    if (features.status === 0 && !/\bextkeys\b/.test(features.stdout ?? "")) {
+        run(["set-option", "-ga", "terminal-features", "xterm*:extkeys"]);
+    }
+    // 已挂上的客户端不会自动重读 terminal-features;直接往当前客户端 tty
+    // 发 modifyOtherKeys,让外层终端立刻开始区分 Shift+Enter。
+    const tty = run(["display-message", "-p", "#{client_tty}"]).stdout?.trim();
+    if (tty) {
+        try {
+            writeFileSync(tty, "\x1b[>4;2m");
+        }
+        catch {
+            // 没权限或不是 tty 就忽略
+        }
+    }
+    // -l: 按字面量发送,避免 send-keys 把转义序列拆成一串普通按键
+    run(["bind-key", "-n", "S-Enter", "send-keys", "-l", "\x1b[13;2u"]);
+    run(["bind-key", "-n", "C-Enter", "send-keys", "-l", "\x1b[13;5u"]);
+}
 async function runAgent(cfg, args) {
+    ensureBrandThemes();
     ensureBrandPrompt();
+    ensureDefaultSettings();
+    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;
     process.env["U1S1_API_KEY"] = cfg.apiKey;
-    const { main } = await import("@earendil-works/pi-coding-agent");
+    // hide pi's own "Run pi update" banner; users should run `u1s1 update` instead
+    process.env["PI_SKIP_VERSION_CHECK"] = "1";
+    const { CustomEditor, main } = await import("@earendil-works/pi-coding-agent");
+    // 网页终端(如 Taikula)把 Shift+Enter 发成 ESC+CR(\x1b\r)。pi 在没开 Kitty
+    // 协议时把它当成 Alt+Enter:空闲就直接发送,忙碌才排队。先改成 CSI-u 的
+    // Shift+Enter,输入框就会换行,真·Alt+Enter(\x1b[13;3u)不受影响。
+    class ShiftEnterEditor extends CustomEditor {
+        handleInput(data) {
+            super.handleInput(data === "\x1b\r" ? "\x1b[13;2u" : data);
+        }
+    }
     const extension = [
         {
             name: "u1s1",
             factory: (pi) => {
+                applyBrandUi(pi, VERSION);
+                // pi 内置只有 /quit；补一个更常见的 /exit，方便新手退出
+                pi.registerCommand("exit", {
+                    description: "退出 u1s1",
+                    handler: async (_args, ctx) => {
+                        ctx.shutdown();
+                    },
+                });
                 pi.registerProvider(PROVIDER_ID, {
                     name: "u1s1",
                     baseUrl: cfg.baseUrl,
                     api: "openai-completions",
                     apiKey: "$U1S1_API_KEY",
-                    models: [
-                        {
-                            id: MODEL_ID,
-                            name: "DeepSeek V4 Flash (u1s1)",
-                            reasoning: false,
-                            input: ["text"],
-                            cost: { input: 0.14, output: 0.28, cacheRead: 0, cacheWrite: 0 },
-                            contextWindow: 1_048_576,
-                            maxTokens: 65_536,
-                        },
-                    ],
+                    models: MODELS.map((m) => ({
+                        id: m.id,
+                        name: m.name,
+                        reasoning: m.reasoning,
+                        input: ["text"],
+                        cost: m.cost,
+                        contextWindow: m.contextWindow,
+                        maxTokens: m.maxTokens,
+                    })),
+                });
+                // /model and Ctrl+P already write pi settings; also keep ~/.u1s1/config.json in sync
+                pi.on("model_select", (event) => {
+                    if (event.source === "restore")
+                        return;
+                    if (event.model.provider !== PROVIDER_ID)
+                        return;
+                    if (!MODELS.some((m) => m.id === event.model.id))
+                        return;
+                    persistPreferredModel(loadConfig(), event.model.id);
+                });
+                pi.on("session_start", (_event, ctx) => {
+                    const previous = ctx.ui.getEditorComponent();
+                    ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+                        if (previous) {
+                            const inner = previous(tui, theme, keybindings);
+                            const orig = inner.handleInput.bind(inner);
+                            inner.handleInput = (data) => orig(data === "\x1b\r" ? "\x1b[13;2u" : data);
+                            return inner;
+                        }
+                        return new ShiftEnterEditor(tui, theme, keybindings);
+                    });
                 });
             },
         },
     ];
     const hasModelArg = args.some((a) => a === "--model" || a.startsWith("--model=") || a === "--provider");
-    const finalArgs = hasModelArg ? args : ["--model", `${PROVIDER_ID}/${MODEL_ID}`, ...args];
+    const defaultModel = resolvePreferredModel(cfg.model);
+    if (cfg.model !== defaultModel)
+        persistPreferredModel(cfg, defaultModel);
+    const finalArgs = hasModelArg ? args : ["--model", `${PROVIDER_ID}/${defaultModel}`, ...args];
     await main(finalArgs, { extensionFactories: extension });
 }
 async function run() {
@@ -62,6 +177,9 @@ async function run() {
         console.log(`u1s1 v${VERSION}`);
         return;
     }
+    if (cmd === "--help" || cmd === "-h") {
+        printConsoleBanner(VERSION);
+    }
     if (cmd === "login") {
         const { login } = await import("./login.js");
         await login(args[1]);
@@ -72,12 +190,22 @@ async function run() {
         await usage();
         return;
     }
+    if (cmd === "model") {
+        const { modelCommand } = await import("./model.js");
+        await modelCommand(args[1]);
+        return;
+    }
     if (cmd === "logout") {
         const { saveConfig } = await import("./config.js");
         saveConfig({ ...loadConfig(), apiKey: undefined });
         console.log("已退出登录。");
         return;
     }
+    if (cmd === "update") {
+        const { update } = await import("./update.js");
+        await update();
+        return;
+    }
     const { ensureAuth } = await import("./login.js");
     const cfg = await ensureAuth();
     await runAgent(cfg, args);

package/dist/login.js

@@ -16,7 +16,7 @@ export async function login(keyArg) {
     if (!key) {
         console.log("");
         console.log("  u1s1 需要一把 API Key(免费):");
-        console.log(`  1. 打开 ${DASHBOARD_URL} 注册/登录(30 秒,送每月 $2 额度)`);
+        console.log(`  1. 打开 ${DASHBOARD_URL} 注册/登录(30 秒,送 $10 额度)`);
         console.log("  2. 复制你的 API Key,粘贴到下面");
         console.log("");
         tryOpenBrowser(DASHBOARD_URL);
@@ -34,7 +34,7 @@ export async function login(keyArg) {
         process.exit(1);
     });
     saveConfig(next);
-    console.log(`  ✓ 登录成功${me.email ? `(${me.email})` : ""},本月还剩 $${me.remaining_usd} 额度。`);
+    console.log(`  ✓ 登录成功${me.email ? `(${me.email})` : ""},还剩 $${me.remaining_usd} 额度。`);
     return next;
 }
 /** Returns a config that definitely has an apiKey, prompting the user if needed. */

package/dist/model.js

@@ -0,0 +1,24 @@
+import { loadConfig, MODELS, persistPreferredModel, resolveModel, resolvePreferredModel } from "./config.js";
+export async function modelCommand(nameOrAlias) {
+    const cfg = loadConfig();
+    const current = resolvePreferredModel(cfg.model);
+    if (!nameOrAlias) {
+        console.log("");
+        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`);
+        }
+        console.log("");
+        console.log("  切换:u1s1 model grok / u1s1 model deepseek(对话里 /model 同样会记住)");
+        console.log("");
+        return;
+    }
+    const m = resolveModel(nameOrAlias);
+    if (!m) {
+        console.error(`  没有叫「${nameOrAlias}」的模型,可选:${MODELS.map((x) => x.aliases[0]).join(" / ")}`);
+        process.exit(1);
+    }
+    persistPreferredModel(cfg, m.id);
+    console.log(`  ✓ 默认模型已切到 ${m.name}(${m.note})`);
+}

package/dist/style.js

@@ -0,0 +1,299 @@
+import { homedir } from "node:os";
+import { basename } from "node:path";
+import { createBashTool, createEditTool, createFindTool, createGrepTool, createLsTool, createReadTool, createWriteTool, } from "@earendil-works/pi-coding-agent";
+import { renderBrandHeader } from "./brand.js";
+function row(text) {
+    return {
+        render() {
+            return text.split("\n");
+        },
+        invalidate() { },
+    };
+}
+function shortPath(path) {
+    if (typeof path !== "string" || !path)
+        return "";
+    const home = homedir();
+    if (path === home)
+        return "~";
+    if (path.startsWith(`${home}/`) || path.startsWith(`${home}\\`)) {
+        return `~${path.slice(home.length)}`;
+    }
+    const cwd = process.cwd();
+    if (path === cwd)
+        return ".";
+    if (path.startsWith(`${cwd}/`) || path.startsWith(`${cwd}\\`)) {
+        return path.slice(cwd.length + 1);
+    }
+    return path;
+}
+function asString(value) {
+    return typeof value === "string" ? value : "";
+}
+function clip(text, max = 72) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 1)}…`;
+}
+function callLine(theme, name, detail) {
+    let text = `${theme.fg("accent", "⏺")} ${theme.bold(theme.fg("toolTitle", name))}`;
+    if (detail)
+        text += ` ${theme.fg("muted", clip(detail))}`;
+    return text;
+}
+function resultLine(theme, text, color = "dim") {
+    return `  ${theme.fg("dim", "⎿")}  ${theme.fg(color, text)}`;
+}
+function indentOutput(theme, output, limit = 20) {
+    const all = output.split("\n");
+    const shown = all.slice(0, limit);
+    let text = shown.map((line) => `     ${theme.fg("dim", line)}`).join("\n");
+    if (all.length > limit) {
+        text += `\n     ${theme.fg("muted", `… ${all.length - limit} 行`)}`;
+    }
+    return text;
+}
+const toolCache = new Map();
+function createBuiltInTools(cwd) {
+    return {
+        read: createReadTool(cwd),
+        bash: createBashTool(cwd),
+        edit: createEditTool(cwd),
+        write: createWriteTool(cwd),
+        find: createFindTool(cwd),
+        grep: createGrepTool(cwd),
+        ls: createLsTool(cwd),
+    };
+}
+function toolsFor(cwd) {
+    let cached = toolCache.get(cwd);
+    if (!cached) {
+        cached = createBuiltInTools(cwd);
+        toolCache.set(cwd, cached);
+    }
+    return cached;
+}
+/**
+ * Claude Code-like chrome: brand header, pulsing dot, one-line tool rows.
+ * All of this is Pi's public extension API — no node_modules patch.
+ */
+export function applyBrandUi(pi, version) {
+    pi.on("session_start", async (_event, ctx) => {
+        if (ctx.mode !== "tui")
+            return;
+        ctx.ui.setHeader((_tui, theme) => ({
+            render() {
+                return renderBrandHeader(theme, version, process.cwd());
+            },
+            invalidate() { },
+        }));
+        const theme = ctx.ui.theme;
+        ctx.ui.setWorkingMessage("思考中");
+        ctx.ui.setWorkingIndicator({
+            frames: [
+                theme.fg("dim", "·"),
+                theme.fg("muted", "•"),
+                theme.fg("accent", "●"),
+                theme.fg("muted", "•"),
+            ],
+            intervalMs: 140,
+        });
+        ctx.ui.setHiddenThinkingLabel("思考中");
+        ctx.ui.setTitle(`u1s1 — ${basename(process.cwd())}`);
+    });
+    const cwd = process.cwd();
+    const originals = toolsFor(cwd);
+    pi.registerTool({
+        name: "read",
+        label: "read",
+        description: originals.read.description,
+        parameters: originals.read.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).read.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            return row(callLine(theme, "Read", shortPath(args.path)));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "读取中…", "warning"));
+            const content = result.content[0];
+            if (content?.type === "image")
+                return row(resultLine(theme, "图片", "success"));
+            if (content?.type !== "text")
+                return row(resultLine(theme, "无内容", "error"));
+            const details = result.details;
+            const count = content.text.split("\n").length;
+            let text = resultLine(theme, `${count} 行`, "success");
+            if (details?.truncation?.truncated)
+                text += theme.fg("warning", " · 已截断");
+            if (expanded)
+                text += `\n${indentOutput(theme, content.text)}`;
+            return row(text);
+        },
+    });
+    pi.registerTool({
+        name: "bash",
+        label: "bash",
+        description: originals.bash.description,
+        parameters: originals.bash.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).bash.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            return row(callLine(theme, "Bash", asString(args.command)));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "执行中…", "warning"));
+            const content = result.content[0];
+            const output = content?.type === "text" ? content.text : "";
+            const exitMatch = output.match(/exit code: (\d+)/);
+            const exitCode = exitMatch ? Number(exitMatch[1]) : null;
+            const details = result.details;
+            const ok = exitCode === 0 || exitCode === null;
+            let text = resultLine(theme, ok ? "完成" : `退出码 ${exitCode}`, ok ? "success" : "error");
+            if (details?.truncation?.truncated)
+                text += theme.fg("warning", " · 已截断");
+            if (expanded && output)
+                text += `\n${indentOutput(theme, output)}`;
+            return row(text);
+        },
+    });
+    pi.registerTool({
+        name: "edit",
+        label: "edit",
+        description: originals.edit.description,
+        parameters: originals.edit.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).edit.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            return row(callLine(theme, "Edit", shortPath(args.path)));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "修改中…", "warning"));
+            const content = result.content[0];
+            if (content?.type === "text" && content.text.startsWith("Error")) {
+                return row(resultLine(theme, content.text.split("\n")[0] ?? "失败", "error"));
+            }
+            const details = result.details;
+            if (!details?.diff)
+                return row(resultLine(theme, "已写入", "success"));
+            let additions = 0;
+            let removals = 0;
+            for (const line of details.diff.split("\n")) {
+                if (line.startsWith("+") && !line.startsWith("+++"))
+                    additions++;
+                if (line.startsWith("-") && !line.startsWith("---"))
+                    removals++;
+            }
+            let text = resultLine(theme, `+${additions} / -${removals}`, "success");
+            if (expanded)
+                text += `\n${indentOutput(theme, details.diff, 30)}`;
+            return row(text);
+        },
+    });
+    pi.registerTool({
+        name: "write",
+        label: "write",
+        description: originals.write.description,
+        parameters: originals.write.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).write.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            const count = asString(args.content).split("\n").length;
+            const detail = `${shortPath(args.path)}${count ? ` (${count} 行)` : ""}`;
+            return row(callLine(theme, "Write", detail));
+        },
+        renderResult(result, { isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "写入中…", "warning"));
+            const content = result.content[0];
+            if (content?.type === "text" && content.text.startsWith("Error")) {
+                return row(resultLine(theme, content.text.split("\n")[0] ?? "失败", "error"));
+            }
+            return row(resultLine(theme, "已写入", "success"));
+        },
+    });
+    pi.registerTool({
+        name: "grep",
+        label: "grep",
+        description: originals.grep.description,
+        parameters: originals.grep.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).grep.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            const where = shortPath(args.path);
+            const detail = where ? `${asString(args.pattern)}  ${where}` : asString(args.pattern);
+            return row(callLine(theme, "Grep", detail));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "搜索中…", "warning"));
+            const content = result.content[0];
+            const output = content?.type === "text" ? content.text : "";
+            const hits = output ? output.split("\n").filter(Boolean).length : 0;
+            let text = resultLine(theme, hits ? `${hits} 处` : "无匹配", hits ? "success" : "dim");
+            if (expanded && output)
+                text += `\n${indentOutput(theme, output)}`;
+            return row(text);
+        },
+    });
+    pi.registerTool({
+        name: "find",
+        label: "find",
+        description: originals.find.description,
+        parameters: originals.find.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).find.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            return row(callLine(theme, "Find", asString(args.pattern)));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "查找中…", "warning"));
+            const content = result.content[0];
+            const output = content?.type === "text" ? content.text : "";
+            const hits = output ? output.split("\n").filter(Boolean).length : 0;
+            let text = resultLine(theme, hits ? `${hits} 个文件` : "没找到", hits ? "success" : "dim");
+            if (expanded && output)
+                text += `\n${indentOutput(theme, output)}`;
+            return row(text);
+        },
+    });
+    pi.registerTool({
+        name: "ls",
+        label: "ls",
+        description: originals.ls.description,
+        parameters: originals.ls.parameters,
+        renderShell: "self",
+        async execute(toolCallId, params, signal, onUpdate, ctx) {
+            return toolsFor(ctx.cwd).ls.execute(toolCallId, params, signal, onUpdate);
+        },
+        renderCall(args, theme) {
+            return row(callLine(theme, "List", shortPath(args.path) || "."));
+        },
+        renderResult(result, { expanded, isPartial }, theme) {
+            if (isPartial)
+                return row(resultLine(theme, "列出中…", "warning"));
+            const content = result.content[0];
+            const output = content?.type === "text" ? content.text : "";
+            const hits = output ? output.split("\n").filter(Boolean).length : 0;
+            let text = resultLine(theme, `${hits} 项`, "success");
+            if (expanded && output)
+                text += `\n${indentOutput(theme, output)}`;
+            return row(text);
+        },
+    });
+}

package/dist/themes.js

@@ -0,0 +1,175 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { agentDir } from "./config.js";
+/**
+ * Claude Code-like: warm terracotta accent, no gray message/tool boxes,
+ * text sits on the terminal background instead of Codex-style cards.
+ */
+export const DARK_THEME = {
+    name: "u1s1-dark",
+    vars: {
+        orange: "#d97757",
+        orangeSoft: "#e8a87c",
+        text: "#e8e4db",
+        muted: "#9a9488",
+        dim: "#6b665e",
+        green: "#8fbc8f",
+        red: "#e07a7a",
+        yellow: "#d4a574",
+        blue: "#89b4c4",
+        selectedBg: "#3a342e",
+    },
+    colors: {
+        accent: "orange",
+        border: "orangeSoft",
+        borderAccent: "orange",
+        borderMuted: "dim",
+        success: "green",
+        error: "red",
+        warning: "yellow",
+        muted: "muted",
+        dim: "dim",
+        text: "text",
+        thinkingText: "muted",
+        selectedBg: "selectedBg",
+        scrollbarThumb: "selectedBg",
+        searchMatchBg: "selectedBg",
+        searchMatchText: "text",
+        userMessageBg: "",
+        userMessageText: "text",
+        customMessageBg: "",
+        customMessageText: "text",
+        customMessageLabel: "orangeSoft",
+        toolPendingBg: "",
+        toolSuccessBg: "",
+        toolErrorBg: "",
+        toolTitle: "text",
+        toolOutput: "muted",
+        mdHeading: "orangeSoft",
+        mdLink: "blue",
+        mdLinkUrl: "dim",
+        mdCode: "orangeSoft",
+        mdCodeBlock: "text",
+        mdCodeBlockBorder: "dim",
+        mdQuote: "muted",
+        mdQuoteBorder: "orange",
+        mdHr: "dim",
+        mdListBullet: "orange",
+        toolDiffAdded: "green",
+        toolDiffRemoved: "red",
+        toolDiffContext: "muted",
+        syntaxComment: "muted",
+        syntaxKeyword: "orangeSoft",
+        syntaxFunction: "orange",
+        syntaxVariable: "text",
+        syntaxString: "green",
+        syntaxNumber: "yellow",
+        syntaxType: "blue",
+        syntaxOperator: "muted",
+        syntaxPunctuation: "dim",
+        thinkingOff: "dim",
+        thinkingMinimal: "muted",
+        thinkingLow: "blue",
+        thinkingMedium: "orangeSoft",
+        thinkingHigh: "orange",
+        thinkingXhigh: "yellow",
+        thinkingMax: "red",
+        bashMode: "green",
+    },
+    export: {
+        pageBg: "#1c1917",
+        cardBg: "#292524",
+        infoBg: "#3d3429",
+    },
+};
+export const LIGHT_THEME = {
+    name: "u1s1-light",
+    vars: {
+        orange: "#c45c38",
+        orangeSoft: "#b86a45",
+        text: "#2c2825",
+        muted: "#6f6a63",
+        dim: "#9a9488",
+        green: "#3d7a4a",
+        red: "#c45c5c",
+        yellow: "#9a6b2f",
+        blue: "#3d6f8a",
+        selectedBg: "#efe8e0",
+    },
+    colors: {
+        accent: "orange",
+        border: "orangeSoft",
+        borderAccent: "orange",
+        borderMuted: "dim",
+        success: "green",
+        error: "red",
+        warning: "yellow",
+        muted: "muted",
+        dim: "dim",
+        text: "text",
+        thinkingText: "muted",
+        selectedBg: "selectedBg",
+        scrollbarThumb: "selectedBg",
+        searchMatchBg: "selectedBg",
+        searchMatchText: "text",
+        userMessageBg: "",
+        userMessageText: "text",
+        customMessageBg: "",
+        customMessageText: "text",
+        customMessageLabel: "orangeSoft",
+        toolPendingBg: "",
+        toolSuccessBg: "",
+        toolErrorBg: "",
+        toolTitle: "text",
+        toolOutput: "muted",
+        mdHeading: "orange",
+        mdLink: "blue",
+        mdLinkUrl: "dim",
+        mdCode: "orangeSoft",
+        mdCodeBlock: "text",
+        mdCodeBlockBorder: "dim",
+        mdQuote: "muted",
+        mdQuoteBorder: "orange",
+        mdHr: "dim",
+        mdListBullet: "orange",
+        toolDiffAdded: "green",
+        toolDiffRemoved: "red",
+        toolDiffContext: "muted",
+        syntaxComment: "muted",
+        syntaxKeyword: "orange",
+        syntaxFunction: "orangeSoft",
+        syntaxVariable: "text",
+        syntaxString: "green",
+        syntaxNumber: "yellow",
+        syntaxType: "blue",
+        syntaxOperator: "muted",
+        syntaxPunctuation: "dim",
+        thinkingOff: "dim",
+        thinkingMinimal: "muted",
+        thinkingLow: "blue",
+        thinkingMedium: "orangeSoft",
+        thinkingHigh: "orange",
+        thinkingXhigh: "yellow",
+        thinkingMax: "red",
+        bashMode: "green",
+    },
+    export: {
+        pageBg: "#faf7f2",
+        cardBg: "#ffffff",
+        infoBg: "#fff4e8",
+    },
+};
+const THEMES = [DARK_THEME, LIGHT_THEME];
+export const DEFAULT_THEME_SETTING = "u1s1-light/u1s1-dark";
+/** Keep ~/.u1s1/agent/themes in sync so Pi picks them up as normal theme files. */
+export function ensureBrandThemes() {
+    const dir = join(agentDir, "themes");
+    mkdirSync(dir, { recursive: true });
+    for (const theme of THEMES) {
+        const path = join(dir, `${theme.name}.json`);
+        const body = `${JSON.stringify(theme, null, 2)}\n`;
+        if (!existsSync(path) || readFileSync(path, "utf8") !== body) {
+            writeFileSync(path, body);
+        }
+    }
+}

package/dist/update.js

@@ -0,0 +1,69 @@
+import { execSync } from "node:child_process";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const VERSION = require("../package.json").version;
+const PACKAGE_NAME = "u1s1-cli";
+/** Detect the package manager that installed u1s1. */
+function detectPackageManager() {
+    // Check common global install locations for clues
+    const userAgent = process.env.npm_config_user_agent ?? "";
+    if (userAgent.startsWith("pnpm"))
+        return "pnpm";
+    if (userAgent.startsWith("yarn"))
+        return "yarn";
+    if (userAgent.startsWith("bun"))
+        return "bun";
+    return "npm";
+}
+/** Fetch the latest published version from npm registry. */
+async function getLatestVersion() {
+    const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+    try {
+        const res = await fetch(url, {
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!res.ok)
+            return undefined;
+        const body = (await res.json());
+        return body.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+function compareVersions(a, b) {
+    const pa = a.split(".").map(Number);
+    const pb = b.split(".").map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
+export async function update() {
+    console.log("正在检查更新…");
+    const latest = await getLatestVersion();
+    if (!latest) {
+        console.error("无法获取最新版本。请检查网络连接后重试。");
+        process.exit(1);
+    }
+    if (compareVersions(latest, VERSION) <= 0) {
+        console.log(`当前 v${VERSION} 已是最新版本 ✓`);
+        return;
+    }
+    const pm = detectPackageManager();
+    console.log(`发现新版本 v${latest} (当前 v${VERSION})`);
+    console.log(`正在用 ${pm} 更新 ${PACKAGE_NAME}…`);
+    try {
+        const installCmd = pm === "npm" ? `npm install -g ${PACKAGE_NAME}@latest` : `${pm} add -g ${PACKAGE_NAME}@latest`;
+        execSync(installCmd, { stdio: "inherit" });
+        console.log(`\n✅ 已更新到 v${latest}，重启 u1s1 后生效。`);
+    }
+    catch {
+        console.error("\n自动更新失败。请手动运行:");
+        console.error(`  ${pm === "npm" ? "npm install -g" : `${pm} add -g`} ${PACKAGE_NAME}@latest`);
+        process.exit(1);
+    }
+}

package/dist/usage.js

@@ -14,14 +14,14 @@ export async function usage() {
         console.error(e.message);
         process.exit(1);
     });
-    const total = me.monthly_free_usd + me.bonus_balance_usd;
-    const remainRatio = total > 0 ? me.remaining_usd / total : 0;
+    const remain = me.remaining_usd;
+    const spent = me.mtd_usd;
+    const denom = remain + spent;
+    const remainRatio = denom > 0 ? remain / denom : 0;
     console.log("");
     console.log(`  账号     ${me.email ?? "(未绑定邮箱)"}`);
-    console.log(`  本月已用 $${me.mtd_usd}`);
-    console.log(`  剩余额度 $${me.remaining_usd}  ${bar(remainRatio)}`);
-    if (me.bonus_balance_usd > 0)
-        console.log(`  其中加量 $${me.bonus_balance_usd}(邀请所得,不过期)`);
+    console.log(`  本月已用 $${spent}`);
+    console.log(`  剩余额度 $${remain}  ${bar(remainRatio)}`);
     console.log("");
     console.log("  邀请朋友双方各得加量 → https://u1s1.io/dashboard");
     console.log("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {
@@ -15,7 +15,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "ai",
@@ -27,7 +28,7 @@
   "license": "MIT",
   "homepage": "https://u1s1.io",
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "0.84.1"
+    "@earendil-works/pi-coding-agent": "0.84.2"
   },
   "devDependencies": {
     "typescript": "^5.9.2",