dsh-plugin-update 0.3.1 → 0.5.0

package/dist/panel.js

@@ -1,5 +1,5 @@
 // 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 { buildChangelogPhoneName, 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 {
@@ -7,6 +7,9 @@ import {
   parseChangelog,
   renderChangelogHTML
 } from "./changelog.js";
+function normalizePanelTheme(value) {
+  return value === "d5-paper" || value === "archive" ? "d5-paper" : "default";
+}
 const BLOCKED_COPY = {
   "unknown-profile": {
     title: "\u4F7F\u7528\u8303\u56F4\u6216\u63D2\u4EF6\u4F4D\u7F6E\u8BA4\u4E0D\u51FA",
@@ -551,8 +554,25 @@ const UPDATE_PANEL_CSS = [
   ".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}",
+  // 骨架微光：只在首帧 loading 出现；reduced-motion 下静止占位，不断语义。
+  ".dsh-upd-skv{display:inline-block;min-width:64px;border-radius:3px;color:transparent !important;user-select:none;",
+  "background:linear-gradient(90deg,var(--dsh-upd-line,#e5e7eb) 25%,var(--dsh-upd-soft,#f3f4f6) 50%,var(--dsh-upd-line,#e5e7eb) 75%);",
+  "background-size:200% 100%;animation:dsh-upd-shimmer 1.2s linear infinite}",
+  "@keyframes dsh-upd-shimmer{to{background-position:-200% 0}}",
   ".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}",
+  // —— 全按钮交互反馈（#36：悬停/按下/过渡/在途忙态；浅深双主题通用写法，不碰上面的既有串）——
+  ".dsh-upd button{transition:background-color .15s ease,border-color .15s ease,color .15s ease,transform .06s ease}",
+  ".dsh-upd button:hover:not(:disabled){border-color:var(--dsh-upd-focus,#2563eb)}",
+  '.dsh-upd button[data-primary="1"]:hover:not(:disabled){filter:brightness(.93)}',
+  ".dsh-upd button:active:not(:disabled){transform:translateY(1px)}",
+  '.dsh-upd button[aria-busy="true"]{cursor:wait;animation:dsh-upd-pulse 1s ease-in-out infinite}',
+  "@keyframes dsh-upd-pulse{0%,100%{opacity:1}50%{opacity:.55}}",
+  // 在途转圈：纯 CSS ::after，不加 DOM 节点（内核 DOM 冻结）；转的是边框缺口，不是 emoji。
+  '.dsh-upd button[aria-busy="true"]::after{content:"";display:inline-block;width:11px;height:11px;margin-left:8px;vertical-align:-1px;',
+  "border:2px solid currentColor;border-top-color:transparent;border-radius:50%;animation:dsh-upd-spin .8s linear infinite}",
+  "@keyframes dsh-upd-spin{to{transform:rotate(360deg)}}",
+  '@media (prefers-reduced-motion: reduce){.dsh-upd button{transition:none}.dsh-upd button:active:not(:disabled){transform:none}.dsh-upd button[aria-busy="true"]{animation:none}.dsh-upd-skv{animation:none}}',
   "@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;",
   // 横幅深色覆盖：底色用低透明度同色系（不是浅色原值），边线提亮，保证「深底浅字」可读。
@@ -681,6 +701,11 @@ function chapterOf(index, inner, note = "") {
   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 skeletonStrip(loading) {
+  if (!loading) return "";
+  const cell = (k) => `<div><span class="dsh-upd-strip-k">${escapeHtml(k)}</span><span class="dsh-upd-strip-v dsh-upd-skv" aria-hidden="true">\u2026</span></div>`;
+  return `<div class="dsh-upd-strip" aria-hidden="true">` + cell("\u8FD0\u884C") + cell("\u78C1\u76D8") + cell("\u8FDC\u7AEF") + `</div>`;
+}
 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 "";
@@ -712,31 +737,34 @@ function renderUpdatePanelKernel(input, view) {
   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));
+  parts.push(snapshot ? versionStrip(snapshot) : skeletonStrip(view.banner.kind === "loading"));
   const showActions = input.actions !== "none";
   const actions = [];
   if (showActions) {
+    const busyAct = input.busyAct;
+    const checkBusy = busyAct === "check";
+    const installBusy = busyAct === "install";
     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>`
+      (checkBusy ? `<button type="button" data-action="check" disabled aria-busy="true" title="\u6B63\u5728\u5411\u5B98\u65B9\u6E90\u67E5\u8BE2\uFF0C\u8BF7\u7A0D\u5019">\u6B63\u5728\u67E5\u65B0\u7248\u2026</button>` : `<button type="button" data-action="check" title="\u91CD\u65B0\u5411\u5B98\u65B9\u6E90\u67E5\u4E00\u6B21\u65B0\u7248\uFF08\u53EA\u8BFB\uFF0C\u4E0D\u5B89\u88C5\uFF09">\u67E5\u65B0\u7248</button>`) + (installBusy ? `<button type="button" data-action="install" data-primary="1" disabled aria-busy="true" title="\u6B63\u5728\u5B89\u88C5\uFF0C\u8BF7\u7A0D\u5019">\u6B63\u5728\u5B89\u88C5\u2026</button>` : `<button type="button" data-action="install" data-primary="1" title="\u7528\u7CBE\u786E\u7248\u672C\u5B89\u88C5\uFF1B\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u540C\u65F6\u53EA\u88C5\u4E00\u4E2A"${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>`);
+      actions.push(`<button type="button" data-action="skip" title="\u8BE5\u7248\u672C\u4E0D\u518D\u63D0\u9192\uFF1B\u6709\u66F4\u65B0\u7684\u65B0\u7248\u672C\u7167\u5E38\u63D0\u9192">\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>`);
+      actions.push(`<button type="button" data-action="reset-skip" title="\u64A4\u9500\u8DF3\u8FC7\uFF0C\u8BE5\u7248\u672C\u91CD\u65B0\u63D0\u9192">\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>`);
+      actions.push(`<button type="button" data-action="copy-manual" title="\u590D\u5236\u624B\u5DE5\u547D\u4EE4\uFF0C\u7C98\u5230\u7EC8\u7AEF\u6574\u884C\u6267\u884C">\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>`);
+      actions.push(`<button type="button" data-action="restart-hint" data-primary="1" title="\u5BBF\u4E3B\u6CA1\u6709\u81EA\u91CD\u542F\u7535\u8BDD\uFF1A\u8BF7\u624B\u52A8\u91CD\u542F\u5BBF\u4E3B">\u91CD\u542F\u5BBF\u4E3B</button>`);
     }
     if (snapshot) {
-      actions.push(`<button type="button" data-action="copy-diag">\u590D\u5236\u8BCA\u65AD</button>`);
+      actions.push(`<button type="button" data-action="copy-diag" title="\u590D\u5236\u5DF2\u8131\u654F\u8BCA\u65AD\uFF0C\u76F4\u63A5\u7C98\u7ED9\u63D2\u4EF6\u4F5C\u8005">\u590D\u5236\u8BCA\u65AD</button>`);
     }
     if (mode === "dialog") {
-      actions.push(`<button type="button" data-action="close-view">\u5173\u95ED</button>`);
+      actions.push(`<button type="button" data-action="close-view" title="\u5173\u95ED\u9762\u677F\uFF08\u5B89\u88C5\u5728\u5BBF\u4E3B\u4FA7\u7EE7\u7EED\u8DD1\uFF0C\u53EF\u91CD\u5F00\u6062\u590D\u663E\u793A\uFF09">\u5173\u95ED</button>`);
     }
     actions.push("</div>");
   }
@@ -838,7 +866,7 @@ ${changelogHTML}
 function renderUpdatePanelHTML(input) {
   const view = panelViewModel(input);
   const kernel = renderUpdatePanelKernel(input, view);
-  const d5 = input.theme === "d5-paper";
+  const d5 = normalizePanelTheme(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}>
@@ -918,6 +946,13 @@ function mountUpdatePanel(container, options) {
   }
   const prefix = options.prefix === void 0 ? "wf" : options.prefix;
   const phoneNames = buildPhoneNames(prefix);
+  const changelogPhone = buildChangelogPhoneName(prefix);
+  const autoChangelogEnabled = typeof options.changelogMarkdown !== "string" && options.autoChangelog !== false;
+  let manualChangelogOverride = typeof options.changelogMarkdown === "string";
+  const changelogCache = /* @__PURE__ */ new Map();
+  const changelogInflight = /* @__PURE__ */ new Set();
+  const changelogFailed = /* @__PURE__ */ new Set();
+  let autoSeq = 0;
   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`);
@@ -926,13 +961,15 @@ function mountUpdatePanel(container, options) {
   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`);
+  if (options.theme !== void 0 && options.theme !== "default" && options.theme !== "archive" && options.theme !== "d5-paper") {
+    throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08d5-paper \u4E3A\u65E7\u522B\u540D\u4ECD\u53EF\u7528\uFF09\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
   }
+  let theme = normalizePanelTheme(options.theme ?? "default");
   let showOthers = options.showOthers === true;
   const call = options.call;
   const onRestartRequested = options.onRestartRequested;
+  const onCloseRequested = typeof options.onCloseRequested === "function" ? options.onCloseRequested : null;
+  let lastHTML = "";
   const copyText = options.copyText ?? defaultCopyText;
   const skipStore = options.skipStore ?? createBrowserSkipStore(pluginId);
   const hostKind = typeof options.hostKind === "string" && options.hostKind ? options.hostKind : null;
@@ -948,20 +985,36 @@ function mountUpdatePanel(container, options) {
   let lastErrorKind = null;
   let lastDiag = null;
   let copyNotice = null;
+  let noticeExpiresAt = 0;
+  let busyAct = null;
   let mounted = true;
   let envProfileName = null;
   let envHostKind = null;
+  function sayCopy(text) {
+    copyNotice = text;
+    try {
+      noticeExpiresAt = Date.now() + 5e3;
+    } catch {
+      noticeExpiresAt = 0;
+    }
+  }
   function queueArgs() {
     return { includeQueue: true, includeEnv: true, showOthers, ...requestId ? { requestId } : {} };
   }
   function render() {
     if (!mounted) return;
+    if (!copyNotice) noticeExpiresAt = 0;
+    else if (noticeExpiresAt && Date.now() > noticeExpiresAt) {
+      copyNotice = null;
+      noticeExpiresAt = 0;
+    }
     const latest = snapshot?.latestVersion ?? null;
     const skippedLatest = !!latest && validReleaseVersion(latest) && skipStore.has(latest);
-    container.innerHTML = renderUpdatePanelHTML({
+    const nextHTML = renderUpdatePanelHTML({
       snapshot,
       manual,
       queue,
+      busyAct,
       skippedLatest,
       lastError,
       errorKind: lastErrorKind,
@@ -975,6 +1028,10 @@ function mountUpdatePanel(container, options) {
       profileName: profileNameOption ?? envProfileName,
       hostKind: hostKind ?? envHostKind
     });
+    if (nextHTML !== lastHTML) {
+      lastHTML = nextHTML;
+      container.innerHTML = nextHTML;
+    }
   }
   function applyStatusReply(reply) {
     if (!isObject(reply)) return;
@@ -1003,6 +1060,44 @@ function mountUpdatePanel(container, options) {
       lastDiag = Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null;
     }
   }
+  function pendingAutoChangelogVersion() {
+    if (!autoChangelogEnabled || manualChangelogOverride || !mounted) return null;
+    const v = snapshot?.latestVersion ?? null;
+    if (typeof v !== "string" || !validReleaseVersion(v)) return null;
+    if (!snapshot || snapshot.canInstall !== true) return null;
+    try {
+      if (skipStore.has(v)) return null;
+    } catch {
+    }
+    if (changelogCache.has(v) || changelogInflight.has(v) || changelogFailed.has(v)) return null;
+    return v;
+  }
+  function maybeAutoChangelog() {
+    const v = pendingAutoChangelogVersion();
+    if (v === null) return;
+    changelogInflight.add(v);
+    const seq = autoSeq;
+    void Promise.resolve().then(() => call(changelogPhone, { version: v })).then(
+      (reply) => {
+        changelogInflight.delete(v);
+        if (!mounted || seq !== autoSeq) return;
+        if (!reply || typeof reply !== "object" || reply["ok"] !== true) {
+          changelogFailed.add(v);
+          return;
+        }
+        const md = reply["markdown"];
+        changelogCache.set(v, typeof md === "string" ? md : null);
+        if (typeof md === "string") {
+          changelogMarkdown = md;
+          render();
+        }
+      },
+      () => {
+        changelogInflight.delete(v);
+        if (mounted && seq === autoSeq) changelogFailed.add(v);
+      }
+    );
+  }
   async function refresh() {
     if (!mounted) return;
     try {
@@ -1016,26 +1111,40 @@ function mountUpdatePanel(container, options) {
       lastDiag = null;
     }
     render();
+    maybeAutoChangelog();
   }
   async function act(kind, arg) {
     if (!mounted) return;
     copyNotice = null;
     switch (kind) {
       case "check": {
+        if (busyAct) return;
+        busyAct = "check";
+        copyNotice = "\u6B63\u5728\u67E5\u65B0\u7248\u2026";
+        render();
         try {
           const reply = await call(phoneNames.updateCheck, queueArgs());
           if (!mounted) return;
           applyStatusReply(reply);
+          changelogFailed.clear();
         } catch {
           if (!mounted) return;
           lastError = "check-failed";
           lastErrorKind = null;
           lastDiag = null;
+        } finally {
+          busyAct = null;
+          if (copyNotice === "\u6B63\u5728\u67E5\u65B0\u7248\u2026") copyNotice = null;
         }
         render();
+        maybeAutoChangelog();
         return;
       }
       case "install": {
+        if (busyAct) return;
+        busyAct = "install";
+        copyNotice = "\u6B63\u5728\u5B89\u88C5\u2026";
+        render();
         try {
           if (!receipt) {
             const checked = await call(phoneNames.updateCheck, queueArgs());
@@ -1063,8 +1172,12 @@ function mountUpdatePanel(container, options) {
           lastError = "check-failed";
           lastErrorKind = null;
           lastDiag = null;
+        } finally {
+          busyAct = null;
+          if (copyNotice === "\u6B63\u5728\u5B89\u88C5\u2026") copyNotice = null;
         }
         render();
+        maybeAutoChangelog();
         return;
       }
       case "skip": {
@@ -1090,9 +1203,9 @@ function mountUpdatePanel(container, options) {
         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";
+            sayCopy("\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";
+            sayCopy("\u590D\u5236\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u9009\u4E2D\u4E0A\u9762\u7684\u547D\u4EE4\u3002");
           }
         }
         render();
@@ -1123,9 +1236,9 @@ function mountUpdatePanel(container, options) {
         });
         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";
+          sayCopy("\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";
+          sayCopy("\u590D\u5236\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u9009\u4E2D\u4E0A\u9762\u7684\u4FE1\u606F\u3002");
         }
         render();
         return;
@@ -1141,18 +1254,18 @@ function mountUpdatePanel(container, options) {
         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";
+            sayCopy("\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";
+            sayCopy("\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";
+          sayCopy("\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();
+        await requestDialogClose();
         return;
       }
     }
@@ -1165,10 +1278,10 @@ function mountUpdatePanel(container, options) {
     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`);
+    if (next !== "default" && next !== "archive" && next !== "d5-paper") {
+      throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08d5-paper \u4E3A\u65E7\u522B\u540D\u4ECD\u53EF\u7528\uFF09\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
     }
-    theme = next;
+    theme = normalizePanelTheme(next);
     render();
   }
   async function setShowOthers(show) {
@@ -1185,13 +1298,34 @@ function mountUpdatePanel(container, options) {
     } catch {
     }
   }
+  async function requestDialogClose() {
+    if (!mounted || mode !== "dialog") return;
+    if (onCloseRequested) {
+      try {
+        await onCloseRequested();
+      } catch {
+      }
+    }
+    unmount();
+  }
+  function onKeyDown(ev) {
+    try {
+      const e = ev;
+      if (!mounted || mode !== "dialog" || !e || e.key !== "Escape") return;
+      void requestDialogClose();
+    } catch {
+    }
+  }
   function setChangelogMarkdown(markdown) {
     changelogMarkdown = typeof markdown === "string" ? markdown : null;
+    if (typeof markdown === "string") manualChangelogOverride = true;
     render();
   }
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    autoSeq++;
+    changelogInflight.clear();
     try {
       timer.clear(handle);
     } catch {
@@ -1200,12 +1334,20 @@ function mountUpdatePanel(container, options) {
       container.removeEventListener?.("click", onClick);
     } catch {
     }
+    try {
+      container.removeEventListener?.("keydown", onKeyDown);
+    } catch {
+    }
   }
   render();
   try {
     container.addEventListener?.("click", onClick);
   } catch {
   }
+  try {
+    container.addEventListener?.("keydown", onKeyDown);
+  } catch {
+  }
   const timer = getTimer();
   const handle = timer.set(() => {
     void refresh();
@@ -1219,6 +1361,7 @@ function mountUpdatePanel(container, options) {
   return { refresh, act, setMode, setTheme, setShowOthers, setChangelogMarkdown, unmount };
 }
 import { buildPhoneNames as buildPhoneNames2 } from "./config.js";
+import { buildChangelogPhoneName as buildChangelogPhoneName2 } from "./config.js";
 const PANEL_POLL = {
   defaultMs: DEFAULT_PANEL_POLL_MS,
   minMs: MIN_PANEL_POLL_MS
@@ -1270,6 +1413,7 @@ export {
   UPDATE_PANEL_D5_CSS,
   blockedCopy,
   buildDiagnosticText,
+  buildChangelogPhoneName2 as buildPanelChangelogPhoneName,
   buildPhoneNames2 as buildPanelPhoneNames,
   buildUpdateDiagCopy,
   changelogForUpdate2 as changelogForUpdate,
@@ -1284,6 +1428,7 @@ export {
   isQueueBusy,
   isUnreleasedVersion,
   mountUpdatePanel,
+  normalizePanelTheme,
   normalizeQueueState,
   panelViewModel,
   parseChangelog2 as parseChangelog,

package/dist/service.d.ts

@@ -69,4 +69,18 @@ export declare function fetchNpmRelease(fetchImpl: FetchImpl, timeoutMs?: number
     registryUrl?: string;
     releaseChannel?: ReleaseChannel;
 }): Promise<ReleaseInfo>;
+/**
+ * 按版本号取发行信息（#38 更新日志电话用：面板说要哪版就取哪版）。
+ *
+ * 与 fetchNpmRelease 同一信任根：只接受名字对得上、版本与请求完全一致且发行合法、
+ * 包地址与完整性校验全合规的返回，否则按版本信息无效处理。通道门禁同样复用
+ * （stable 只要纯三段，prerelease 才收预发布）。取的是版本文档（与 latest 文档同量级），
+ * 不是全量包元数据。
+ */
+export declare function fetchNpmVersionRelease(fetchImpl: FetchImpl, timeoutMs: number | undefined, opts: {
+    targetPackageName?: string;
+    registryUrl?: string;
+    releaseChannel?: ReleaseChannel;
+    version: string;
+}): Promise<ReleaseInfo>;
 export declare function createUpdateCore(ports: UpdatePorts): UpdateCore;

package/dist/service.js

@@ -226,6 +226,55 @@ async function fetchNpmRelease(fetchImpl, timeoutMs = CHECK_TIMEOUT_MS, opts) {
     throw checkFailedWithStatus(response);
   }
 }
+async function fetchNpmVersionRelease(fetchImpl, timeoutMs = CHECK_TIMEOUT_MS, opts) {
+  const targetName = opts?.targetPackageName ?? PACKAGE_NAME;
+  const registry = opts?.registryUrl ?? NPM_REGISTRY;
+  const channel = opts?.releaseChannel === "prerelease" ? "prerelease" : "stable";
+  const version = opts?.version;
+  if (typeof version !== "string" || !validReleaseVersion(version) || !isVersionAllowedInChannel(version, channel)) {
+    throw updateError("invalid-release");
+  }
+  let response = null;
+  try {
+    response = await fetchImpl(`${registry}${encodeURIComponent(targetName)}/${encodeURIComponent(version)}`, {
+      headers: { accept: "application/json" },
+      redirect: "error",
+      signal: timeoutSignal(timeoutMs)
+    });
+  } catch {
+    throw updateError("check-failed");
+  }
+  try {
+    if (!response.ok) throw checkFailedWithStatus(response);
+    const declared = Number(response.headers.get("content-length"));
+    if (Number.isFinite(declared) && declared > MAX_METADATA_BYTES) throw updateError("invalid-release");
+    const text = await response.text();
+    if (byteLength(text) > MAX_METADATA_BYTES) throw updateError("invalid-release");
+    const value = JSON.parse(text);
+    if (value.name !== targetName || value.version !== version || !isVersionAllowedInChannel(value.version, channel)) {
+      throw updateError("invalid-release");
+    }
+    const nodeRange = value.engines?.node;
+    if (nodeRange !== void 0 && typeof nodeRange !== "string") throw updateError("invalid-release");
+    const tarballText = value.dist?.tarball;
+    const integrity = value.dist?.integrity;
+    let tarball;
+    try {
+      tarball = new URL(String(tarballText));
+    } catch {
+      throw updateError("invalid-release");
+    }
+    const registryOrigin = new URL(registry).origin;
+    const shapeOk = tarball.origin === registryOrigin && !tarball.username && !tarball.password && !tarball.search && !tarball.hash && tarball.pathname === `/${targetName}/-/${targetName}-${version}.tgz` && typeof integrity === "string" && new RegExp(INTEGRITY_PATTERN).test(integrity);
+    if (!shapeOk) throw updateError("invalid-release");
+    return { version, nodeRange: typeof nodeRange === "string" ? nodeRange : "*", integrity, tarball: tarball.href };
+  } catch (error) {
+    if (error?.code === "check-failed") throw error;
+    if (error?.code === "invalid-release") throw error;
+    if (response !== null && response.ok) throw updateError("invalid-release");
+    throw checkFailedWithStatus(response);
+  }
+}
 function createUpdateCore(ports) {
   const checkTimeoutMs = ports.checkTimeoutMs ?? CHECK_TIMEOUT_MS;
   const confirmationTtlMs = ports.confirmationTtlMs ?? CONFIRMATION_TTL_MS;
@@ -446,6 +495,7 @@ export {
   compareVersions,
   createUpdateCore,
   fetchNpmRelease,
+  fetchNpmVersionRelease,
   isPrereleaseVersion,
   isVersionAllowedInChannel,
   satisfiesNodeRange,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-update",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "可复用的更新系统装成的 npm 包：任何 DSH 插件照文档能集成检查更新等功能（地图 #579）",
   "license": "MIT",
   "author": "王辰浩",