dsh-plugin-update 0.2.0 → 0.3.0

package/dist/panel.js

@@ -0,0 +1,1300 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/panel.ts
+import { buildPhoneNames, DEFAULT_PANEL_POLL_MS, MIN_PANEL_POLL_MS } from "./config.js";
+import { COPY_BUDGET_CHARS, sanitizeForCopy } from "./redaction.js";
+import { validReleaseVersion } from "./service.js";
+import {
+  changelogForUpdate,
+  parseChangelog,
+  renderChangelogHTML
+} from "./changelog.js";
+const BLOCKED_COPY = {
+  "unknown-profile": {
+    title: "\u4F7F\u7528\u8303\u56F4\u6216\u63D2\u4EF6\u4F4D\u7F6E\u8BA4\u4E0D\u51FA",
+    action: "\u91CD\u5F00\u5BBF\u4E3B\u518D\u67E5\u4E00\u6B21\uFF1B\u4E00\u76F4\u8FD9\u6837\u5C31\u628A\u7248\u672C\u53F7\u4E0E\u65E5\u5FD7\u4EA4\u7ED9\u63D2\u4EF6\u4F5C\u8005\uFF1B\u8FD9\u79CD\u60C5\u5F62\u4E0D\u7ED9\u624B\u5DE5\u547D\u4EE4"
+  },
+  "source-install": {
+    title: "\u5F53\u524D\u662F\u4ECE\u6E90\u7801\u88C5\u7684\uFF0C\u4E0D\u662F\u6309\u7248\u672C\u53F7\u88C5\u7684",
+    action: "\u8FD9\u79CD\u60C5\u5F62\u4E0D\u7ED9\u624B\u5DE5\u547D\u4EE4\uFF1B\u60F3\u8D70\u66F4\u65B0\u5148\u6309\u7248\u672C\u53F7\u91CD\u88C5\u4E00\u6B21"
+  },
+  "invalid-installation": {
+    title: "\u5DF2\u88C5\u7684\u5305\u4E0D\u5B8C\u6574\uFF08\u540D\u5B57\u5BF9\u4E0D\u4E0A\u3001\u7248\u672C\u975E\u6CD5\u3001\u5165\u53E3\u6587\u4EF6\u7F3A\u5931\uFF09",
+    action: "\u91CD\u88C5\u5F53\u524D\u7248\u672C\uFF0C\u4FEE\u597D\u5DF2\u88C5\u76EE\u5F55\u518D\u67E5\u66F4\u65B0"
+  },
+  "installation-changed": {
+    title: "\u5B89\u88C5\u4F4D\u7F6E\u5728\u4F7F\u7528\u4E2D\u9014\u53D8\u4E86\uFF08\u6362\u4E86\u76EE\u5F55\u6216\u6362\u4E86\u5305\uFF09",
+    action: "\u91CD\u65B0\u6253\u5F00\u5BBF\u4E3B\u518D\u67E5\u4E00\u6B21\uFF1B\u8FD8\u51FA\u73B0\u5C31\u91CD\u88C5"
+  },
+  "pending-restart": {
+    title: "\u65B0\u7248\u5DF2\u88C5\u5230\u78C1\u76D8\uFF0C\u6B63\u5728\u8DD1\u7684\u8FD8\u662F\u65E7\u7248",
+    action: "\u91CD\u542F\u5BBF\u4E3B\uFF0C\u8BA9\u65B0\u7248\u8DD1\u8D77\u6765\uFF1B\u8FD9\u662F\u6B63\u5E38\u7EC8\u6001\uFF0C\u4E0D\u662F\u5931\u8D25"
+  },
+  "registry-conflict": {
+    title: "\u672C\u5730\u58F0\u660E\u7684\u7248\u672C\u4E0E\u78C1\u76D8\u5B9E\u9645\u7248\u672C\u4E92\u76F8\u77DB\u76FE",
+    action: "\u6253\u5F00\u4F7F\u7528\u8303\u56F4\u7684\u6E05\u5355\u6587\u4EF6\uFF0C\u628A\u76EE\u6807\u5305\u540D\u90A3\u4E00\u884C\u6539\u6210\u7248\u672C\u53F7\u518D\u8BD5"
+  },
+  "incompatible-node": {
+    title: "\u65B0\u7248\u8981\u6C42\u7684 Node \u4E0E\u5F53\u524D\u8FD0\u884C\u7684\u5BF9\u4E0D\u4E0A",
+    action: "\u5148\u5347\u7EA7 Node \u5230 22 \u6216\u66F4\u9AD8\uFF0C\u518D\u67E5\u66F4\u65B0"
+  },
+  "recovery-required": {
+    title: "\u4E0A\u6B21\u5B89\u88C5\u88AB\u6253\u65AD\uFF0C\u7559\u4E0B\u4E00\u4E2A\u534A\u622A\u4EFB\u52A1",
+    action: "\u91CD\u65B0\u70B9\u4E00\u6B21\u5B89\u88C5\uFF1B\u4E00\u76F4\u51FA\u73B0\u5C31\u6309\u7B2C 6 \u8282\u6392\u9519"
+  }
+};
+function blockedCopy(reason) {
+  if (reason === null || reason === void 0) return null;
+  return BLOCKED_COPY[reason] ?? null;
+}
+const PHONE_FAILURE_COPY = {
+  "check-failed": {
+    zh: "\u67E5\u65B0\u7248\u6CA1\u6210\u529F\uFF08\u8054\u7F51\u3001\u6E90\u3001\u9650\u6D41\u90FD\u53EF\u80FD\uFF09",
+    act: "\u8FC7\u4E00\u4F1A\u513F\u518D\u67E5\u4E00\u6B21\uFF1B\u4E00\u76F4\u5931\u8D25\u5C31\u628A\u590D\u5236\u8BCA\u65AD\u4EA4\u7ED9\u63D2\u4EF6\u4F5C\u8005"
+  },
+  "invalid-release": {
+    zh: "\u62FF\u5230\u7684\u53D1\u5E03\u4FE1\u606F\u4E0D\u5408\u6CD5\uFF08\u7248\u672C\u53F7\u975E\u6CD5\u6216\u5185\u5BB9\u5BF9\u4E0D\u4E0A\uFF09",
+    act: "\u68C0\u67E5\u6E05\u5355\u6587\u4EF6\u91CC\u7684\u5305\u540D\u4E0E\u7248\u672C\u5199\u6CD5\uFF0C\u518D\u67E5\u4E00\u6B21"
+  },
+  "check-expired": {
+    zh: "\u51ED\u8BC1\u8FC7\u671F\u4E86\uFF0C\u5B89\u88C5\u8BF7\u6C42\u88AB\u62D2",
+    act: "\u91CD\u65B0\u67E5\u4E00\u6B21\u65B0\u7248\u518D\u70B9\u5B89\u88C5\uFF0C\u4E0D\u8981\u91CD\u8BD5\u65E7\u7F16\u53F7"
+  },
+  "update-busy": {
+    zh: "\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u6B63\u5728\u88C5\u53E6\u4E00\u4E2A",
+    act: "\u7B49\u5F53\u524D\u4EFB\u52A1\u79BB\u5F00 installing/verifying \u518D\u70B9\uFF1B\u6392\u961F\u4E2D\u53BB\u67E5\u72B6\u6001\u770B\u4F4D\u7F6E"
+  },
+  "install-failed": {
+    zh: "\u88C5\u4E0D\u4E0A\uFF08\u8BE6\u89C1\u8BCA\u65AD\u6458\u8981\uFF09",
+    act: "\u5148\u770B\u590D\u5236\u8BCA\u65AD\uFF1B\u5B98\u65B9\u684C\u9762\u7248\u628A\u8FD9\u6BB5\u4EA4\u7ED9\u63D2\u4EF6\u4F5C\u8005"
+  },
+  internal: {
+    zh: "\u51FA\u4E86\u70B9\u95EE\u9898\uFF0C\u8BA4\u4E0D\u51FA\u5177\u4F53\u539F\u56E0",
+    act: "\u5148\u91CD\u8BD5\u4E00\u6B21\uFF1B\u4E00\u76F4\u8FD9\u6837\u5C31\u628A\u590D\u5236\u8BCA\u65AD\u4EA4\u7ED9\u63D2\u4EF6\u4F5C\u8005"
+  }
+};
+const UNKNOWN_FAILURE_COPY = {
+  zh: "\u51FA\u4E86\u70B9\u95EE\u9898\uFF0C\u8BA4\u4E0D\u51FA\u5177\u4F53\u539F\u56E0",
+  act: "\u5148\u91CD\u8BD5\u4E00\u6B21\uFF1B\u4E00\u76F4\u8FD9\u6837\u5C31\u628A\u590D\u5236\u8BCA\u65AD\u4EA4\u7ED9\u63D2\u4EF6\u4F5C\u8005\uFF08\u5E26\u4E0A\u4F60\u770B\u5230\u7684\u7801\uFF09"
+};
+function isKnownFailureCode(code) {
+  if (typeof code !== "string" || !code) return false;
+  const c = code.trim();
+  if (!c) return false;
+  return c in BLOCKED_COPY || c in PHONE_FAILURE_COPY;
+}
+function failureCopy(code) {
+  if (typeof code !== "string") return null;
+  const c = code.trim();
+  if (!c) return null;
+  const blocked = BLOCKED_COPY[c];
+  if (blocked) return { zh: blocked.title, act: blocked.action };
+  const phone = PHONE_FAILURE_COPY[c];
+  if (phone) return phone;
+  return UNKNOWN_FAILURE_COPY;
+}
+function failureCodeOf(reply, fallback) {
+  const kind = reply && typeof reply.errorKind === "string" ? reply.errorKind.trim() : "";
+  if (kind) return kind;
+  const err = reply && typeof reply.error === "string" ? reply.error.trim() : "";
+  if (err) return err;
+  if (typeof fallback === "string" && fallback.trim()) return fallback.trim();
+  return "internal";
+}
+const PANEL_DIAG_MAX_CHARS = COPY_BUDGET_CHARS;
+function redactForCopy(text) {
+  return sanitizeForCopy(text);
+}
+function buildDiagnosticText(input) {
+  const code = String(input.code || "check-failed");
+  const lines = [`[\u66F4\u65B0\u8BCA\u65AD] ${String(input.pluginId)} \u7A33\u5B9A\u7801\uFF1A${code}`];
+  const detail = redactForCopy(input.detail ?? "");
+  lines.push(`\u4EBA\u8BDD\uFF1A${detail || failureCopy(code)?.act || code}`);
+  const versions = [
+    `\u8FD0\u884C\u7248\uFF1A${input.runningVersion ?? "\u672A\u77E5"}`,
+    `\u5DF2\u88C5\uFF1A${input.installedVersion ?? "\u672A\u77E5"}`,
+    `\u8FDC\u7AEF\uFF1A${input.latestVersion ?? "\u672A\u67E5\u8FC7"}`
+  ].join(" / ");
+  lines.push(versions);
+  const queue = input.queuePosition === 0 ? "\u6B63\u5728\u5B89\u88C5" : typeof input.queuePosition === "number" ? `\u6392\u961F\u7B2C ${input.queuePosition} \u4F4D` : "\u4E0D\u5728\u961F\u5217\u91CC";
+  const hostLine = [`\u5BBF\u4E3B\uFF1A${input.hostKind ?? "\u672A\u77E5"}`];
+  if (typeof input.profileName === "string" && input.profileName) hostLine.push(`\u4F7F\u7528\u8303\u56F4\uFF1A${input.profileName}`);
+  hostLine.push(`\u961F\u5217\uFF1A${queue}`);
+  lines.push(hostLine.join(" / ") + (input.requestId ? ` / \u8BF7\u6C42\u7F16\u53F7\uFF1A${input.requestId}` : ""));
+  const manual = redactForCopy(input.manual ?? "");
+  if (manual) lines.push(`\u624B\u5DE5\u547D\u4EE4\uFF1A${manual}`);
+  return redactForCopy(lines.join("\n"));
+}
+const DIAG_KNOWN_TYPES = {
+  v: "number",
+  stage: "string",
+  route: "string",
+  method: "string",
+  httpStatus: "number",
+  exitCode: "number",
+  latencyMs: "number",
+  detail: "string",
+  targetPackageName: "string",
+  runningVersion: "string",
+  latestVersion: "string",
+  environmentKind: "string",
+  requestId: "string",
+  checkId: "string",
+  registryHost: "string",
+  action: "string"
+};
+function readDiagTolerant(diag) {
+  const empty = {
+    stage: null,
+    route: null,
+    method: null,
+    httpStatus: null,
+    exitCode: null,
+    latencyMs: null,
+    detail: null,
+    targetPackageName: null,
+    runningVersion: null,
+    latestVersion: null,
+    environmentKind: null,
+    requestId: null,
+    checkId: null,
+    registryHost: null,
+    action: null,
+    unknownKeys: []
+  };
+  if (!diag || typeof diag !== "object" || Array.isArray(diag)) return empty;
+  const raw = diag;
+  const out = { ...empty, unknownKeys: [] };
+  for (const key of Object.keys(DIAG_KNOWN_TYPES)) {
+    if (!Object.prototype.hasOwnProperty.call(raw, key)) continue;
+    const v = raw[key];
+    if (v === void 0 || v === null) continue;
+    if (typeof v !== DIAG_KNOWN_TYPES[key]) continue;
+    out[key] = v;
+  }
+  for (const key of Object.keys(raw)) {
+    if (!Object.prototype.hasOwnProperty.call(DIAG_KNOWN_TYPES, key)) out.unknownKeys.push(key);
+  }
+  return out;
+}
+function pickText(value, fallback) {
+  if (typeof value === "string" && value.trim()) return value.trim();
+  return fallback;
+}
+function queueTextOf(queuePosition, _diagQueuePos) {
+  void _diagQueuePos;
+  const pos = typeof queuePosition === "number" ? queuePosition : null;
+  if (pos === 0) return "\u6B63\u5728\u5B89\u88C5";
+  if (typeof pos === "number") return `\u6392\u961F\u7B2C ${pos} \u4F4D`;
+  return "\u4E0D\u5728\u961F\u5217\u91CC";
+}
+function buildUpdateDiagCopy(input) {
+  const rawCode = String(input.code ?? "").trim() || "internal";
+  const copy = failureCopy(rawCode) ?? UNKNOWN_FAILURE_COPY;
+  const diag = readDiagTolerant(input.diag);
+  const detailRaw = diag.detail ?? input.detail ?? "";
+  const detail = redactForCopy(detailRaw) || "\uFF08\u672C\u56DE\u5305\u6CA1\u6709\u5E26\u8BCA\u65AD\u6458\u8981\uFF0C\u7B49\u7535\u8BDD\u4FA7 diag \u843D\u5B9A\u540E\u8865\u9F50\uFF09";
+  const pluginName = pickText(diag.targetPackageName ?? input.pluginId, "(\u672A\u77E5\u5305)");
+  const runVer = pickText(diag.runningVersion ?? input.runningVersion, "?");
+  const instVer = pickText(input.installedVersion ?? diag.latestVersion, "?");
+  const host = pickText(diag.environmentKind ?? input.hostKind, "\u672A\u77E5");
+  const routeRaw = diag.route ?? input.route;
+  const requestRaw = diag.requestId ?? input.requestId;
+  const checkRaw = diag.checkId ?? input.checkId;
+  const queue = queueTextOf(input.queuePosition ?? null);
+  const prov = [`\u63D2\u4EF6=${pluginName}`, `\u7248\u672C=${runVer}\u2192${instVer}`, `\u5BBF\u4E3B=${host}`];
+  if (typeof routeRaw === "string" && routeRaw.trim()) prov.push(`\u8DEF\u7531=${routeRaw.trim()}`);
+  if (diag.stage) prov.push(`\u9636\u6BB5=${diag.stage}`);
+  if (diag.method) prov.push(`\u65B9\u6CD5=${diag.method}`);
+  if (typeof diag.httpStatus === "number") prov.push(`HTTP=${diag.httpStatus}`);
+  if (typeof diag.exitCode === "number") prov.push(`exit=${diag.exitCode}`);
+  if (typeof diag.latencyMs === "number") prov.push(`\u8017\u65F6=${diag.latencyMs}ms`);
+  if (diag.registryHost) prov.push(`\u6E90=${diag.registryHost}`);
+  else prov.push("\u6E90=\u672A\u77E5\uFF08\u975E\u5B98\u65B9\u6E90\u65F6\u7701\u7565\u672C\u8EAB\u5373\u4FE1\u606F\uFF09");
+  if (diag.action) prov.push(`\u5EFA\u8BAE=${diag.action}`);
+  if (typeof requestRaw === "string" && requestRaw.trim()) prov.push(`\u8BF7\u6C42=${requestRaw.trim()}`);
+  if (typeof checkRaw === "string" && checkRaw.trim()) prov.push(`\u68C0\u67E5=${checkRaw.trim()}`);
+  prov.push(`\u961F\u5217=${queue}`);
+  const format = input.format === "line" ? "line" : "block";
+  const provLine = redactForCopy(prov.join(" \xB7 "));
+  if (format === "line") {
+    const line = `[update-diag] code=${rawCode} \xB7 ${copy.zh} \xB7 \u6458\u8981=${detail} \xB7 ${provLine} \xB7 \u600E\u4E48\u529E=${copy.act}`;
+    return redactForCopy(line);
+  }
+  const block = [
+    `[update-diag] ${rawCode} \u2014 ${copy.zh}`,
+    `  \u6458\u8981\uFF1A${detail}`,
+    `  \u6765\u6E90\uFF1A${provLine}`,
+    `  \u600E\u4E48\u529E\uFF1A${copy.act}`
+  ].join("\n");
+  return block;
+}
+const PANEL_SKIPPED_MAX = 50;
+function panelSkipKey(pluginId) {
+  return `dsh-upd-skipped/${String(pluginId)}`;
+}
+function normalizePanelSkipped(raw) {
+  if (!raw || typeof raw !== "object") return [];
+  const list = raw.skipped;
+  if (!Array.isArray(list)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const item of list) {
+    if (!item || typeof item !== "object") continue;
+    const version = item.version;
+    if (!validReleaseVersion(version) || seen.has(version)) continue;
+    seen.add(version);
+    const at = item.skippedAt;
+    out.push({ version, skippedAt: typeof at === "number" && Number.isFinite(at) ? at : 0 });
+  }
+  return out.slice(0, PANEL_SKIPPED_MAX);
+}
+function createMemorySkipStore(now = Date.now) {
+  let skipped = [];
+  function assertVersion(version) {
+    if (!validReleaseVersion(version)) {
+      throw new Error(`[dsh-plugin-update] \u8DF3\u8FC7\u7248\u672C\u53F7\u975E\u6CD5\uFF1A\u987B\u4E3A\u53D1\u884C\u7248\u672C\u53F7\uFF08\u6536\u5230 ${JSON.stringify(version)}\uFF09`);
+    }
+    return version;
+  }
+  return {
+    list: () => skipped.map((e) => e.version),
+    has: (version) => validReleaseVersion(version) ? skipped.some((e) => e.version === version) : false,
+    skip: (version) => {
+      const v = assertVersion(version);
+      const at = now();
+      skipped = [{ version: v, skippedAt: typeof at === "number" && Number.isFinite(at) ? at : 0 }].concat(skipped.filter((e) => e.version !== v)).slice(0, PANEL_SKIPPED_MAX);
+    },
+    reset: (version) => {
+      if (version === void 0) skipped = [];
+      else skipped = skipped.filter((e) => e.version !== version);
+    }
+  };
+}
+function probeStorage(candidate) {
+  try {
+    if (!candidate || typeof candidate !== "object") return null;
+    const s = candidate;
+    if (typeof s.getItem !== "function" || typeof s.setItem !== "function" || typeof s.removeItem !== "function") return null;
+    return s;
+  } catch {
+    return null;
+  }
+}
+function createBrowserSkipStore(pluginId, storage, now = Date.now) {
+  const memory = createMemorySkipStore(now);
+  const store = probeStorage(storage) ?? probeStorage(globalThis["localStorage"] ?? null) ?? null;
+  if (!store) return memory;
+  const active = store;
+  const key = panelSkipKey(pluginId);
+  function read() {
+    try {
+      const raw = active.getItem(key);
+      if (!raw) return [];
+      return normalizePanelSkipped(JSON.parse(raw));
+    } catch {
+      return [];
+    }
+  }
+  function write(entries) {
+    try {
+      active.setItem(key, JSON.stringify({ skipped: entries }));
+    } catch {
+    }
+  }
+  try {
+    for (const e of read()) memory.skip(e.version);
+  } catch {
+  }
+  return {
+    list: () => memory.list(),
+    has: (version) => memory.has(version),
+    skip: (version) => {
+      memory.skip(version);
+      write(normalizePanelSkipped({ skipped: memory.list().map((v) => ({ version: v, skippedAt: now() })) }));
+    },
+    reset: (version) => {
+      memory.reset(version);
+      if (version === void 0) {
+        try {
+          active.removeItem(key);
+        } catch {
+        }
+      } else {
+        write(normalizePanelSkipped({ skipped: memory.list().map((v) => ({ version: v, skippedAt: now() })) }));
+      }
+    }
+  };
+}
+const SEAL_BY_KIND = {
+  loading: { text: "\u5F85\u67E5", mini: "\u67E5", tone: "ink" },
+  idle: { text: "\u5F85\u67E5", mini: "\u67E5", tone: "ink" },
+  update: { text: "\u53EF\u88C5", mini: "\u88C5", tone: "green" },
+  busy: { text: "\u5B89\u88C5\u4E2D", mini: "\u88C5", tone: "yellow" },
+  restart: { text: "\u5F85\u91CD\u542F", mini: "\u542F", tone: "yellow" },
+  blocked: { text: "\u53D7\u963B", mini: "\u963B", tone: "red" },
+  failed: { text: "\u53D7\u963B", mini: "\u963B", tone: "red" },
+  done: { text: "\u5DF2\u6700\u65B0", mini: "\u5B9A", tone: "green" }
+};
+function messageCodeOf(message) {
+  if (typeof message !== "string" || !message) return "";
+  const at = message.indexOf(":");
+  return (at < 0 ? message : message.slice(0, at)).trim();
+}
+function panelViewModel(input) {
+  const view = panelViewModelCore(input);
+  return { ...view, seal: SEAL_BY_KIND[view.banner.kind] ?? SEAL_BY_KIND.idle };
+}
+function panelViewModelCore(input) {
+  const { snapshot, manual, queue, skippedLatest, lastError } = input;
+  const errorKind = input.errorKind;
+  if (!snapshot) {
+    const earlyCode = typeof errorKind === "string" && errorKind.trim() || lastError || "";
+    if (earlyCode) {
+      const copy = failureCopy(earlyCode);
+      return {
+        banner: {
+          kind: "failed",
+          title: `\u66F4\u65B0\u5931\u8D25\uFF08${earlyCode}\uFF09\uFF1A${copy?.zh ?? earlyCode}\u3002`,
+          action: copy?.act || "\u590D\u5236\u8BCA\u65AD\u53D1\u7ED9\u63D2\u4EF6\u4F5C\u8005\uFF1B\u6DF1\u6316\u770B\u65E5\u5FD7\u901A\u9053\u3002"
+        },
+        installEnabled: false,
+        installLabel: "\u91CD\u8BD5\u5B89\u88C5",
+        skippedLatest: false,
+        showManual: manual ? true : false,
+        showReset: false,
+        queueNote: null
+      };
+    }
+    return {
+      banner: { kind: "loading", title: "\u6B63\u5728\u8BFB\u53D6\u66F4\u65B0\u72B6\u6001\u2026", action: "" },
+      installEnabled: false,
+      installLabel: "\u5B89\u88C5\u66F4\u65B0",
+      skippedLatest: false,
+      showManual: false,
+      showReset: false,
+      queueNote: null
+    };
+  }
+  const job = snapshot.job ?? null;
+  const jobState = job?.state ?? null;
+  const queueNote = queue && queue.busy ? queue.position === 0 ? "\u6B63\u5728\u5B89\u88C5\uFF08\u672C\u63D2\u4EF6\u5728\u88C5\uFF09\u3002" : typeof queue.position === "number" ? `\u524D\u65B9\u6709\u5B89\u88C5\u5728\u8FDB\u884C\uFF0C\u672C\u63D2\u4EF6\u6392\u7B2C ${queue.position} \u4F4D\uFF0C\u5230\u961F\u9996\u518D\u70B9\u5B89\u88C5\u3002` : "\u524D\u65B9\u6709\u5176\u4ED6\u63D2\u4EF6\u5728\u5B89\u88C5\uFF0C\u7A0D\u540E\u91CD\u8BD5\u3002" : null;
+  if (skippedLatest && snapshot.latestVersion) {
+    return {
+      banner: {
+        kind: "idle",
+        title: `\u5DF2\u8DF3\u8FC7 ${snapshot.latestVersion}`,
+        action: "\u70B9\u201C\u6062\u590D\u201D\u53EF\u91CD\u65B0\u63D0\u9192\u8BE5\u7248\u672C\uFF1B\u6709\u66F4\u65B0\u7684\u65B0\u7248\u672C\u4F1A\u7167\u5E38\u63D0\u9192\u3002"
+      },
+      installEnabled: false,
+      installLabel: "\u5B89\u88C5\u66F4\u65B0",
+      skippedLatest: true,
+      showManual: false,
+      showReset: true,
+      queueNote
+    };
+  }
+  if (snapshot.blockedReason === "pending-restart") {
+    const latest = snapshot.latestVersion ?? snapshot.installedVersion ?? "";
+    return {
+      banner: {
+        kind: "restart",
+        // 文案照原型（d5-paper.html:329）：不带 emoji——警示由横幅左侧的手绘 SVG 标承担，
+        // 印章在状态一侧，两者各司其职，不再三重标记。
+        title: `\u65B0\u7248 ${latest} \u5DF2\u5B89\u88C5\uFF0C\u91CD\u542F\u5BBF\u4E3B\u540E\u751F\u6548\u3002`,
+        action: BLOCKED_COPY["pending-restart"].action
+      },
+      installEnabled: false,
+      installLabel: "\u5B89\u88C5\u66F4\u65B0",
+      skippedLatest: false,
+      showManual: manual ? true : false,
+      showReset: false,
+      queueNote
+    };
+  }
+  if (jobState === "installing" || jobState === "verifying") {
+    return {
+      banner: {
+        kind: "busy",
+        title: `\u6B63\u5728\u5B89\u88C5${job?.targetVersion ? ` ${job.targetVersion}` : ""}\u2026\u5173\u95ED\u9762\u677F\u4E0D\u4F1A\u4E2D\u65AD\u3002`,
+        action: "\u8FDB\u5EA6\u6309\u8F6E\u8BE2\u81EA\u52A8\u5237\u65B0\uFF1B\u91CD\u5F00\u9762\u677F 1 \u79D2\u5185\u6062\u590D\u663E\u793A\u3002"
+      },
+      installEnabled: false,
+      installLabel: "\u5B89\u88C5\u4E2D\u2026",
+      skippedLatest: false,
+      showManual: false,
+      showReset: false,
+      queueNote
+    };
+  }
+  const jobCode = jobState === "failed" ? messageCodeOf(job?.message) || "install-failed" : "";
+  const failedCode = typeof errorKind === "string" && errorKind.trim() || lastError || jobCode || "";
+  if (failedCode || jobState === "failed" || jobState === "interrupted") {
+    const code = failedCode || "install-failed";
+    const copy = failureCopy(code);
+    return {
+      banner: {
+        kind: "failed",
+        title: `\u66F4\u65B0\u5931\u8D25\uFF08${code}\uFF09\uFF1A${copy?.zh ?? code}\u3002`,
+        action: copy?.act || "\u590D\u5236\u8BCA\u65AD\u53D1\u7ED9\u63D2\u4EF6\u4F5C\u8005\uFF1B\u6DF1\u6316\u770B\u65E5\u5FD7\u901A\u9053\u3002"
+      },
+      installEnabled: snapshot.canInstall,
+      installLabel: "\u91CD\u8BD5\u5B89\u88C5",
+      skippedLatest: false,
+      showManual: manual ? true : false,
+      showReset: false,
+      queueNote
+    };
+  }
+  if (snapshot.blockedReason) {
+    const copy = blockedCopy(snapshot.blockedReason);
+    return {
+      banner: {
+        kind: "blocked",
+        title: copy ? `${copy.title}\u3002` : `${snapshot.blockedReason}\u3002`,
+        action: copy?.action || ""
+      },
+      installEnabled: false,
+      installLabel: "\u5B89\u88C5\u66F4\u65B0",
+      skippedLatest: false,
+      showManual: manual ? true : false,
+      showReset: false,
+      queueNote
+    };
+  }
+  if (snapshot.canInstall && snapshot.latestVersion) {
+    return {
+      banner: {
+        kind: "update",
+        title: `\u6709\u65B0\u7248 ${snapshot.latestVersion} \u53EF\u88C5\uFF08\u5F53\u524D ${snapshot.runningVersion}\uFF09\u3002`,
+        action: "\u70B9\u5B89\u88C5\u5373\u8D70\u7CBE\u786E\u7248\u672C\u5B89\u88C5\uFF1B\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u540C\u65F6\u53EA\u88C5\u4E00\u4E2A\u3002"
+      },
+      installEnabled: true,
+      installLabel: `\u5B89\u88C5 ${snapshot.latestVersion}`,
+      skippedLatest: false,
+      showManual: manual ? true : false,
+      showReset: false,
+      queueNote
+    };
+  }
+  return {
+    banner: { kind: "done", title: "\u5DF2\u662F\u6700\u65B0\uFF0C\u65E0\u9700\u66F4\u65B0\u3002", action: "" },
+    installEnabled: false,
+    installLabel: "\u5B89\u88C5\u66F4\u65B0",
+    skippedLatest: false,
+    showManual: false,
+    showReset: false,
+    queueNote
+  };
+}
+const UPDATE_PANEL_CSS = [
+  '.dsh-upd{font:14px/1.6 system-ui,"Microsoft YaHei",sans-serif;color:var(--dsh-upd-fg,#1f2937);',
+  "background:var(--dsh-upd-bg,#ffffff);border:1px solid var(--dsh-upd-line,#e5e7eb);border-radius:8px;padding:12px 14px;max-width:560px;",
+  // 横幅配色走变量（浅色默认 + 深色覆盖，见下方 dark 媒体块）：硬编码浅色会让深色下
+  // 「浅底 + 浅字」读不出来（现场回归：默认主题深色模式更新横幅白底浅字）。
+  "--dsh-upd-ok-bg:#ecfdf5;--dsh-upd-ok-line:#059669;--dsh-upd-warn-bg:#fffbeb;--dsh-upd-warn-line:#d97706;",
+  "--dsh-upd-bad-bg:#fef2f2;--dsh-upd-bad-line:#dc2626;--dsh-upd-busy-bg:#eff6ff;--dsh-upd-busy-line:#2563eb}",
+  ".dsh-upd *{box-sizing:border-box}",
+  ".dsh-upd button{font:inherit;border:1px solid var(--dsh-upd-line,#d1d5db);border-radius:6px;background:var(--dsh-upd-btn,#f9fafb);",
+  "color:inherit;padding:4px 12px;cursor:pointer;margin:2px 6px 2px 0}",
+  ".dsh-upd button:disabled{opacity:.45;cursor:not-allowed}",
+  ".dsh-upd button:focus-visible{outline:2px solid var(--dsh-upd-focus,#2563eb);outline-offset:1px}",
+  '.dsh-upd button[data-primary="1"]{background:var(--dsh-upd-primary,#2563eb);border-color:var(--dsh-upd-primary,#2563eb);color:#fff}',
+  ".dsh-upd-banner{border-left:4px solid var(--dsh-upd-line,#9ca3af);padding:6px 10px;margin:0 0 8px;background:var(--dsh-upd-soft,#f3f4f6)}",
+  '.dsh-upd-banner[data-kind="restart"]{border-color:var(--dsh-upd-warn-line);background:var(--dsh-upd-warn-bg)}',
+  '.dsh-upd-banner[data-kind="failed"],.dsh-upd-banner[data-kind="blocked"]{border-color:var(--dsh-upd-bad-line);background:var(--dsh-upd-bad-bg)}',
+  '.dsh-upd-banner[data-kind="update"]{border-color:var(--dsh-upd-ok-line);background:var(--dsh-upd-ok-bg)}',
+  '.dsh-upd-banner[data-kind="busy"]{border-color:var(--dsh-upd-busy-line);background:var(--dsh-upd-busy-bg)}',
+  ".dsh-upd code{font-family:Consolas,Menlo,monospace;font-size:12px;word-break:break-all}",
+  ".dsh-upd-manual,.dsh-upd-queue,.dsh-upd-log{margin:8px 0;font-size:13px}",
+  ".dsh-upd-changelog-wrap{margin:8px 0;font-size:13px;border-top:1px solid var(--dsh-upd-line,#e5e7eb);padding-top:8px}",
+  ".dsh-upd-changelog-title{font-weight:700;margin:0 0 4px}",
+  ".dsh-upd-changelog-version{margin:6px 0}",
+  ".dsh-upd-changelog-catname{font-weight:600;margin:6px 0 2px}",
+  ".dsh-upd-changelog ul{margin:2px 0 6px 20px;padding:0}",
+  ".dsh-upd-changelog li{margin:2px 0}",
+  ".dsh-upd-changelog-fold{margin:4px 0}",
+  ".dsh-upd-changelog-fold>summary{cursor:pointer}",
+  ".dsh-upd-changelog-neutral{color:inherit;opacity:.8}",
+  ".dsh-upd-overlay{position:fixed;inset:0;background:rgba(0,0,0,.35);display:flex;align-items:center;justify-content:center;z-index:9999}",
+  ".dsh-upd-overlay .dsh-upd{background:var(--dsh-upd-bg,#ffffff);max-height:85vh;overflow:auto}",
+  // —— 档案头 / 版本条 / 章节 / 进度条 / 跳过行（原型 :208-245 的新结构，默认主题给最小可用样式）——
+  ".dsh-upd-head{display:flex;gap:12px;align-items:baseline;flex-wrap:wrap}",
+  // 卷宗抬头「插件更新 / 更新档案 卷」：D5 档案卷才画，默认（最小）主题不画。
+  // 两个主题共用同一份内核 HTML（见 renderUpdatePanelHTML 的注释），画不画是皮肤决定的事。
+  ".dsh-upd-masthead{display:none}",
+  ".dsh-upd-name{font-weight:700}",
+  ".dsh-upd-meta{font-size:12.5px;opacity:.75}",
+  ".dsh-upd-proftag{font-family:Consolas,Menlo,monospace;font-size:11px;border:1px solid var(--dsh-upd-line,#d1d5db);border-radius:3px;padding:0 5px;margin-left:6px;letter-spacing:.06em}",
+  ".dsh-upd-strip{display:flex;flex-wrap:wrap;margin:8px 0 0;border:1px solid var(--dsh-upd-line,#e5e7eb);border-radius:4px;overflow:hidden;font-size:12.5px}",
+  ".dsh-upd-strip>div{flex:1 1 110px;padding:6px 10px;border-left:1px solid var(--dsh-upd-line,#e5e7eb)}",
+  ".dsh-upd-strip>div:first-child{border-left:0}",
+  ".dsh-upd-strip-k{display:block;font-size:11px;letter-spacing:.14em;opacity:.7}",
+  ".dsh-upd-strip-v{font-family:Consolas,Menlo,monospace;font-size:12.5px}",
+  ".dsh-upd-chapter{margin-top:14px;padding-top:10px;border-top:1px solid var(--dsh-upd-line,#e5e7eb)}",
+  ".dsh-upd-chap-head{display:flex;align-items:baseline;gap:10px;margin-bottom:6px}",
+  ".dsh-upd-chap-no{font-size:13px;font-style:italic;opacity:.6}",
+  ".dsh-upd-chap-title{font-size:14px;margin:0}",
+  ".dsh-upd-chap-rule{flex:1;border-top:1px solid var(--dsh-upd-line,#e5e7eb);transform:translateY(-3px)}",
+  // 03 章标题行右端的开关（问题 3 定案：按钮形态、挪到标题行）。
+  ".dsh-upd-chap-note{flex:none;font-size:12px;opacity:.75}",
+  ".dsh-upd-chap-note button{margin:0}",
+  // 更新队列两行键值（用户定案的设计）：结构两主题共用，皮肤各自收敛。
+  ".dsh-upd-qrow{display:flex;align-items:baseline;gap:10px;padding:6px 0}",
+  ".dsh-upd-qrow+.dsh-upd-qrow{border-top:1px solid var(--dsh-upd-line,#e5e7eb)}",
+  ".dsh-upd-qdot{width:8px;height:8px;border-radius:50%;flex:none;align-self:center;background:currentColor;opacity:.5}",
+  '.dsh-upd-qdot[data-tone="busy"]{background:var(--dsh-upd-warn-line,#d97706);opacity:1}',
+  '.dsh-upd-qdot[data-tone="you"]{background:var(--dsh-upd-primary,#2563eb);opacity:1}',
+  ".dsh-upd-qk{flex:none;width:5.5em;font-size:12px;opacity:.7}",
+  ".dsh-upd-qv{font-weight:600}",
+  ".dsh-upd-qn{margin-left:auto;font-size:12px;opacity:.7}",
+  ".dsh-upd-qseq{font-family:Consolas,Menlo,monospace;font-size:12px;word-break:break-all}",
+  ".dsh-upd-prog{height:8px;background:var(--dsh-upd-line,#e5e7eb);border-radius:4px;overflow:hidden;margin:10px 0 4px}",
+  ".dsh-upd-prog-bar{display:block;height:100%;background:var(--dsh-upd-primary,#2563eb);transition:width .3s}",
+  ".dsh-upd-progtxt{font-size:12.5px;opacity:.75}",
+  ".dsh-upd-skipline{font-size:13px;margin-top:8px}",
+  ".dsh-upd-tag{display:inline-block;border:1px dashed currentColor;border-radius:3px;padding:1px 8px;margin-right:8px;font-family:Consolas,Menlo,monospace;font-size:12px}",
+  ".dsh-upd-err{font-size:13px;margin:0 0 6px}",
+  "@media (prefers-color-scheme: dark){.dsh-upd{--dsh-upd-fg:#e5e7eb;--dsh-upd-bg:#111827;--dsh-upd-line:#374151;",
+  "--dsh-upd-btn:#1f2937;--dsh-upd-soft:#1f2937;--dsh-upd-primary:#3b82f6;--dsh-upd-focus:#93c5fd;",
+  // 横幅深色覆盖：底色用低透明度同色系（不是浅色原值），边线提亮，保证「深底浅字」可读。
+  "--dsh-upd-ok-bg:rgba(16,185,129,.14);--dsh-upd-ok-line:#34d399;",
+  "--dsh-upd-warn-bg:rgba(245,158,11,.16);--dsh-upd-warn-line:#fbbf24;",
+  "--dsh-upd-bad-bg:rgba(239,68,68,.16);--dsh-upd-bad-line:#f87171;",
+  "--dsh-upd-busy-bg:rgba(59,130,246,.16);--dsh-upd-busy-line:#60a5fa}}"
+].join("\n");
+const UPDATE_PANEL_D5_CSS = [
+  "/* D5 \u6863\u6848\u5377\u53EF\u9009\u4E3B\u9898\uFF1A\u53EA\u6362\u989C\u8272/\u5B57\u4F53/\u95F4\u8DDD\uFF1B\u5185\u6838 DOM \u987A\u5E8F\u4E00\u5B57\u4E0D\u52A8\uFF0C\u4E0D\u65AD\u590D\u5236\u8BCA\u65AD\u3002 */",
+  '.dsh-upd[data-theme="d5-paper"]{--d5-bg:#f7f3ea;--d5-card:#fffdf6;--d5-ink:#1a1a1a;--d5-muted:#6f675a;',
+  "--d5-line:#e3d9c4;--d5-line-strong:#c4b896;--d5-accent:#c8402a;--d5-accent-deep:#9c2e1d;",
+  "--d5-ok:#1a7f37;--d5-ok-bg:#e9f4ea;--d5-warn:#8a5a00;--d5-warn-bg:#fbf0d0;",
+  "--d5-bad:#b3261e;--d5-bad-bg:#fbe9e5;",
+  '--d5-serif:Georgia,"Songti SC","STSong","SimSun","Noto Serif CJK SC","Source Han Serif SC",serif;',
+  '--d5-sans:system-ui,"PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;',
+  '--d5-mono:ui-monospace,"SF Mono",SFMono-Regular,Consolas,"Noto Sans Mono",monospace;',
+  "--d5-shadow:0 1px 2px rgba(60,40,20,.08),0 12px 32px rgba(60,40,20,.10);",
+  "font-family:var(--d5-sans);color:var(--d5-ink);background:var(--d5-card);",
+  "border:1px solid var(--d5-line-strong);border-radius:4px;box-shadow:var(--d5-shadow)}",
+  '.dsh-upd[data-theme="d5-paper"] button{border-color:var(--d5-line-strong);background:transparent;color:var(--d5-ink);border-radius:3px;font-family:var(--d5-sans)}',
+  '.dsh-upd[data-theme="d5-paper"] button:hover:not(:disabled){border-color:var(--d5-accent);color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]{background:var(--d5-accent);border-color:var(--d5-accent);color:#fff}',
+  '.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]:hover:not(:disabled){background:var(--d5-accent-deep);color:#fff}',
+  '.dsh-upd[data-theme="d5-paper"] button:focus-visible{outline:2px solid var(--d5-accent);outline-offset:2px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{background:var(--d5-bg);border-color:var(--d5-line-strong)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]{border-color:var(--d5-warn);background:var(--d5-warn-bg)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]{border-color:var(--d5-warn);background:var(--d5-warn-bg);font-family:var(--d5-serif);border-width:2px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"],.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]{border-color:var(--d5-bad);background:var(--d5-bad-bg)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
+  // —— 大印章（原型 :206 `.seal`：右上 88px、旋转 -7°、双细框；内容与色调来自根属性，不加节点）——
+  '.dsh-upd[data-theme="d5-paper"]{position:relative;padding:22px 26px 20px}',
+  '.dsh-upd[data-theme="d5-paper"]::before{content:attr(data-seal);position:absolute;top:20px;right:24px;width:88px;height:88px;',
+  "display:flex;align-items:center;justify-content:center;text-align:center;letter-spacing:.18em;text-indent:.18em;line-height:1.35;",
+  "border:3px solid currentColor;border-radius:14px;transform:rotate(-7deg);font-family:var(--d5-serif);font-weight:700;font-size:21px;",
+  "background:color-mix(in srgb,currentColor 8%,transparent);user-select:none;pointer-events:none;",
+  "box-shadow:inset 0 0 0 5px var(--d5-card),inset 0 0 0 6px currentColor,0 2px 6px rgba(0,0,0,.12)}",
+  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="ink"]::before{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="green"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="yellow"]::before{color:var(--d5-warn)}',
+  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="red"]::before{color:var(--d5-bad)}',
+  // 印章占位：首行（横幅/状态行）右侧留出 120px，文字不许压到印章上（原型 .filehead padding-right:120px）
+  // —— 卷宗抬头（原型 :195-203 的刊头，主题切换按钮按用户口径去掉）：只有 D5 档案卷才显示 ——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead{display:block;padding:0 0 10px;margin:0 0 12px;border-bottom:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-kicker{display:block;font-size:11px;letter-spacing:.35em;color:var(--d5-muted);margin-bottom:3px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title{font-family:var(--d5-serif);font-size:26px;font-weight:700;line-height:1.2}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title i{color:var(--d5-accent);font-style:normal}',
+  // 横幅不再给大印章留 124px：实测（headless 量盒子）印章盒底边 y=109，横幅正文顶边 y=108、
+  // 状态行那句在 y=159——印章只压到横幅顶部的留白带，压不到正文。留着反而把 27px 那句话挤成两行
+  // （27px 单行需 428px，留白后只剩 366px）。档案头那 120px 保留：那里是真的重叠。
+  // —— 更新队列（03 章）D5 皮肤 ——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qrow{padding:8px 0}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qk{width:66px;letter-spacing:.18em}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qv{font-family:var(--d5-serif);font-size:16px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qn{font-family:var(--d5-mono);font-size:11.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qseq{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-note{color:var(--d5-muted)}',
+  // —— 小印章（原型 :215 `.sealmini`：30px、旋转 -5°、一字）——
+  // 待重启横幅一律不画印章：那一档的标记是左侧手绘 SVG（原型 :446 的 .mark 只有 SVG）。
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="loading"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="idle"]::before,',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]::before,',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"]::before,',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]::before{content:attr(data-mini);display:inline-flex;align-items:center;justify-content:center;',
+  "width:30px;height:30px;margin-right:10px;vertical-align:middle;border:2px solid currentColor;border-radius:7px;",
+  "font-family:var(--d5-serif);font-weight:700;font-size:16px;line-height:26px;transform:rotate(-5deg);flex:none;color:var(--d5-muted)}",
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]::before{color:var(--d5-warn)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"]::before{color:var(--d5-bad)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-log code{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;letter-spacing:.06em}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-manual code{display:block;background:var(--d5-ink);color:var(--d5-bg);font-family:var(--d5-mono);font-size:12.5px;padding:12px 14px;border-radius:4px;white-space:pre-wrap;word-break:break-all}',
+  // 待重启标记：手绘 SVG 当**独立 flex 标记**放在文字块左侧（原型 :446 `.mark` 是独立节点），
+  // 不能用行内背景——那样换行时三角会落在句子中间把话劈开（现场回归）。
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child{display:flex;gap:10px;align-items:flex-start}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{content:"";flex:none;width:20px;height:20px;margin-top:3px;',
+  'background:url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2720%27 height=%2720%27 viewBox=%270 0 24 24%27 fill=%27none%27 stroke=%27%238a5a00%27 stroke-width=%272%27 stroke-linecap=%27round%27 stroke-linejoin=%27round%27%3E%3Cpath d=%27M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z%27/%3E%3Cline x1=%2712%27 y1=%279%27 x2=%2712%27 y2=%2713%27/%3E%3Cline x1=%2712%27 y1=%2717%27 x2=%2712.01%27 y2=%2717%27/%3E%3C/svg%3E") no-repeat center/20px 20px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{overflow:hidden;text-overflow:ellipsis}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-actions{flex-wrap:wrap}',
+  // —— 档案头（原型 :208-211 `.filehead`：serif 插件名 22px + 使用范围 + profile 牌；右侧留章位）——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-head{display:flex;gap:16px;align-items:baseline;flex-wrap:wrap;padding-right:120px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-name{font-family:var(--d5-serif);font-size:22px;font-weight:700}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-meta{width:100%;font-size:12.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-meta b{color:var(--d5-ink);font-weight:600}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-proftag{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;margin-left:8px;letter-spacing:.06em}',
+  // —— 版本条（原型 :216 `.strip`：三格，格间一线，左上小写标签 + 等宽值）——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip{display:flex;flex-wrap:wrap;margin:10px 0 0;border:1px solid var(--d5-line);border-radius:4px;overflow:hidden;font-size:12.5px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip>div{flex:1 1 120px;padding:8px 12px;border-left:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip>div:first-child{border-left:0}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip-k{display:block;font-size:11px;letter-spacing:.2em;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip-v{font-family:var(--d5-mono);font-size:13px}',
+  // —— 章节（原型 :218-245：01–05 编号 + 衬线标题 + 细线）——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chapter{margin-top:26px;padding-top:16px;border-top:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-head{display:flex;align-items:baseline;gap:12px;margin-bottom:10px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-no{font-family:var(--d5-serif);font-style:italic;font-size:15px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-title{font-family:var(--d5-serif);font-size:17px;margin:0;letter-spacing:.1em}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-rule{flex:1;border-top:1px solid var(--d5-line);transform:translateY(-4px)}',
+  // —— 横幅即状态行 / 待重启横幅（原型 :81-85 `.restart-banner`：2px 边框、圆角 4、内边距 12/16、衬线；右侧留章位）——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{border:2px solid var(--d5-line-strong);border-radius:4px;padding:12px 16px;font-size:14.5px;font-family:var(--d5-serif);display:flex;gap:10px;align-items:center;flex-wrap:wrap}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{flex:1 1 auto;min-width:0}',
+  // 状态行字号照原型 .status-line=27px（实测去掉横幅右侧占位后可写 486px > 428px，一行放得下）
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child strong{font-family:var(--d5-serif);font-size:27px;font-weight:700;line-height:1.35}',
+  // —— 进度条 / 跳过行（原型 :132-133 `.prog`、:129-131 `.skipline .tag`）——
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-prog{height:8px;background:var(--d5-line);border-radius:4px;overflow:hidden;margin:10px 0 4px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-prog-bar{display:block;height:100%;background:var(--d5-accent);transition:width .3s}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-progtxt{font-size:12.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-skipline{font-size:13px;margin-top:8px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-tag{display:inline-block;border:1px dashed var(--d5-line-strong);border-radius:3px;padding:1px 8px;margin-right:8px;font-family:var(--d5-mono);font-size:12px}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-err{font-size:13px;margin:0 0 6px;color:var(--d5-muted)}',
+  '@media (max-width:640px){.dsh-upd[data-theme="d5-paper"]{padding:10px 12px}.dsh-upd[data-theme="d5-paper"]::before{top:12px;right:12px;width:56px;height:56px;font-size:15px;box-shadow:inset 0 0 0 4px var(--d5-card),inset 0 0 0 5px currentColor}.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title{font-size:19px}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{padding-right:16px}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner::before{width:24px;height:24px;font-size:14px;line-height:20px;flex:none}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{white-space:normal}}',
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"]{--d5-bg:#141210;--d5-card:#1e1a15;--d5-ink:#ece5d3;--d5-muted:#a89c83;',
+  "--d5-line:#3a3226;--d5-line-strong:#5c4e3b;--d5-accent:#e0684e;--d5-accent-deep:#f0866b;",
+  "--d5-ok:#8fd6a4;--d5-ok-bg:rgba(80,180,120,.12);--d5-warn:#e8c15a;--d5-warn-bg:rgba(232,193,90,.12);",
+  "--d5-bad:#ef8a7d;--d5-bad-bg:rgba(239,138,125,.12);--d5-shadow:0 1px 2px rgba(0,0,0,.4),0 12px 32px rgba(0,0,0,.45)}}",
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]{color:#141210}.dsh-upd[data-theme="d5-paper"] button:focus-visible{outline-color:var(--d5-accent-deep)}}',
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2720%27 height=%2720%27 viewBox=%270 0 24 24%27 fill=%27none%27 stroke=%27%23e8c15a%27 stroke-width=%272%27 stroke-linecap=%27round%27 stroke-linejoin=%27round%27%3E%3Cpath d=%27M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z%27/%3E%3Cline x1=%2712%27 y1=%279%27 x2=%2712%27 y2=%2713%27/%3E%3Cline x1=%2712%27 y1=%2717%27 x2=%2712.01%27 y2=%2717%27/%3E%3C/svg%3E")}}',
+  '@media (forced-colors: active){.dsh-upd[data-theme="d5-paper"]{box-shadow:none}.dsh-upd[data-theme="d5-paper"]::before{background:none;box-shadow:none;border-color:CanvasText;color:CanvasText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{border:1px solid CanvasText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner::before{border-color:CanvasText;color:CanvasText;background:Canvas}.dsh-upd[data-theme="d5-paper"] button{border:1px solid ButtonText}.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]{background:ButtonFace;color:ButtonText;border-color:ButtonText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:none;content:"\u26A0"}}',
+  '@media (prefers-reduced-motion: reduce){.dsh-upd[data-theme="d5-paper"] *{transition:none !important;animation:none !important}}'
+].join("\n");
+function escapeHtml(text) {
+  return String(text).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+const CHAPTER_TITLES = ["\u68C0\u67E5\u4E0E\u5B89\u88C5", "\u66F4\u65B0\u65E5\u5FD7", "\u66F4\u65B0\u961F\u5217", "\u9519\u8BEF\u4FE1\u606F", "\u624B\u5DE5\u547D\u4EE4"];
+function chapterOf(index, inner, note = "") {
+  const no = String(index).padStart(2, "0");
+  const title = CHAPTER_TITLES[index - 1];
+  return `<section class="dsh-upd-chapter" data-chapter="${no}"><div class="dsh-upd-chap-head"><span class="dsh-upd-chap-no">${no}</span><h3 class="dsh-upd-chap-title">${escapeHtml(title)}</h3><span class="dsh-upd-chap-rule"></span>${note}</div>${inner}</section>`;
+}
+function versionStrip(snapshot) {
+  const cell = (k, v) => `<div><span class="dsh-upd-strip-k">${escapeHtml(k)}</span><span class="dsh-upd-strip-v">${escapeHtml(v ?? "\u672A\u77E5")}</span></div>`;
+  if (!snapshot) return "";
+  return `<div class="dsh-upd-strip">` + cell("\u8FD0\u884C", snapshot.runningVersion) + cell("\u78C1\u76D8", snapshot.installedVersion) + cell("\u8FDC\u7AEF", snapshot.latestVersion) + `</div>`;
+}
+function progressBar(snapshot) {
+  const job = snapshot?.job;
+  if (!job) return "";
+  const state = String(job.state);
+  if (state !== "installing" && state !== "verifying") return "";
+  const width = state === "installing" ? 60 : 90;
+  const text = state === "installing" ? "\u6B63\u5728\u5B89\u88C5\u65B0\u7248\u2026" : "\u6B63\u5728\u6821\u9A8C\u5B89\u88C5\u7ED3\u679C\u2026";
+  return `<div class="dsh-upd-prog" role="progressbar" aria-valuemin="0" aria-valuemax="100" aria-valuenow="${width}"><i class="dsh-upd-prog-bar" style="width:${width}%"></i></div><div class="dsh-upd-progtxt">${escapeHtml(text)}</div>`;
+}
+function renderUpdatePanelKernel(input, view) {
+  const { snapshot, manual, queue, mode, showOthers, pluginId, copyNotice } = input;
+  const changelogMarkdown = input.changelogMarkdown ?? null;
+  const profileName = typeof input.profileName === "string" && input.profileName ? input.profileName : null;
+  const b = view.banner;
+  const seal = view.seal;
+  const parts = [];
+  parts.push(
+    '<div class="dsh-upd-masthead"><span class="dsh-upd-masthead-kicker">\u63D2\u4EF6\u66F4\u65B0</span><span class="dsh-upd-masthead-title">\u66F4\u65B0\u6863\u6848 <i>\u5377</i></span></div>'
+  );
+  parts.push(
+    `<div class="dsh-upd-head"><span class="dsh-upd-name">${escapeHtml(pluginId)}</span><span class="dsh-upd-meta">\u4F7F\u7528\u8303\u56F4 <b>${escapeHtml(profileName ?? "\u672A\u77E5")}</b><span class="dsh-upd-proftag">profile</span></span></div>`
+  );
+  parts.push(`<div class="dsh-upd-banner" data-kind="${b.kind}" data-mini="${escapeHtml(seal.mini)}" role="status" aria-live="polite">`);
+  parts.push(`<div><strong>${escapeHtml(b.title)}</strong></div>`);
+  if (b.action) parts.push(`<div>${escapeHtml(b.action)}</div>`);
+  parts.push("</div>");
+  parts.push(versionStrip(snapshot));
+  const showActions = input.actions !== "none";
+  const actions = [];
+  if (showActions) {
+    actions.push('<div class="dsh-upd-actions">');
+    actions.push(
+      `<button type="button" data-action="check">\u67E5\u65B0\u7248</button><button type="button" data-action="install" data-primary="1"${view.installEnabled ? "" : " disabled"}>${escapeHtml(view.installLabel)}</button>`
+    );
+    if (snapshot?.latestVersion && !view.skippedLatest && view.banner.kind === "update") {
+      actions.push(`<button type="button" data-action="skip">\u8DF3\u8FC7\u8BE5\u7248\u672C</button>`);
+    }
+    if (view.showReset && snapshot?.latestVersion) {
+      actions.push(`<button type="button" data-action="reset-skip">\u6062\u590D\uFF08${escapeHtml(snapshot.latestVersion)}\uFF09</button>`);
+    }
+    if (view.showManual && manual) {
+      actions.push(`<button type="button" data-action="copy-manual">\u590D\u5236\u624B\u5DE5\u547D\u4EE4</button>`);
+    }
+    if (b.kind === "restart") {
+      actions.push(`<button type="button" data-action="restart-hint" data-primary="1">\u91CD\u542F\u5BBF\u4E3B</button>`);
+    }
+    if (snapshot) {
+      actions.push(`<button type="button" data-action="copy-diag">\u590D\u5236\u8BCA\u65AD</button>`);
+    }
+    if (mode === "dialog") {
+      actions.push(`<button type="button" data-action="close-view">\u5173\u95ED</button>`);
+    }
+    actions.push("</div>");
+  }
+  actions.push(progressBar(snapshot));
+  if (view.skippedLatest && snapshot?.latestVersion) {
+    actions.push(
+      `<div class="dsh-upd-skipline"><span class="dsh-upd-tag">\u5DF2\u8DF3\u8FC7 ${escapeHtml(snapshot.latestVersion)}</span>\u70B9\u300C\u6062\u590D\u300D\u53EF\u64A4\u9500\uFF0C\u4E4B\u540E\u8FD9\u4E00\u7248\u8FD8\u4F1A\u518D\u63D0\u9192\u3002</div>`
+    );
+  }
+  parts.push(chapterOf(1, actions.join("")));
+  {
+    let inner = "";
+    if (snapshot && snapshot.latestVersion) {
+      try {
+        const mdText = typeof changelogMarkdown === "string" ? changelogMarkdown : "";
+        const entries = parseChangelog(mdText);
+        const ranged = changelogForUpdate(
+          entries,
+          snapshot.runningVersion,
+          snapshot.latestVersion,
+          snapshot.installedVersion
+        );
+        const changelogHTML = renderChangelogHTML(ranged);
+        const fromText = String(snapshot.runningVersion ?? "");
+        const toText = String(snapshot.latestVersion ?? "");
+        const rangeTitle = fromText && toText ? `\u66F4\u65B0\u8BF4\u660E\uFF08${fromText} \u2192 ${toText}\uFF09\uFF1A` : "\u66F4\u65B0\u8BF4\u660E\uFF1A";
+        inner = `<div class="dsh-upd-changelog-wrap"><div>${escapeHtml(rangeTitle)}</div>
+${changelogHTML}
+</div>`;
+      } catch {
+        inner = "";
+      }
+    }
+    if (!inner) {
+      inner = `<div class="dsh-upd-changelog-wrap"><div class="dsh-upd-changelog-neutral">${escapeHtml(
+        snapshot && snapshot.latestVersion ? "\u65E5\u5FD7\u8BFB\u4E0D\u51FA\u6765\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\u3002" : "\u8FD8\u6CA1\u67E5\u5230\u65B0\u7248\uFF1B\u67E5\u5230\u540E\u518D\u663E\u793A\u65E5\u5FD7\u3002"
+      )}</div></div>`;
+    }
+    parts.push(chapterOf(2, inner));
+  }
+  {
+    const queued = !!queue && (queue.busy || queue.waiting.length > 0);
+    if (queued && queue) {
+      const busy = queue.busy;
+      const ownerRaw = queue.owner;
+      const named = ownerRaw && "pluginId" in ownerRaw && ownerRaw.pluginId ? String(ownerRaw.pluginId) : null;
+      const version = ownerRaw && "targetVersion" in ownerRaw && ownerRaw.targetVersion ? `@${String(ownerRaw.targetVersion)}` : "";
+      const aboutSelf = named !== null && named === pluginId;
+      const reveal = showOthers === true;
+      const ownerShown = !busy ? "\u7A7A\u95F2" : named === null ? "\u5176\u4ED6\u63D2\u4EF6" : aboutSelf ? "\u672C\u63D2\u4EF6" : reveal ? named : "\u5176\u4ED6\u63D2\u4EF6";
+      const ownerVer = busy && named !== null && (aboutSelf || reveal) ? version : "";
+      const pos = typeof queue.position === "number" ? queue.position : null;
+      const posText = pos === null ? "\u672A\u6392\u961F" : `\u7B2C ${pos} \u4F4D`;
+      const posNote = pos === null ? "" : pos === 1 ? "\u4E0B\u4E00\u4E2A\u5C31\u662F\u4F60" : `\u524D\u65B9 ${pos - 1} \u4E2A`;
+      const rows = [
+        `<div class="dsh-upd-qrow"><span class="dsh-upd-qdot" data-tone="${busy ? "busy" : "idle"}"></span><span class="dsh-upd-qk">\u6B63\u5728\u5B89\u88C5</span><span class="dsh-upd-qv">${escapeHtml(ownerShown + ownerVer)}</span><span class="dsh-upd-qn">${busy ? "\u88C5\u5B8C\u81EA\u52A8\u8F6E\u5230\u4F60" : "\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u4E00\u6B21\u53EA\u88C5\u4E00\u4E2A"}</span></div>`,
+        `<div class="dsh-upd-qrow"><span class="dsh-upd-qdot" data-tone="you"></span><span class="dsh-upd-qk">\u4F60\u7684\u987A\u4F4D</span><span class="dsh-upd-qv">${escapeHtml(posText)}</span><span class="dsh-upd-qn">${escapeHtml(posNote)}</span></div>`
+      ];
+      if (reveal && queue.waiting.length > 0) {
+        const seq = queue.waiting.map((e) => `${e.pluginId}${e.targetVersion ? `@${e.targetVersion}` : ""}`).join(" \u2192 ");
+        rows.push(
+          `<div class="dsh-upd-qrow"><span class="dsh-upd-qdot"></span><span class="dsh-upd-qk">\u6392\u961F\u987A\u5E8F</span><span class="dsh-upd-qseq">${escapeHtml(seq)}</span></div>`
+        );
+      }
+      const note = showActions ? `<span class="dsh-upd-chap-note"><button type="button" data-action="toggle-queue">${reveal ? "\u9690\u85CF\u4ED6\u4EBA\u660E\u7EC6" : "\u663E\u793A\u5176\u4ED6\u63D2\u4EF6"}</button></span>` : "";
+      parts.push(chapterOf(3, `<div class="dsh-upd-queue">${rows.join("")}</div>`, note));
+    } else {
+      parts.push(
+        chapterOf(
+          3,
+          `<div class="dsh-upd-queue"><div class="dsh-upd-changelog-neutral">${escapeHtml(
+            view.queueNote ?? "\u5F53\u524D\u6CA1\u6709\u6392\u961F\u4EFB\u52A1\uFF0C\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u4E00\u6B21\u53EA\u88C5\u4E00\u4E2A\u3002"
+          )}</div></div>`
+        )
+      );
+    }
+  }
+  {
+    const errLines = [];
+    if (b.kind === "failed" || b.kind === "blocked") {
+      errLines.push(
+        `<div class="dsh-upd-err">\u7A33\u5B9A\u7801 <code>${escapeHtml(String(b.kind === "blocked" ? snapshot?.blockedReason ?? b.kind : "install-failed"))}</code>\uFF1A\u4E0A\u4E00\u6761\u4E2D\u6587\u8BF4\u660E\u5C31\u662F\u8981\u7528\u6237\u505A\u7684\u4E8B\uFF1B\u8981\u5F80\u4E0A\u6E38\u62A5\uFF0C\u7528\u300C\u590D\u5236\u8BCA\u65AD\u300D\u6574\u6BB5\u7C98\uFF08\u5DF2\u8131\u654F\uFF09\u3002</div>`
+      );
+    }
+    errLines.push(
+      `<div class="dsh-upd-log">\u6DF1\u6316\u770B\u65E5\u5FD7\uFF1A\u6309\u63D2\u4EF6\u6807\u8BC6 <code>${escapeHtml(pluginId)}</code> \u8FC7\u6EE4 <code>host.call</code>\u3001<code>host.call.fail</code>\u3001<code>update.install.exec</code> \u4E09\u4E2A\u4E8B\u4EF6\u3002</div>`
+    );
+    if (copyNotice) errLines.push(`<div class="dsh-upd-copy" role="status">${escapeHtml(copyNotice)}</div>`);
+    parts.push(chapterOf(4, errLines.join("")));
+  }
+  parts.push(
+    chapterOf(
+      5,
+      view.showManual && manual ? `<div class="dsh-upd-manual"><div>\u624B\u5DE5\u515C\u5E95\u547D\u4EE4\uFF08\u590D\u5236\u6574\u884C\u6267\u884C\uFF09\uFF1A</div><code>${escapeHtml(manual)}</code></div>` : `<div class="dsh-upd-manual"><div class="dsh-upd-changelog-neutral">\u5F53\u524D\u6CA1\u6709\u53EF\u7528\u7684\u624B\u5DE5\u547D\u4EE4\uFF08\u8BA4\u4E0D\u51FA\u4F7F\u7528\u8303\u56F4\u6216\u5C5E\u6E90\u7801\u5B89\u88C5\u65F6\u4E0D\u7ED9\uFF09\u3002</div></div>`
+    )
+  );
+  return parts.join("\n");
+}
+function renderUpdatePanelHTML(input) {
+  const view = panelViewModel(input);
+  const kernel = renderUpdatePanelKernel(input, view);
+  const d5 = input.theme === "d5-paper";
+  const attr = d5 ? ' data-theme="d5-paper"' : "";
+  const sealAttr = ` data-seal="${escapeHtml(view.seal.text)}" data-seal-tone="${view.seal.tone}"`;
+  const body = input.mode === "dialog" ? `<div class="dsh-upd-overlay" data-mode="dialog"><div class="dsh-upd" data-mode="dialog" data-plugin="${escapeHtml(input.pluginId)}"${sealAttr}${attr}>
+${kernel}
+</div></div>` : `<div class="dsh-upd" data-mode="embedded" data-plugin="${escapeHtml(input.pluginId)}"${sealAttr}${attr}>
+${kernel}
+</div>`;
+  const css = d5 ? `${UPDATE_PANEL_CSS}
+${UPDATE_PANEL_D5_CSS}` : UPDATE_PANEL_CSS;
+  return `<style>${css}</style>
+${body}`;
+}
+function isObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function asSnapshot(value) {
+  if (!isObject(value)) return null;
+  const s = value;
+  if (typeof s["runningVersion"] !== "string") return null;
+  if (typeof s["canInstall"] !== "boolean") return null;
+  return value;
+}
+function asQueue(value) {
+  if (!isObject(value) || typeof value["busy"] !== "boolean") return null;
+  return value;
+}
+function randomRequestId() {
+  try {
+    const rand = Math.floor(Math.random() * 16777215).toString(36);
+    return `r${Date.now().toString(36)}${rand}`.slice(0, 64);
+  } catch {
+    return `r${Date.now()}`;
+  }
+}
+function getTimer() {
+  const g = globalThis;
+  const set = g["setInterval"];
+  const clear = g["clearInterval"];
+  if (typeof set === "function" && typeof clear === "function") {
+    return {
+      set: (fn, ms) => set(fn, ms),
+      clear: (h) => clear(h)
+    };
+  }
+  const setT = g["setTimeout"];
+  const clearT = g["clearTimeout"];
+  return {
+    set: (fn, ms) => setT(fn, ms),
+    clear: (h) => clearT(h)
+  };
+}
+async function defaultCopyText(text) {
+  try {
+    const holder = globalThis["navigator"];
+    const clip = holder?.clipboard;
+    const write = clip?.writeText;
+    if (clip && typeof write === "function") {
+      await write.call(clip, text);
+      return;
+    }
+  } catch {
+  }
+}
+function mountUpdatePanel(container, options) {
+  if (!container || typeof container.innerHTML !== "string") {
+    throw new Error("[dsh-plugin-update] \u6302\u8F7D\u9762\u677F\u9700\u8981\u4E00\u4E2A\u6709 innerHTML \u7684\u5BB9\u5668");
+  }
+  if (!options || typeof options !== "object") {
+    throw new Error("[dsh-plugin-update] \u6302\u8F7D\u9762\u677F\u7F3A\u5C11\u914D\u7F6E\uFF1A\u63D2\u4EF6\u6807\u8BC6 pluginId \u5FC5\u586B");
+  }
+  const pluginId = options.pluginId;
+  if (typeof pluginId !== "string" || !pluginId) {
+    throw new Error(`[dsh-plugin-update] \u63D2\u4EF6\u6807\u8BC6 pluginId \u5FC5\u586B\uFF1A\u987B\u4E3A\u975E\u7A7A\u5B57\u7B26\u4E32\uFF08\u6536\u5230 ${JSON.stringify(pluginId)}\uFF09`);
+  }
+  if (typeof options.call !== "function") {
+    throw new Error("[dsh-plugin-update] \u6302\u8F7D\u9762\u677F\u9700\u8981\u4F20\u8F93\u51FD\u6570 call\uFF08\u9762\u677F\u8C03\u5BBF\u4E3B\u7535\u8BDD\u7684\u552F\u4E00\u63A5\u89E6\u9762\uFF09");
+  }
+  const prefix = options.prefix === void 0 ? "wf" : options.prefix;
+  const phoneNames = buildPhoneNames(prefix);
+  const pollMs = options.pollMs === void 0 ? DEFAULT_PANEL_POLL_MS : options.pollMs;
+  if (typeof pollMs !== "number" || !Number.isFinite(pollMs) || pollMs < MIN_PANEL_POLL_MS) {
+    throw new Error(`[dsh-plugin-update] \u9762\u677F\u8F6E\u8BE2\u95F4\u9694\u975E\u6CD5\uFF1A\u4E0D\u5F97\u5C0F\u4E8E 250 \u6BEB\u79D2\uFF08\u6536\u5230 ${JSON.stringify(options.pollMs)}\uFF09`);
+  }
+  let mode = options.mode ?? "embedded";
+  if (mode !== "embedded" && mode !== "dialog") {
+    throw new Error(`[dsh-plugin-update] \u6446\u653E\u5F62\u6001\u975E\u6CD5\uFF1A\u53EA\u6536 embedded \u6216 dialog\uFF08\u6536\u5230 ${JSON.stringify(options.mode)}\uFF09`);
+  }
+  let theme = options.theme ?? "default";
+  if (theme !== "default" && theme !== "d5-paper") {
+    throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 d5-paper\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
+  }
+  let showOthers = options.showOthers === true;
+  const call = options.call;
+  const onRestartRequested = options.onRestartRequested;
+  const copyText = options.copyText ?? defaultCopyText;
+  const skipStore = options.skipStore ?? createBrowserSkipStore(pluginId);
+  const hostKind = typeof options.hostKind === "string" && options.hostKind ? options.hostKind : null;
+  const profileNameOption = typeof options.profileName === "string" && options.profileName ? options.profileName : null;
+  const diagCopyFormat = options.diagCopyFormat === "line" ? "line" : "block";
+  let changelogMarkdown = typeof options.changelogMarkdown === "string" ? options.changelogMarkdown : null;
+  let snapshot = null;
+  let manual = null;
+  let queue = null;
+  let receipt = null;
+  let requestId = null;
+  let lastError = null;
+  let lastErrorKind = null;
+  let lastDiag = null;
+  let copyNotice = null;
+  let mounted = true;
+  let envProfileName = null;
+  let envHostKind = null;
+  function queueArgs() {
+    return { includeQueue: true, includeEnv: true, showOthers, ...requestId ? { requestId } : {} };
+  }
+  function render() {
+    if (!mounted) return;
+    const latest = snapshot?.latestVersion ?? null;
+    const skippedLatest = !!latest && validReleaseVersion(latest) && skipStore.has(latest);
+    container.innerHTML = renderUpdatePanelHTML({
+      snapshot,
+      manual,
+      queue,
+      skippedLatest,
+      lastError,
+      errorKind: lastErrorKind,
+      changelogMarkdown,
+      mode,
+      showOthers,
+      pluginId,
+      copyNotice,
+      theme,
+      // 使用范围与宿主种类：调用方显式传的优先，否则用宿主回的真值。
+      profileName: profileNameOption ?? envProfileName,
+      hostKind: hostKind ?? envHostKind
+    });
+  }
+  function applyStatusReply(reply) {
+    if (!isObject(reply)) return;
+    if (reply["ok"] === true) {
+      const s = asSnapshot(reply["snapshot"]);
+      if (s) snapshot = s;
+      manual = typeof reply["manual"] === "string" ? reply["manual"] : null;
+      if (reply["receipt"] && isObject(reply["receipt"]) && typeof reply["receipt"]["checkId"] === "string") {
+        receipt = { checkId: reply["receipt"]["checkId"] };
+      }
+      const q = asQueue(reply["queue"]);
+      if (q) queue = q;
+      const env = reply["env"];
+      if (isObject(env)) {
+        const pn = env["profileName"];
+        const hk = env["environmentKind"];
+        if (typeof pn === "string" && pn) envProfileName = pn;
+        if (typeof hk === "string" && hk) envHostKind = hk;
+      }
+      lastError = null;
+      lastErrorKind = null;
+      lastDiag = Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null;
+    } else {
+      lastError = typeof reply["error"] === "string" ? reply["error"] : "check-failed";
+      lastErrorKind = typeof reply["errorKind"] === "string" && reply["errorKind"].trim() ? reply["errorKind"].trim() : null;
+      lastDiag = Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null;
+    }
+  }
+  async function refresh() {
+    if (!mounted) return;
+    try {
+      const reply = await call(phoneNames.updateStatus, queueArgs());
+      if (!mounted) return;
+      applyStatusReply(reply);
+    } catch {
+      if (!mounted) return;
+      lastError = "check-failed";
+      lastErrorKind = null;
+      lastDiag = null;
+    }
+    render();
+  }
+  async function act(kind, arg) {
+    if (!mounted) return;
+    copyNotice = null;
+    switch (kind) {
+      case "check": {
+        try {
+          const reply = await call(phoneNames.updateCheck, queueArgs());
+          if (!mounted) return;
+          applyStatusReply(reply);
+        } catch {
+          if (!mounted) return;
+          lastError = "check-failed";
+          lastErrorKind = null;
+          lastDiag = null;
+        }
+        render();
+        return;
+      }
+      case "install": {
+        try {
+          if (!receipt) {
+            const checked = await call(phoneNames.updateCheck, queueArgs());
+            if (!mounted) return;
+            applyStatusReply(checked);
+          }
+          if (!mounted) return;
+          if (!receipt) {
+            lastError = "check-expired";
+            lastErrorKind = "check-expired";
+            lastDiag = null;
+            render();
+            return;
+          }
+          requestId = randomRequestId();
+          const reply = await call(phoneNames.updateInstall, {
+            checkId: receipt.checkId,
+            requestId,
+            ...queueArgs()
+          });
+          if (!mounted) return;
+          applyStatusReply(reply);
+        } catch {
+          if (!mounted) return;
+          lastError = "check-failed";
+          lastErrorKind = null;
+          lastDiag = null;
+        }
+        render();
+        return;
+      }
+      case "skip": {
+        const v = snapshot?.latestVersion ?? null;
+        if (v && validReleaseVersion(v)) {
+          try {
+            skipStore.skip(v);
+          } catch {
+          }
+        }
+        render();
+        return;
+      }
+      case "reset-skip": {
+        try {
+          skipStore.reset(arg ?? snapshot?.latestVersion ?? void 0);
+        } catch {
+        }
+        await refresh();
+        return;
+      }
+      case "copy-manual": {
+        if (manual) {
+          try {
+            await copyText(manual);
+            copyNotice = "\u624B\u5DE5\u547D\u4EE4\u5DF2\u590D\u5236\uFF0C\u7C98\u5230\u7EC8\u7AEF\u6574\u884C\u6267\u884C\u5373\u53EF\u3002";
+          } catch {
+            copyNotice = "\u590D\u5236\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u9009\u4E2D\u4E0A\u9762\u7684\u547D\u4EE4\u3002";
+          }
+        }
+        render();
+        return;
+      }
+      case "copy-diag": {
+        const jobCode = snapshot?.job?.state === "failed" ? messageCodeOf(snapshot.job.message) || "install-failed" : "";
+        const code = failureCodeOf(
+          { error: lastError, errorKind: lastErrorKind },
+          jobCode || snapshot?.blockedReason || "check-failed"
+        );
+        const detail = snapshot?.job?.message && snapshot.job.message.includes(":") ? snapshot.job.message.slice(snapshot.job.message.indexOf(":") + 1) : snapshot?.job?.message;
+        const text = buildUpdateDiagCopy({
+          pluginId,
+          code,
+          detail,
+          runningVersion: snapshot?.runningVersion ?? null,
+          installedVersion: snapshot?.installedVersion ?? null,
+          latestVersion: snapshot?.latestVersion ?? null,
+          hostKind,
+          queuePosition: queue?.position ?? null,
+          requestId,
+          checkId: receipt?.checkId ?? null,
+          route: null,
+          diag: lastDiag,
+          manual,
+          format: diagCopyFormat
+        });
+        try {
+          await copyText(text);
+          copyNotice = "\u8BCA\u65AD\u5DF2\u590D\u5236\uFF0C\u76F4\u63A5\u7C98\u7ED9\u63D2\u4EF6\u4F5C\u8005\u5373\u53EF\uFF08\u5DF2\u8131\u654F\uFF09\u3002";
+        } catch {
+          copyNotice = "\u590D\u5236\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u9009\u4E2D\u4E0A\u9762\u7684\u4FE1\u606F\u3002";
+        }
+        render();
+        return;
+      }
+      case "toggle-queue": {
+        showOthers = !showOthers;
+        await refresh();
+        return;
+      }
+      // 「重启宿主」：宿主没有重启自己的电话，所以只做入口——
+      // 调用方给了 onRestartRequested 就交给它；没给就如实说“请手动重启”，不假装。
+      case "restart-hint": {
+        try {
+          if (typeof onRestartRequested === "function") {
+            await onRestartRequested();
+            copyNotice = "\u5DF2\u6309\u8C03\u7528\u65B9\u7684\u91CD\u542F\u6D41\u7A0B\u5904\u7406\uFF1B\u91CD\u542F\u540E\u65B0\u7248\u751F\u6548\u3002";
+          } else {
+            copyNotice = "\u672C\u5BBF\u4E3B\u672A\u63D0\u4F9B\u91CD\u542F\u5165\u53E3\uFF1A\u8BF7\u624B\u52A8\u91CD\u542F\u5BBF\u4E3B\uFF0C\u91CD\u542F\u540E\u65B0\u7248\u751F\u6548\u3002";
+          }
+        } catch {
+          copyNotice = "\u91CD\u542F\u5165\u53E3\u8C03\u7528\u5931\u8D25\uFF1A\u8BF7\u624B\u52A8\u91CD\u542F\u5BBF\u4E3B\uFF0C\u91CD\u542F\u540E\u65B0\u7248\u751F\u6548\u3002";
+        }
+        render();
+        return;
+      }
+      case "close-view": {
+        if (mode === "dialog") unmount();
+        return;
+      }
+    }
+  }
+  async function setMode(next) {
+    if (next !== "embedded" && next !== "dialog") {
+      throw new Error(`[dsh-plugin-update] \u6446\u653E\u5F62\u6001\u975E\u6CD5\uFF1A\u53EA\u6536 embedded \u6216 dialog\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
+    }
+    mode = next;
+    render();
+  }
+  async function setTheme(next) {
+    if (next !== "default" && next !== "d5-paper") {
+      throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 d5-paper\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
+    }
+    theme = next;
+    render();
+  }
+  async function setShowOthers(show) {
+    showOthers = show === true;
+    await refresh();
+  }
+  function onClick(ev) {
+    try {
+      const t = ev;
+      const btn = t?.target && typeof t.target.closest === "function" ? t.target.closest("[data-action]") : null;
+      const kind = btn?.getAttribute ? btn.getAttribute("data-action") : null;
+      if (!kind) return;
+      void act(kind);
+    } catch {
+    }
+  }
+  function setChangelogMarkdown(markdown) {
+    changelogMarkdown = typeof markdown === "string" ? markdown : null;
+    render();
+  }
+  function unmount() {
+    if (!mounted) return;
+    mounted = false;
+    try {
+      timer.clear(handle);
+    } catch {
+    }
+    try {
+      container.removeEventListener?.("click", onClick);
+    } catch {
+    }
+  }
+  render();
+  try {
+    container.addEventListener?.("click", onClick);
+  } catch {
+  }
+  const timer = getTimer();
+  const handle = timer.set(() => {
+    void refresh();
+  }, pollMs);
+  try {
+    const h = handle;
+    if (h && typeof h.unref === "function") h.unref();
+  } catch {
+  }
+  void refresh();
+  return { refresh, act, setMode, setTheme, setShowOthers, setChangelogMarkdown, unmount };
+}
+import { buildPhoneNames as buildPhoneNames2 } from "./config.js";
+const PANEL_POLL = {
+  defaultMs: DEFAULT_PANEL_POLL_MS,
+  minMs: MIN_PANEL_POLL_MS
+};
+import {
+  QUEUE_INTENT_TTL_MS,
+  emptyQueueState,
+  normalizeQueueState,
+  queuePositionOf,
+  isHeadOfQueue,
+  isQueueBusy,
+  visibleQueueFor as visibleQueueFor2
+} from "./queue.js";
+import {
+  CHANGELOG_ALL_CATEGORIES,
+  CHANGELOG_FILENAME,
+  CHANGELOG_FOLDED,
+  CHANGELOG_MAX_BULLETS_PER_SECTION,
+  CHANGELOG_MAX_BULLET_CHARS,
+  CHANGELOG_MAX_CHARS,
+  CHANGELOG_MAX_ENTRIES,
+  CHANGELOG_MUST_SHOW,
+  CHANGELOG_NEUTRAL_HINT,
+  CHANGELOG_NEUTRAL_LINE,
+  changelogForUpdate as changelogForUpdate2,
+  hasVisibleSections,
+  isUnreleasedVersion,
+  parseChangelog as parseChangelog2,
+  renderChangelogHTML as renderChangelogHTML2,
+  renderChangelogNeutral,
+  renderChangelogSection,
+  selectChangelogEntries
+} from "./changelog.js";
+export {
+  CHANGELOG_ALL_CATEGORIES,
+  CHANGELOG_FILENAME,
+  CHANGELOG_FOLDED,
+  CHANGELOG_MAX_BULLETS_PER_SECTION,
+  CHANGELOG_MAX_BULLET_CHARS,
+  CHANGELOG_MAX_CHARS,
+  CHANGELOG_MAX_ENTRIES,
+  CHANGELOG_MUST_SHOW,
+  CHANGELOG_NEUTRAL_HINT,
+  CHANGELOG_NEUTRAL_LINE,
+  PANEL_DIAG_MAX_CHARS,
+  PANEL_POLL,
+  QUEUE_INTENT_TTL_MS,
+  UPDATE_PANEL_CSS,
+  UPDATE_PANEL_D5_CSS,
+  blockedCopy,
+  buildDiagnosticText,
+  buildPhoneNames2 as buildPanelPhoneNames,
+  buildUpdateDiagCopy,
+  changelogForUpdate2 as changelogForUpdate,
+  createBrowserSkipStore,
+  createMemorySkipStore,
+  emptyQueueState,
+  failureCodeOf,
+  failureCopy,
+  hasVisibleSections,
+  isHeadOfQueue,
+  isKnownFailureCode,
+  isQueueBusy,
+  isUnreleasedVersion,
+  mountUpdatePanel,
+  normalizeQueueState,
+  panelViewModel,
+  parseChangelog2 as parseChangelog,
+  queuePositionOf,
+  readDiagTolerant,
+  redactForCopy,
+  renderChangelogHTML2 as renderChangelogHTML,
+  renderChangelogNeutral,
+  renderChangelogSection,
+  renderUpdatePanelHTML,
+  renderUpdatePanelKernel,
+  selectChangelogEntries,
+  visibleQueueFor2 as visibleQueueFor
+};