u1s1-cli 1.4.3 → 1.5.0

package/dist/agent-setup.js

@@ -251,17 +251,21 @@ export function writeErrorHumanizeExtension() {
     const dir = join(agentDir, "extensions");
     mkdirSync(dir, { recursive: true });
     const url = new URL("./error-humanize.js", import.meta.url).href;
+    const traceUrl = new URL("./request-trace.js", import.meta.url).href;
     writeFileSync(join(dir, "u1s1-error-humanize.js"), `// 由 u1s1 每次启动自动生成,请勿手改\n` +
         `export default async function (pi) {\n` +
-        `  let humanize;\n` +
+        `  let humanize, extractRequestId, rememberRequestId;\n` +
         `  try {\n` +
-        `    humanize = (await import(${JSON.stringify(url)})).humanizeModelError;\n` +
+        `    ({ humanizeModelError: humanize, extractRequestId } = await import(${JSON.stringify(url)}));\n` +
+        `    ({ rememberRequestId } = await import(${JSON.stringify(traceUrl)}));\n` +
         `  } catch {\n` +
         `    return;\n` +
         `  }\n` +
         `  pi.on("message_end", (event) => {\n` +
         `    const msg = event.message;\n` +
         `    if (msg.role !== "assistant" || msg.stopReason !== "error" || !msg.errorMessage) return;\n` +
+        `    // 记下最近一次报错的请求编号,u1s1 feedback / /feedback 建工单时附上\n` +
+        `    rememberRequestId(extractRequestId(msg.errorMessage));\n` +
         `    const friendly = humanize(msg.errorMessage);\n` +
         `    if (!friendly) return;\n` +
         `    return { message: { ...msg, errorMessage: friendly } };\n` +

package/dist/brand.js

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

package/dist/config.d.ts

@@ -150,6 +150,8 @@ export declare const agentSettingsFile: string;
 export interface AgentSettings {
     showStartupBanner?: boolean;
     autoUpdate?: boolean;
+    /** false 时关闭客户端事件上报(见 telemetry.ts;环境变量 U1S1_TELEMETRY=0 同效) */
+    telemetry?: boolean;
     [key: string]: unknown;
 }
 /** Read u1s1 agent settings (settings.json). Returns empty object if missing or invalid. */

package/dist/deploy.js

@@ -1,9 +1,11 @@
 import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { basename, join, relative, resolve, sep } from "node:path";
-import { createInterface } from "node:readline/promises";
 import { VERSION, u1s1Dir } from "./config.js";
 import { authorizedFetch } from "./device-auth.js";
 import { readJsonResponseCapped } from "./api.js";
+import { markNudge } from "./nudges.js";
+import { askLine } from "./prompt.js";
+import { sendTelemetryEvent } from "./telemetry.js";
 /**
  * u1s1 deploy publishes a static site to <project>.<account-code>.u1s1.app.
  * Detect the site root, ask for a project slug, and remember it in ~/.u1s1/deploys.json.
@@ -211,33 +213,18 @@ async function uploadAll(cfg, start, files) {
     }
 }
 async function promptSiteName(def) {
-    if (!process.stdin.isTTY)
-        return def;
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const answer = (await rl.question(`  项目名(回车用 ${def}，只需在你的账号内唯一):`)).trim().toLowerCase();
-        return answer || def;
-    }
-    finally {
-        rl.close();
-    }
+    return (await askLine(`  项目名(回车用 ${def}，只需在你的账号内唯一):`, def)).toLowerCase();
 }
 async function promptVisibility() {
     if (!process.stdin.isTTY)
         return "private";
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        while (true) {
-            const answer = (await rl.question("  发布方式  [1] 公开(进入作品社区)  [2] 私密(仅自己登录后可看,默认):")).trim().toLowerCase();
-            if (!answer || answer === "2" || answer === "private" || answer === "私密")
-                return "private";
-            if (answer === "1" || answer === "public" || answer === "公开")
-                return "public";
-            console.log("  请输入 1 或 2");
-        }
-    }
-    finally {
-        rl.close();
+    while (true) {
+        const answer = (await askLine("  发布方式  [1] 公开(进入作品社区)  [2] 私密(仅自己登录后可看,默认):")).toLowerCase();
+        if (!answer || answer === "2" || answer === "private" || answer === "私密")
+            return "private";
+        if (answer === "1" || answer === "public" || answer === "公开")
+            return "public";
+        console.log("  请输入 1 或 2");
     }
 }
 async function listDeployments(cfg) {
@@ -376,5 +363,11 @@ export async function deployCommand(cfg, args) {
         },
     });
     rememberSite(selection.dir, start.slug || name || start.site);
+    // 部署过一次之后,会话里不再推「u1s1 deploy 一键上线」
+    markNudge("deploy_done");
     printDeploymentResult(result, start);
+    await sendTelemetryEvent(cfg, "deploy_done", {
+        public: result.visibility === "public",
+        file_count: result.file_count,
+    });
 }

package/dist/embed.d.ts

@@ -9,3 +9,4 @@ export { apiOrigin, pollDeviceLogin, startDeviceLogin, type DeviceStart } from "
 export { prepareWebEnv, refreshWebModels } from "./web.js";
 export { applyWebUiBranding } from "./webui-brand.js";
 export { DASHBOARD_URL } from "./brand.js";
+export { hasNudge, markNudge, readNudges, type NudgeKey } from "./nudges.js";

package/dist/embed.js

@@ -9,3 +9,4 @@ export { apiOrigin, pollDeviceLogin, startDeviceLogin } from "./login.js";
 export { prepareWebEnv, refreshWebModels } from "./web.js";
 export { applyWebUiBranding } from "./webui-brand.js";
 export { DASHBOARD_URL } from "./brand.js";
+export { hasNudge, markNudge, readNudges } from "./nudges.js";

package/dist/error-humanize.d.ts

@@ -1,15 +1,3 @@
-/**
- * 模型调用失败时,网关的中文说明会被 OpenAI SDK + pi-ai 包成
- * `429: {"message":"…","type":"…","code":"…"}` 直出到聊天区。
- * 这里把 JSON 里的 message 提出来当正文,状态码与错误代号收进尾巴。
- *
- * 尾巴不是装饰,必须保留:pi 按 errorMessage 正则做三类分类——
- * - 重试:429/5xx 数字、rate_limit、fetch failed 等(retry.js RETRYABLE)
- * - 不重试:insufficient_quota(额度用尽时快速失败,不做无谓退避)
- * - 上下文超长:context_length_exceeded(触发自动压缩而非重试)
- * 改写后的文本必须与原文落进同一分类,否则会破坏重试/压缩行为。
- *
- * 网关会在错误 JSON 里注入 error.request_id(见 gateway request-id.ts),
- * 拼进尾巴让用户报障时有编号可给,客服凭它直查日志和 usage 记录。
- */
+/** 只取错误里的 request_id(纯函数,给 request-trace 记「最近一次请求编号」用)。 */
+export declare function extractRequestId(raw: string): string | undefined;
 export declare function humanizeModelError(raw: string): string | undefined;

package/dist/error-humanize.js

@@ -12,7 +12,7 @@
  * 网关会在错误 JSON 里注入 error.request_id(见 gateway request-id.ts),
  * 拼进尾巴让用户报障时有编号可给,客服凭它直查日志和 usage 记录。
  */
-export function humanizeModelError(raw) {
+function parseErrorPayload(raw) {
     const jsonStart = raw.indexOf("{");
     const jsonEnd = raw.lastIndexOf("}");
     if (jsonStart === -1 || jsonEnd <= jsonStart)
@@ -30,6 +30,19 @@ export function humanizeModelError(raw) {
     const err = root["error"] !== null && typeof root["error"] === "object"
         ? root["error"]
         : root;
+    return { err, jsonStart };
+}
+/** 只取错误里的 request_id(纯函数,给 request-trace 记「最近一次请求编号」用)。 */
+export function extractRequestId(raw) {
+    const payload = parseErrorPayload(raw);
+    const id = payload?.err["request_id"];
+    return typeof id === "string" && id.length > 0 && id.length <= 128 ? id : undefined;
+}
+export function humanizeModelError(raw) {
+    const payload = parseErrorPayload(raw);
+    if (!payload)
+        return undefined;
+    const { err, jsonStart } = payload;
     const message = typeof err["message"] === "string" ? err["message"].trim() : "";
     if (!message)
         return undefined;

package/dist/feedback.d.ts

@@ -0,0 +1,66 @@
+import { type CliConfig } from "./config.js";
+/**
+ * `u1s1 feedback [text]` / 会话内 `/feedback`:一条命令直接建工单,并附上
+ * 版本、平台、最近一次请求编号等诊断快照(运营清单 E4),不用再手写邮件。
+ * 走 POST /v1/support/tickets(设备签名),201 返回 {id, url}。
+ */
+export declare const FEEDBACK_CATEGORIES: readonly ["question", "bug", "billing", "suggestion", "other"];
+export type FeedbackCategory = (typeof FEEDBACK_CATEGORIES)[number];
+export declare const FEEDBACK_SUBJECT_MAX = 50;
+export declare const FEEDBACK_MESSAGE_MAX = 4000;
+export declare const SUPPORT_URL = "https://u1s1.io/dashboard#sec-support";
+export interface FeedbackArgs {
+    category: FeedbackCategory;
+    text: string;
+    help?: boolean;
+}
+/** `--bug` 等旗标可放在任意位置,其余 token 拼成正文。 */
+export declare function parseFeedbackArgs(args: string[]): FeedbackArgs;
+export interface FeedbackDiagnostics {
+    client_version: string;
+    platform: string;
+    node_version: string;
+    request_id?: string;
+    model?: string;
+    /** terminal(u1s1 feedback)/ session(会话内 /feedback) */
+    surface?: string;
+}
+export interface FeedbackRequest {
+    category: FeedbackCategory;
+    subject: string;
+    message: string;
+    diagnostics: FeedbackDiagnostics;
+}
+/** 主题 = 正文首行前 50 字(空白折叠);正文原样保留,超长截断。 */
+export declare function buildFeedbackRequest(input: {
+    text: string;
+    category?: FeedbackCategory;
+    diagnostics: FeedbackDiagnostics;
+}): FeedbackRequest;
+/** 诊断快照:版本/平台/Node/最近请求编号/当前模型。model 由调用方决定来源。 */
+export declare function collectDiagnostics(extra?: {
+    model?: string;
+    surface?: string;
+}): FeedbackDiagnostics;
+export type FeedbackOutcome = {
+    ok: true;
+    id: string;
+    url: string;
+} | {
+    ok: false;
+    status: number;
+    message: string;
+    retryAfterSeconds?: number;
+};
+/** 提交工单;网络错误直接抛,HTTP 错误(含 429)转成结构化结果由调用方措辞。 */
+export declare function submitFeedback(cfg: CliConfig, body: FeedbackRequest): Promise<FeedbackOutcome>;
+/** 结果措辞,终端与会话内共用(每项一行)。 */
+export declare function feedbackOutcomeLines(outcome: FeedbackOutcome): string[];
+export declare function printFeedbackHelp(): void;
+/** 终端命令入口。 */
+export declare function feedbackCommand(args: string[]): Promise<void>;
+/**
+ * 会话内 /feedback:参数字符串按空格切开复用同一套解析;正文为空时由调用方
+ * 先用 ctx.ui.input 问过再传进来。返回要展示的行。
+ */
+export declare function feedbackInSession(rawArgs: string, model?: string): Promise<string[]>;

package/dist/feedback.js

@@ -0,0 +1,200 @@
+import { readJsonResponseCapped } from "./api.js";
+import { loadConfig, PROVIDER_ID, resolvePreferredModel, VERSION } from "./config.js";
+import { authorizedFetch, hasDeviceCredential } from "./device-auth.js";
+import { askLine } from "./prompt.js";
+import { lastRequestId } from "./request-trace.js";
+/**
+ * `u1s1 feedback [text]` / 会话内 `/feedback`:一条命令直接建工单,并附上
+ * 版本、平台、最近一次请求编号等诊断快照(运营清单 E4),不用再手写邮件。
+ * 走 POST /v1/support/tickets(设备签名),201 返回 {id, url}。
+ */
+export const FEEDBACK_CATEGORIES = ["question", "bug", "billing", "suggestion", "other"];
+const CATEGORY_LABELS = {
+    question: "提问",
+    bug: "故障",
+    billing: "计费",
+    suggestion: "建议",
+    other: "其他",
+};
+export const FEEDBACK_SUBJECT_MAX = 50;
+export const FEEDBACK_MESSAGE_MAX = 4_000;
+export const SUPPORT_URL = "https://u1s1.io/dashboard#sec-support";
+const MAX_TICKET_RESPONSE_BYTES = 64 * 1024;
+/** `--bug` 等旗标可放在任意位置,其余 token 拼成正文。 */
+export function parseFeedbackArgs(args) {
+    let category = "other";
+    const words = [];
+    for (const arg of args) {
+        if (arg === "--help" || arg === "-h")
+            return { category, text: "", help: true };
+        if (arg.startsWith("--") && FEEDBACK_CATEGORIES.includes(arg.slice(2))) {
+            category = arg.slice(2);
+            continue;
+        }
+        if (arg.startsWith("--"))
+            throw new Error(`不认识的 feedback 参数:${arg}(可用 --bug --question --suggestion --billing)`);
+        words.push(arg);
+    }
+    return { category, text: words.join(" ").trim() };
+}
+/** 主题 = 正文首行前 50 字(空白折叠);正文原样保留,超长截断。 */
+export function buildFeedbackRequest(input) {
+    const message = input.text.replace(/\r\n?/g, "\n").trim();
+    if (!message)
+        throw new Error("反馈内容不能为空");
+    const firstLine = message.split("\n").find((l) => l.trim())?.replace(/\s+/g, " ").trim() ?? message;
+    const subject = firstLine.length > FEEDBACK_SUBJECT_MAX
+        ? `${firstLine.slice(0, FEEDBACK_SUBJECT_MAX - 1)}…`
+        : firstLine;
+    const diagnostics = { ...input.diagnostics };
+    // 空值不发,免得服务端存一堆 undefined/空串
+    for (const key of Object.keys(diagnostics)) {
+        if (!diagnostics[key])
+            delete diagnostics[key];
+    }
+    return {
+        category: input.category ?? "other",
+        subject,
+        message: message.length > FEEDBACK_MESSAGE_MAX ? message.slice(0, FEEDBACK_MESSAGE_MAX) : message,
+        diagnostics,
+    };
+}
+/** 诊断快照:版本/平台/Node/最近请求编号/当前模型。model 由调用方决定来源。 */
+export function collectDiagnostics(extra = {}) {
+    return {
+        client_version: VERSION,
+        platform: `${process.platform}-${process.arch}`,
+        node_version: process.version,
+        request_id: lastRequestId(),
+        model: extra.model,
+        surface: extra.surface,
+    };
+}
+function preferredModelLabel(cfg) {
+    const ref = resolvePreferredModel(cfg);
+    return ref.provider === PROVIDER_ID ? ref.id : `${ref.provider}/${ref.id}`;
+}
+/** 提交工单;网络错误直接抛,HTTP 错误(含 429)转成结构化结果由调用方措辞。 */
+export async function submitFeedback(cfg, body) {
+    let resp;
+    try {
+        resp = await authorizedFetch(cfg, `${cfg.baseUrl}/support/tickets`, {
+            method: "POST",
+            headers: { "x-u1s1-version": VERSION, "content-type": "application/json" },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(15_000),
+        });
+    }
+    catch {
+        throw new Error(`连不上 ${cfg.baseUrl},检查一下网络?`);
+    }
+    const value = await readJsonResponseCapped(resp, MAX_TICKET_RESPONSE_BYTES).catch(() => null);
+    const data = value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+    if (resp.status === 201 || resp.status === 200) {
+        const id = typeof data?.id === "string" || typeof data?.id === "number" ? String(data.id) : "";
+        const url = typeof data?.url === "string" && data.url.startsWith("https://") ? data.url : SUPPORT_URL;
+        if (!id)
+            return { ok: false, status: resp.status, message: "服务端工单响应格式不正确" };
+        return { ok: true, id, url };
+    }
+    const header = Number(resp.headers.get("retry-after"));
+    const fromBody = Number(data?.error?.retry_after);
+    const retryAfterSeconds = Number.isFinite(header) && header > 0
+        ? header
+        : Number.isFinite(fromBody) && fromBody > 0 ? fromBody : undefined;
+    const message = typeof data?.error?.message === "string"
+        ? data.error.message.slice(0, 500)
+        : resp.status === 401
+            ? "登录已失效,请重新运行 u1s1 login"
+            : `服务端返回 ${resp.status},稍后再试`;
+    return { ok: false, status: resp.status, message, retryAfterSeconds };
+}
+/** 结果措辞,终端与会话内共用(每项一行)。 */
+export function feedbackOutcomeLines(outcome) {
+    if (outcome.ok) {
+        return [
+            `✅ 反馈已提交,工单编号 ${outcome.id}。`,
+            `进度与回复在这里看:${outcome.url}`,
+            "我们通常会在 24 小时内回复到你的注册邮箱。",
+        ];
+    }
+    if (outcome.status === 429) {
+        const wait = outcome.retryAfterSeconds
+            ? `请等 ${Math.ceil(outcome.retryAfterSeconds / 60) || 1} 分钟后再试`
+            : "请稍等几分钟再试";
+        return [`提交太频繁了,${wait}。`, `等不及的话直接到后台留言:${SUPPORT_URL}`];
+    }
+    return [`提交失败:${outcome.message}`, `可以直接到后台留言:${SUPPORT_URL}`];
+}
+export function printFeedbackHelp() {
+    console.log("");
+    console.log("  u1s1 feedback [--bug|--question|--suggestion|--billing] [一句话描述]");
+    console.log("");
+    console.log("    不带描述时会问你一行;分类不写默认「其他」。");
+    console.log("    会自动附上版本、平台、最近一次报错的请求编号,方便我们定位。");
+    console.log(`    也可以在后台留言:${SUPPORT_URL}`);
+    console.log("");
+}
+/** 终端命令入口。 */
+export async function feedbackCommand(args) {
+    const parsed = parseFeedbackArgs(args);
+    if (parsed.help) {
+        printFeedbackHelp();
+        return;
+    }
+    const cfg = loadConfig();
+    if (!hasDeviceCredential(cfg)) {
+        console.error("还没登录,先跑 u1s1 login");
+        process.exitCode = 1;
+        return;
+    }
+    let text = parsed.text;
+    if (!text) {
+        text = await askLine(`  想反馈什么?(${CATEGORY_LABELS[parsed.category]},一行说清即可):`);
+    }
+    if (!text) {
+        console.error("反馈内容不能为空。用法:u1s1 feedback \"一句话描述\"");
+        process.exitCode = 1;
+        return;
+    }
+    const body = buildFeedbackRequest({
+        text,
+        category: parsed.category,
+        diagnostics: collectDiagnostics({ model: preferredModelLabel(cfg), surface: "terminal" }),
+    });
+    const outcome = await submitFeedback(cfg, body);
+    console.log("");
+    for (const line of feedbackOutcomeLines(outcome))
+        console.log(`  ${line}`);
+    console.log("");
+    if (!outcome.ok)
+        process.exitCode = 1;
+}
+/**
+ * 会话内 /feedback:参数字符串按空格切开复用同一套解析;正文为空时由调用方
+ * 先用 ctx.ui.input 问过再传进来。返回要展示的行。
+ */
+export async function feedbackInSession(rawArgs, model) {
+    const parsed = parseFeedbackArgs(rawArgs.split(/\s+/).filter(Boolean));
+    if (parsed.help) {
+        return ["/feedback [--bug|--question|--suggestion|--billing] 一句话描述", `或到后台留言:${SUPPORT_URL}`];
+    }
+    const cfg = loadConfig();
+    if (!hasDeviceCredential(cfg))
+        return ["还没登录,先在终端运行 u1s1 login"];
+    if (!parsed.text)
+        return ["反馈内容不能为空,例如:/feedback --bug 生成的网页打不开"];
+    const body = buildFeedbackRequest({
+        text: parsed.text,
+        category: parsed.category,
+        diagnostics: collectDiagnostics({ model, surface: "session" }),
+    });
+    try {
+        return feedbackOutcomeLines(await submitFeedback(cfg, body));
+    }
+    catch (e) {
+        return [e instanceof Error ? e.message : String(e), `可以直接到后台留言:${SUPPORT_URL}`];
+    }
+}

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("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,13 @@ async function run() {
         console.log("   u1s1 update            升级到最新版");
         console.log("   u1s1 deploy            发布网页(--public / --private)");
         console.log("   u1s1 deploy list       查看已发布的站点");
+        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 +564,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 +641,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.5.0",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {