dsh-plugin-update 0.4.0 → 0.5.1

package/dist/host.js

@@ -11,6 +11,7 @@ import {
 } from "./config.js";
 import { manualCommand } from "./commands.js";
 import { fetchReleaseChangelogText } from "./changelog-io.js";
+import { shouldFetchChangelog } from "./changelog.js";
 import { buildDiag } from "./diag.js";
 import { fetchNpmVersionRelease, isVersionAllowedInChannel, updateError, validReleaseVersion, validRequestId } from "./service.js";
 import { createUpdateDiskPorts, createUpdateExecutor, createUpdateQueuePorts } from "./store.js";
@@ -73,14 +74,24 @@ import {
   CHANGELOG_MUST_SHOW,
   CHANGELOG_NEUTRAL_HINT,
   CHANGELOG_NEUTRAL_LINE,
+  BREAKING_BADGE_TEXT,
+  CHANGELOG_POLL_BACKOFF_MS,
   changelogForUpdate,
+  countsOf,
   hasVisibleSections,
+  isBreakingChangelogItem,
   isUnreleasedVersion,
   parseChangelog,
   renderChangelogHTML,
+  renderChangelogItem,
   renderChangelogNeutral,
   renderChangelogSection,
-  selectChangelogEntries
+  selectChangelogEntries,
+  shouldFetchChangelog as shouldFetchChangelog2,
+  splitBreakingPrefix,
+  truncatedNoteHTML,
+  validateChangelog,
+  yankedBannerHTML
 } from "./changelog.js";
 import {
   CHANGELOG_DEFAULT_REGISTRY,
@@ -578,12 +589,24 @@ function createHostUpdate(deps = {}, configInput) {
   const readerOverrides = { ...deps.readerOverrides ?? {}, ctx, ...deps.pluginManager ? { pluginManager: deps.pluginManager } : {} };
   const phoneNames = buildPhoneNames(config.prefix);
   const changelogCache = /* @__PURE__ */ new Map();
+  const changelogFailedAt = /* @__PURE__ */ new Map();
   async function readChangelog(args) {
     const raw = args ? args["version"] : void 0;
     if (!validReleaseVersion(raw)) throw updateError("invalid-release");
     const version = raw;
     if (!isVersionAllowedInChannel(version, config.releaseChannel)) throw updateError("invalid-release");
     if (changelogCache.has(version)) return { version, markdown: changelogCache.get(version) ?? null };
+    try {
+      let nowMs = 0;
+      try {
+        nowMs = Date.now();
+      } catch {
+        nowMs = 0;
+      }
+      const failedAt = changelogFailedAt.has(version) ? changelogFailedAt.get(version) : null;
+      void shouldFetchChangelog({ hasCache: false, failedAt, now: nowMs, isManual: true });
+    } catch {
+    }
     const fetchImpl = readerOverrides.fetchImpl ?? globalThis.fetch;
     const release = await fetchNpmVersionRelease(fetchImpl, config.checkTimeoutMs, {
       targetPackageName: config.targetPackageName,
@@ -591,12 +614,29 @@ function createHostUpdate(deps = {}, configInput) {
       releaseChannel: config.releaseChannel,
       version
     });
-    const markdown = await fetchReleaseChangelogText(
-      fetchImpl,
-      { tarball: release.tarball, integrity: release.integrity, version },
-      { targetPackageName: config.targetPackageName, registryUrl: config.registryUrl, timeoutMs: config.checkTimeoutMs }
-    );
+    let markdown;
+    try {
+      markdown = await fetchReleaseChangelogText(
+        fetchImpl,
+        { tarball: release.tarball, integrity: release.integrity, version },
+        { targetPackageName: config.targetPackageName, registryUrl: config.registryUrl, timeoutMs: config.checkTimeoutMs }
+      );
+    } catch (err) {
+      try {
+        changelogFailedAt.set(version, Date.now());
+      } catch {
+        try {
+          changelogFailedAt.set(version, 0);
+        } catch {
+        }
+      }
+      throw err;
+    }
     changelogCache.set(version, markdown);
+    try {
+      changelogFailedAt.delete(version);
+    } catch {
+    }
     return { version, markdown };
   }
   async function readStatus(args) {
@@ -713,6 +753,7 @@ function __resetSharedUpdateReaderForTests() {
   sharedDesktopPnpm = null;
 }
 export {
+  BREAKING_BADGE_TEXT,
   CHANGELOG_ALL_CATEGORIES,
   CHANGELOG_DEFAULT_REGISTRY,
   CHANGELOG_FETCH_MAX_BYTES,
@@ -725,6 +766,7 @@ export {
   CHANGELOG_MUST_SHOW,
   CHANGELOG_NEUTRAL_HINT,
   CHANGELOG_NEUTRAL_LINE,
+  CHANGELOG_POLL_BACKOFF_MS,
   CHANGELOG_TARBALL_MAX_BYTES,
   CHANGELOG_TAR_MAX_BYTES,
   COPY_BUDGET_CHARS,
@@ -764,6 +806,7 @@ export {
   compareReleaseVersions,
   compareVersions,
   containingPackage,
+  countsOf,
   createHostUpdate,
   createSkipDiskPorts,
   createUpdateDiskPorts2 as createUpdateDiskPorts,
@@ -782,6 +825,7 @@ export {
   extractChangelogFromTar,
   fetchReleaseChangelogText2 as fetchReleaseChangelogText,
   hasVisibleSections,
+  isBreakingChangelogItem,
   isHeadOfQueue2 as isHeadOfQueue,
   isPrereleaseVersion,
   isUnreleasedVersion,
@@ -800,6 +844,7 @@ export {
   registrySpec,
   releaseOwnerInQueue2 as releaseOwnerInQueue,
   renderChangelogHTML,
+  renderChangelogItem,
   renderChangelogNeutral,
   renderChangelogSection,
   resolveCliEntry,
@@ -810,9 +855,14 @@ export {
   sanitizeForCopy,
   selectChangelogEntries,
   setOwnerIfFree2 as setOwnerIfFree,
+  shouldFetchChangelog2 as shouldFetchChangelog,
   skipKey,
+  splitBreakingPrefix,
   truncateToWordBoundary,
+  truncatedNoteHTML,
   validReleaseVersion2 as validReleaseVersion,
   validVersion,
-  visibleQueueFor2 as visibleQueueFor
+  validateChangelog,
+  visibleQueueFor2 as visibleQueueFor,
+  yankedBannerHTML
 };

package/dist/panel-batch.js

@@ -1,6 +1,7 @@
 // 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 { shouldFetchChangelog } from "./changelog.js";
 import {
   isTerminalPhase,
   normalizeBatchSession
@@ -12,6 +13,7 @@ import {
   createBrowserSkipStore,
   failureCopy,
   isKnownFailureCode,
+  normalizePanelTheme,
   renderUpdatePanelHTML
 } from "./panel.js";
 const BATCH_PANEL_POLL = {
@@ -92,7 +94,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 : {};
@@ -167,7 +169,7 @@ function renderBatchPanelHTML(input) {
     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>";
@@ -618,10 +620,10 @@ 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;
@@ -630,7 +632,7 @@ function mountUpdateBatchPanel(container, options) {
   const autoChangelogEnabled = options.autoChangelog !== false;
   const rowChangelog = /* @__PURE__ */ new Map();
   const rowInflight = /* @__PURE__ */ new Set();
-  const rowFailed = /* @__PURE__ */ new Map();
+  const rowFailedAt = /* @__PURE__ */ new Map();
   let rowAutoSeq = 0;
   let rows = [];
   let expandedKey = null;
@@ -671,7 +673,19 @@ function mountUpdateBatchPanel(container, options) {
     const cached = rowChangelog.get(key);
     if (cached && cached.version === version) return;
     if (rowInflight.has(key)) return;
-    if (rowFailed.get(key) === version) return;
+    try {
+      const failKey = key + "\0" + version;
+      const hasCache = false;
+      const failedAt = rowFailedAt.has(failKey) ? rowFailedAt.get(failKey) : null;
+      let nowMs = 0;
+      try {
+        nowMs = Date.now();
+      } catch {
+        nowMs = 0;
+      }
+      if (!shouldFetchChangelog({ hasCache, failedAt, now: nowMs, isManual: false })) return;
+    } catch {
+    }
     const phone2 = changelogPhoneOf(row);
     if (!phone2) return;
     rowInflight.add(key);
@@ -681,7 +695,14 @@ function mountUpdateBatchPanel(container, options) {
         rowInflight.delete(key);
         if (!mounted || seq !== rowAutoSeq) return;
         if (!isObject(reply) || reply["ok"] !== true) {
-          rowFailed.set(key, version);
+          try {
+            rowFailedAt.set(key + "\0" + version, Date.now());
+          } catch {
+            try {
+              rowFailedAt.set(key + "\0" + version, 0);
+            } catch {
+            }
+          }
           return;
         }
         const md = reply["markdown"];
@@ -690,13 +711,23 @@ function mountUpdateBatchPanel(container, options) {
       },
       () => {
         rowInflight.delete(key);
-        if (mounted && seq === rowAutoSeq) rowFailed.set(key, version);
+        if (mounted && seq === rowAutoSeq) {
+          try {
+            rowFailedAt.set(key + "\0" + version, Date.now());
+          } catch {
+            try {
+              rowFailedAt.set(key + "\0" + version, 0);
+            } catch {
+            }
+          }
+        }
       }
     );
   }
+  let lastHTML = "";
   function render() {
     if (!mounted) return;
-    container.innerHTML = renderBatchPanelHTML({
+    const nextHTML = renderBatchPanelHTML({
       rows,
       theme,
       mode,
@@ -711,6 +742,10 @@ function mountUpdateBatchPanel(container, options) {
       confirmCancel: confirmCancelArmed,
       changelogs: changelogView()
     });
+    if (nextHTML !== lastHTML) {
+      lastHTML = nextHTML;
+      container.innerHTML = nextHTML;
+    }
   }
   function rowOfKey(key) {
     return rows.find((row) => row.key === key) ?? null;
@@ -802,7 +837,7 @@ function mountUpdateBatchPanel(container, options) {
         return;
       }
       applyReply(reply);
-      rowFailed.clear();
+      rowFailedAt.clear();
     } catch {
       if (!mounted) return;
       lastError = "check-failed";

package/dist/panel.d.ts

@@ -2,8 +2,17 @@ import { type VisibleQueue } from './queue.js';
 import type { BlockedReason, UpdateSnapshot } from './ports.js';
 /** 摆放形态：默认内嵌，切弹窗走同一参数。 */
 export type UpdatePanelMode = 'embedded' | 'dialog';
-/** 面板主题：默认最小可用样式；`d5-paper` 为可选 D5 档案卷专业主题（只换肤，不换 DOM 顺序）。 */
-export type UpdatePanelTheme = 'default' | 'd5-paper';
+/** 面板主题：默认最小可用样式；`archive` 为档案卷纸面浅色（只换肤，不换 DOM 顺序；`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>>;
 /** 复制文本的出口：不传即尝试浏览器剪贴板，都没有则只留“已生成、请手动复制”提示。 */
@@ -17,7 +26,7 @@ export interface UpdatePanelOptions {
     prefix?: string;
     /** 摆放形态：默认内嵌。 */
     mode?: UpdatePanelMode;
-    /** 面板主题：默认 `default`（最小可用样式，一字不动）；传 `d5-paper` 切 D5 档案卷可选主题。 */
+    /** 面板主题：默认 `default`（最小可用样式，一字不动）；传 `archive` 切档案卷（`d5-paper` 为旧别名）。 */
     theme?: UpdatePanelTheme;
     /** 是否看他人排队明细：默认只看自己的（他人仅露正忙占位，位置照给）。 */
     showOthers?: boolean;
@@ -52,6 +61,11 @@ export interface UpdatePanelOptions {
      * 回来经内部通道换日志节；显式传过 changelogMarkdown 或传 false 即退回手动模式。
      */
     autoChangelog?: boolean;
+    /**
+     * 弹窗关闭的落地：只在 dialog 下点「关闭」/按 Esc 时调用；调用方在此撤掉弹窗 DOM。
+     * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
+     */
+    onCloseRequested?: () => void | Promise<void>;
 }
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface UpdatePanelContainer {

package/dist/panel.js

@@ -5,8 +5,13 @@ import { validReleaseVersion } from "./service.js";
 import {
   changelogForUpdate,
   parseChangelog,
-  renderChangelogHTML
+  renderChangelogHTML,
+  shouldFetchChangelog,
+  yankedBannerHTML
 } 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",
@@ -513,6 +518,12 @@ const UPDATE_PANEL_CSS = [
   ".dsh-upd-changelog li{margin:2px 0}",
   ".dsh-upd-changelog-fold{margin:4px 0}",
   ".dsh-upd-changelog-fold>summary{cursor:pointer}",
+  ".dsh-upd-changelog-count{font-size:12px;opacity:.7;margin:2px 0 4px}",
+  ".dsh-upd-changelog-yanked{border-left:4px solid var(--dsh-upd-warn-line,#d97706);background:var(--dsh-upd-warn-bg,#fffbeb);padding:6px 10px;margin:6px 0;font-size:13px}",
+  ".dsh-upd-breaking-badge{display:inline-block;font-size:11px;font-weight:700;border:1px solid currentColor;border-radius:3px;padding:0 5px;margin-right:6px;vertical-align:baseline}",
+  ".dsh-upd-changelog-security-more{margin:4px 0 6px}",
+  ".dsh-upd-changelog-security-more>summary{cursor:pointer;font-size:12px;opacity:.8}",
+  ".dsh-upd-changelog-more-note{font-size:12px;opacity:.7;margin:2px 0 4px}",
   ".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}",
@@ -590,7 +601,8 @@ const UPDATE_PANEL_D5_CSS = [
   "--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)}',
+  // 按钮脸自己不透明（宿主底色未知时也读得出；卡片上渲染与 transparent 逐字同色）。
+  '.dsh-upd[data-theme="d5-paper"] button{border-color:var(--d5-line-strong);background:var(--d5-card);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}',
@@ -601,6 +613,10 @@ const UPDATE_PANEL_D5_CSS = [
   '.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)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-changelog-yanked{border-color:var(--d5-warn);background:var(--d5-warn-bg);color:var(--d5-ink)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-breaking-badge{color:var(--d5-accent);border-color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-changelog-count{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-changelog-more-note{color:var(--d5-muted)}',
   // —— 大印章（原型 :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;',
@@ -788,7 +804,22 @@ function renderUpdatePanelKernel(input, view) {
         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>
+        let yankedBanner = "";
+        try {
+          const toEntry = Array.isArray(ranged) ? ranged.find(function(e) {
+            try {
+              return e && e.version === toText;
+            } catch {
+              return false;
+            }
+          }) : null;
+          if (toEntry && toEntry.yanked === true && toText) {
+            yankedBanner = yankedBannerHTML(toText);
+          }
+        } catch {
+          yankedBanner = "";
+        }
+        inner = `<div class="dsh-upd-changelog-wrap"><div>${escapeHtml(rangeTitle)}</div>${yankedBanner}
 ${changelogHTML}
 </div>`;
       } catch {
@@ -863,7 +894,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}>
@@ -948,7 +979,7 @@ function mountUpdatePanel(container, options) {
   let manualChangelogOverride = typeof options.changelogMarkdown === "string";
   const changelogCache = /* @__PURE__ */ new Map();
   const changelogInflight = /* @__PURE__ */ new Set();
-  const changelogFailed = /* @__PURE__ */ new Set();
+  const changelogFailedAt = /* @__PURE__ */ new Map();
   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) {
@@ -958,13 +989,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;
@@ -1005,7 +1038,7 @@ function mountUpdatePanel(container, options) {
     }
     const latest = snapshot?.latestVersion ?? null;
     const skippedLatest = !!latest && validReleaseVersion(latest) && skipStore.has(latest);
-    container.innerHTML = renderUpdatePanelHTML({
+    const nextHTML = renderUpdatePanelHTML({
       snapshot,
       manual,
       queue,
@@ -1023,6 +1056,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;
@@ -1060,7 +1097,16 @@ function mountUpdatePanel(container, options) {
       if (skipStore.has(v)) return null;
     } catch {
     }
-    if (changelogCache.has(v) || changelogInflight.has(v) || changelogFailed.has(v)) return null;
+    if (changelogInflight.has(v)) return null;
+    const hasCache = changelogCache.has(v);
+    const failedAt = changelogFailedAt.has(v) ? changelogFailedAt.get(v) : null;
+    let nowMs = 0;
+    try {
+      nowMs = Date.now();
+    } catch {
+      nowMs = 0;
+    }
+    if (!shouldFetchChangelog({ hasCache, failedAt, now: nowMs, isManual: false })) return null;
     return v;
   }
   function maybeAutoChangelog() {
@@ -1073,7 +1119,14 @@ function mountUpdatePanel(container, options) {
         changelogInflight.delete(v);
         if (!mounted || seq !== autoSeq) return;
         if (!reply || typeof reply !== "object" || reply["ok"] !== true) {
-          changelogFailed.add(v);
+          try {
+            changelogFailedAt.set(v, Date.now());
+          } catch {
+            try {
+              changelogFailedAt.set(v, 0);
+            } catch {
+            }
+          }
           return;
         }
         const md = reply["markdown"];
@@ -1085,7 +1138,16 @@ function mountUpdatePanel(container, options) {
       },
       () => {
         changelogInflight.delete(v);
-        if (mounted && seq === autoSeq) changelogFailed.add(v);
+        if (mounted && seq === autoSeq) {
+          try {
+            changelogFailedAt.set(v, Date.now());
+          } catch {
+            try {
+              changelogFailedAt.set(v, 0);
+            } catch {
+            }
+          }
+        }
       }
     );
   }
@@ -1117,7 +1179,7 @@ function mountUpdatePanel(container, options) {
           const reply = await call(phoneNames.updateCheck, queueArgs());
           if (!mounted) return;
           applyStatusReply(reply);
-          changelogFailed.clear();
+          changelogFailedAt.clear();
         } catch {
           if (!mounted) return;
           lastError = "check-failed";
@@ -1256,7 +1318,7 @@ function mountUpdatePanel(container, options) {
         return;
       }
       case "close-view": {
-        if (mode === "dialog") unmount();
+        await requestDialogClose();
         return;
       }
     }
@@ -1269,10 +1331,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) {
@@ -1289,11 +1351,21 @@ 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;
-      unmount();
+      void requestDialogClose();
     } catch {
     }
   }
@@ -1409,6 +1481,7 @@ export {
   isQueueBusy,
   isUnreleasedVersion,
   mountUpdatePanel,
+  normalizePanelTheme,
   normalizeQueueState,
   panelViewModel,
   parseChangelog2 as parseChangelog,

package/package.json

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