u1s1-cli 1.7.0 → 1.8.0

package/dist/agent-setup.d.ts

@@ -49,6 +49,13 @@ export declare function writeErrorHumanizeExtension(): void;
  * print/json 一次性模式不起轮询;import 失败静默跳过(同 error-humanize)。
  */
 export declare function writeAnnouncementsExtension(): void;
+/**
+ * 生成「自定义 MCP 服务」扩展到 <agentDir>/extensions/u1s1-mcp.js。
+ * 读 ~/.u1s1/mcp.json,把每个服务的工具注册成 mcp_<服务>_<工具>;逻辑在 mcp/extension.ts,
+ * 这里只负责投影(Desktop App 共享)。没配置任何服务时扩展直接返回,零开销。
+ * 子会话(spawn_subagent)里不挂 MCP 工具:避免每个子进程都拉起一份服务。
+ */
+export declare function writeMcpExtension(): void;
 /**
  * 生成「OpenRouter 应用归因」扩展到 <agentDir>/extensions/u1s1-attribution.js。
  * 用户自己配 OPENROUTER_API_KEY 直连时，pi 内置的归因头归到 pi.dev 名下（且受遥测

package/dist/agent-setup.js

@@ -332,6 +332,35 @@ export function writeAnnouncementsExtension() {
         `  });\n` +
         `}\n`);
 }
+/**
+ * 生成「自定义 MCP 服务」扩展到 <agentDir>/extensions/u1s1-mcp.js。
+ * 读 ~/.u1s1/mcp.json,把每个服务的工具注册成 mcp_<服务>_<工具>;逻辑在 mcp/extension.ts,
+ * 这里只负责投影(Desktop App 共享)。没配置任何服务时扩展直接返回,零开销。
+ * 子会话(spawn_subagent)里不挂 MCP 工具:避免每个子进程都拉起一份服务。
+ */
+export function writeMcpExtension() {
+    const dir = join(agentDir, "extensions");
+    mkdirSync(dir, { recursive: true });
+    const url = new URL("./mcp/extension.js", import.meta.url).href;
+    writeFileSync(join(dir, "u1s1-mcp.js"), `// 由 u1s1 每次启动自动生成,请勿手改\n` +
+        `export default async function (pi) {\n` +
+        `  if (process.env.U1S1_IN_SUBAGENT === "1") return;\n` +
+        `  let registerMcpServers;\n` +
+        `  try {\n` +
+        `    registerMcpServers = (await import(${JSON.stringify(url)})).registerMcpServers;\n` +
+        `  } catch {\n` +
+        `    return;\n` +
+        `  }\n` +
+        `  try {\n` +
+        `    await registerMcpServers(pi);\n` +
+        `  } catch (err) {\n` +
+        `    const msg = err instanceof Error ? err.message : String(err);\n` +
+        `    pi.on("session_start", (_event, ctx) => {\n` +
+        `      if (ctx.hasUI) ctx.ui.notify("MCP 服务加载失败:" + msg, "warning");\n` +
+        `    });\n` +
+        `  }\n` +
+        `}\n`);
+}
 /**
  * 生成「OpenRouter 应用归因」扩展到 <agentDir>/extensions/u1s1-attribution.js。
  * 用户自己配 OPENROUTER_API_KEY 直连时，pi 内置的归因头归到 pi.dev 名下（且受遥测
@@ -377,6 +406,10 @@ export default async function (pi) {
   // ---- 汇总统计 ----
   let counts = {};
   let errors = 0;
+  // 工具调用被折叠后,这一行摘要是新手了解「AI 刚才做了什么」的唯一入口,内置工具名给人话
+  const TOOL_SUMMARY_LABELS: Record<string, string> = {
+    read: "读文件", write: "写文件", edit: "改文件", bash: "跑命令", grep: "搜内容", find: "找文件", ls: "列目录",
+  };
   pi.on("agent_start", async () => {
     counts = {};
     errors = 0;
@@ -392,14 +425,14 @@ export default async function (pi) {
     if (total === 0) return;
     const parts = Object.entries(counts)
       .sort((a, b) => b[1] - a[1])
-      .map(([name, n]) => name + "×" + n);
+      .map(([name, n]) => (TOOL_SUMMARY_LABELS[name] ?? name) + "×" + n);
     if (errors > 0) parts.push("✗ " + errors);
     pi.appendEntry("tool-summary", { total, summary: parts.join(" · ") });
   });
   pi.registerEntryRenderer("tool-summary", (entry, _opts, theme) => {
     const d = entry.data;
     let text = theme.fg("muted", "⚙ ");
-    text += theme.fg("toolTitle", theme.bold(d.total + " tool" + (d.total > 1 ? "s" : "")));
+    text += theme.fg("toolTitle", theme.bold(d.total + " 次工具调用"));
     text += theme.fg("dim", " · " + d.summary);
     return new Text(text, 0, 0);
   });

package/dist/api.d.ts

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

package/dist/api.js

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

package/dist/brand.js

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

package/dist/error-humanize.js

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

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execSync, spawnSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
-import { cleanupBrandThemes, endpointKeyEnv, endpointProviderEntry, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, ensureWorkflowPromptTemplate, scrubForeignProviderEnv, toProviderModels, writeAnnouncementsExtension, writeAttributionExtension, writeCompactUiExtension, writeErrorHumanizeExtension, writeWebToolsExtension, } from "./agent-setup.js";
+import { cleanupBrandThemes, endpointKeyEnv, endpointProviderEntry, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, ensureWorkflowPromptTemplate, scrubForeignProviderEnv, toProviderModels, writeAnnouncementsExtension, writeAttributionExtension, writeMcpExtension, writeCompactUiExtension, writeErrorHumanizeExtension, writeWebToolsExtension, } from "./agent-setup.js";
 import { Text } from "@earendil-works/pi-tui";
 import { printConsoleBanner } from "./brand.js";
 import { agentDir, apiModelToDef, CUSTOM_ENDPOINTS, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, refValid, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
@@ -9,7 +9,7 @@ import { registerLoopCommand } from "./loop.js";
 import { ensureSearchTools } from "./search-tools.js";
 import { ensureUsableShell } from "./shell-doctor.js";
 import { applyBrandUi, setAnnouncement, setUpdateNotice } from "./style.js";
-import { AuthError, fetchModels, loadCustomEndpoints, readJsonResponseCapped } from "./api.js";
+import { AccessDeniedError, AuthError, fetchModels, loadCustomEndpoints, readJsonResponseCapped } from "./api.js";
 import { ensureSigningProxy } from "./device-auth.js";
 import { installChildEnvGuard } from "./secret-env.js";
 import { DEPLOY_HINT_TEXT, markNudge, shouldShowDeployHint } from "./nudges.js";
@@ -93,6 +93,7 @@ function installPendingUpdate() {
         return;
     const { latest, installCmd } = pendingUpdate;
     console.log(`\n⬆ 正在更新到 v${latest}…`);
+    console.log("  (可能需要几分钟,期间请不要关闭窗口或按 Ctrl+C,中途打断会装出半截)");
     try {
         execSync(installCmd, { stdio: "inherit" });
         console.log(`✅ 已更新到 v${latest},下次运行 u1s1 生效。`);
@@ -200,6 +201,12 @@ async function runAgent(cfg, args) {
                 return undefined;
             });
         }
+        else if (e instanceof AccessDeniedError) {
+            // 封禁/停用/设备不受信任:进 TUI 后每条消息都会失败,不如现在就把原因说清楚并退出
+            console.error(`  ${e.message}`);
+            console.error("  这个账号当前无法使用 u1s1。如有疑问可发邮件到 contact@u1s1.io,或在 https://u1s1.io/dashboard 提交工单。");
+            process.exit(1);
+        }
         else {
             console.error("  获取模型列表失败,使用内置列表:", e.message);
         }
@@ -248,6 +255,8 @@ async function runAgent(cfg, args) {
     writeAnnouncementsExtension();
     // OpenRouter 应用归因：直连流量计入 u1s1 的公开排行
     writeAttributionExtension();
+    // 自定义 MCP 服务的工具(~/.u1s1/mcp.json,同样投影,Desktop 共享)
+    writeMcpExtension();
     ensureTmuxKeyboardProtocol();
     // must be set before pi reads them (getAgentDir() reads at call time);
     // 常量部分已在 runAgent 开头、发起 import 之前设好
@@ -530,6 +539,7 @@ async function run() {
         console.log("   u1s1 deploy remove     删除已发布的站点");
         console.log("   u1s1 feedback \"一句话\"  反馈问题或建议(自动建工单,--bug/--question…)");
         console.log("   u1s1 import            导入历史会话(import skills 导入技能)");
+        console.log("   u1s1 mcp               配置第三方 MCP 服务(add/list/test/remove/import)");
         console.log("   u1s1 bench             模型编码能力评测");
         console.log("   u1s1 --version         查看版本");
         console.log("");
@@ -543,6 +553,12 @@ async function run() {
         process.exitCode = 1;
         return;
     }
+    // `u1s1 login --help` 不该真的去登录、`logout --help` 不该真的退出:先看是不是在问用法
+    if (cmd && SIMPLE_COMMAND_HELP[cmd] && (args[1] === "--help" || args[1] === "-h")) {
+        for (const line of SIMPLE_COMMAND_HELP[cmd])
+            console.log(line);
+        return;
+    }
     if (cmd === "deploy") {
         const { deployCommand, printDeployHelp } = await import("./deploy.js");
         // --help 不该先被拽去登录
@@ -570,6 +586,11 @@ async function run() {
         await feedbackCommand(args.slice(1));
         return;
     }
+    if (cmd === "mcp") {
+        const { mcpCommand } = await import("./mcp/command.js");
+        await mcpCommand(args.slice(1));
+        return;
+    }
     if (cmd === "model") {
         const { modelCommand } = await import("./model.js");
         await modelCommand(args[1]);
@@ -622,8 +643,9 @@ async function run() {
     }
     // 拼错的子命令(如 `u1s1 depoly`)不该被静默当成第一条消息发给模型白烧 token。
     // 只拦「单个短英文词 + 与已知命令编辑距离很近」的情况,正常 prompt 不受影响。
+    // `u1s1 delpoy list` 这类带参数的拼错也拦;长句(≥4 个词)才当 prompt 放行
     if (cmd
-        && args.length === 1
+        && args.length <= 3
         && /^[a-z][a-z0-9-]{1,15}$/.test(cmd)
         && !KNOWN_COMMANDS.includes(cmd)) {
         const near = KNOWN_COMMANDS.find((k) => editDistance(k, cmd) <= (k.length <= 4 ? 1 : 2));
@@ -642,7 +664,28 @@ async function run() {
     // autoUpdate 开着且启动时发现了新版:现在装(TUI 已退出,原地重铺安全)
     installPendingUpdate();
 }
-const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "bench", "feedback", "help", "web"];
+const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "mcp", "bench", "feedback", "help"];
+/** 没有自己 --help 处理的简单子命令:问用法时只打印说明,不执行任何动作。 */
+const SIMPLE_COMMAND_HELP = {
+    login: [
+        "用法: u1s1 login",
+        "  在浏览器里批准这台设备登录 u1s1;没有账号会引导注册。",
+        "  登录信息保存在 ~/.u1s1/config.json,退出登录用 u1s1 logout。",
+    ],
+    logout: [
+        "用法: u1s1 logout",
+        "  退出本机登录,并注销这台设备在服务端的授权(连不上服务器时只清本机)。",
+    ],
+    usage: [
+        "用法: u1s1 usage",
+        "  查看剩余额度:免费包、已购用量包与余额。会话内也可输入 /usage。",
+    ],
+    update: [
+        "用法: u1s1 update",
+        "  检查并升级到最新版;npm 安装的走 npm,便携版原地自更新。",
+        "  不想每次退出自动更新:在 ~/.u1s1/agent/settings.json 设 \"autoUpdate\": false",
+    ],
+};
 /** 经典 Levenshtein,命令名都很短,O(nm) 足够。 */
 function editDistance(a, b) {
     const dp = Array.from({ length: a.length + 1 }, (_, i) => i);

package/dist/login.js

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

package/dist/mcp/client.d.ts

@@ -0,0 +1,53 @@
+import type { McpServerConfig, McpToolInfo } from "./config.js";
+/**
+ * 极简 MCP 客户端:只做 initialize / tools/list / tools/call 三件事,
+ * 支持 stdio(本机进程,按行 JSON-RPC)和 Streamable HTTP(POST JSON,
+ * 响应可能是 JSON 也可能是 SSE)两种传输。不引 SDK:pi 本身没有 MCP client,
+ * 我们只需要把远端工具挂成 pi 工具,协议面很窄,自己写反而少一坨依赖。
+ */
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+export declare const DEFAULT_CONNECT_TIMEOUT_MS = 20000;
+export declare const DEFAULT_CALL_TIMEOUT_MS = 120000;
+export interface McpClientOptions {
+    connectTimeoutMs?: number;
+    callTimeoutMs?: number;
+    /** 服务端 stderr / 传输层告警;默认丢弃 */
+    onLog?: (line: string) => void;
+}
+export interface McpServerInfo {
+    serverName?: string;
+    serverVersion?: string;
+    protocolVersion: string;
+}
+export interface McpCallResult {
+    text: string;
+    isError: boolean;
+}
+export declare class McpError extends Error {
+    readonly code?: number | undefined;
+    constructor(message: string, code?: number | undefined);
+}
+/** 解析 SSE 正文,返回每个 event 的 data 拼接结果 */
+export declare function parseSseData(body: string): string[];
+/** 把 tools/call 返回的 content 数组压成模型可读的文本 */
+export declare function contentToText(result: unknown): McpCallResult;
+export declare function normalizeToolInfo(raw: unknown): McpToolInfo | undefined;
+export declare class McpClient {
+    readonly name: string;
+    private readonly config;
+    private readonly opts;
+    private transport;
+    private nextId;
+    private readonly connectTimeoutMs;
+    private readonly callTimeoutMs;
+    private connected;
+    info: McpServerInfo | undefined;
+    constructor(name: string, config: McpServerConfig, opts?: McpClientOptions);
+    /** 建连并完成 initialize 握手;重复调用返回同一个 promise,失败后可重试 */
+    connect(): Promise<McpServerInfo>;
+    private doConnect;
+    private rpc;
+    listTools(): Promise<McpToolInfo[]>;
+    callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<McpCallResult>;
+    close(): Promise<void>;
+}