dsh-plugin-update 0.3.1 → 0.5.0

package/dist/http.d.ts

@@ -8,8 +8,8 @@ export declare const HTTP_TRANSPORT_FAILED = "http-transport-failed";
 export declare const DEFAULT_HTTP_CHECK_TIMEOUT_MS = 15000;
 export declare const DEFAULT_HTTP_INSTALL_TIMEOUT_MS: number;
 export declare const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15000;
-/** 单插件三电话动作名（与 src/config.ts PHONE_ACTIONS 同字面，不另起字面）。 */
-export declare const HTTP_PHONE_ACTIONS: readonly ["updateStatus", "updateCheck", "updateInstall"];
+/** 单插件电话动作名（旧三电话与 src/config.ts PHONE_ACTIONS 同字面，不另起字面；#38 加 updateChangelog）。 */
+export declare const HTTP_PHONE_ACTIONS: readonly ["updateStatus", "updateCheck", "updateInstall", "updateChangelog"];
 export type HttpPhoneAction = (typeof HTTP_PHONE_ACTIONS)[number];
 /** 批量五电话动作名（与 src/panel-batch.ts buildBatchPhoneNames 同字面，不另起字面；同一内核）。 */
 export declare const HTTP_BATCH_ACTIONS: readonly ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];

package/dist/http.js

@@ -10,7 +10,7 @@ const HTTP_TRANSPORT_FAILED = "http-transport-failed";
 const DEFAULT_HTTP_CHECK_TIMEOUT_MS = 15e3;
 const DEFAULT_HTTP_INSTALL_TIMEOUT_MS = 16 * 6e4;
 const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15e3;
-const HTTP_PHONE_ACTIONS = ["updateStatus", "updateCheck", "updateInstall"];
+const HTTP_PHONE_ACTIONS = ["updateStatus", "updateCheck", "updateInstall", "updateChangelog"];
 const HTTP_BATCH_ACTIONS = ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];
 function isAbsoluteUrl(value) {
   return /^https?:\/\//i.test(value);
@@ -42,6 +42,7 @@ function allowedRouteKeys(prefix, batchPrefix) {
       out.add(batchPrefix + "." + a);
     }
   }
+  out.add("updateChangelog");
   return out;
 }
 function assertHttpRoutes(routes, prefix, batchPrefix) {
@@ -127,7 +128,7 @@ function timeoutForPhone(phoneName, timeout) {
     if (typeof t.installMs === "number" && Number.isFinite(t.installMs) && t.installMs > 0) return t.installMs;
     return DEFAULT_HTTP_INSTALL_TIMEOUT_MS;
   }
-  if (phoneName.endsWith(".updateCheck") || phoneName.endsWith(".batchCheck")) {
+  if (phoneName.endsWith(".updateCheck") || phoneName.endsWith(".batchCheck") || phoneName.endsWith(".updateChangelog")) {
     if (typeof t.checkMs === "number" && Number.isFinite(t.checkMs) && t.checkMs > 0) return t.checkMs;
     return DEFAULT_HTTP_CHECK_TIMEOUT_MS;
   }

package/dist/panel-batch.d.ts

@@ -44,6 +44,11 @@ export interface BatchPanelOptions {
     onRestartRequested?: () => void | Promise<void>;
     /** 复制文本的出口（与单插件面板同一口径）：不传即试浏览器剪贴板，都没有也不抛错。 */
     copyText?: (text: string) => void | Promise<void>;
+    /**
+     * 详情行自动取日志（#38）：默认开。展开行有新版时调该行自己的更新日志电话按需取；
+     * 老宿主没给行电话名即回中性提示；false 关闭。
+     */
+    autoChangelog?: boolean;
 }
 /** 面板可点的动作（HTML 上 data-act 一一对应；测试走同一条路）。 */
 export type BatchPanelActionKind = 'check' | 'install' | 'resume' | 'cancel' | 'row-install' | 'row-skip' | 'row-resume-skip' | 'row-cancel-queue' | 'row-copy-manual' | 'row-copy-diag' | 'toggle-details' | 'restart' | 'close';
@@ -125,6 +130,8 @@ export interface BatchPanelRenderInput {
     notice?: string | null;
     /** 面板正有一次电话在飞（本地忙守卫的一半）。 */
     inFlight?: boolean;
+    /** 「取消这一批」已点过一次：按钮换确认文案，再点一次才真取消（防误触）。 */
+    confirmCancel?: boolean;
     /** 是否已经拿到过第一次回包（决定总账那句是不是「正在读取…」）。 */
     loaded?: boolean;
     titles?: Record<string, string>;
@@ -132,6 +139,8 @@ export interface BatchPanelRenderInput {
     skippedVersions?: Record<string, string | null>;
     /** notice 归哪一家：等于某行键时那条回执画在该家详情里（否则画在面板底部）。 */
     noticeKey?: string | null;
+    /** 键 -> 该行已取到的日志全文（只传有文本的；取不到与没展开即中性提示，不挡安装）。 */
+    changelogs?: Record<string, string | null>;
 }
 /** 整面板 HTML（含样式；重绘即整体替换 innerHTML，故每次都带 style 也只留一份）。 */
 export declare function renderBatchPanelHTML(input: BatchPanelRenderInput): string;

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
@@ -11,6 +12,7 @@ import {
   createBrowserSkipStore,
   failureCopy,
   isKnownFailureCode,
+  normalizePanelTheme,
   renderUpdatePanelHTML
 } from "./panel.js";
 const BATCH_PANEL_POLL = {
@@ -91,7 +93,7 @@ function batchRowStatus(row, skippedVersion) {
 }
 function renderBatchPanelHTML(input) {
   const rows = Array.isArray(input.rows) ? input.rows : [];
-  const theme = input.theme === "d5-paper" ? "d5-paper" : "default";
+  const theme = normalizePanelTheme(input.theme);
   const mode = input.mode === "dialog" ? "dialog" : "embedded";
   const titles = input.titles && typeof input.titles === "object" ? input.titles : {};
   const skippedVersions = input.skippedVersions && typeof input.skippedVersions === "object" ? input.skippedVersions : {};
@@ -111,6 +113,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 +121,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 +146,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,14 +158,17 @@ 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) {
     parts.push('<div class="dsh-upd-batch-notice" role="status">' + escapeHtml(notice) + "</div>");
   }
   const kernel = parts.join(String.fromCharCode(10));
-  const d5 = theme === "d5-paper";
+  const d5 = normalizePanelTheme(theme) === "d5-paper";
   const attr = d5 ? ' data-theme="d5-paper"' : "";
   const seal = batchSealOf(counts);
   const root = '<div class="dsh-upd dsh-upd-batch" data-mode="' + mode + '" data-seal="' + escapeHtml(seal.text) + '" data-seal-tone="' + seal.tone + '"' + attr + ">\n" + kernel + "\n</div>";
@@ -263,6 +271,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 +372,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}",
@@ -608,15 +619,20 @@ function mountUpdateBatchPanel(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 === void 0 ? "default" : options.theme;
-  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");
   const call = options.call;
   const titles = options.titles && typeof options.titles === "object" ? options.titles : {};
   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,10 +641,64 @@ 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);
+      }
+    );
+  }
+  let lastHTML = "";
   function render() {
     if (!mounted) return;
-    container.innerHTML = renderBatchPanelHTML({
+    const nextHTML = renderBatchPanelHTML({
       rows,
       theme,
       mode,
@@ -639,8 +709,14 @@ function mountUpdateBatchPanel(container, options) {
       skippedVersions: skippedVersionsOf(),
       inFlight,
       loaded,
-      titles
+      titles,
+      confirmCancel: confirmCancelArmed,
+      changelogs: changelogView()
     });
+    if (nextHTML !== lastHTML) {
+      lastHTML = nextHTML;
+      container.innerHTML = nextHTML;
+    }
   }
   function rowOfKey(key) {
     return rows.find((row) => row.key === key) ?? null;
@@ -717,6 +793,7 @@ function mountUpdateBatchPanel(container, options) {
       refreshing = false;
     }
     render();
+    maybeAutoRowChangelog(expandedKey);
   }
   async function phone(name, args, busyRowKey = null) {
     if (!mounted || inFlight) return;
@@ -731,6 +808,7 @@ function mountUpdateBatchPanel(container, options) {
         return;
       }
       applyReply(reply);
+      rowFailed.clear();
     } catch {
       if (!mounted) return;
       lastError = "check-failed";
@@ -738,9 +816,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 +840,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 +919,7 @@ function mountUpdateBatchPanel(container, options) {
         if (typeof key !== "string" || !key) return;
         expandedKey = expandedKey === key ? null : key;
         render();
+        maybeAutoRowChangelog(expandedKey);
         return;
       }
       // 「重启宿主」：宿主没有重启自己的电话，只做入口——调用方给了 onRestartRequested 就交给它，
@@ -859,6 +946,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 +974,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 +989,8 @@ function mountUpdateBatchPanel(container, options) {
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    rowAutoSeq++;
+    rowInflight.clear();
     try {
       timer.clear(handle);
     } catch {
@@ -895,12 +999,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

@@ -3,7 +3,16 @@ import type { BlockedReason, UpdateSnapshot } from './ports.js';
 /** 摆放形态：默认内嵌，切弹窗走同一参数。 */
 export type UpdatePanelMode = 'embedded' | 'dialog';
 /** 面板主题：默认最小可用样式；`d5-paper` 为可选 D5 档案卷专业主题（只换肤，不换 DOM 顺序）。 */
-export type UpdatePanelTheme = 'default' | 'd5-paper';
+/**
+ * 面板主题：`default` 最小可用深色；`archive` 档案卷纸面浅色（原型敲定的案卷风格，只换肤）。
+ * `d5-paper` 是 archive 的旧别名（历史取值），仍可用，渲染逐字相同。
+ */
+export type UpdatePanelTheme = 'default' | 'archive' | 'd5-paper';
+/**
+ * 主题归一：archive 与旧别名 d5-paper 走同一套渲染（DOM 属性仍为 d5-paper，既有覆盖样式不断）；
+ * 其余一律回 default（纯渲染函数永不抛；挂载/setTheme 的非法值另行抛错）。
+ */
+export declare function normalizePanelTheme(value: unknown): 'default' | 'd5-paper';
 /** 与宿主通话的传输函数：面板只认这个签名，不认任何宿主对象的具体形状。 */
 export type UpdatePanelCall = (phoneName: string, args: Record<string, unknown>) => Promise<Record<string, unknown>>;
 /** 复制文本的出口：不传即尝试浏览器剪贴板，都没有则只留“已生成、请手动复制”提示。 */
@@ -43,9 +52,20 @@ export interface UpdatePanelOptions {
     /**
      * 更新日志 Markdown（#23 包内 CHANGELOG 展示）：
      * 调用方按“已装版离线读、新版按需取 tarball”备好后传入（取不到传 null/空串即中性提示）；
-     * 面板只渲染不取数，缺日志永不挡安装、不写 blockedReason。
+     * 缺日志永不挡安装、不写 blockedReason。
+     * 显式传入即赢：自动链路（见 autoChangelog）永不覆盖它。
      */
     changelogMarkdown?: string | null;
+    /**
+     * 自动取日志（#38）：默认开。有新版时面板按 latestVersion 调一次宿主更新日志电话，
+     * 回来经内部通道换日志节；显式传过 changelogMarkdown 或传 false 即退回手动模式。
+     */
+    autoChangelog?: boolean;
+    /**
+     * 弹窗关闭的落地：只在 dialog 下点「关闭」/按 Esc 时调用；调用方在此撤掉弹窗 DOM。
+     * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
+     */
+    onCloseRequested?: () => void | Promise<void>;
 }
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface UpdatePanelContainer {
@@ -221,6 +241,11 @@ export interface PanelRenderInput extends PanelViewInput {
     profileName?: string | null;
     /** 宿主种类：进诊断文本；缺省显示“未知”。 */
     hostKind?: string | null;
+    /**
+     * 在途动作（仅挂载态内部用：点下查新版/安装到回包前的那一帧，按钮置忙）。
+     * 缺省即静默（输出与旧版一字不差）；只在挂载器置忙的那次 render 里传。
+     */
+    busyAct?: 'check' | 'install' | null;
     /**
      * 动作面归谁：`default`（缺省）由内核画动作按钮；`none` 只画内容、不画按钮。
      * 给「调用方自己提供动作面」的场景（如批量面板的详情：动作由批量面板经自己的通道提供）。
@@ -242,6 +267,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;