u1s1-cli 1.4.3 → 1.6.0

package/dist/agent-setup.js

@@ -221,8 +221,10 @@ export function writeWebToolsExtension(cfg, features) {
         `      }\n` +
         `    });\n` +
         `    pi.registerTool(tools.createSubagentTool(getParentModel));\n` +
-        `    const workflow = await import(${JSON.stringify(new URL("./workflow/tool.js", import.meta.url).href)});\n` +
-        `    pi.registerTool(workflow.createRunWorkflowTool(getParentModel));\n` +
+        `    try {\n` +
+        `      const workflow = await import(${JSON.stringify(new URL("./workflow/tool.js", import.meta.url).href)});\n` +
+        `      pi.registerTool(workflow.createRunWorkflowTool(getParentModel));\n` +
+        `    } catch {}\n` +
         `  }\n`;
     // 密钥剥离守卫也从这里装:Desktop App 的 pi 跑在 pi-web-ui 子进程里,没有
     // 启动器代码,只有扩展能替它把 U1S1_API_KEY / U1S1_EP_KEY_* 挡在子进程之外
@@ -232,7 +234,17 @@ export function writeWebToolsExtension(cfg, features) {
         `  (await import(${JSON.stringify(secretEnvUrl)})).installChildEnvGuard();\n` +
         `  if (process.env.U1S1_TOOLS_VIA_EXTENSION !== "1") return;\n` +
         `  const baseUrl = process.env.U1S1_SIGNING_PROXY_URL || ${JSON.stringify(cfg.baseUrl)};\n` +
-        `  const tools = await import(${JSON.stringify(toolsUrl)});\n` +
+        // 升级半途 / 权限问题导致 CLI dist 不可读时,宁可这一会话没有联网工具,
+        // 也不能让扩展加载失败刷英文堆栈(审计 B4);只在 UI 里提示一句中文
+        `  let tools;\n` +
+        `  try {\n` +
+        `    tools = await import(${JSON.stringify(toolsUrl)});\n` +
+        `  } catch {\n` +
+        `    pi.on("session_start", (_event, ctx) => {\n` +
+        `      try { if (ctx.hasUI) ctx.ui.notify("联网工具本次未能加载(程序文件可能正在更新),重启 u1s1 即可恢复", "warning"); } catch {}\n` +
+        `    });\n` +
+        `    return;\n` +
+        `  }\n` +
         searchLine +
         `  pi.registerTool(tools.createFetchTool({ baseUrl, apiKey: process.env.U1S1_API_KEY, renderFallback: ${features.webFetchRender} }));\n` +
         imageLine +
@@ -251,17 +263,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` +
@@ -287,7 +303,12 @@ export function writeAnnouncementsExtension() {
         `  } catch {\n` +
         `    return;\n` +
         `  }\n` +
-        `  const { Text } = await import("@earendil-works/pi-tui");\n` +
+        `  let Text;\n` +
+        `  try {\n` +
+        `    Text = (await import("@earendil-works/pi-tui")).Text;\n` +
+        `  } catch {\n` +
+        `    return;\n` +
+        `  }\n` +
         `  pi.registerEntryRenderer("u1s1-announcement", (entry, _opts, theme) => {\n` +
         `    const d = entry.data ?? {};\n` +
         `    let text = theme.fg("text", theme.bold("📢 " + String(d.text ?? "")));\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.d.ts

@@ -1,4 +1,9 @@
 import { type CliConfig } from "./config.js";
+/**
+ * `u1s1 deploy remove` 的站点参数可以是 slug、完整网址或域名:
+ * `my-site` / `https://my-site.u1abc123.u1s1.app/` / `my-site.u1abc123.u1s1.app` 都指向 my-site。
+ */
+export declare function siteReferenceFromInput(input: string): string;
 interface SiteFile {
     path: string;
     abs: string;

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.
@@ -36,6 +38,30 @@ function rememberSite(dir, site) {
         // ignore
     }
 }
+/** 站点删掉后把 deploys.json 里指向它的目录记录一并清掉,下次 deploy 重新问名字。 */
+function forgetSite(site) {
+    try {
+        const all = readDeploys();
+        const remaining = Object.fromEntries(Object.entries(all).filter(([, value]) => value !== site));
+        if (Object.keys(remaining).length !== Object.keys(all).length) {
+            writeFileSync(deploysFile, JSON.stringify(remaining, null, 2) + "\n");
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+/**
+ * `u1s1 deploy remove` 的站点参数可以是 slug、完整网址或域名:
+ * `my-site` / `https://my-site.u1abc123.u1s1.app/` / `my-site.u1abc123.u1s1.app` 都指向 my-site。
+ */
+export function siteReferenceFromInput(input) {
+    let value = input.trim().toLowerCase();
+    value = value.replace(/^[a-z]+:\/\//, "");
+    value = value.replace(/[/?#].*$/, "");
+    const firstLabel = value.split(".")[0] ?? "";
+    return firstLabel;
+}
 /** 找要部署的目录:显式参数 > 含 index.html 的构建产物目录 > 当前目录本身。 */
 function resolveSiteDir(explicit) {
     if (explicit) {
@@ -211,33 +237,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) {
@@ -255,6 +266,44 @@ async function listDeployments(cfg) {
     }
     console.log("");
 }
+async function confirmRemoval(url) {
+    const answer = (await askLine(`  确定删除 ${url} 吗?网址会立即失效,站点文件会被清除,无法恢复。输入 y 确认:`)).toLowerCase();
+    return answer === "y" || answer === "yes";
+}
+async function removeDeployment(cfg, args) {
+    const yes = args.some((arg) => arg === "--yes" || arg === "-y");
+    const positional = args.filter((arg) => !arg.startsWith("-"));
+    if (positional.length !== 1) {
+        throw new Error("用法:u1s1 deploy remove <站点名或网址> [--yes]");
+    }
+    const reference = siteReferenceFromInput(positional[0]);
+    if (!reference)
+        throw new Error("站点名不能为空");
+    // 先按列表核对,拿到完整网址给确认提示;名字打错在这里就能提前发现
+    const { sites } = await api(cfg, { method: "GET", path: "/deploy/sites" });
+    const site = sites.find((s) => (s.slug || s.name) === reference || s.name === reference);
+    if (!site) {
+        throw new Error(`没有找到站点「${reference}」。运行 u1s1 deploy list 查看已有站点`);
+    }
+    if (!yes) {
+        if (!process.stdin.isTTY) {
+            throw new Error("非交互环境下删除站点需要加 --yes 明确确认");
+        }
+        if (!(await confirmRemoval(site.url))) {
+            console.log("  已取消,站点保留。");
+            return;
+        }
+    }
+    await api(cfg, {
+        method: "DELETE",
+        path: `/deploy/sites/${encodeURIComponent(site.name)}`,
+    });
+    forgetSite(site.slug || site.name);
+    console.log("");
+    console.log(`  ✓ 已删除 ${site.url}`);
+    console.log("  同一个名字可以再次 u1s1 deploy 重新发布。");
+    console.log("");
+}
 async function selectDeployment(args) {
     const parsed = parseDeployArgs(args);
     let { name, dirArg, visibility } = parsed;
@@ -349,11 +398,13 @@ export function printDeployHelp() {
     console.log("    不带参数时自动找构建产物目录(dist/build/out 等),否则用当前目录。");
     console.log("    首次发布会问项目名和公开/私密,之后记住;再跑一次即为更新。");
     console.log("");
-    console.log("  u1s1 deploy list    查看已发布的站点");
+    console.log("  u1s1 deploy list                    查看已发布的站点");
+    console.log("  u1s1 deploy remove <站点名或网址>    删除站点(会二次确认,--yes 跳过)");
     console.log("");
 }
 export async function deployCommand(cfg, args) {
-    // 参数:[dir] [--name xxx] [--public|--private];u1s1 deploy list 列出已有站点
+    // 参数:[dir] [--name xxx] [--public|--private];u1s1 deploy list 列出已有站点;
+    // u1s1 deploy remove <站点> 删除站点(rm/delete 同义)
     if (args.includes("--help") || args.includes("-h")) {
         printDeployHelp();
         return;
@@ -362,6 +413,10 @@ export async function deployCommand(cfg, args) {
         await listDeployments(cfg);
         return;
     }
+    if (args[0] === "remove" || args[0] === "rm" || args[0] === "delete") {
+        await removeDeployment(cfg, args.slice(1));
+        return;
+    }
     const selection = await selectDeployment(args);
     const { name, start } = await startDeployment(cfg, selection.name);
     validateDeploymentLimits(start, selection.files, selection.totalBytes);
@@ -376,5 +431,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

@@ -11,5 +11,11 @@
  *
  * 网关会在错误 JSON 里注入 error.request_id(见 gateway request-id.ts),
  * 拼进尾巴让用户报障时有编号可给,客服凭它直查日志和 usage 记录。
+ *
+ * 额度用尽(reason=exhausted)时网关还带 error.resets_at(免费池刷新时刻,ISO),
+ * 这里换算成「距刷新还有 N 小时 M 分」接在正文后:比「北京时间 0 点」更省用户脑子。
  */
-export declare function humanizeModelError(raw: string): string | undefined;
+export declare function quotaResetHint(resetsAt: unknown, now?: number): string;
+/** 只取错误里的 request_id(纯函数,给 request-trace 记「最近一次请求编号」用)。 */
+export declare function extractRequestId(raw: string): string | undefined;
+export declare function humanizeModelError(raw: string, now?: number): string | undefined;

package/dist/error-humanize.js

@@ -11,8 +11,25 @@
  *
  * 网关会在错误 JSON 里注入 error.request_id(见 gateway request-id.ts),
  * 拼进尾巴让用户报障时有编号可给,客服凭它直查日志和 usage 记录。
+ *
+ * 额度用尽(reason=exhausted)时网关还带 error.resets_at(免费池刷新时刻,ISO),
+ * 这里换算成「距刷新还有 N 小时 M 分」接在正文后:比「北京时间 0 点」更省用户脑子。
  */
-export function humanizeModelError(raw) {
+export function quotaResetHint(resetsAt, now = Date.now()) {
+    if (typeof resetsAt !== "string")
+        return "";
+    const at = Date.parse(resetsAt);
+    if (!Number.isFinite(at))
+        return "";
+    const remainingMinutes = Math.ceil((at - now) / 60_000);
+    if (remainingMinutes <= 0 || remainingMinutes > 48 * 60)
+        return "";
+    const hours = Math.floor(remainingMinutes / 60);
+    const minutes = remainingMinutes % 60;
+    const span = hours > 0 ? `${hours} 小时${minutes > 0 ? ` ${minutes} 分` : ""}` : `${minutes} 分`;
+    return `距免费额度刷新还有 ${span}`;
+}
+function parseErrorPayload(raw) {
     const jsonStart = raw.indexOf("{");
     const jsonEnd = raw.lastIndexOf("}");
     if (jsonStart === -1 || jsonEnd <= jsonStart)
@@ -30,6 +47,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, now = Date.now()) {
+    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;
@@ -42,6 +72,8 @@ export function humanizeModelError(raw) {
         type === "insufficient_quota" || code === "quota_exceeded" ? "insufficient_quota" : code,
         requestId ? `请求编号 ${requestId}` : "",
     ].filter(Boolean);
-    const friendly = tags.length ? `${message} (${tags.join(" · ")})` : message;
+    const resetHint = err["reason"] === "exhausted" ? quotaResetHint(err["resets_at"], now) : "";
+    const body = resetHint ? `${message}〔${resetHint}〕` : message;
+    const friendly = tags.length ? `${body} (${tags.join(" · ")})` : body;
     return friendly === raw ? undefined : friendly;
 }

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}`];
+    }
+}