u1s1-cli 1.4.3 → 1.6.0

package/dist/index.js

@@ -12,6 +12,8 @@ import { applyBrandUi, setAnnouncement, setUpdateNotice } from "./style.js";
 import { 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";
+import { createGatewayTelemetry } from "./telemetry.js";
 const PACKAGE_NAME = "u1s1-cli";
 /** 启动时检测到的可自动安装的新版;TUI 退出后才装(见 installPendingUpdate)。 */
 let pendingUpdate;
@@ -257,6 +259,26 @@ async function runAgent(cfg, args) {
     scrubForeignProviderEnv();
     // 密钥只留在本进程:模型跑的 shell 命令、子 agent、扩展派生的任何子进程都拿不到
     installChildEnvGuard();
+    // 客户端事件上报(见 telemetry.ts):状态放在 runAgent 作用域,/clear、/resume
+    // 会重建扩展运行时、重跑下面的 factory,但一个 TUI 进程只算一个会话
+    const telemetry = createGatewayTelemetry(cfg);
+    const sessionStartedAt = Date.now();
+    const stats = { turns: 0, toolCalls: 0, filesWritten: 0, writesThisRun: 0 };
+    let firstToolSuccessSent = false;
+    let firstTaskDoneSent = false;
+    let sessionEndSent = false;
+    telemetry.track("session_start", { surface: "terminal" });
+    const trackSessionEnd = () => {
+        if (sessionEndSent)
+            return;
+        sessionEndSent = true;
+        telemetry.track("session_end", {
+            duration_ms: Date.now() - sessionStartedAt,
+            turns: stats.turns,
+            tool_calls: stats.toolCalls,
+            files_written: stats.filesWritten,
+        });
+    };
     await searchToolsReady;
     const { CustomEditor, main } = await agentReady;
     // 网页终端(如 Taikula)把 Shift+Enter 发成 ESC+CR(\x1b\r)。pi 在没开 Kitty
@@ -326,8 +348,10 @@ async function runAgent(cfg, args) {
                         theme.fg("text", "直接打字说需求,回车发送 · Shift+Enter 换行 · Ctrl+V 贴图 · Esc 中断"),
                         theme.fg("text", "/model 切换模型(留意免费/价格提示) · /clear 清空上下文开新会话"),
                         theme.fg("text", "/usage 查剩余额度 · /resume 恢复历史会话 · /settings 设置"),
-                        theme.fg("dim", "/compact 压缩上下文 · /hotkeys 全部快捷键(英文) · /exit 退出"),
+                        theme.fg("text", "/feedback 一句话反馈问题或建议(自动附带版本与请求编号建工单)"),
+                        theme.fg("dim", "/compact 压缩上下文 · /hotkeys 全部快捷键 · /exit 退出"),
                         theme.fg("dim", "退出后在终端:u1s1 deploy 发布网页 · u1s1 update 升级"),
+                        theme.fg("dim", "匿名使用统计只记会话开始/结束等节点,不含任何内容;U1S1_TELEMETRY=0 可关闭"),
                         theme.fg("dim", "新手教程 → https://u1s1.io/guides"),
                     ].join("\n");
                     return new Text(text, 1, 0);
@@ -352,6 +376,75 @@ async function runAgent(cfg, args) {
                         pi.appendEntry("u1s1-usage", await usageEntryData());
                     },
                 });
+                // /feedback:会话内直接建工单,附版本/平台/最近请求编号(运营清单 E4)
+                pi.registerEntryRenderer("u1s1-feedback", (entry, _opts, theme) => {
+                    const data = entry.data ?? {};
+                    return new Text((data.lines ?? []).map((l) => theme.fg("text", l)).join("\n"), 1, 0);
+                });
+                pi.registerCommand("feedback", {
+                    description: "反馈问题或建议(自动附带诊断信息建工单)",
+                    handler: async (cmdArgs, ctx) => {
+                        const { feedbackInSession, parseFeedbackArgs } = await import("./feedback.js");
+                        let raw = cmdArgs.trim();
+                        let parsed;
+                        try {
+                            parsed = parseFeedbackArgs(raw.split(/\s+/).filter(Boolean));
+                        }
+                        catch (e) {
+                            pi.appendEntry("u1s1-feedback", { lines: [e instanceof Error ? e.message : String(e)] });
+                            return;
+                        }
+                        if (!parsed.help && !parsed.text && ctx.hasUI) {
+                            const text = (await ctx.ui.input("反馈内容", "一句话说清楚问题或建议"))?.trim();
+                            if (!text)
+                                return;
+                            raw = `--${parsed.category} ${text}`;
+                        }
+                        const model = ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined;
+                        pi.appendEntry("u1s1-feedback", { lines: await feedbackInSession(raw, model) });
+                    },
+                });
+                // ---- 事件上报 + 首次写文件后的 deploy 提示 ----
+                pi.on("agent_start", () => {
+                    stats.writesThisRun = 0;
+                });
+                pi.on("turn_end", () => {
+                    stats.turns++;
+                });
+                pi.on("tool_result", (event) => {
+                    stats.toolCalls++;
+                    if (event.isError)
+                        return;
+                    if (!firstToolSuccessSent) {
+                        firstToolSuccessSent = true;
+                        telemetry.track("first_tool_success", { tool: event.toolName });
+                    }
+                    if (event.toolName === "write" || event.toolName === "edit") {
+                        stats.filesWritten++;
+                        stats.writesThisRun++;
+                    }
+                });
+                pi.on("agent_end", (_event, ctx) => {
+                    if (stats.writesThisRun === 0)
+                        return;
+                    if (!firstTaskDoneSent) {
+                        firstTaskDoneSent = true;
+                        telemetry.track("first_task_done", { files_written: stats.filesWritten });
+                    }
+                    // 每台机器只提示一次;跑过 u1s1 deploy 后永不再提(见 nudges.ts)
+                    if (ctx.hasUI && shouldShowDeployHint()) {
+                        markNudge("deploy_hint_shown");
+                        ctx.ui.notify(DEPLOY_HINT_TEXT, "info");
+                    }
+                });
+                // pi 在 session_shutdown 处理完后直接 process.exit,session_end 只能在这里
+                // 发并等冲刷(最多 1 秒);/clear、/resume 的 reason 不是 quit,不算会话结束
+                pi.on("session_shutdown", async (event) => {
+                    if (event.reason !== "quit")
+                        return;
+                    trackSessionEnd();
+                    await telemetry.shutdown();
+                });
                 // 模型调用错误人话化不在这里注册:走 writeErrorHumanizeExtension 投影,
                 // TUI 和 Desktop App 共用一份(见 agent-setup.ts)
                 // /clear: 清空当前对话上下文，开始新会话
@@ -408,7 +501,13 @@ async function runAgent(cfg, args) {
         persistPreferredModel(cfg, pref.provider, pref.id);
     }
     const finalArgs = hasModelArg ? args : ["--model", `${pref.provider}/${pref.id}`, ...args];
-    await main(finalArgs, { extensionFactories: extension });
+    try {
+        await main(finalArgs, { extensionFactories: extension });
+    }
+    finally {
+        trackSessionEnd();
+        await telemetry.shutdown();
+    }
 }
 async function run() {
     const args = process.argv.slice(2);
@@ -428,11 +527,14 @@ async function run() {
         console.log("   u1s1 update            升级到最新版");
         console.log("   u1s1 deploy            发布网页(--public / --private)");
         console.log("   u1s1 deploy list       查看已发布的站点");
+        console.log("   u1s1 deploy remove     删除已发布的站点");
+        console.log("   u1s1 feedback \"一句话\"  反馈问题或建议(自动建工单,--bug/--question…)");
         console.log("   u1s1 import            导入历史会话");
         console.log("   u1s1 bench             模型编码能力评测");
         console.log("   u1s1 --version         查看版本");
         console.log("");
-        console.log(" 对话里输入 /help 看会话内命令(/model /clear /exit …)");
+        console.log(" 对话里输入 /help 看会话内命令(/model /clear /feedback /exit …)");
+        console.log(" 匿名使用统计只记会话开始/结束等节点,不含内容;设 U1S1_TELEMETRY=0 关闭");
         console.log(" 更多帮助 → https://u1s1.io/guides");
         return;
     }
@@ -463,6 +565,11 @@ async function run() {
         await usage();
         return;
     }
+    if (cmd === "feedback") {
+        const { feedbackCommand } = await import("./feedback.js");
+        await feedbackCommand(args.slice(1));
+        return;
+    }
     if (cmd === "model") {
         const { modelCommand } = await import("./model.js");
         await modelCommand(args[1]);
@@ -535,7 +642,7 @@ async function run() {
     // autoUpdate 开着且启动时发现了新版:现在装(TUI 已退出,原地重铺安全)
     installPendingUpdate();
 }
-const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "bench", "help", "web"];
+const KNOWN_COMMANDS = ["deploy", "login", "logout", "usage", "model", "update", "import", "bench", "feedback", "help", "web"];
 /** 经典 Levenshtein,命令名都很短,O(nm) 足够。 */
 function editDistance(a, b) {
     const dp = Array.from({ length: a.length + 1 }, (_, i) => i);

package/dist/nudges.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 「只提示一次」的机器级标记,落在 ~/.u1s1/nudges.json,CLI 与桌面版共用
+ * (桌面版经 u1s1-cli/embed 拿到同一份 helper)。值是 ISO 时间戳,便于事后
+ * 排查「什么时候提示过」。读写都是尽力而为:文件坏了当作没提示过,写失败
+ * 最多是多提示一次,绝不能因为它抛错影响主流程。
+ */
+export type NudgeKey = 
+/** 首次写文件后打印过「u1s1 deploy 一键上线」提示 */
+"deploy_hint_shown"
+/** 用户成功跑过一次 u1s1 deploy(之后不再推 deploy) */
+ | "deploy_done"
+/** 桌面版首启引导已看过 */
+ | "desktop_onboarding_done";
+export type NudgeState = Partial<Record<NudgeKey, string>>;
+export declare const nudgesFile: string;
+export declare function readNudges(file?: string): NudgeState;
+export declare function hasNudge(key: NudgeKey, file?: string): boolean;
+export declare function markNudge(key: NudgeKey, file?: string): void;
+/** 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。 */
+export declare function shouldShowDeployHint(file?: string): boolean;
+export declare const DEPLOY_HINT_TEXT = "\u505A\u597D\u4E86\u60F3\u7ED9\u670B\u53CB\u770B\uFF1F\u8FD0\u884C u1s1 deploy \u4E00\u952E\u4E0A\u7EBF";

package/dist/nudges.js

@@ -0,0 +1,40 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { u1s1Dir } from "./config.js";
+export const nudgesFile = join(u1s1Dir, "nudges.json");
+export function readNudges(file = nudgesFile) {
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return {};
+        const out = {};
+        for (const [k, v] of Object.entries(parsed)) {
+            if (typeof v === "string")
+                out[k] = v;
+        }
+        return out;
+    }
+    catch {
+        return {};
+    }
+}
+export function hasNudge(key, file = nudgesFile) {
+    return readNudges(file)[key] !== undefined;
+}
+export function markNudge(key, file = nudgesFile) {
+    try {
+        mkdirSync(join(file, ".."), { recursive: true });
+        const all = readNudges(file);
+        all[key] = new Date().toISOString();
+        writeFileSync(file, JSON.stringify(all, null, 2) + "\n");
+    }
+    catch {
+        // ignore
+    }
+}
+/** 会话里首次写/改文件后要不要提示 deploy:没提示过、也没部署过才提示。 */
+export function shouldShowDeployHint(file = nudgesFile) {
+    const state = readNudges(file);
+    return state.deploy_hint_shown === undefined && state.deploy_done === undefined;
+}
+export const DEPLOY_HINT_TEXT = "做好了想给朋友看？运行 u1s1 deploy 一键上线";

package/dist/prompt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 终端里问一行:非 TTY(脚本/管道)直接返回默认值,不挂住。
+ * deploy 问站点名、feedback 问反馈内容都走这里。
+ */
+export declare function askLine(question: string, def?: string): Promise<string>;

package/dist/prompt.js

@@ -0,0 +1,17 @@
+import { createInterface } from "node:readline/promises";
+/**
+ * 终端里问一行:非 TTY(脚本/管道)直接返回默认值,不挂住。
+ * deploy 问站点名、feedback 问反馈内容都走这里。
+ */
+export async function askLine(question, def = "") {
+    if (!process.stdin.isTTY)
+        return def;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question(question)).trim();
+        return answer || def;
+    }
+    finally {
+        rl.close();
+    }
+}

package/dist/request-trace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 记住最近一次模型调用报错带回的 request_id(网关在错误 JSON 里注入,见
+ * error-humanize.ts),`u1s1 feedback` / 会话内 /feedback 建工单时附进诊断
+ * 快照,客服凭它直查日志。进程内先记内存;同时尽力落到 ~/.u1s1/last-request.json,
+ * 让退出会话后再跑 `u1s1 feedback` 的用户也能带上编号。超过 24 小时的记录
+ * 不再当「最近」。
+ */
+export declare const lastRequestFile: string;
+export declare function rememberRequestId(id: string | undefined, file?: string): void;
+export declare function lastRequestId(file?: string, now?: number): string | undefined;
+/** 测试用:清掉进程内缓存。 */
+export declare function resetRequestTraceForTests(): void;

package/dist/request-trace.js

@@ -0,0 +1,45 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { u1s1Dir } from "./config.js";
+/**
+ * 记住最近一次模型调用报错带回的 request_id(网关在错误 JSON 里注入,见
+ * error-humanize.ts),`u1s1 feedback` / 会话内 /feedback 建工单时附进诊断
+ * 快照,客服凭它直查日志。进程内先记内存;同时尽力落到 ~/.u1s1/last-request.json,
+ * 让退出会话后再跑 `u1s1 feedback` 的用户也能带上编号。超过 24 小时的记录
+ * 不再当「最近」。
+ */
+export const lastRequestFile = join(u1s1Dir, "last-request.json");
+const MAX_AGE_MS = 24 * 60 * 60 * 1000;
+let inMemory;
+export function rememberRequestId(id, file = lastRequestFile) {
+    if (!id || id.length > 128)
+        return;
+    const at = Date.now();
+    inMemory = { request_id: id, at };
+    try {
+        writeFileSync(file, JSON.stringify({ request_id: id, at: new Date(at).toISOString() }) + "\n");
+    }
+    catch {
+        // ~/.u1s1 不存在(纯环境变量登录)等情况:只记内存
+    }
+}
+export function lastRequestId(file = lastRequestFile, now = Date.now()) {
+    if (inMemory && now - inMemory.at <= MAX_AGE_MS)
+        return inMemory.request_id;
+    try {
+        const parsed = JSON.parse(readFileSync(file, "utf8"));
+        if (typeof parsed.request_id !== "string" || typeof parsed.at !== "string")
+            return undefined;
+        const at = Date.parse(parsed.at);
+        if (!Number.isFinite(at) || now - at > MAX_AGE_MS)
+            return undefined;
+        return parsed.request_id;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 测试用:清掉进程内缓存。 */
+export function resetRequestTraceForTests() {
+    inMemory = undefined;
+}

package/dist/telemetry.d.ts

@@ -0,0 +1,56 @@
+import { type CliConfig } from "./config.js";
+/**
+ * 客户端事件上报(运营清单 C1):只报「会话开始/结束、首次工具成功、首次任务
+ * 完成、部署完成」几个节点,不采任何内容。事件先在内存排队,每 30 秒或退出时
+ * 批量 POST /v1/telemetry(每批最多 20 条),失败静默丢弃,绝不阻塞界面、
+ * 绝不拖慢退出(退出冲刷最多等 1 秒)。
+ *
+ * 关闭方式:环境变量 U1S1_TELEMETRY=0,或 ~/.u1s1/agent/settings.json 里
+ * "telemetry": false。关闭后 track 直接丢,不打印任何东西。
+ */
+export type TelemetryEventName = "session_start" | "session_end" | "first_tool_success" | "first_task_done" | "deploy_done";
+export interface TelemetryEvent {
+    name: TelemetryEventName;
+    /** epoch ms */
+    ts: number;
+    props?: Record<string, unknown>;
+}
+export type TelemetryTransport = (events: TelemetryEvent[]) => Promise<void>;
+export interface TelemetryOptions {
+    transport: TelemetryTransport;
+    /** 默认 true;false 时所有 track 都是空操作 */
+    enabled?: boolean;
+    /** 定时冲刷间隔,默认 30 秒 */
+    flushIntervalMs?: number;
+    /** 单批上限,默认 20(与网关契约一致) */
+    maxBatch?: number;
+    /** 退出冲刷的等待上限,默认 1 秒 */
+    shutdownTimeoutMs?: number;
+    now?: () => number;
+}
+export interface Telemetry {
+    track(name: TelemetryEventName, props?: Record<string, unknown>): void;
+    /** 立即把队列里的事件按批发出;传输失败静默丢弃 */
+    flush(): Promise<void>;
+    /** 停掉定时器并做最后一次冲刷(最多等 shutdownTimeoutMs) */
+    shutdown(): Promise<void>;
+    /** 当前排队条数(测试用) */
+    pending(): number;
+    readonly enabled: boolean;
+}
+export declare const TELEMETRY_FLUSH_INTERVAL_MS = 30000;
+export declare const TELEMETRY_MAX_BATCH = 20;
+export declare const TELEMETRY_SHUTDOWN_TIMEOUT_MS = 1000;
+/** 环境变量优先于设置文件;两者都没说就默认开启。 */
+export declare function telemetryEnabled(env?: NodeJS.ProcessEnv, settings?: {
+    telemetry?: unknown;
+}): boolean;
+export declare function createTelemetry(options: TelemetryOptions): Telemetry;
+/** 真正的传输:设备签名 POST /v1/telemetry,3 秒超时,响应体直接丢。 */
+export declare function gatewayTransport(cfg: CliConfig, timeoutMs?: number): TelemetryTransport;
+/** 按当前环境/设置组装一个连着网关的 Telemetry。 */
+export declare function createGatewayTelemetry(cfg: CliConfig, overrides?: Partial<TelemetryOptions>): Telemetry;
+/**
+ * 一次性命令(如 deploy)用:发一个事件就冲刷,最多等 1 秒;任何失败都吞掉。
+ */
+export declare function sendTelemetryEvent(cfg: CliConfig, name: TelemetryEventName, props?: Record<string, unknown>): Promise<void>;

package/dist/telemetry.js

@@ -0,0 +1,146 @@
+import { readSettings, VERSION } from "./config.js";
+import { authorizedFetch } from "./device-auth.js";
+export const TELEMETRY_FLUSH_INTERVAL_MS = 30_000;
+export const TELEMETRY_MAX_BATCH = 20;
+export const TELEMETRY_SHUTDOWN_TIMEOUT_MS = 1_000;
+/** 内存里最多攒这么多条;再多就丢最旧的,防止网络长期不通时无限增长 */
+const MAX_QUEUE = 200;
+/** 环境变量优先于设置文件;两者都没说就默认开启。 */
+export function telemetryEnabled(env = process.env, settings = readSettings()) {
+    const raw = env["U1S1_TELEMETRY"];
+    if (raw !== undefined && raw !== "") {
+        const v = raw.trim().toLowerCase();
+        if (v === "0" || v === "false" || v === "off" || v === "no")
+            return false;
+        if (v === "1" || v === "true" || v === "on" || v === "yes")
+            return true;
+    }
+    return settings.telemetry !== false;
+}
+export function createTelemetry(options) {
+    const enabled = options.enabled ?? true;
+    const flushIntervalMs = options.flushIntervalMs ?? TELEMETRY_FLUSH_INTERVAL_MS;
+    const maxBatch = options.maxBatch ?? TELEMETRY_MAX_BATCH;
+    const shutdownTimeoutMs = options.shutdownTimeoutMs ?? TELEMETRY_SHUTDOWN_TIMEOUT_MS;
+    const now = options.now ?? Date.now;
+    const queue = [];
+    let timer;
+    let inflight;
+    let stopped = false;
+    const clearTimer = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = undefined;
+    };
+    const flushNow = async () => {
+        clearTimer();
+        // 串行发送:上一批还在路上就等它,避免乱序与并发放大
+        if (inflight)
+            await inflight;
+        inflight = (async () => {
+            // 一次 flush 最多发几批,剩下的留给下一轮,别把退出拖住
+            for (let round = 0; round < 3 && queue.length > 0; round++) {
+                const batch = queue.splice(0, maxBatch);
+                try {
+                    await options.transport(batch);
+                }
+                catch {
+                    // 静默丢弃:遥测不值得重试,更不值得打扰用户
+                }
+            }
+        })();
+        try {
+            await inflight;
+        }
+        finally {
+            inflight = undefined;
+        }
+    };
+    const schedule = () => {
+        if (timer || stopped)
+            return;
+        timer = setTimeout(() => {
+            timer = undefined;
+            void flushNow();
+        }, flushIntervalMs);
+        // 定时器不能拖住进程退出
+        timer.unref?.();
+    };
+    return {
+        enabled,
+        track(name, props) {
+            if (!enabled || stopped)
+                return;
+            queue.push(props ? { name, ts: now(), props } : { name, ts: now() });
+            if (queue.length > MAX_QUEUE)
+                queue.splice(0, queue.length - MAX_QUEUE);
+            if (queue.length >= maxBatch)
+                void flushNow();
+            else
+                schedule();
+        },
+        async flush() {
+            if (!enabled)
+                return;
+            await flushNow();
+        },
+        async shutdown() {
+            if (!enabled || stopped)
+                return;
+            stopped = true;
+            clearTimer();
+            if (queue.length === 0 && !inflight)
+                return;
+            let cap;
+            const deadline = new Promise((resolve) => {
+                cap = setTimeout(resolve, shutdownTimeoutMs);
+                cap.unref?.();
+            });
+            try {
+                await Promise.race([flushNow(), deadline]);
+            }
+            finally {
+                if (cap)
+                    clearTimeout(cap);
+            }
+        },
+        pending() {
+            return queue.length;
+        },
+    };
+}
+/** 真正的传输:设备签名 POST /v1/telemetry,3 秒超时,响应体直接丢。 */
+export function gatewayTransport(cfg, timeoutMs = 3_000) {
+    return async (events) => {
+        const resp = await authorizedFetch(cfg, `${cfg.baseUrl}/telemetry`, {
+            method: "POST",
+            headers: { "x-u1s1-version": VERSION, "content-type": "application/json" },
+            body: JSON.stringify({ events }),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        void resp.body?.cancel("telemetry response ignored").catch(() => { });
+    };
+}
+/** 按当前环境/设置组装一个连着网关的 Telemetry。 */
+export function createGatewayTelemetry(cfg, overrides = {}) {
+    return createTelemetry({
+        transport: gatewayTransport(cfg),
+        enabled: telemetryEnabled(),
+        ...overrides,
+    });
+}
+/**
+ * 一次性命令(如 deploy)用:发一个事件就冲刷,最多等 1 秒;任何失败都吞掉。
+ */
+export async function sendTelemetryEvent(cfg, name, props) {
+    try {
+        const t = createGatewayTelemetry(cfg);
+        if (!t.enabled)
+            return;
+        t.track(name, props);
+        await t.shutdown();
+    }
+    catch {
+        // 遥测永远不影响命令本身
+    }
+}

package/dist/update.js

@@ -166,8 +166,8 @@ async function portableSelfUpdate(latest) {
         execFileSync("bash", [tmp], { stdio: "inherit" });
     }
     catch {
-        console.error("\n自动升级失败。请手动运行:");
-        console.error("  curl -fsSL https://u1s1.io/releases/install.sh | bash");
+        // 安装脚本已经打印了失败原因与重试提示(多半是到 u1s1.io 的链路慢),这里不再重复一整段
+        console.error("\n自动升级没有完成,稍后重试 u1s1 update 即可;已安装版本不受影响。");
         process.exit(1);
     }
     // 脚本退出码 0 ≠ 升级成功:安装脚本认的是官网 LATEST 版本源,它若认为

package/dist/usage.d.ts

@@ -1,4 +1,7 @@
 import { type MeResponse } from "./api.js";
+export declare const TOPUP_URL = "https://u1s1.io/dashboard#usage-topup-card";
+/** 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。 */
+export declare function usageCtaLines(): string[];
 /** 额度报告正文(不含首尾空行),终端 `u1s1 usage` 和会话内 /usage 共用。 */
 export declare function usageReportLines(me: MeResponse): string[];
 /** 会话内 /usage 用:拉取额度并打包成 entry data,错误转成中文提示而不是抛出。 */

package/dist/usage.js

@@ -93,6 +93,8 @@ function packageUsageLines(me, tokensPerUsd) {
     lines.push("  免费用量包覆盖 DeepSeek V4 Flash / Vision、GLM-5.3 Flash、Qwen3.8 Flash 和联网搜索。");
     lines.push("  其他模型(如 DeepSeek V4 Pro)不走免费包，可用余额或全模型包 → https://u1s1.io/dashboard");
     lines.push("  Token 数按默认模型单价折算,为约数;用更贵的模型时消耗更快。");
+    lines.push("");
+    lines.push(...usageCtaLines());
     return lines;
 }
 function legacyUsageLines(me, tokensPerUsd) {
@@ -116,9 +118,17 @@ function legacyUsageLines(me, tokensPerUsd) {
         lines.push(`  本月成本   $${me.mtd_usd.toFixed(2)}`);
     }
     lines.push("");
-    lines.push("  免费额度每天自动恢复；邀请朋友双方各得永久加量 → https://u1s1.io/dashboard");
+    lines.push(...usageCtaLines());
     return lines;
 }
+export const TOPUP_URL = "https://u1s1.io/dashboard#usage-topup-card";
+/** 报告尾巴的两条行动入口:邀请(永久加量)与充值(撞线用户的直接出口,运营清单 A2)。 */
+export function usageCtaLines() {
+    return [
+        "  免费额度每天自动恢复；邀请朋友双方各得永久加量 → https://u1s1.io/dashboard",
+        `  额度不够用?充值 → ${TOPUP_URL}`,
+    ];
+}
 /** 额度报告正文(不含首尾空行),终端 `u1s1 usage` 和会话内 /usage 共用。 */
 export function usageReportLines(me) {
     const tokensPerUsd = me.tokens_per_usd ?? 0;

package/package.json

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