u1s1-cli 0.9.1 → 0.9.3

package/dist/agent-setup.js

@@ -1,6 +1,6 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { agentDir, MODELS, PROVIDER_ID } from "./config.js";
+import { agentDir, MODELS, PROVIDER_ID, VERSION } from "./config.js";
 const BRAND_APPEND = `## u1s1
 
 你是 u1s1(有一说一) —— 说人话的 AI 编程搭子,一个面向编程新手的中文 AI 编程助手。用户很可能不熟悉编程术语:
@@ -84,6 +84,28 @@ export function cleanupBrandThemes() {
  * itself holds no secret. Rewritten on every launch so baseUrl/model changes
  * propagate; other providers a user may have added are preserved.
  */
+/**
+ * 联网工具经 <agentDir>/extensions 投影:pi 的资源加载器对 TUI 和 `u1s1 web`
+ * 都会扫描这个目录,两个前端从此共用同一份工具注册,不用各接一遍。
+ * 文件每次启动重写(baseUrl/服务端开关变化随之生效);apiKey 走 U1S1_API_KEY
+ * 环境变量,文件里不落密钥。U1S1_TOOLS_VIA_EXTENSION 守卫:旧版 CLI 仍在
+ * 进程内注册工具且不设该变量,残留的本文件在旧版下自动空转,避免双重注册。
+ */
+export function writeWebToolsExtension(cfg, webSearchEnabled) {
+    const dir = join(agentDir, "extensions");
+    mkdirSync(dir, { recursive: true });
+    const toolsUrl = new URL("./tools.js", import.meta.url).href;
+    const searchLine = webSearchEnabled
+        ? `  pi.registerTool(tools.createSearchTool({ baseUrl: ${JSON.stringify(cfg.baseUrl)}, apiKey: process.env.U1S1_API_KEY }));\n`
+        : "";
+    writeFileSync(join(dir, "u1s1-tools.js"), `// 由 u1s1 每次启动自动生成,请勿手改\n` +
+        `export default async function (pi) {\n` +
+        `  if (process.env.U1S1_TOOLS_VIA_EXTENSION !== "1") return;\n` +
+        `  const tools = await import(${JSON.stringify(toolsUrl)});\n` +
+        searchLine +
+        `  pi.registerTool(tools.webFetchTool);\n` +
+        `}\n`);
+}
 export function ensureProviderModels(cfg) {
     mkdirSync(agentDir, { recursive: true });
     const p = join(agentDir, "models.json");
@@ -104,6 +126,8 @@ export function ensureProviderModels(cfg) {
         baseUrl: cfg.baseUrl,
         api: "openai-completions",
         apiKey: "$U1S1_API_KEY",
+        // 网关按这个头识别客户端版本;不带头的旧版会在会话首轮被追加升级提示
+        headers: { "x-u1s1-version": VERSION },
         models: MODELS.map((m) => ({
             id: m.id,
             name: m.name,

package/dist/api.js

@@ -1,8 +1,13 @@
+import { VERSION } from "./config.js";
+/** 网关按 x-u1s1-version 识别客户端版本(旧版 CLI 不带,提示升级)。 */
+function authHeaders(apiKey) {
+    return { authorization: `Bearer ${apiKey}`, "x-u1s1-version": VERSION };
+}
 export async function fetchModels(cfg) {
     let resp;
     try {
         resp = await fetch(`${cfg.baseUrl}/models`, {
-            headers: { authorization: `Bearer ${cfg.apiKey}` },
+            headers: authHeaders(cfg.apiKey),
         });
     }
     catch {
@@ -13,9 +18,9 @@ export async function fetchModels(cfg) {
     if (!resp.ok)
         throw new Error(`服务端返回 ${resp.status},稍后再试`);
     const body = (await resp.json());
-    return body.data;
+    return { models: body.data, features: body.features ?? {} };
 }
-/** 联网搜索走网关代理（上游 key 只在服务端）。 */
+/** 联网搜索走网关代理（上游 key 只在服务端）。maxResults 不传时由服务端决定默认值。 */
 export async function searchWeb(cfg, query, maxResults, signal) {
     if (!cfg.apiKey)
         throw new Error("没有配置 API Key");
@@ -24,7 +29,7 @@ export async function searchWeb(cfg, query, maxResults, signal) {
         resp = await fetch(`${cfg.baseUrl}/search`, {
             method: "POST",
             headers: {
-                authorization: `Bearer ${cfg.apiKey}`,
+                ...authHeaders(cfg.apiKey),
                 "content-type": "application/json",
             },
             body: JSON.stringify({ query, max_results: maxResults }),
@@ -48,7 +53,7 @@ export async function fetchMe(cfg) {
     let resp;
     try {
         resp = await fetch(`${cfg.baseUrl}/me`, {
-            headers: { authorization: `Bearer ${cfg.apiKey}` },
+            headers: authHeaders(cfg.apiKey),
         });
     }
     catch {

package/dist/brand.js

@@ -46,8 +46,9 @@ function paintArt(theme, line) {
  * Startup hero, responsive to terminal width:
  * wide → wordmark with info column beside it; medium → stacked; narrow → one-liner.
  */
-export function renderBrandHeader(theme, version, cwd, width) {
-    const name = theme.bold(theme.fg("text", `${BRAND_NAME} v${version}`));
+export function renderBrandHeader(theme, version, cwd, width, notice) {
+    const name = theme.bold(theme.fg("text", `${BRAND_NAME} v${version}`)) +
+        (notice ? `  ${theme.fg("accent", notice)}` : "");
     const brand = theme.fg("muted", `${BRAND_CN} · ${BRAND_TAGLINE}`);
     const dir = theme.fg("dim", `cwd: ${formatHomePath(cwd)}`);
     const hints = theme.fg("dim", "/help 看命令 · Shift+Enter 换行 · Esc 中断");

package/dist/config.js

@@ -1,6 +1,24 @@
 import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+export const VERSION = require("../package.json").version;
+/**
+ * 便携包安装(install.sh / install.ps1):包根旁边带自己的 node 运行时,
+ * npm 更新碰不到这份拷贝,升级只能整包重装。npm 全局安装的包在 node_modules
+ * 下,按父目录名先排除,避免撞上恰好叫 node 的目录误判。
+ */
+export function isPortableInstall() {
+    const pkgRoot = join(dirname(fileURLToPath(import.meta.url)), ".."); // dist/.. = 包根
+    if (basename(dirname(pkgRoot)) === "node_modules")
+        return false;
+    const portableNode = process.platform === "win32"
+        ? join(pkgRoot, "..", "node", "node.exe")
+        : join(pkgRoot, "..", "node", "bin", "node");
+    return existsSync(portableNode);
+}
 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. */

package/dist/index.js

@@ -1,24 +1,18 @@
 #!/usr/bin/env node
 import { spawnSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
-import { createRequire } from "node:module";
-import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, } from "./agent-setup.js";
+import { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, writeWebToolsExtension, } from "./agent-setup.js";
 import { printConsoleBanner } from "./brand.js";
-import { agentDir, apiModelToDef, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, resolvePreferredModel, setModelsFromApi, } from "./config.js";
-import { applyBrandUi } from "./style.js";
-import { createFetchTool, createSearchTool } from "./tools.js";
+import { agentDir, apiModelToDef, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
+import { applyBrandUi, setUpdateNotice } from "./style.js";
 import { fetchModels } from "./api.js";
-const require = createRequire(import.meta.url);
-const VERSION = require("../package.json").version;
 const PACKAGE_NAME = "u1s1-cli";
 /**
- * 启动时自动检查 npm 最新版，发现更新就静默安装。
- * 不阻塞启动流程，失败也不报错（留到手动 `u1s1 update`）。
+ * 启动时自动检查 npm 最新版:autoUpdate 开着就静默安装,关着也在启动横幅的
+ * 版本号后面提示一句(u1s1 vX.Y.Z 后跟升级状态,见 setUpdateNotice)。
+ * 不阻塞启动流程,失败也不报错(留到手动 `u1s1 update`)。
  */
 async function checkAndAutoUpdate() {
-    const settings = readSettings();
-    if (settings.autoUpdate === false)
-        return;
     let latest;
     try {
         const url = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
@@ -50,6 +44,12 @@ async function checkAndAutoUpdate() {
     }
     if (!newer)
         return;
+    const settings = readSettings();
+    // 便携版没法用 npm 自更新;autoUpdate 关闭同理只提示。u1s1 update 会给出正确升级方式
+    if (settings.autoUpdate === false || isPortableInstall()) {
+        setUpdateNotice(`⬆ 新版 v${latest} 可用 · u1s1 update 升级`);
+        return;
+    }
     // 检测包管理器
     const userAgent = process.env.npm_config_user_agent ?? "";
     const pm = userAgent.startsWith("pnpm") ? "pnpm"
@@ -59,14 +59,17 @@ async function checkAndAutoUpdate() {
     const installCmd = pm === "npm"
         ? `npm install -g ${PACKAGE_NAME}@latest`
         : `${pm} add -g ${PACKAGE_NAME}@latest`;
+    setUpdateNotice(`⬆ 发现新版 v${latest},自动更新中…`);
     try {
-        // 用同步 execSync 确保安装完成后再进交互
-        const { execSync } = await import("node:child_process");
-        execSync(installCmd, { stdio: "pipe", timeout: 60_000 });
-        console.log(`  ✨ 已自动更新到 v${latest}，下次启动生效`);
+        // 异步安装: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},重启后生效`);
     }
     catch {
         // 自动更新失败不阻塞，用户可手动 `u1s1 update`
+        setUpdateNotice(`⬆ 新版 v${latest} 可用 · u1s1 update 升级`);
     }
 }
 /**
@@ -114,18 +117,24 @@ async function runAgent(cfg, args) {
     ensureBrandPrompt();
     ensureDefaultSettings();
     // Fetch model list from server; fall back to built-in MODELS on error.
+    // 服务端没开搜索(或老网关没有 features 字段)时不注册 web_search,模型就不会白调
+    let webSearchEnabled = true;
     try {
-        const apiModels = await fetchModels(cfg);
-        setModelsFromApi(apiModels.map(apiModelToDef));
+        const { models, features } = await fetchModels(cfg);
+        setModelsFromApi(models.map(apiModelToDef));
+        webSearchEnabled = features.web_search !== false;
     }
     catch (e) {
         console.error("  获取模型列表失败,使用内置列表:", e.message);
     }
     ensureProviderModels(cfg);
+    // 联网工具经 agentDir/extensions 投影,TUI 和 u1s1 web 共用一份注册
+    writeWebToolsExtension(cfg, webSearchEnabled);
     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;
+    process.env["U1S1_TOOLS_VIA_EXTENSION"] = "1";
     // 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");
@@ -158,9 +167,6 @@ async function runAgent(cfg, args) {
             name: "u1s1",
             factory: (pi) => {
                 applyBrandUi(pi, VERSION);
-                // 联网能力:搜索走网关(上游 key 只在服务端),抓网页在本地直接出网
-                pi.registerTool(createSearchTool(cfg));
-                pi.registerTool(createFetchTool());
                 // pi 内置只有 /quit；补一个更常见的 /exit，方便新手退出
                 pi.registerCommand("exit", {
                     description: "退出 u1s1",

package/dist/style.js

@@ -2,6 +2,16 @@ import { basename } from "node:path";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 import { readSettings } from "./config.js";
 import { renderBrandHeader } from "./brand.js";
+/**
+ * 启动横幅版本号后面的升级状态(如「发现新版 v0.9.3,自动更新中…」)。
+ * checkAndAutoUpdate 异步写入;横幅已挂载时主动触发一次重绘,否则等首帧渲染。
+ */
+let updateNotice = "";
+let refreshHeader;
+export function setUpdateNotice(notice) {
+    updateNotice = notice;
+    refreshHeader?.();
+}
 /**
  * Brand chrome is just the startup hero + window title; everything else
  * (tool rows, thinking blocks, spinner) stays Pi's default UI.
@@ -13,13 +23,16 @@ export function applyBrandUi(pi, version) {
         // 检查设置:关掉就不显示启动横幅
         const settings = readSettings();
         if (settings.showStartupBanner !== false) {
-            ctx.ui.setHeader((_tui, theme) => ({
-                render(width) {
-                    // pi-tui crashes on lines wider than the terminal, so truncate defensively.
-                    return renderBrandHeader(theme, version, process.cwd(), width).map((line) => truncateToWidth(line, width));
-                },
-                invalidate() { },
-            }));
+            ctx.ui.setHeader((tui, theme) => {
+                refreshHeader = () => tui.requestRender();
+                return {
+                    render(width) {
+                        // pi-tui crashes on lines wider than the terminal, so truncate defensively.
+                        return renderBrandHeader(theme, version, process.cwd(), width, updateNotice).map((line) => truncateToWidth(line, width));
+                    },
+                    invalidate() { },
+                };
+            });
         }
         ctx.ui.setTitle(`u1s1 — ${basename(process.cwd())}`);
     });

package/dist/tools.js

@@ -1,8 +1,17 @@
+import { defineTool } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { searchWeb } from "./api.js";
 const FETCH_TIMEOUT_MS = 20_000;
 const MAX_FETCH_BYTES = 2_000_000;
 const MAX_TEXT_CHARS = 30_000;
+const HTML_ENTITIES = {
+    " ": " ",
+    "&": "&",
+    "&lt;": "<",
+    "&gt;": ">",
+    "&quot;": '"',
+    "&#39;": "'",
+};
 /** 把网页 HTML 榨成纯文本:去掉脚本样式和标签,压掉多余空白。 */
 function htmlToText(html) {
     return html
@@ -11,12 +20,7 @@ function htmlToText(html) {
         .replace(/<br\s*\/?>/gi, "\n")
         .replace(/<\/(p|div|li|tr|h[1-6])>/gi, "\n")
         .replace(/<[^>]+>/g, " ")
-        .replace(/&nbsp;/g, " ")
-        .replace(/&amp;/g, "&")
-        .replace(/&lt;/g, "<")
-        .replace(/&gt;/g, ">")
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
+        .replace(/&(?:nbsp|amp|lt|gt|quot|#39);/g, (m) => HTML_ENTITIES[m] ?? m)
         .replace(/[ \t]+/g, " ")
         .replace(/\n\s*\n\s*\n+/g, "\n\n")
         .trim();
@@ -26,9 +30,48 @@ function truncate(text) {
         return text;
     return `${text.slice(0, MAX_TEXT_CHARS)}\n\n…（内容过长已截断，共 ${text.length} 字符）`;
 }
+/** 只下载前 maxBytes 就断流,超大页面不用整个拉完再丢。 */
+async function readBodyCapped(resp, maxBytes) {
+    if (!resp.body)
+        return new Uint8Array(await resp.arrayBuffer()).subarray(0, maxBytes);
+    const reader = resp.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+        total += value.byteLength;
+        if (total >= maxBytes) {
+            void reader.cancel().catch(() => { });
+            break;
+        }
+    }
+    const out = new Uint8Array(Math.min(total, maxBytes));
+    let offset = 0;
+    for (const chunk of chunks) {
+        const room = out.byteLength - offset;
+        if (room <= 0)
+            break;
+        out.set(room < chunk.byteLength ? chunk.subarray(0, room) : chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+/** 按响应头声明的 charset 解码(GBK 等中文页面不至于乱码),没有或不认识就按 UTF-8。 */
+function decodeBody(bytes, contentType) {
+    const charset = /charset=["']?([\w-]+)/i.exec(contentType)?.[1];
+    try {
+        return new TextDecoder(charset || "utf-8").decode(bytes);
+    }
+    catch {
+        return new TextDecoder("utf-8").decode(bytes);
+    }
+}
 /** 联网搜索工具:走 u1s1 网关代理,上游 key 不落到用户机器上。 */
 export function createSearchTool(cfg) {
-    return {
+    return defineTool({
         name: "web_search",
         label: "联网搜索",
         description: "Search the web for current information. Use it for anything time-sensitive or outside the codebase: library docs, error messages, latest versions, recent events. Returns a short answer plus ranked results with URLs and snippets. Follow up with web_fetch to read a promising result in full.",
@@ -42,7 +85,7 @@ export function createSearchTool(cfg) {
             maxResults: Type.Optional(Type.Number({ description: "How many results to return (1-10, default 5).", minimum: 1, maximum: 10 })),
         }),
         async execute(_toolCallId, params, signal) {
-            const data = await searchWeb(cfg, params.query, params.maxResults ?? 5, signal);
+            const data = await searchWeb(cfg, params.query, params.maxResults, signal);
             const lines = [];
             if (data.answer)
                 lines.push(`Answer: ${data.answer}`, "");
@@ -59,63 +102,61 @@ export function createSearchTool(cfg) {
                 details: { query: data.query, count: data.results.length },
             };
         },
-    };
+    });
 }
 /** 抓网页:纯客户端出网,不经过我们的服务器,也不额外计费。 */
-export function createFetchTool() {
-    return {
-        name: "web_fetch",
-        label: "读取网页",
-        description: "Fetch a URL and return its readable text content (HTML is stripped to text; JSON and plain text are returned as-is). Use it to read a page found via web_search, or any URL the user pasted.",
-        promptSnippet: "抓取指定网址并转成可读文本",
-        promptGuidelines: [
-            "Use web_fetch to read a specific URL, and web_search when you still need to find the URL.",
-        ],
-        parameters: Type.Object({
-            url: Type.String({ description: "Absolute http(s) URL to fetch." }),
-        }),
-        async execute(_toolCallId, params, signal) {
-            let url;
-            try {
-                url = new URL(params.url.trim().replace(/^@/, ""));
-            }
-            catch {
-                throw new Error(`不是合法的网址: ${params.url}`);
-            }
-            if (url.protocol !== "http:" && url.protocol !== "https:") {
-                throw new Error(`只支持 http/https,收到 ${url.protocol}`);
-            }
-            const timeout = AbortSignal.timeout(FETCH_TIMEOUT_MS);
-            const abort = signal ? AbortSignal.any([signal, timeout]) : timeout;
-            let resp;
-            try {
-                resp = await fetch(url, {
-                    redirect: "follow",
-                    headers: {
-                        accept: "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.8",
-                        "user-agent": "u1s1-cli",
-                    },
-                    signal: abort,
-                });
-            }
-            catch (e) {
-                throw new Error(`打不开 ${url.href}: ${e.message}`);
-            }
-            if (!resp.ok)
-                throw new Error(`${url.href} 返回 ${resp.status} ${resp.statusText}`);
-            const type = resp.headers.get("content-type") ?? "";
-            if (!/text\/|json|xml|javascript/i.test(type)) {
-                throw new Error(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`);
-            }
-            const buf = await resp.arrayBuffer();
-            const raw = new TextDecoder("utf-8").decode(buf.slice(0, MAX_FETCH_BYTES));
-            const text = /html|xml/i.test(type) ? htmlToText(raw) : raw.trim();
-            return {
-                content: [
-                    { type: "text", text: truncate(`# ${url.href}\n\n${text || "(空白页面)"}`) },
-                ],
-                details: { url: url.href, contentType: type, chars: text.length },
-            };
-        },
-    };
-}
+export const webFetchTool = defineTool({
+    name: "web_fetch",
+    label: "读取网页",
+    description: "Fetch a URL and return its readable text content (HTML is stripped to text; JSON and plain text are returned as-is). Use it to read a page found via web_search, or any URL the user pasted.",
+    promptSnippet: "抓取指定网址并转成可读文本",
+    promptGuidelines: [
+        "Use web_fetch to read a specific URL, and web_search when you still need to find the URL.",
+    ],
+    parameters: Type.Object({
+        url: Type.String({ description: "Absolute http(s) URL to fetch." }),
+    }),
+    async execute(_toolCallId, params, signal) {
+        let url;
+        try {
+            // 用户从聊天工具粘来的链接常带 "@https://…" 前缀,顺手剥掉
+            url = new URL(params.url.trim().replace(/^@/, ""));
+        }
+        catch {
+            throw new Error(`不是合法的网址: ${params.url}`);
+        }
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            throw new Error(`只支持 http/https,收到 ${url.protocol}`);
+        }
+        const timeout = AbortSignal.timeout(FETCH_TIMEOUT_MS);
+        const abort = signal ? AbortSignal.any([signal, timeout]) : timeout;
+        let resp;
+        try {
+            resp = await fetch(url, {
+                redirect: "follow",
+                headers: {
+                    accept: "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.8",
+                    "user-agent": "u1s1-cli",
+                },
+                signal: abort,
+            });
+        }
+        catch (e) {
+            throw new Error(`打不开 ${url.href}: ${e.message}`);
+        }
+        if (!resp.ok)
+            throw new Error(`${url.href} 返回 ${resp.status} ${resp.statusText}`);
+        const type = resp.headers.get("content-type") ?? "";
+        if (!/text\/|json|xml|javascript/i.test(type)) {
+            throw new Error(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`);
+        }
+        const raw = decodeBody(await readBodyCapped(resp, MAX_FETCH_BYTES), type);
+        const text = /html|xml/i.test(type) ? htmlToText(raw) : raw.trim();
+        return {
+            content: [
+                { type: "text", text: truncate(`# ${url.href}\n\n${text || "(空白页面)"}`) },
+            ],
+            details: { url: url.href, contentType: type, chars: text.length },
+        };
+    },
+});

package/dist/update.js

@@ -1,8 +1,15 @@
 import { execSync } from "node:child_process";
 import { createRequire } from "node:module";
+import { isPortableInstall } from "./config.js";
 const require = createRequire(import.meta.url);
-export const VERSION = require("../package.json").version;
+const pkg = require("../package.json");
+export const VERSION = pkg.version;
 export const PACKAGE_NAME = "u1s1-cli";
+/** engines.node 里要求的最低版本(如 ">=22.19.0" → "22.19.0");解析不出返回 undefined。 */
+function requiredNodeVersion() {
+    const m = /(\d+\.\d+\.\d+)/.exec(pkg.engines?.node ?? "");
+    return m?.[1];
+}
 /** Detect the package manager that installed u1s1. */
 export function detectPackageManager() {
     // Check common global install locations for clues
@@ -53,11 +60,38 @@ export async function update() {
         console.log(`当前 v${VERSION} 已是最新版本 ✓`);
         return;
     }
-    const pm = detectPackageManager();
     console.log(`发现新版本 v${latest} (当前 v${VERSION})`);
+    // 便携版:npm 装到全局目录,但 PATH 先命中便携目录,怎么更都还是旧版。
+    // 唯一正确的升级方式是重跑官网安装命令整包替换,这里不再碰 npm。
+    if (isPortableInstall()) {
+        const isWin = process.platform === "win32";
+        console.log("");
+        console.log("你装的是便携版(自带 Node),npm 更新不了它。升级分两步:");
+        console.log("  1. 关闭所有 u1s1 窗口");
+        console.log(isWin
+            ? "  2. 打开 PowerShell 运行: irm https://u1s1.io/releases/install.ps1 | iex"
+            : "  2. 在终端运行: curl -fsSL https://u1s1.io/releases/install.sh | bash");
+        return;
+    }
+    const pm = detectPackageManager();
+    // 系统 Node 低于新版要求时,先说人话:推荐官网安装命令(便携包自带合适的
+    // Node,不用自己折腾)。npm 更新仍继续——引擎不匹配只是警告,装上大概率能跑。
+    const required = requiredNodeVersion();
+    if (required && compareVersions(process.versions.node, required) < 0) {
+        const cmd = process.platform === "win32"
+            ? "irm https://u1s1.io/releases/install.ps1 | iex   (在 PowerShell 里运行)"
+            : "curl -fsSL https://u1s1.io/releases/install.sh | bash";
+        console.log("");
+        console.log(`⚠ 你电脑的 Node.js 是 v${process.versions.node},新版 u1s1 建议 v${required} 或更新。`);
+        console.log("  推荐用官网安装命令重装,自带合适的 Node,一步到位:");
+        console.log(`    ${cmd}`);
+        console.log("  下面仍会继续用 npm 更新;更新后如果运行异常,再用上面的命令重装即可。");
+        console.log("");
+    }
     console.log(`正在用 ${pm} 更新 ${PACKAGE_NAME}…`);
     try {
-        const installCmd = pm === "npm" ? `npm install -g ${PACKAGE_NAME}@latest` : `${pm} add -g ${PACKAGE_NAME}@latest`;
+        // npm 压掉 EBADENGINE 等警告墙,对新手只有噪音;出错时 error 仍会显示
+        const installCmd = pm === "npm" ? `npm install -g --loglevel=error ${PACKAGE_NAME}@latest` : `${pm} add -g ${PACKAGE_NAME}@latest`;
         execSync(installCmd, { stdio: "inherit" });
         console.log(`\n✅ 已更新到 v${latest}，重启 u1s1 后生效。`);
     }

package/dist/usage.js

@@ -4,6 +4,21 @@ function bar(ratio, width = 24) {
     const filled = Math.round(Math.max(0, Math.min(1, ratio)) * width);
     return "█".repeat(filled) + "░".repeat(width - filled);
 }
+// 与官网 app.js 的 fmtTokensCn 保持一致:万/亿单位,2 位有效数字
+function fmtTokensCn(tokens) {
+    const t = Number(tokens);
+    if (!Number.isFinite(t) || t <= 0)
+        return "0";
+    const sig2 = (n) => {
+        const m = Math.pow(10, Math.max(0, String(Math.round(n)).length - 2));
+        return Math.round(n / m) * m;
+    };
+    if (t >= 1e8)
+        return (Math.round((t / 1e8) * 10) / 10).toLocaleString("en-US") + " 亿";
+    if (t >= 1e4)
+        return sig2(t / 1e4).toLocaleString("en-US") + " 万";
+    return sig2(t).toLocaleString("en-US");
+}
 export async function usage() {
     const cfg = loadConfig();
     if (!cfg.apiKey) {
@@ -14,16 +29,28 @@ export async function usage() {
         console.error(e.message);
         process.exit(1);
     });
-    const remain = me.remaining_usd;
     const freeRemain = me.daily_free_remaining_usd;
     const freeTotal = me.daily_free_usd;
     const freeRatio = freeTotal > 0 ? freeRemain / freeTotal : 0;
+    const tpu = me.tokens_per_usd ?? 0;
     console.log("");
     console.log(`  账号       ${me.email ?? "(未绑定邮箱)"}`);
-    console.log(`  今日免费   $${freeRemain} / $${freeTotal}  ${bar(freeRatio)}`);
-    console.log("             DeepSeek V4 Flash · 北京时间 0 点恢复");
-    console.log(`  永久余额   $${remain}`);
-    console.log(`  本月成本   $${me.mtd_usd}`);
+    if (tpu > 0) {
+        const tok = (usd) => `${fmtTokensCn(usd * tpu)} Token`;
+        console.log(`  今日免费   还剩 ${fmtTokensCn(freeRemain * tpu)} / ${tok(freeTotal)}  ${bar(freeRatio)}`);
+        console.log("             DeepSeek V4 Flash · 北京时间 0 点恢复");
+        console.log(`  永久余额   ${tok(me.remaining_usd)}`);
+        console.log(`  本月已用   约 ${tok(me.mtd_usd)}($${me.mtd_usd.toFixed(2)})`);
+        console.log("");
+        console.log("  Token 数按默认模型单价折算,为约数;用更贵的模型时消耗更快。");
+    }
+    else {
+        // 老网关没下发 tokens_per_usd,退回金额显示
+        console.log(`  今日免费   $${freeRemain} / $${freeTotal}  ${bar(freeRatio)}`);
+        console.log("             DeepSeek V4 Flash · 北京时间 0 点恢复");
+        console.log(`  永久余额   $${me.remaining_usd}`);
+        console.log(`  本月成本   $${me.mtd_usd}`);
+    }
     console.log("");
     console.log("  免费额度每天自动恢复；邀请朋友双方各得永久加量 → https://u1s1.io/dashboard");
     console.log("");

package/dist/web.js

@@ -2,7 +2,7 @@ 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 { cleanupBrandThemes, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, writeWebToolsExtension, } 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";
@@ -49,14 +49,19 @@ export async function webCommand(cfg, args) {
     ensureBrandPrompt();
     ensureDefaultSettings();
     // Fetch model list from server; fall back to built-in MODELS on error.
+    // 服务端没开搜索(或老网关没有 features 字段)时不注册 web_search
+    let webSearchEnabled = true;
     try {
-        const apiModels = await fetchModels(cfg);
-        setModelsFromApi(apiModels.map(apiModelToDef));
+        const { models, features } = await fetchModels(cfg);
+        setModelsFromApi(models.map(apiModelToDef));
+        webSearchEnabled = features.web_search !== false;
     }
     catch (e) {
         console.error("  获取模型列表失败,使用内置列表:", e.message);
     }
     ensureProviderModels(cfg);
+    // 联网工具经 agentDir/extensions 投影,和 TUI 共用一份注册
+    writeWebToolsExtension(cfg, webSearchEnabled);
     // 网页版新会话从 settings.json 的 defaultModel 取模型(TUI 是每次传 --model),
     // 确保它有值;resolvePreferredModel 优先尊重已有的 in-session 选择,不会回退覆盖。
     writeAgentDefaultModel(resolvePreferredModel(cfg.model));
@@ -70,6 +75,7 @@ export async function webCommand(cfg, args) {
             ...process.env,
             PI_CODING_AGENT_DIR: agentDir,
             U1S1_API_KEY: cfg.apiKey,
+            U1S1_TOOLS_VIA_EXTENSION: "1",
             PI_WEB_DATA_DIR: dataDir,
         },
     });

package/package.json

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