dsh-plugin-update 0.3.1 → 0.4.0

package/dist/panel-batch.js

@@ -1,5 +1,6 @@
 // AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/panel-batch.ts
 import { assertPrefix, MIN_PANEL_POLL_MS } from "./config.js";
+import { validReleaseVersion } from "./service.js";
 import {
   isTerminalPhase,
   normalizeBatchSession
@@ -111,6 +112,7 @@ function renderBatchPanelHTML(input) {
   const notice = typeof input.notice === "string" && input.notice ? input.notice : null;
   const noticeKey = typeof input.noticeKey === "string" && input.noticeKey ? input.noticeKey : null;
   const detailNoticeKey = notice !== null && noticeKey !== null && noticeKey === expandedKey ? noticeKey : null;
+  const changelogs = input.changelogs && typeof input.changelogs === "object" ? input.changelogs : {};
   const ctx = {
     expanded: false,
     busy: installing,
@@ -118,15 +120,16 @@ function renderBatchPanelHTML(input) {
     theme,
     titles,
     skipped: null,
-    notice: null
+    notice: null,
+    changelogMarkdown: null
   };
   const parts = [];
   parts.push('<div class="dsh-upd-batch-head">');
   parts.push('<div class="dsh-upd-batch-title">\u66F4\u65B0\u6863\u6848 \xB7 <i>\u603B\u8D26</i></div>');
   parts.push('<div class="dsh-upd-batch-macros">');
-  parts.push('<button type="button" data-act="check"' + disabled + ">\u68C0\u67E5\u66F4\u65B0</button>");
-  parts.push('<button type="button" data-act="install" data-primary="1"' + disabled + ">\u5168\u90E8\u66F4\u65B0</button>");
-  if (mode === "dialog") parts.push('<button type="button" data-act="close">\u5173\u95ED</button>');
+  parts.push('<button type="button" data-act="check"' + disabled + ' title="\u91CD\u65B0\u8BFB\u53D6\u6279\u91CF\u72B6\u6001\uFF08\u53EA\u8BFB\uFF09">\u68C0\u67E5\u66F4\u65B0</button>');
+  parts.push('<button type="button" data-act="install" data-primary="1"' + disabled + ' title="\u628A\u6709\u65B0\u7248\u7684\u51E0\u5BB6\u4E00\u6B21\u63D0\u4EA4\uFF1B\u540C\u4E00\u4F1A\u8BDD\u540C\u4E00\u5E42\u7B49\u7F16\u53F7">\u5168\u90E8\u66F4\u65B0</button>');
+  if (mode === "dialog") parts.push('<button type="button" data-act="close" title="\u5173\u95ED\u9762\u677F\uFF08\u6279\u91CF\u63A8\u8FDB\u5728\u5BBF\u4E3B\u4FA7\u7EE7\u7EED\u8DD1\uFF09">\u5173\u95ED</button>');
   parts.push("</div>");
   parts.push("</div>");
   const summary = loaded ? batchSummaryText(counts, rows, total, installing, lastError !== null) : "\u6B63\u5728\u8BFB\u53D6\u6279\u91CF\u66F4\u65B0\u72B6\u6001\u2026";
@@ -142,7 +145,8 @@ function renderBatchPanelHTML(input) {
         ...ctx,
         expanded,
         skipped,
-        notice: expanded && row.key === detailNoticeKey ? notice : null
+        notice: expanded && row.key === detailNoticeKey ? notice : null,
+        changelogMarkdown: expanded && typeof changelogs[row.key] === "string" ? changelogs[row.key] : null
       })
     );
   }
@@ -153,7 +157,10 @@ function renderBatchPanelHTML(input) {
   if (total > 0 && !terminal) {
     const more = [];
     if (stalled) more.push('<button type="button" data-act="resume">\u63A5\u7740\u4E0A\u6B21</button>');
-    more.push('<button type="button" data-act="cancel"' + disabled + ">\u53D6\u6D88\u8FD9\u4E00\u6279</button>");
+    const confirmCancel = input.confirmCancel === true;
+    more.push(
+      '<button type="button" data-act="cancel"' + disabled + (confirmCancel ? ' data-confirm="1" title="\u518D\u70B9\u4E00\u6B21\u786E\u8BA4\u53D6\u6D88"' : ' title="\u53D6\u6D88\u8FD9\u4E00\u6279\uFF08\u8981\u70B9\u4E24\u6B21\u786E\u8BA4\uFF0C\u9632\u8BEF\u89E6\uFF09"') + ">" + (confirmCancel ? "\u786E\u8BA4\u53D6\u6D88\u8FD9\u4E00\u6279" : "\u53D6\u6D88\u8FD9\u4E00\u6279") + "</button>"
+    );
     parts.push('<div class="dsh-upd-batch-more">' + more.join("") + "</div>");
   }
   if (notice !== null && detailNoticeKey === null) {
@@ -263,6 +270,7 @@ function detailHTML(row, ctx) {
   const html = renderUpdatePanelHTML({
     snapshot: asSnapshotLike(row.snapshot),
     manual: typeof row.manual === "string" ? row.manual : null,
+    changelogMarkdown: typeof ctx.changelogMarkdown === "string" ? ctx.changelogMarkdown : null,
     queue: asQueueLike(row.queue),
     // 跳过是面板本地记录（与单插件面板同一套语义）：内核按「已跳过」画 tag 与提示行，
     // 恢复按钮由上面的动作行提供，措辞与内核提示里的「恢复」对得上。
@@ -363,6 +371,8 @@ const UPDATE_BATCH_PANEL_CSS = [
   ".dsh-upd-batch-ledger{margin:8px 0 0;font-size:13px;opacity:.85}",
   ".dsh-upd-batch-more{margin-top:6px}",
   ".dsh-upd-batch-more button{font-size:12px}",
+  // 确认态：红框红字，与「关闭」等中性按钮一眼区分；disabled 照旧置灰。
+  '.dsh-upd-batch-more button[data-confirm="1"]{border-color:var(--dsh-upd-bad-line,#dc2626);color:var(--dsh-upd-bad-line,#dc2626)}',
   ".dsh-upd-batch-notice{margin-top:6px;font-size:12.5px;opacity:.85}",
   ".dsh-upd-bdetail-actions{margin:0 0 6px}",
   ".dsh-upd .dsh-upd-bdetail-actions button{font-size:12.5px}",
@@ -617,6 +627,11 @@ function mountUpdateBatchPanel(container, options) {
   const onRestartRequested = options.onRestartRequested;
   const copyText = options.copyText ?? defaultCopyText;
   const skipStores = /* @__PURE__ */ new Map();
+  const autoChangelogEnabled = options.autoChangelog !== false;
+  const rowChangelog = /* @__PURE__ */ new Map();
+  const rowInflight = /* @__PURE__ */ new Set();
+  const rowFailed = /* @__PURE__ */ new Map();
+  let rowAutoSeq = 0;
   let rows = [];
   let expandedKey = null;
   let lastError = null;
@@ -625,7 +640,60 @@ function mountUpdateBatchPanel(container, options) {
   let inFlight = false;
   let loaded = false;
   let refreshing = false;
+  let confirmCancelArmed = false;
   let mounted = true;
+  function changelogView() {
+    const out = {};
+    for (const row of rows) {
+      const cached = rowChangelog.get(row.key);
+      if (!cached || typeof cached.markdown !== "string") continue;
+      if (latestVersionOf(row) !== cached.version) continue;
+      out[row.key] = cached.markdown;
+    }
+    return out;
+  }
+  function changelogPhoneOf(row) {
+    const phones2 = isObject(row.phoneNames) ? row.phoneNames : null;
+    if (!phones2) return null;
+    const name = phones2["updateChangelog"];
+    return typeof name === "string" && name ? name : null;
+  }
+  function maybeAutoRowChangelog(key) {
+    if (!autoChangelogEnabled || !mounted || !key) return;
+    const row = rowOfKey(key);
+    if (!row || asBatchPhase(row.phase) !== "ready") return;
+    const version = latestVersionOf(row);
+    if (!version || !validReleaseVersion(version)) return;
+    try {
+      if (skipStoreFor(pluginIdOf(row)).has(version)) return;
+    } catch {
+    }
+    const cached = rowChangelog.get(key);
+    if (cached && cached.version === version) return;
+    if (rowInflight.has(key)) return;
+    if (rowFailed.get(key) === version) return;
+    const phone2 = changelogPhoneOf(row);
+    if (!phone2) return;
+    rowInflight.add(key);
+    const seq = rowAutoSeq;
+    void Promise.resolve().then(() => call(phone2, { version })).then(
+      (reply) => {
+        rowInflight.delete(key);
+        if (!mounted || seq !== rowAutoSeq) return;
+        if (!isObject(reply) || reply["ok"] !== true) {
+          rowFailed.set(key, version);
+          return;
+        }
+        const md = reply["markdown"];
+        rowChangelog.set(key, { version, markdown: typeof md === "string" ? md : null });
+        if (typeof md === "string") render();
+      },
+      () => {
+        rowInflight.delete(key);
+        if (mounted && seq === rowAutoSeq) rowFailed.set(key, version);
+      }
+    );
+  }
   function render() {
     if (!mounted) return;
     container.innerHTML = renderBatchPanelHTML({
@@ -639,7 +707,9 @@ function mountUpdateBatchPanel(container, options) {
       skippedVersions: skippedVersionsOf(),
       inFlight,
       loaded,
-      titles
+      titles,
+      confirmCancel: confirmCancelArmed,
+      changelogs: changelogView()
     });
   }
   function rowOfKey(key) {
@@ -717,6 +787,7 @@ function mountUpdateBatchPanel(container, options) {
       refreshing = false;
     }
     render();
+    maybeAutoRowChangelog(expandedKey);
   }
   async function phone(name, args, busyRowKey = null) {
     if (!mounted || inFlight) return;
@@ -731,6 +802,7 @@ function mountUpdateBatchPanel(container, options) {
         return;
       }
       applyReply(reply);
+      rowFailed.clear();
     } catch {
       if (!mounted) return;
       lastError = "check-failed";
@@ -738,9 +810,14 @@ function mountUpdateBatchPanel(container, options) {
       inFlight = false;
       if (mounted) render();
     }
+    maybeAutoRowChangelog(expandedKey);
   }
   async function act(kind, key) {
     if (!mounted) return;
+    if (kind !== "cancel" && confirmCancelArmed) {
+      confirmCancelArmed = false;
+      render();
+    }
     switch (kind) {
       case "check":
         return phone(phones.check, {});
@@ -757,7 +834,10 @@ function mountUpdateBatchPanel(container, options) {
         render();
         return;
       }
+      // 程序调用（controller.act）即执行：调它就是明确意图，不上膛。
+      // 鼠标误触的防护在 onClick 那一层（第一次点击只上膛）。
       case "cancel": {
+        confirmCancelArmed = false;
         await phone(phones.cancel, {});
         if (!mounted) return;
         say("\u5DF2\u53D6\u6D88\u8FD9\u4E00\u6279\uFF1A\u5269\u4E0B\u7684\u4E0D\u518D\u63A8\u8FDB\uFF1B\u8981\u91CD\u6765\u70B9\u300C\u68C0\u67E5\u66F4\u65B0\u300D\u3002");
@@ -833,6 +913,7 @@ function mountUpdateBatchPanel(container, options) {
         if (typeof key !== "string" || !key) return;
         expandedKey = expandedKey === key ? null : key;
         render();
+        maybeAutoRowChangelog(expandedKey);
         return;
       }
       // 「重启宿主」：宿主没有重启自己的电话，只做入口——调用方给了 onRestartRequested 就交给它，
@@ -859,6 +940,14 @@ function mountUpdateBatchPanel(container, options) {
         return;
     }
   }
+  function onKeyDown(ev) {
+    try {
+      const e = ev;
+      if (!mounted || mode !== "dialog" || !e || e.key !== "Escape") return;
+      unmount();
+    } catch {
+    }
+  }
   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");
@@ -879,6 +968,13 @@ function mountUpdateBatchPanel(container, options) {
       const btn = t?.target && typeof t.target.closest === "function" ? t.target.closest("[data-act]") : null;
       const kind = btn?.getAttribute ? btn.getAttribute("data-act") : null;
       if (!kind) return;
+      if (kind === "cancel" && !confirmCancelArmed) {
+        confirmCancelArmed = true;
+        say("\u518D\u70B9\u4E00\u6B21\u300C\u786E\u8BA4\u53D6\u6D88\u8FD9\u4E00\u6279\u300D\u624D\u771F\u7684\u53D6\u6D88\uFF1B\u70B9\u522B\u7684\u6309\u94AE\u53EF\u64A4\u9500\u8FD9\u6B21\u786E\u8BA4\u3002");
+        render();
+        return;
+      }
+      if (kind === "cancel") confirmCancelArmed = false;
       const key = btn?.getAttribute ? btn.getAttribute("data-key") : null;
       void act(kind, key === null ? void 0 : key);
     } catch {
@@ -887,6 +983,8 @@ function mountUpdateBatchPanel(container, options) {
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    rowAutoSeq++;
+    rowInflight.clear();
     try {
       timer.clear(handle);
     } catch {
@@ -895,12 +993,20 @@ function mountUpdateBatchPanel(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();

package/dist/panel.d.ts

@@ -43,9 +43,15 @@ export interface UpdatePanelOptions {
     /**
      * 更新日志 Markdown（#23 包内 CHANGELOG 展示）：
      * 调用方按“已装版离线读、新版按需取 tarball”备好后传入（取不到传 null/空串即中性提示）；
-     * 面板只渲染不取数，缺日志永不挡安装、不写 blockedReason。
+     * 缺日志永不挡安装、不写 blockedReason。
+     * 显式传入即赢：自动链路（见 autoChangelog）永不覆盖它。
      */
     changelogMarkdown?: string | null;
+    /**
+     * 自动取日志（#38）：默认开。有新版时面板按 latestVersion 调一次宿主更新日志电话，
+     * 回来经内部通道换日志节；显式传过 changelogMarkdown 或传 false 即退回手动模式。
+     */
+    autoChangelog?: boolean;
 }
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface UpdatePanelContainer {
@@ -221,6 +227,11 @@ export interface PanelRenderInput extends PanelViewInput {
     profileName?: string | null;
     /** 宿主种类：进诊断文本；缺省显示“未知”。 */
     hostKind?: string | null;
+    /**
+     * 在途动作（仅挂载态内部用：点下查新版/安装到回包前的那一帧，按钮置忙）。
+     * 缺省即静默（输出与旧版一字不差）；只在挂载器置忙的那次 render 里传。
+     */
+    busyAct?: 'check' | 'install' | null;
     /**
      * 动作面归谁：`default`（缺省）由内核画动作按钮；`none` 只画内容、不画按钮。
      * 给「调用方自己提供动作面」的场景（如批量面板的详情：动作由批量面板经自己的通道提供）。
@@ -242,6 +253,8 @@ export declare function renderUpdatePanelHTML(input: PanelRenderInput): string;
 export declare function mountUpdatePanel(container: UpdatePanelContainer, options: UpdatePanelOptions): UpdatePanelController;
 export { buildPhoneNames as buildPanelPhoneNames } from './config.js';
 export type { PhoneAction as PanelPhoneAction } from './config.js';
+export { buildChangelogPhoneName as buildPanelChangelogPhoneName } from './config.js';
+export type { ChangelogPhoneAction as PanelChangelogPhoneAction } from './config.js';
 /** 面板轮询口径（默认 1 秒、下限 250 毫秒，与宿主侧同一套）。 */
 export declare const PANEL_POLL: {
     readonly defaultMs: 1000;

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 {
@@ -551,8 +551,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 +698,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 +734,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>");
   }
@@ -918,6 +943,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`);
@@ -948,20 +980,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({
       snapshot,
       manual,
       queue,
+      busyAct,
       skippedLatest,
       lastError,
       errorKind: lastErrorKind,
@@ -1003,6 +1051,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 +1102,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 +1163,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 +1194,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 +1227,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,12 +1245,12 @@ 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;
@@ -1185,13 +1289,24 @@ function mountUpdatePanel(container, options) {
     } catch {
     }
   }
+  function onKeyDown(ev) {
+    try {
+      const e = ev;
+      if (!mounted || mode !== "dialog" || !e || e.key !== "Escape") return;
+      unmount();
+    } 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 +1315,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 +1342,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 +1394,7 @@ export {
   UPDATE_PANEL_D5_CSS,
   blockedCopy,
   buildDiagnosticText,
+  buildChangelogPhoneName2 as buildPanelChangelogPhoneName,
   buildPhoneNames2 as buildPanelPhoneNames,
   buildUpdateDiagCopy,
   changelogForUpdate2 as changelogForUpdate,

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;