dsh-plugin-update 0.5.4 → 0.5.5

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.5.5] - 2026-10-06
+
+### Added
+- 档案卷主题收敛 archive 与面板紧凑化：运行时 data-theme 统一为 archive（d5-paper 仅作输入旧别名归一），entry/entry-batch/panel-batch 输出与 CSS 选择器同步，panel-batch setTheme 补 archive 并归一存储；根／卷头／横幅／版本条／章节／章头／队列行／footer 间距收紧；删 changelog-wrap 与章节线重影内边框；页脚去技术词，批量关闭 title 同步。
+- 双语底座 #54（先行）：bilingual 字典模块、entry key 映射链、noteVersion 运行时值；research/52-inventory 双语盘点与原型矩阵随附。
+
+### Fixed
+- 安装/查失败常驻与复制诊断锁定（#58）：失败横幅保留到下一次用户主动查/装的新结论、任务态或版本变化，只读轮询不再洗回可装页；「复制诊断」锁定致命那次回包（稳定码、摘要、版本、宿主、请求与检查编号冻结在失败时刻）；失败旁新增「知道了」可显式确认回到可装页；健康无失败时复制改为当前状态快照，不再伪造失败码；04 章失败时变为卷宗（真实稳定码、本次查询键与失败时刻、证据冻结声明、凭编号对日志的现成查询，平时为路牌＋中性行，可用 `showLogHint: false` 藏路牌）；日志事件名收归 `log-events.ts` 单源（宿主发射与面板路牌同源）；对抗审查补强：瞬态读失败不跨重挂、查锁存不再错配旧安装编号、瞬态失败换诚实文案、跨挂载表有界 100 家；`update-busy` 仍为瞬态不锁存；四电话形状与快照六字段零变更。
+
 ## [0.5.4] - 2026-10-06
 
 ### Added

package/README.md

@@ -131,7 +131,7 @@ const panel = mountUpdatePanel(document.getElementById('update-slot'), {
 // 弹窗版想让「关闭」按钮真把弹窗撤掉：传 onCloseRequested（面板点关闭/Esc 时先调它撤 DOM，再停轮询；入口件打开的 dialog 已内置）。
 ```
 
-组件内部消化的事（调用者不再写）：按 `panelPollMs` 轮询查状态（下限 250 毫秒）；安装按钮状态跟随快照的 `canInstall`，不另写门控规则；装不了的原因按第 5.2 节展示中文一句话；`pending-restart` 单独横幅加重启指引，不再给安装按钮；手工命令展示与复制；排队位置展示与 `showOthers` 开关；跳过按版本记（“已跳过 X.Y.Z · 恢复”在同一行，不藏进设置页）；失败时旁边的“复制诊断”一键给出脱敏后的自包含文本（稳定码、版本、宿主、队列位置），深挖仍看日志（组件里留着第 6 节第 11 条的过滤口径）。
+组件内部消化的事（调用者不再写）：按 `panelPollMs` 轮询查状态（下限 250 毫秒）；安装按钮状态跟随快照的 `canInstall`，不另写门控规则；装不了的原因按第 5.2 节展示中文一句话；`pending-restart` 单独横幅加重启指引，不再给安装按钮；手工命令展示与复制；排队位置展示与 `showOthers` 开关；跳过按版本记（“已跳过 X.Y.Z · 恢复”在同一行，不藏进设置页）；失败时旁边的“复制诊断”一键给出脱敏后的自包含文本（稳定码、版本、宿主、队列位置），深挖仍看日志（组件里留着第 6 节第 11 条的过滤口径）。失败横幅常驻：查/装失败后保留到下一次用户主动查/装的新结论、任务态或版本变化，只读轮询不再洗掉；复制诊断锁定致命那次回包的证据（码、摘要、版本、宿主、编号冻结在失败时刻）；失败旁有「知道了」可显式确认回到可装页（只清面板提示，不调电话）。无失败时复制诊断给当前状态快照（版本、宿主、范围、队列），不伪造失败码。04 章平时是路牌（中性行＋日志过滤口径，可用 `showLogHint: false` 隐藏）；失败时变为卷宗：真实稳定码、本次查询键（请求／检查编号＋失败时刻）、证据冻结声明、凭编号对日志的现成查询。日志事件名（`host.call`／`host.call.fail`／`update.install.exec`）由宿主与面板共用单源，改名即全改。
 
 待重启横幅上有个「重启宿主」入口。宿主没有“重启自己”的电话，所以默认点击只如实提示「请手动重启宿主」；想把重启流程接进来就传 `onRestartRequested`（面板调它，成败都回执）：
 

package/dist/bilingual.d.ts

@@ -0,0 +1,39 @@
+/** 字典版本钉（#53 Q3 解耦）：key 冻即解阻塞 #54，文案按词标 draft/locked；开发钉此版本，转正只换文案不换 key。 */
+export declare const BILINGUAL_DICT_VERSION = "2026-10-06-pin53";
+/** 首批 key 全集（entry 7 键，命名沿 #52 §1 key 提案，area.group.name）。 */
+export type BilingualKey = 'entry.label.idle' | 'entry.label.failed' | 'entry.label.busy' | 'entry.label.restart' | 'entry.label.has-update' | 'entry.action.checking' | 'entry.note.up-to-date';
+/** 一条双语：en/zh 模板 + 成熟度。模板内具名槽如 {version}，运行时值填入（值永不翻译）。 */
+export interface BilingualEntry {
+    en: string;
+    zh: string;
+    /** true=待母语+域内双签（#53 Q3），false=已双签转正。首批全 draft（无评审不假锁）。 */
+    draft: boolean;
+}
+/**
+ * 集中字典（机器源，类型锁死：Record<BilingualKey, BilingualEntry> 缺键即 tsc 报错）。
+ * 人读源为 #57 规格 + #53 结论英文定调；英文终稿待母语评审，故全标 draft。
+ * zh 逐字等于 entry.ts 现有散落文案（兼容既有测试与接入方 label() 口径）。
+ */
+export declare const BILINGUAL_STRINGS: Record<BilingualKey, BilingualEntry>;
+/** 取一条双语原文（类型锁死：未知 key 在 tsc 即拦；运行时未知亦抛，不静默回退）。 */
+export declare function bilingualEntry(key: BilingualKey): BilingualEntry;
+/**
+ * 纯文本双语（一行，英文在前中文在后，空白分隔）：用于 title / aria-label 等放不下 HTML 的属性位。
+ * 返回原文（未转义），调用方按上下文转义后再拼入属性。
+ */
+export declare function bilingualText(key: BilingualKey, values?: Record<string, unknown>): string;
+/**
+ * 双语语义块 HTML（唯一渲染出口）：英文在前中文在后，空白分隔，lang 属性齐全。
+ * 返回已转义可直接拼入 innerHTML 的片段；调用方不得再对整体转义，不得拆 span 重组。
+ */
+export declare function bilingualHTML(key: BilingualKey, values?: Record<string, unknown>): string;
+/** 是否 draft（供 #56 门禁读零 draft 放行条件；#54 自身不断言零 draft）。 */
+export declare function isDraft(key: BilingualKey): boolean;
+/** 全表 draft key 一览（#56 门禁：空数组才放行合入主分支）。 */
+export declare function draftKeys(): BilingualKey[];
+/**
+ * 双语块最小样式（与 UPDATE_ENTRY_CSS 同缝注入）：
+ * 平时行内双语（英文前中文后，空白分隔），窄处竖排不断行（@media 360px 以下 column）。
+ * 只管排版，不管字重字号（字重间距留给 #55 视觉矩阵验收）。
+ */
+export declare const BILINGUAL_CSS: string;

package/dist/bilingual.js

@@ -0,0 +1,58 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/bilingual.ts
+const BILINGUAL_DICT_VERSION = "2026-10-06-pin53";
+const BILINGUAL_STRINGS = {
+  "entry.label.idle": { en: "Check for updates", zh: "\u68C0\u67E5\u66F4\u65B0", draft: true },
+  "entry.label.failed": { en: "Update failed \u2014 View details", zh: "\u66F4\u65B0\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B", draft: true },
+  "entry.label.busy": { en: "Installing\u2026", zh: "\u6B63\u5728\u5B89\u88C5\u2026", draft: true },
+  "entry.label.restart": { en: "Restart required", zh: "\u5F85\u91CD\u542F", draft: true },
+  "entry.label.has-update": { en: "Update available {version}", zh: "\u6709\u65B0\u7248 {version}", draft: true },
+  "entry.action.checking": { en: "Checking for updates\u2026", zh: "\u6B63\u5728\u67E5\u65B0\u7248\u2026", draft: true },
+  "entry.note.up-to-date": { en: "Up to date {version}", zh: "\u5DF2\u662F\u6700\u65B0 {version}", draft: true }
+};
+function escapeHtml(value) {
+  return String(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function formatTemplate(template, values) {
+  const vals = values ?? {};
+  return String(template).replace(/\{([A-Za-z0-9_]+)\}/g, (_, name) => {
+    const v = vals[name];
+    if (v === null || v === void 0) return "";
+    return String(v).trim();
+  });
+}
+function bilingualEntry(key) {
+  const hit = BILINGUAL_STRINGS[key];
+  if (!hit) throw new Error("[dsh-plugin-update] \u672A\u77E5\u6587\u6848 key\uFF1A" + String(key));
+  return hit;
+}
+function bilingualText(key, values) {
+  const e = bilingualEntry(key);
+  return formatTemplate(e.en, values) + " " + formatTemplate(e.zh, values);
+}
+function bilingualHTML(key, values) {
+  const e = bilingualEntry(key);
+  const en = escapeHtml(formatTemplate(e.en, values));
+  const zh = escapeHtml(formatTemplate(e.zh, values));
+  return '<span class="dsh-upd-bi"><span lang="en">' + en + '</span> <span lang="zh">' + zh + "</span></span>";
+}
+function isDraft(key) {
+  return bilingualEntry(key).draft;
+}
+function draftKeys() {
+  return Object.keys(BILINGUAL_STRINGS).filter((k) => BILINGUAL_STRINGS[k].draft);
+}
+const BILINGUAL_CSS = [
+  ".dsh-upd-bi{display:inline-flex;align-items:baseline;gap:.5em;max-width:100%}",
+  '.dsh-upd-bi [lang="en"],.dsh-upd-bi [lang="zh"]{overflow-wrap:anywhere}',
+  "@media (max-width:360px){.dsh-upd-bi{flex-direction:column;gap:0}}"
+].join("\n");
+export {
+  BILINGUAL_CSS,
+  BILINGUAL_DICT_VERSION,
+  BILINGUAL_STRINGS,
+  bilingualEntry,
+  bilingualHTML,
+  bilingualText,
+  draftKeys,
+  isDraft
+};

package/dist/entry-batch.js

@@ -166,7 +166,7 @@ function mountUpdateBatchEntry(container, options) {
     const summary = summaryOf();
     const text = activating ? "\u6B63\u5728\u67E5\u65B0\u7248\u2026" : currentLabel();
     const busyAttr = activating ? ' disabled aria-busy="true"' : "";
-    const themeAttr = theme === "d5-paper" ? ' data-theme="d5-paper"' : "";
+    const themeAttr = theme === "archive" ? ' data-theme="archive"' : "";
     const control = variant === "badge" ? '<button type="button" class="dsh-upd-entry-dot" ' + ENTRY_ATTR + '="activate" title="' + escapeHtml(text) + '" aria-label="' + escapeHtml(text) + '"' + busyAttr + "></button>" : '<button type="button" class="dsh-upd-entry-btn" ' + ENTRY_ATTR + '="activate"' + busyAttr + ">" + escapeHtml(text) + "</button>";
     const noteHTML = note ? '<span class="dsh-upd-entry-note" data-dsh-upd-note="1">' + escapeHtml(note) + "</span>" : "";
     return "<style>" + UPDATE_ENTRY_CSS + '</style>\n<span class="dsh-upd-entry" data-variant="' + variant + '" data-state="' + summary.kind + '"' + themeAttr + ">" + control + noteHTML + "</span>";

package/dist/entry.d.ts

@@ -1,5 +1,6 @@
 import { type UpdatePanelContainer, type UpdatePanelTheme } from './panel.js';
 import type { UpdateSnapshot } from './ports.js';
+import { type BilingualKey } from './bilingual.js';
 /** 入口件的形态。 */
 export type EntryVariant = 'button' | 'badge' | 'inline';
 /** 什么时候主动查一次（只读，联网一次）。 */
@@ -65,6 +66,17 @@ export interface UpdateEntryController {
  * 待重启是正常终态（不是失败），所以排在失败前面；正在装的任务比一条陈旧的失败码更可信。
  */
 export declare function entryStateKind(state: UpdateEntryState | null | undefined): EntryStateKind;
+/**
+ * 入口件双语 key（#54 底座调用链）：与 entryStateKind 同一输入（快照 + 失败码），分支只认稳定码，永不读文案。
+ * 数据层只传 key + {version} 运行时值，表现层经 bilingualHTML 拼语义块。
+ */
+export declare function entryBilingualKeyFor(state: UpdateEntryState | null | undefined): BilingualKey;
+/** 双语插值（运行时值永不翻译：同一 version 在中英两 span 各出现一次）。 */
+export declare function entryBilingualValuesFor(state: UpdateEntryState | null | undefined): Record<string, string>;
+/** 一路调用链的语义块 HTML（entryHTML 按钮正文唯一来源，无覆盖时必走此函数）。 */
+export declare function entryBilingualHTMLFor(state: UpdateEntryState | null | undefined): string;
+/** 属性位纯文本双语（title / aria-label 用，放不下 HTML 时的同内容平面版）。 */
+export declare function entryBilingualTextFor(state: UpdateEntryState | null | undefined): string;
 /** 入口件文案（唯一出处：测试与接入方都读它，不各写一份）。 */
 export declare function entryLabelFor(state: UpdateEntryState | null | undefined): string;
 export declare const UPDATE_ENTRY_CSS: string;

package/dist/entry.js

@@ -5,6 +5,7 @@ import {
   mountUpdatePanel,
   normalizePanelTheme
 } from "./panel.js";
+import { BILINGUAL_CSS, bilingualHTML, bilingualText } from "./bilingual.js";
 const LABEL_IDLE = "\u68C0\u67E5\u66F4\u65B0";
 const LABEL_FAILED = "\u66F4\u65B0\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B";
 const LABEL_BUSY = "\u6B63\u5728\u5B89\u88C5\u2026";
@@ -28,6 +29,36 @@ function entryStateKind(state) {
   if (hasUpdateOf(snapshot)) return "update";
   return "idle";
 }
+function entryBilingualKeyFor(state) {
+  switch (entryStateKind(state)) {
+    case "busy":
+      return "entry.label.busy";
+    case "restart":
+      return "entry.label.restart";
+    case "failed":
+      return "entry.label.failed";
+    case "update": {
+      const latest = state?.snapshot?.latestVersion;
+      return typeof latest === "string" && latest.trim() ? "entry.label.has-update" : "entry.label.idle";
+    }
+    default:
+      return "entry.label.idle";
+  }
+}
+function entryBilingualValuesFor(state) {
+  const key = entryBilingualKeyFor(state);
+  if (key === "entry.label.has-update") {
+    const v = state?.snapshot?.latestVersion;
+    return { version: typeof v === "string" ? v.trim() : "" };
+  }
+  return {};
+}
+function entryBilingualHTMLFor(state) {
+  return bilingualHTML(entryBilingualKeyFor(state), entryBilingualValuesFor(state));
+}
+function entryBilingualTextFor(state) {
+  return bilingualText(entryBilingualKeyFor(state), entryBilingualValuesFor(state));
+}
 function entryLabelFor(state) {
   switch (entryStateKind(state)) {
     case "busy":
@@ -66,13 +97,13 @@ const UPDATE_ENTRY_CSS = [
   '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-dot{background:var(--dsh-upd-bad-line,#dc2626)}',
   // 小字自带底（深色宿主 + 浅色变量时也读得出；浅底宿主上只是多一圈细线，不抢戏）。
   ".dsh-upd-entry-note{font-size:12.5px;opacity:.9;background:var(--dsh-upd-bg,#ffffff);border:1px solid var(--dsh-upd-line,#e5e7eb);border-radius:4px;padding:1px 8px}",
-  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-note{background:var(--d5-card);border-color:var(--d5-line-strong);color:var(--d5-ink)}',
-  '.dsh-upd-entry[data-theme="d5-paper"]{--d5-ink:#1a1a1a;--d5-muted:#6f675a;--d5-line-strong:#c4b896;--d5-accent:#c8402a;--d5-card:#fffdf6;',
+  '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-note{background:var(--d5-card);border-color:var(--d5-line-strong);color:var(--d5-ink)}',
+  '.dsh-upd-entry[data-theme="archive"]{--d5-ink:#1a1a1a;--d5-muted:#6f675a;--d5-line-strong:#c4b896;--d5-accent:#c8402a;--d5-card:#fffdf6;',
   'font-family:Georgia,"Songti SC","STSong","SimSun",serif;color:var(--d5-ink)}',
   // 按钮脸自己不透明（深色宿主 + 浅色系统变量时也读得出；hover 红在深浅底上都可见）。
-  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn{border-color:var(--d5-line-strong);background:var(--d5-card);color:var(--d5-ink);border-radius:3px}',
-  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn:hover{border-color:var(--d5-accent);color:var(--d5-accent)}',
-  '@media (prefers-color-scheme: dark){.dsh-upd-entry[data-theme="d5-paper"]{--d5-ink:#ece5d3;--d5-muted:#a89c83;--d5-line-strong:#5c4e3b;--d5-accent:#e0684e;--d5-card:#1e1a15}}',
+  '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-btn{border-color:var(--d5-line-strong);background:var(--d5-card);color:var(--d5-ink);border-radius:3px}',
+  '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-btn:hover{border-color:var(--d5-accent);color:var(--d5-accent)}',
+  '@media (prefers-color-scheme: dark){.dsh-upd-entry[data-theme="archive"]{--d5-ink:#ece5d3;--d5-muted:#a89c83;--d5-line-strong:#5c4e3b;--d5-accent:#e0684e;--d5-card:#1e1a15}}',
   "@media (prefers-color-scheme: dark){.dsh-upd-entry{color:#e5e7eb}",
   ".dsh-upd-entry-btn{--dsh-upd-btn:#1f2937;--dsh-upd-line:#374151}}"
 ].join("\n");
@@ -133,7 +164,7 @@ function mountUpdateEntry(container, options) {
   const call = options.call;
   let snapshot = null;
   let error = null;
-  let note = null;
+  let noteVersion = null;
   let activating = false;
   let mounted = true;
   let panel = null;
@@ -170,12 +201,14 @@ function mountUpdateEntry(container, options) {
   }
   function entryHTML() {
     const kind = entryStateKind(stateOf());
-    const text = activating ? "\u6B63\u5728\u67E5\u65B0\u7248\u2026" : currentLabel();
+    const labelHTML = labelOverride ? escapeHtml(labelOverride) : activating ? bilingualHTML("entry.action.checking") : entryBilingualHTMLFor(stateOf());
+    const labelText = labelOverride ?? (activating ? bilingualText("entry.action.checking") : entryBilingualTextFor(stateOf()));
     const busyAttr = activating ? ' disabled aria-busy="true"' : "";
-    const themeAttr = theme === "d5-paper" ? ' data-theme="d5-paper"' : "";
-    const control = variant === "badge" ? `<button type="button" class="dsh-upd-entry-dot" ${ENTRY_ATTR}="activate" title="${escapeHtml(text)}" aria-label="${escapeHtml(text)}"${busyAttr}></button>` : `<button type="button" class="dsh-upd-entry-btn" ${ENTRY_ATTR}="activate"${busyAttr}>${escapeHtml(text)}</button>`;
-    const noteHTML = note ? `<span class="dsh-upd-entry-note" data-dsh-upd-note="1">${escapeHtml(note)}</span>` : "";
-    return `<style>${UPDATE_ENTRY_CSS}</style>
+    const themeAttr = theme === "archive" ? ' data-theme="archive"' : "";
+    const control = variant === "badge" ? `<button type="button" class="dsh-upd-entry-dot" ${ENTRY_ATTR}="activate" title="${escapeHtml(labelText)}" aria-label="${escapeHtml(labelText)}"${busyAttr}></button>` : `<button type="button" class="dsh-upd-entry-btn" ${ENTRY_ATTR}="activate"${busyAttr}>${labelHTML}</button>`;
+    const noteHTML = noteVersion ? `<span class="dsh-upd-entry-note" data-dsh-upd-note="1">${bilingualHTML("entry.note.up-to-date", { version: noteVersion })}</span>` : "";
+    return `<style>${UPDATE_ENTRY_CSS}
+${BILINGUAL_CSS}</style>
 <span class="dsh-upd-entry" data-variant="${variant}" data-state="${kind}"${themeAttr}>${control}${noteHTML}</span>`;
   }
   function render() {
@@ -258,7 +291,7 @@ function mountUpdateEntry(container, options) {
       return;
     }
     activating = true;
-    note = null;
+    noteVersion = null;
     render();
     try {
       await checkNow();
@@ -276,7 +309,7 @@ function mountUpdateEntry(container, options) {
       openDialog();
       return;
     }
-    note = `\u5DF2\u662F\u6700\u65B0 ${snapshot.runningVersion}`;
+    noteVersion = snapshot.runningVersion;
     render();
   }
   function setTheme(next) {
@@ -342,6 +375,10 @@ function mountUpdateEntry(container, options) {
 }
 export {
   UPDATE_ENTRY_CSS,
+  entryBilingualHTMLFor,
+  entryBilingualKeyFor,
+  entryBilingualTextFor,
+  entryBilingualValuesFor,
   entryLabelFor,
   entryStateKind,
   mountUpdateEntry

package/dist/host.js

@@ -13,6 +13,7 @@ import { manualCommand } from "./commands.js";
 import { fetchReleaseChangelogText } from "./changelog-io.js";
 import { shouldFetchChangelog } from "./changelog.js";
 import { buildDiag } from "./diag.js";
+import { LOG_EVENT_CALL, LOG_EVENT_CALL_FAIL } from "./log-events.js";
 import { fetchNpmVersionRelease, isVersionAllowedInChannel, updateError, validReleaseVersion, validRequestId } from "./service.js";
 import { createUpdateDiskPorts, createUpdateExecutor, createUpdateQueuePorts } from "./store.js";
 import { createUpdateReader, defaultHomeDir, resolveProfileName, resolveTargetPackage } from "./reader.js";
@@ -496,7 +497,7 @@ function loggedPhone(method, kind, pluginId, fn, diagCtx) {
     try {
       const out = await fn(safeArgs);
       const snapshot = out && out.snapshot ? out.snapshot : out;
-      emit("info", "host.call", { method, latencyMs: Date.now() - t0, ok: true, kind, pluginId });
+      emit("info", LOG_EVENT_CALL, { method, latencyMs: Date.now() - t0, ok: true, kind, pluginId });
       return {
         ok: true,
         snapshot,
@@ -509,7 +510,7 @@ function loggedPhone(method, kind, pluginId, fn, diagCtx) {
       };
     } catch (error) {
       const payload = toUpdateErrorPayload(error);
-      emit("warn", "host.call.fail", { method, kind, errorHash: hash8(String(error?.message || payload.error)), pluginId });
+      emit("warn", LOG_EVENT_CALL_FAIL, { method, kind, errorHash: hash8(String(error?.message || payload.error)), pluginId });
       let diag;
       try {
         const cfg = diagCtx?.config;
@@ -581,11 +582,11 @@ function loggedChangelogPhone(method, pluginId, fn, diagCtx) {
     const safeArgs = args && typeof args === "object" ? args : {};
     try {
       const out = await fn(safeArgs);
-      emit("info", "host.call", { method, latencyMs: Date.now() - t0, ok: true, kind: "update-changelog", pluginId });
+      emit("info", LOG_EVENT_CALL, { method, latencyMs: Date.now() - t0, ok: true, kind: "update-changelog", pluginId });
       return { ok: true, version: out.version, markdown: out.markdown };
     } catch (error) {
       const payload = toUpdateErrorPayload(error);
-      emit("warn", "host.call.fail", { method, kind: "update-changelog", errorHash: hash8(String(error?.message || payload.error)), pluginId });
+      emit("warn", LOG_EVENT_CALL_FAIL, { method, kind: "update-changelog", errorHash: hash8(String(error?.message || payload.error)), pluginId });
       let diag;
       try {
         const cfg = diagCtx?.config;

package/dist/log-events.d.ts

@@ -0,0 +1,10 @@
+/**
+ * src/log-events.ts —— 日志事件名（单源）。
+ *
+ * 宿主发射（host/store）、面板路牌（panel）、测试断言都从这里取：
+ * 改名即全改，不存在“发射侧改了、路牌还是旧名”的静默分叉。
+ * 本文件零导入，宿主/面板同缝（与 redaction 同口径）。
+ */
+export declare const LOG_EVENT_CALL = "host.call";
+export declare const LOG_EVENT_CALL_FAIL = "host.call.fail";
+export declare const LOG_EVENT_INSTALL_EXEC = "update.install.exec";

package/dist/log-events.js

@@ -0,0 +1,9 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/log-events.ts
+const LOG_EVENT_CALL = "host.call";
+const LOG_EVENT_CALL_FAIL = "host.call.fail";
+const LOG_EVENT_INSTALL_EXEC = "update.install.exec";
+export {
+  LOG_EVENT_CALL,
+  LOG_EVENT_CALL_FAIL,
+  LOG_EVENT_INSTALL_EXEC
+};

package/dist/panel-batch.js

@@ -131,7 +131,7 @@ function renderBatchPanelHTML(input) {
   parts.push('<div class="dsh-upd-batch-macros">');
   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>');
+  if (mode === "dialog") parts.push('<button type="button" data-act="close" title="\u5173\u95ED\u7A97\u53E3\uFF0C\u6279\u91CF\u66F4\u65B0\u4E0D\u53D7\u5F71\u54CD">\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";
@@ -169,8 +169,8 @@ 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 = normalizePanelTheme(theme) === "d5-paper";
-  const attr = d5 ? ' data-theme="d5-paper"' : "";
+  const d5 = normalizePanelTheme(theme) === "archive";
+  const attr = d5 ? ' data-theme="archive"' : "";
   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>";
   const body = mode === "dialog" ? '<div class="dsh-upd-overlay" data-mode="dialog">' + root + "</div>" : root;
@@ -388,16 +388,16 @@ const UPDATE_BATCH_PANEL_CSS = [
 ].join(String.fromCharCode(10));
 const UPDATE_BATCH_PANEL_D5_CSS = [
   "/* \u6279\u91CF\u9762\u677F\u7684 D5 \u76AE\u80A4\uFF1A\u53EA\u6362\u989C\u8272/\u5B57\u4F53/\u95F4\u8DDD\uFF1B\u6839\u4E0A\u7684\u5927\u5370\u7AE0\u7531 UPDATE_PANEL_D5_CSS \u8D1F\u8D23\u3002 */",
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-batch-head{padding-right:120px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-batch-title{font-family:var(--d5-serif);font-size:21px;letter-spacing:.04em}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-batch-title i{color:var(--d5-accent)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-brow-main{background:transparent;border:0;color:var(--d5-ink)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-brow-main:hover{color:var(--d5-accent)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-bname{font-family:var(--d5-serif)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-bver{font-family:var(--d5-mono);color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-batch-ledger{color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-batch-sum{color:var(--d5-ink)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-brow-set{border-top-color:var(--d5-line)}'
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch-head{padding-right:120px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch-title{font-family:var(--d5-serif);font-size:21px;letter-spacing:.04em}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch-title i{color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-brow-main{background:transparent;border:0;color:var(--d5-ink)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-brow-main:hover{color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-bname{font-family:var(--d5-serif)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-bver{font-family:var(--d5-mono);color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch-ledger{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch-sum{color:var(--d5-ink)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-brow-set{border-top-color:var(--d5-line)}'
 ].join(String.fromCharCode(10));
 function escapeHtml(text) {
   return String(text).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -995,10 +995,10 @@ function mountUpdateBatchPanel(container, options) {
     }
   }
   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();
   }
   function setMode(next) {

package/dist/panel.d.ts

@@ -9,16 +9,16 @@ export type UpdatePanelMode = 'embedded' | 'dialog';
  */
 export type UpdatePanelTheme = 'default' | 'archive' | 'd5-paper';
 /**
- * 主题归一：archive 与旧别名 d5-paper 走同一套渲染（DOM 属性仍为 d5-paper，既有覆盖样式不断）；
+ * 主题归一：archive 为首选名，旧别名 d5-paper 仍收并归到 archive（DOM 属性只出 archive）；
  * 其余一律回 default（纯渲染函数永不抛；挂载/setTheme 的非法值另行抛错）。
  */
-export declare function normalizePanelTheme(value: unknown): 'default' | 'd5-paper';
+export declare function normalizePanelTheme(value: unknown): 'default' | 'archive';
 /** 与宿主通话的传输函数：面板只认这个签名，不认任何宿主对象的具体形状。 */
 export type UpdatePanelCall = (phoneName: string, args: Record<string, unknown>) => Promise<Record<string, unknown>>;
 /** 复制文本的出口：不传即尝试浏览器剪贴板，都没有则只留“已生成、请手动复制”提示。 */
 export type UpdatePanelCopyText = (text: string) => void | Promise<void>;
 /** 面板可点的动作（与 HTML 里 data-action 一一对应，测试走同一条路）。 */
-export type UpdatePanelActionKind = 'check' | 'install' | 'skip' | 'reset-skip' | 'copy-manual' | 'copy-diag' | 'toggle-queue' | 'restart-hint' | 'close-view';
+export type UpdatePanelActionKind = 'check' | 'install' | 'skip' | 'reset-skip' | 'copy-manual' | 'copy-diag' | 'toggle-queue' | 'restart-hint' | 'close-view' | 'dismiss-failure';
 export interface UpdatePanelOptions {
     /** 插件标识：必填，与宿主侧 createHostUpdate 传的 pluginId 一致。 */
     pluginId: string;
@@ -30,6 +30,8 @@ export interface UpdatePanelOptions {
     theme?: UpdatePanelTheme;
     /** 是否看他人排队明细：默认只看自己的（他人仅露正忙占位，位置照给）。 */
     showOthers?: boolean;
+    /** 是否显示深挖日志指引：默认显示；面向纯终端用户的嵌入可关（失败证据行不受影响）。 */
+    showLogHint?: boolean;
     /** 轮询间隔毫秒：默认 1000，不得小于 250。 */
     pollMs?: number;
     /** 与宿主通话的函数（面板侧唯一的宿主接触面）。 */
@@ -235,7 +237,7 @@ export interface PanelRenderInput extends PanelViewInput {
     showOthers: boolean;
     pluginId: string;
     copyNotice: string | null;
-    /** 可选主题：不传即默认（输出与旧版一字不差）；`d5-paper` 切 D5 档案卷。 */
+    /** 可选主题：不传即默认（输出与旧版一字不差）；`archive` 切档案卷（旧别名 `d5-paper` 仍收）。 */
     theme?: UpdatePanelTheme;
     /** 使用范围名（profile）：面板「使用范围」一栏的唯一来源，缺省显示“未知”，不猜。 */
     profileName?: string | null;
@@ -246,6 +248,10 @@ export interface PanelRenderInput extends PanelViewInput {
      * 缺省即静默（输出与旧版一字不差）；只在挂载器置忙的那次 render 里传。
      */
     busyAct?: 'check' | 'install' | null;
+    /** 失败引用（失败档案的查询键；缺省即无失败，不画卷宗）。 */
+    failure?: PanelFailureRef | null;
+    /** 日志指引开关：false 即藏通用日志行（失败证据行不受影响）。 */
+    showLogHint?: boolean;
     /**
      * 动作面归谁：`default`（缺省）由内核画动作按钮；`none` 只画内容、不画按钮。
      * 给「调用方自己提供动作面」的场景（如批量面板的详情：动作由批量面板经自己的通道提供）。
@@ -253,6 +259,16 @@ export interface PanelRenderInput extends PanelViewInput {
      */
     actions?: 'default' | 'none';
 }
+/** 内核渲染用的失败引用（只读快照：证据仍在锁存里，这里只传展示键）。 */
+export interface PanelFailureRef {
+    requestId: string | null;
+    checkId: string | null;
+    atMs: number | null;
+    source: 'check' | 'install' | null;
+    volatile: boolean;
+}
+/** 锁存时刻 → 本地 HH:MM:SS（失败档案“失败于”用；非法值回 null，不画时间）。 */
+export declare function formatLatchTime(atMs: unknown): string | null;
 /** 内核 HTML（双形态行为等价的根：同一视图产出同一内核，只换外层）。 */
 export declare function renderUpdatePanelKernel(input: PanelRenderInput, view: PanelView): string;
 /** 整面板 HTML（含样式；重绘即整体替换 innerHTML，故每次都带 style 也只留一份）。 */

package/dist/panel.js

@@ -9,8 +9,9 @@ import {
   shouldFetchChangelog,
   yankedBannerHTML
 } from "./changelog.js";
+import { LOG_EVENT_CALL, LOG_EVENT_CALL_FAIL, LOG_EVENT_INSTALL_EXEC } from "./log-events.js";
 function normalizePanelTheme(value) {
-  return value === "d5-paper" || value === "archive" ? "d5-paper" : "default";
+  return value === "archive" || value === "d5-paper" ? "archive" : "default";
 }
 const BLOCKED_COPY = {
   "unknown-profile": {
@@ -510,8 +511,8 @@ const UPDATE_PANEL_CSS = [
   '.dsh-upd-banner[data-kind="update"]{border-color:var(--dsh-upd-ok-line);background:var(--dsh-upd-ok-bg)}',
   '.dsh-upd-banner[data-kind="busy"]{border-color:var(--dsh-upd-busy-line);background:var(--dsh-upd-busy-bg)}',
   ".dsh-upd code{font-family:Consolas,Menlo,monospace;font-size:12px;word-break:break-all}",
-  ".dsh-upd-manual,.dsh-upd-queue,.dsh-upd-log{margin:8px 0;font-size:13px}",
-  ".dsh-upd-changelog-wrap{margin:8px 0;font-size:13px;border-top:1px solid var(--dsh-upd-line,#e5e7eb);padding-top:8px}",
+  ".dsh-upd-manual,.dsh-upd-queue,.dsh-upd-log{margin:4px 0;font-size:13px}",
+  ".dsh-upd-changelog-wrap{margin:4px 0 0;font-size:13px}",
   ".dsh-upd-changelog-title{font-weight:700;margin:0 0 4px}",
   ".dsh-upd-changelog-version{margin:6px 0}",
   ".dsh-upd-changelog-catname{font-weight:600;margin:6px 0 2px}",
@@ -596,7 +597,7 @@ const UPDATE_PANEL_CSS = [
 ].join("\n");
 const UPDATE_PANEL_D5_CSS = [
   "/* D5 \u6863\u6848\u5377\u53EF\u9009\u4E3B\u9898\uFF1A\u53EA\u6362\u989C\u8272/\u5B57\u4F53/\u95F4\u8DDD\uFF1B\u5185\u6838 DOM \u987A\u5E8F\u4E00\u5B57\u4E0D\u52A8\uFF0C\u4E0D\u65AD\u590D\u5236\u8BCA\u65AD\u3002 */",
-  '.dsh-upd[data-theme="d5-paper"]{--d5-bg:#f7f3ea;--d5-card:#fffdf6;--d5-ink:#1a1a1a;--d5-muted:#6f675a;',
+  '.dsh-upd[data-theme="archive"]{--d5-bg:#f7f3ea;--d5-card:#fffdf6;--d5-ink:#1a1a1a;--d5-muted:#6f675a;',
   "--d5-line:#e3d9c4;--d5-line-strong:#c4b896;--d5-accent:#c8402a;--d5-accent-deep:#9c2e1d;",
   "--d5-ok:#1a7f37;--d5-ok-bg:#e9f4ea;--d5-warn:#8a5a00;--d5-warn-bg:#fbf0d0;",
   "--d5-bad:#b3261e;--d5-bad-bg:#fbe9e5;",
@@ -607,116 +608,125 @@ const UPDATE_PANEL_D5_CSS = [
   "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)}",
   // 按钮脸自己不透明（宿主底色未知时也读得出；卡片上渲染与 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}',
-  '.dsh-upd[data-theme="d5-paper"] button:focus-visible{outline:2px solid var(--d5-accent);outline-offset:2px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{background:var(--d5-bg);border-color:var(--d5-line-strong)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]{border-color:var(--d5-warn);background:var(--d5-warn-bg)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]{border-color:var(--d5-warn);background:var(--d5-warn-bg);font-family:var(--d5-serif);border-width:2px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"],.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]{border-color:var(--d5-bad);background:var(--d5-bad-bg)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
-  '.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)}',
+  '.dsh-upd[data-theme="archive"] 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="archive"] button:hover:not(:disabled){border-color:var(--d5-accent);color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="archive"] button[data-primary="1"]{background:var(--d5-accent);border-color:var(--d5-accent);color:#fff}',
+  '.dsh-upd[data-theme="archive"] button[data-primary="1"]:hover:not(:disabled){background:var(--d5-accent-deep);color:#fff}',
+  '.dsh-upd[data-theme="archive"] button:focus-visible{outline:2px solid var(--d5-accent);outline-offset:2px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner{background:var(--d5-bg);border-color:var(--d5-line-strong)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="update"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="busy"]{border-color:var(--d5-warn);background:var(--d5-warn-bg)}',
+  '.dsh-upd[data-theme="archive"] .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="archive"] .dsh-upd-banner[data-kind="failed"],.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="blocked"]{border-color:var(--d5-bad);background:var(--d5-bad-bg)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="done"]{border-color:var(--d5-ok);background:var(--d5-ok-bg)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-changelog-yanked{border-color:var(--d5-warn);background:var(--d5-warn-bg);color:var(--d5-ink)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-breaking-badge{color:var(--d5-accent);border-color:var(--d5-accent)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-changelog-count{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .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;',
+  '.dsh-upd[data-theme="archive"]{position:relative;padding:16px 20px 14px}',
+  '.dsh-upd[data-theme="archive"]::before{content:attr(data-seal);position:absolute;top:20px;right:24px;width:88px;height:88px;',
   "display:flex;align-items:center;justify-content:center;text-align:center;letter-spacing:.18em;text-indent:.18em;line-height:1.35;",
   "border:3px solid currentColor;border-radius:14px;transform:rotate(-7deg);font-family:var(--d5-serif);font-weight:700;font-size:21px;",
   "background:color-mix(in srgb,currentColor 8%,transparent);user-select:none;pointer-events:none;",
   "box-shadow:inset 0 0 0 5px var(--d5-card),inset 0 0 0 6px currentColor,0 2px 6px rgba(0,0,0,.12)}",
-  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="ink"]::before{color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="green"]::before{color:var(--d5-ok)}',
-  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="yellow"]::before{color:var(--d5-warn)}',
-  '.dsh-upd[data-theme="d5-paper"][data-seal-tone="red"]::before{color:var(--d5-bad)}',
+  '.dsh-upd[data-theme="archive"][data-seal-tone="ink"]::before{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"][data-seal-tone="green"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="archive"][data-seal-tone="yellow"]::before{color:var(--d5-warn)}',
+  '.dsh-upd[data-theme="archive"][data-seal-tone="red"]::before{color:var(--d5-bad)}',
   // 印章占位：首行（横幅/状态行）右侧留出 120px，文字不许压到印章上（原型 .filehead padding-right:120px）
   // —— 卷宗抬头（原型 :195-203 的刊头，主题切换按钮按用户口径去掉）：只有 D5 档案卷才显示 ——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead{display:block;padding:0 0 10px;margin:0 0 12px;border-bottom:1px solid var(--d5-line)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-kicker{display:block;font-size:11px;letter-spacing:.35em;color:var(--d5-muted);margin-bottom:3px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title{font-family:var(--d5-serif);font-size:26px;font-weight:700;line-height:1.2}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title i{color:var(--d5-accent);font-style:normal}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-masthead{display:block;padding:0 0 8px;margin:0 0 8px;border-bottom:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-masthead-kicker{display:block;font-size:11px;letter-spacing:.35em;color:var(--d5-muted);margin-bottom:3px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-masthead-title{font-family:var(--d5-serif);font-size:26px;font-weight:700;line-height:1.2}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-masthead-title i{color:var(--d5-accent);font-style:normal}',
   // 横幅不再给大印章留 124px：实测（headless 量盒子）印章盒底边 y=109，横幅正文顶边 y=108、
   // 状态行那句在 y=159——印章只压到横幅顶部的留白带，压不到正文。留着反而把 27px 那句话挤成两行
   // （27px 单行需 428px，留白后只剩 366px）。档案头那 120px 保留：那里是真的重叠。
   // —— 更新队列（03 章）D5 皮肤 ——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qrow{padding:8px 0}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qk{width:66px;letter-spacing:.18em}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qv{font-family:var(--d5-serif);font-size:16px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qn{font-family:var(--d5-mono);font-size:11.5px;color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-qseq{color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-note{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-qrow{padding:6px 0}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-qk{width:66px;letter-spacing:.18em}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-qv{font-family:var(--d5-serif);font-size:16px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-qn{font-family:var(--d5-mono);font-size:11.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-qseq{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chap-note{color:var(--d5-muted)}',
   // —— 小印章（原型 :215 `.sealmini`：30px、旋转 -5°、一字）——
   // 待重启横幅一律不画印章：那一档的标记是左侧手绘 SVG（原型 :446 的 .mark 只有 SVG）。
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="loading"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="idle"]::before,',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]::before,',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"]::before,',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]::before{content:attr(data-mini);display:inline-flex;align-items:center;justify-content:center;',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="loading"]::before,.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="idle"]::before,',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="update"]::before,.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="busy"]::before,',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="failed"]::before,',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="done"]::before{content:attr(data-mini);display:inline-flex;align-items:center;justify-content:center;',
   "width:30px;height:30px;margin-right:10px;vertical-align:middle;border:2px solid currentColor;border-radius:7px;",
   "font-family:var(--d5-serif);font-weight:700;font-size:16px;line-height:26px;transform:rotate(-5deg);flex:none;color:var(--d5-muted)}",
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="update"]::before{color:var(--d5-ok)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="busy"]::before{color:var(--d5-warn)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="failed"]::before{color:var(--d5-bad)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="done"]::before{color:var(--d5-ok)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-log code{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;letter-spacing:.06em}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-manual code{display:block;background:var(--d5-ink);color:var(--d5-bg);font-family:var(--d5-mono);font-size:12.5px;padding:12px 14px;border-radius:4px;white-space:pre-wrap;word-break:break-all}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="update"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="busy"]::before{color:var(--d5-warn)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="blocked"]::before,.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="failed"]::before{color:var(--d5-bad)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="done"]::before{color:var(--d5-ok)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-log code{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;letter-spacing:.06em}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-manual code{display:block;background:var(--d5-ink);color:var(--d5-bg);font-family:var(--d5-mono);font-size:12.5px;padding:12px 14px;border-radius:4px;white-space:pre-wrap;word-break:break-all}',
   // 待重启标记：手绘 SVG 当**独立 flex 标记**放在文字块左侧（原型 :446 `.mark` 是独立节点），
   // 不能用行内背景——那样换行时三角会落在句子中间把话劈开（现场回归）。
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child{display:flex;gap:10px;align-items:flex-start}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{content:"";flex:none;width:20px;height:20px;margin-top:3px;',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="restart"]>div:first-child{display:flex;gap:10px;align-items:flex-start}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{content:"";flex:none;width:20px;height:20px;margin-top:3px;',
   'background:url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2720%27 height=%2720%27 viewBox=%270 0 24 24%27 fill=%27none%27 stroke=%27%238a5a00%27 stroke-width=%272%27 stroke-linecap=%27round%27 stroke-linejoin=%27round%27%3E%3Cpath d=%27M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z%27/%3E%3Cline x1=%2712%27 y1=%279%27 x2=%2712%27 y2=%2713%27/%3E%3Cline x1=%2712%27 y1=%2717%27 x2=%2712.01%27 y2=%2717%27/%3E%3C/svg%3E") no-repeat center/20px 20px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{overflow:hidden;text-overflow:ellipsis}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-actions{flex-wrap:wrap}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner>div:first-child{overflow:hidden;text-overflow:ellipsis}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-actions{flex-wrap:wrap}',
   // footer 只换肤（#47 定案 A + D5 约束：不换 DOM 顺序；复制诊断永不隐藏，本串不动它）。
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-footer{margin-top:26px;padding-top:16px;border-top:1px solid var(--d5-line)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-foot-note{color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-footer{margin-top:14px;padding-top:10px;border-top:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-foot-note{color:var(--d5-muted)}',
   // —— 档案头（原型 :208-211 `.filehead`：serif 插件名 22px + 使用范围 + profile 牌；右侧留章位）——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-head{display:flex;gap:16px;align-items:baseline;flex-wrap:wrap;padding-right:120px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-name{font-family:var(--d5-serif);font-size:22px;font-weight:700}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-meta{width:100%;font-size:12.5px;color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-meta b{color:var(--d5-ink);font-weight:600}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-proftag{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;margin-left:8px;letter-spacing:.06em}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-head{display:flex;gap:16px;align-items:baseline;flex-wrap:wrap;padding-right:120px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-name{font-family:var(--d5-serif);font-size:22px;font-weight:700}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-meta{width:100%;font-size:12.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-meta b{color:var(--d5-ink);font-weight:600}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-proftag{font-family:var(--d5-mono);font-size:11px;color:var(--d5-muted);border:1px solid var(--d5-line-strong);border-radius:3px;padding:0 6px;margin-left:8px;letter-spacing:.06em}',
   // —— 版本条（原型 :216 `.strip`：三格，格间一线，左上小写标签 + 等宽值）——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip{display:flex;flex-wrap:wrap;margin:10px 0 0;border:1px solid var(--d5-line);border-radius:4px;overflow:hidden;font-size:12.5px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip>div{flex:1 1 120px;padding:8px 12px;border-left:1px solid var(--d5-line)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip>div:first-child{border-left:0}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip-k{display:block;font-size:11px;letter-spacing:.2em;color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-strip-v{font-family:var(--d5-mono);font-size:13px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-strip{display:flex;flex-wrap:wrap;margin:8px 0 0;border:1px solid var(--d5-line);border-radius:4px;overflow:hidden;font-size:12.5px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-strip>div{flex:1 1 120px;padding:6px 10px;border-left:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-strip>div:first-child{border-left:0}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-strip-k{display:block;font-size:11px;letter-spacing:.2em;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-strip-v{font-family:var(--d5-mono);font-size:13px}',
   // —— 章节（原型 :218-245：01–05 编号 + 衬线标题 + 细线）——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chapter{margin-top:26px;padding-top:16px;border-top:1px solid var(--d5-line)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-head{display:flex;align-items:baseline;gap:12px;margin-bottom:10px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-no{font-family:var(--d5-serif);font-style:italic;font-size:15px;color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-title{font-family:var(--d5-serif);font-size:17px;margin:0;letter-spacing:.1em}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-chap-rule{flex:1;border-top:1px solid var(--d5-line);transform:translateY(-4px)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chapter{margin-top:16px;padding-top:10px;border-top:1px solid var(--d5-line)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chap-head{display:flex;align-items:baseline;gap:12px;margin-bottom:6px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chap-no{font-family:var(--d5-serif);font-style:italic;font-size:15px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chap-title{font-family:var(--d5-serif);font-size:17px;margin:0;letter-spacing:.1em}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-chap-rule{flex:1;border-top:1px solid var(--d5-line);transform:translateY(-4px)}',
   // —— 横幅即状态行 / 待重启横幅（原型 :81-85 `.restart-banner`：2px 边框、圆角 4、内边距 12/16、衬线；右侧留章位）——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{border:2px solid var(--d5-line-strong);border-radius:4px;padding:12px 16px;font-size:14.5px;font-family:var(--d5-serif);display:flex;gap:10px;align-items:center;flex-wrap:wrap}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{flex:1 1 auto;min-width:0}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner{border:2px solid var(--d5-line-strong);border-radius:4px;padding:10px 12px;font-size:14.5px;font-family:var(--d5-serif);display:flex;gap:10px;align-items:center;flex-wrap:wrap}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner>div:first-child{flex:1 1 auto;min-width:0}',
   // 状态行字号照原型 .status-line=27px（实测去掉横幅右侧占位后可写 486px > 428px，一行放得下）
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child strong{font-family:var(--d5-serif);font-size:27px;font-weight:700;line-height:1.35}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-banner>div:first-child strong{font-family:var(--d5-serif);font-size:27px;font-weight:700;line-height:1.25}',
   // —— 进度条 / 跳过行（原型 :132-133 `.prog`、:129-131 `.skipline .tag`）——
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-prog{height:8px;background:var(--d5-line);border-radius:4px;overflow:hidden;margin:10px 0 4px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-prog-bar{display:block;height:100%;background:var(--d5-accent);transition:width .3s}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-progtxt{font-size:12.5px;color:var(--d5-muted)}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-skipline{font-size:13px;margin-top:8px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-tag{display:inline-block;border:1px dashed var(--d5-line-strong);border-radius:3px;padding:1px 8px;margin-right:8px;font-family:var(--d5-mono);font-size:12px}',
-  '.dsh-upd[data-theme="d5-paper"] .dsh-upd-err{font-size:13px;margin:0 0 6px;color:var(--d5-muted)}',
-  '@media (max-width:640px){.dsh-upd[data-theme="d5-paper"]{padding:10px 12px}.dsh-upd[data-theme="d5-paper"]::before{top:12px;right:12px;width:56px;height:56px;font-size:15px;box-shadow:inset 0 0 0 4px var(--d5-card),inset 0 0 0 5px currentColor}.dsh-upd[data-theme="d5-paper"] .dsh-upd-masthead-title{font-size:19px}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{padding-right:16px}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner::before{width:24px;height:24px;font-size:14px;line-height:20px;flex:none}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner>div:first-child{white-space:normal}}',
-  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"]{--d5-bg:#141210;--d5-card:#1e1a15;--d5-ink:#ece5d3;--d5-muted:#a89c83;',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-prog{height:8px;background:var(--d5-line);border-radius:4px;overflow:hidden;margin:10px 0 4px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-prog-bar{display:block;height:100%;background:var(--d5-accent);transition:width .3s}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-progtxt{font-size:12.5px;color:var(--d5-muted)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-skipline{font-size:13px;margin-top:8px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-tag{display:inline-block;border:1px dashed var(--d5-line-strong);border-radius:3px;padding:1px 8px;margin-right:8px;font-family:var(--d5-mono);font-size:12px}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-err{font-size:13px;margin:0 0 6px;color:var(--d5-muted)}',
+  '@media (max-width:640px){.dsh-upd[data-theme="archive"]{padding:10px 12px}.dsh-upd[data-theme="archive"]::before{top:12px;right:12px;width:56px;height:56px;font-size:15px;box-shadow:inset 0 0 0 4px var(--d5-card),inset 0 0 0 5px currentColor}.dsh-upd[data-theme="archive"] .dsh-upd-masthead-title{font-size:19px}.dsh-upd[data-theme="archive"] .dsh-upd-banner{padding-right:16px}.dsh-upd[data-theme="archive"] .dsh-upd-banner::before{width:24px;height:24px;font-size:14px;line-height:20px;flex:none}.dsh-upd[data-theme="archive"] .dsh-upd-banner>div:first-child{white-space:normal}}',
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="archive"]{--d5-bg:#141210;--d5-card:#1e1a15;--d5-ink:#ece5d3;--d5-muted:#a89c83;',
   "--d5-line:#3a3226;--d5-line-strong:#5c4e3b;--d5-accent:#e0684e;--d5-accent-deep:#f0866b;",
   "--d5-ok:#8fd6a4;--d5-ok-bg:rgba(80,180,120,.12);--d5-warn:#e8c15a;--d5-warn-bg:rgba(232,193,90,.12);",
   "--d5-bad:#ef8a7d;--d5-bad-bg:rgba(239,138,125,.12);--d5-shadow:0 1px 2px rgba(0,0,0,.4),0 12px 32px rgba(0,0,0,.45)}}",
-  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]{color:#141210}.dsh-upd[data-theme="d5-paper"] button:focus-visible{outline-color:var(--d5-accent-deep)}}',
-  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2720%27 height=%2720%27 viewBox=%270 0 24 24%27 fill=%27none%27 stroke=%27%23e8c15a%27 stroke-width=%272%27 stroke-linecap=%27round%27 stroke-linejoin=%27round%27%3E%3Cpath d=%27M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z%27/%3E%3Cline x1=%2712%27 y1=%279%27 x2=%2712%27 y2=%2713%27/%3E%3Cline x1=%2712%27 y1=%2717%27 x2=%2712.01%27 y2=%2717%27/%3E%3C/svg%3E")}}',
-  '@media (forced-colors: active){.dsh-upd[data-theme="d5-paper"]{box-shadow:none}.dsh-upd[data-theme="d5-paper"]::before{background:none;box-shadow:none;border-color:CanvasText;color:CanvasText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner{border:1px solid CanvasText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner::before{border-color:CanvasText;color:CanvasText;background:Canvas}.dsh-upd[data-theme="d5-paper"] button{border:1px solid ButtonText}.dsh-upd[data-theme="d5-paper"] button[data-primary="1"]{background:ButtonFace;color:ButtonText;border-color:ButtonText}.dsh-upd[data-theme="d5-paper"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:none;content:"\u26A0"}}',
-  '@media (prefers-reduced-motion: reduce){.dsh-upd[data-theme="d5-paper"] *{transition:none !important;animation:none !important}}'
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="archive"] button[data-primary="1"]{color:#141210}.dsh-upd[data-theme="archive"] button:focus-visible{outline-color:var(--d5-accent-deep)}}',
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:url("data:image/svg+xml,%3Csvg xmlns=%27http://www.w3.org/2000/svg%27 width=%2720%27 height=%2720%27 viewBox=%270 0 24 24%27 fill=%27none%27 stroke=%27%23e8c15a%27 stroke-width=%272%27 stroke-linecap=%27round%27 stroke-linejoin=%27round%27%3E%3Cpath d=%27M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z%27/%3E%3Cline x1=%2712%27 y1=%279%27 x2=%2712%27 y2=%2713%27/%3E%3Cline x1=%2712%27 y1=%2717%27 x2=%2712.01%27 y2=%2717%27/%3E%3C/svg%3E")}}',
+  '@media (forced-colors: active){.dsh-upd[data-theme="archive"]{box-shadow:none}.dsh-upd[data-theme="archive"]::before{background:none;box-shadow:none;border-color:CanvasText;color:CanvasText}.dsh-upd[data-theme="archive"] .dsh-upd-banner{border:1px solid CanvasText}.dsh-upd[data-theme="archive"] .dsh-upd-banner::before{border-color:CanvasText;color:CanvasText;background:Canvas}.dsh-upd[data-theme="archive"] button{border:1px solid ButtonText}.dsh-upd[data-theme="archive"] button[data-primary="1"]{background:ButtonFace;color:ButtonText;border-color:ButtonText}.dsh-upd[data-theme="archive"] .dsh-upd-banner[data-kind="restart"]>div:first-child::before{background-image:none;content:"\u26A0"}}',
+  '@media (prefers-reduced-motion: reduce){.dsh-upd[data-theme="archive"] *{transition:none !important;animation:none !important}}'
 ].join("\n");
 function escapeHtml(text) {
   return String(text).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 const CHAPTER_TITLES = ["\u68C0\u67E5\u4E0E\u5B89\u88C5", "\u66F4\u65B0\u65E5\u5FD7", "\u66F4\u65B0\u961F\u5217", "\u9519\u8BEF\u4FE1\u606F", "\u624B\u5DE5\u547D\u4EE4"];
+function formatLatchTime(atMs) {
+  if (typeof atMs !== "number" || !Number.isFinite(atMs) || atMs <= 0) return null;
+  try {
+    const s = new Date(atMs).toLocaleTimeString("zh-CN", { hour12: false });
+    return s ? s : null;
+  } catch {
+    return null;
+  }
+}
 function chapterOf(index, inner, note = "") {
   const no = String(index).padStart(2, "0");
   const title = CHAPTER_TITLES[index - 1];
@@ -781,6 +791,9 @@ function renderUpdatePanelKernel(input, view) {
     if (b.kind === "restart") {
       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 (b.kind === "failed") {
+      actions.push(`<button type="button" data-action="dismiss-failure" title="\u786E\u8BA4\u5DF2\u77E5\u6653\u8BE5\u5931\u8D25\uFF1A\u56DE\u5230\u53EF\u88C5\u9875\uFF0C\u4E0B\u6B21\u67E5/\u88C5\u5C06\u91CD\u65B0\u8BC4\u4F30">\u77E5\u9053\u4E86</button>`);
+    }
     if (snapshot) {
       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>`);
     }
@@ -877,14 +890,45 @@ ${changelogHTML}
   }
   {
     const errLines = [];
-    if (b.kind === "failed" || b.kind === "blocked") {
+    const failedNow = b.kind === "failed" || b.kind === "blocked";
+    const failRef = input.failure;
+    if (failedNow) {
+      const shownCode = b.kind === "blocked" ? snapshot?.blockedReason ?? b.kind : typeof input.lastError === "string" && input.lastError.trim() ? input.lastError : "install-failed";
       errLines.push(
-        `<div class="dsh-upd-err">\u7A33\u5B9A\u7801 <code>${escapeHtml(String(b.kind === "blocked" ? snapshot?.blockedReason ?? b.kind : "install-failed"))}</code>\uFF1A\u4E0A\u4E00\u6761\u4E2D\u6587\u8BF4\u660E\u5C31\u662F\u8981\u7528\u6237\u505A\u7684\u4E8B\uFF1B\u8981\u5F80\u4E0A\u6E38\u62A5\uFF0C\u7528\u300C\u590D\u5236\u8BCA\u65AD\u300D\u6574\u6BB5\u7C98\uFF08\u5DF2\u8131\u654F\uFF09\u3002</div>`
+        `<div class="dsh-upd-err">\u7A33\u5B9A\u7801 <code>${escapeHtml(String(shownCode))}</code>\uFF1A\u4E0A\u4E00\u6761\u4E2D\u6587\u8BF4\u660E\u5C31\u662F\u8981\u7528\u6237\u505A\u7684\u4E8B\uFF1B\u8981\u5F80\u4E0A\u6E38\u62A5\uFF0C\u7528\u300C\u590D\u5236\u8BCA\u65AD\u300D\u6574\u6BB5\u7C98\uFF08\u5DF2\u8131\u654F\uFF09\u3002</div>`
       );
+      if (b.kind === "failed" && failRef) {
+        const keys = [];
+        if (typeof failRef.requestId === "string" && failRef.requestId) keys.push(`\u8BF7\u6C42 <code>${escapeHtml(failRef.requestId)}</code>`);
+        if (typeof failRef.checkId === "string" && failRef.checkId) keys.push(`\u68C0\u67E5 <code>${escapeHtml(failRef.checkId)}</code>`);
+        const at = formatLatchTime(failRef.atMs);
+        if (at) keys.push(`\u5931\u8D25\u4E8E ${escapeHtml(at)}`);
+        if (keys.length > 0) {
+          errLines.push(`<div class="dsh-upd-err">\u672C\u6B21\u67E5\u8BE2\u952E\uFF1A${keys.join(" \xB7 ")}\uFF08\u62FF\u7740\u5B83\u4EEC\u53BB\u65E5\u5FD7\u91CC\u5BF9\uFF09\u3002</div>`);
+        }
+        if (!failRef.volatile) {
+          errLines.push(
+            `<div class="dsh-upd-err">\u8BC1\u636E\u5DF2\u51BB\u7ED3\uFF1A\u590D\u5236\u8BCA\u65AD\u91CC\u7684\u7801\u3001\u7248\u672C\u3001\u7F16\u53F7\u90FD\u53D6\u81EA\u5931\u8D25\u65F6\u523B\uFF0C\u4E0D\u968F\u8F6E\u8BE2\u5237\u65B0\uFF1B\u4E0B\u4E00\u6B21\u67E5\u65B0\u7248\u6216\u5B89\u88C5\u4F1A\u66F4\u65B0\u5B83\u3002</div>`
+          );
+        } else {
+          errLines.push(
+            `<div class="dsh-upd-err">\u8BFB\u6570\u77AC\u6001\u5931\u8D25\uFF1A\u4E0B\u4E00\u6B21\u6210\u529F\u8BFB\u6570\u4F1A\u81EA\u52A8\u89E3\u9664\uFF1B\u4E00\u76F4\u51FA\u73B0\u518D\u6309\u7A33\u5B9A\u7801\u6392\u67E5\u3002</div>`
+          );
+        }
+      }
+    } else {
+      errLines.push(`<div class="dsh-upd-changelog-neutral">\u6682\u65E0\u5931\u8D25\uFF1A\u6B64\u65F6\u590D\u5236\u8BCA\u65AD\u7ED9\u51FA\u7684\u662F\u5F53\u524D\u72B6\u6001\u5FEB\u7167\u3002</div>`);
+    }
+    if (input.showLogHint !== false) {
+      errLines.push(
+        `<div class="dsh-upd-log">\u6DF1\u6316\u770B\u65E5\u5FD7\uFF1A\u6309\u63D2\u4EF6\u6807\u8BC6 <code>${escapeHtml(pluginId)}</code> \u8FC7\u6EE4 <code>${LOG_EVENT_CALL}</code>\u3001<code>${LOG_EVENT_CALL_FAIL}</code>\u3001<code>${LOG_EVENT_INSTALL_EXEC}</code> \u4E09\u4E2A\u4E8B\u4EF6\u3002</div>`
+      );
+      if (b.kind === "failed" && failRef && (failRef.requestId || failRef.checkId)) {
+        errLines.push(
+          `<div class="dsh-upd-log">\u51ED\u4E0A\u9762\u7684\u8BF7\u6C42\uFF0F\u68C0\u67E5\u7F16\u53F7\u5728 <code>${LOG_EVENT_CALL_FAIL}</code> \u91CC\u5BF9\u4E0A\uFF1B\u57FA\u7EBF\u8017\u65F6\u770B <code>${LOG_EVENT_CALL}</code>\uFF0C\u6267\u884C\u7ED3\u679C\u770B <code>${LOG_EVENT_INSTALL_EXEC}</code>\u3002</div>`
+        );
+      }
     }
-    errLines.push(
-      `<div class="dsh-upd-log">\u6DF1\u6316\u770B\u65E5\u5FD7\uFF1A\u6309\u63D2\u4EF6\u6807\u8BC6 <code>${escapeHtml(pluginId)}</code> \u8FC7\u6EE4 <code>host.call</code>\u3001<code>host.call.fail</code>\u3001<code>update.install.exec</code> \u4E09\u4E2A\u4E8B\u4EF6\u3002</div>`
-    );
     if (copyNotice) errLines.push(`<div class="dsh-upd-copy" role="status">${escapeHtml(copyNotice)}</div>`);
     parts.push(chapterOf(4, errLines.join("")));
   }
@@ -896,7 +940,7 @@ ${changelogHTML}
   );
   if (showActions && mode === "dialog") {
     parts.push(
-      `<div class="dsh-upd-footer"><span class="dsh-upd-foot-note">\u5B89\u88C5\u5728\u5BBF\u4E3B\u4FA7\u7EE7\u7EED\u8DD1\uFF0C\u91CD\u5F00\u6062\u590D\u663E\u793A</span><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></div>`
+      `<div class="dsh-upd-footer"><span class="dsh-upd-foot-note">\u5173\u95ED\u4E0D\u5F71\u54CD\u66F4\u65B0\uFF0C\u53EF\u968F\u65F6\u56DE\u6765\u67E5\u770B</span><button type="button" data-action="close-view" title="\u5173\u95ED\u7A97\u53E3\uFF0C\u66F4\u65B0\u4E0D\u53D7\u5F71\u54CD">\u5173\u95ED</button></div>`
     );
   }
   return parts.join("\n");
@@ -904,8 +948,8 @@ ${changelogHTML}
 function renderUpdatePanelHTML(input) {
   const view = panelViewModel(input);
   const kernel = renderUpdatePanelKernel(input, view);
-  const d5 = normalizePanelTheme(input.theme) === "d5-paper";
-  const attr = d5 ? ' data-theme="d5-paper"' : "";
+  const d5 = normalizePanelTheme(input.theme) === "archive";
+  const attr = d5 ? ' data-theme="archive"' : "";
   const sealAttr = ` data-seal="${escapeHtml(view.seal.text)}" data-seal-tone="${view.seal.tone}"`;
   const body = input.mode === "dialog" ? `<div class="dsh-upd-overlay" data-mode="dialog"><div class="dsh-upd" data-mode="dialog" data-plugin="${escapeHtml(input.pluginId)}"${sealAttr}${attr}>
 ${kernel}
@@ -917,6 +961,7 @@ ${UPDATE_PANEL_D5_CSS}` : UPDATE_PANEL_CSS;
   return `<style>${css}</style>
 ${body}`;
 }
+const PANEL_FAILURE_LATCHES = /* @__PURE__ */ new Map();
 function isObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -1019,6 +1064,7 @@ function mountUpdatePanel(container, options) {
   const skipStore = options.skipStore ?? createBrowserSkipStore(pluginId);
   const hostKind = typeof options.hostKind === "string" && options.hostKind ? options.hostKind : null;
   const profileNameOption = typeof options.profileName === "string" && options.profileName ? options.profileName : null;
+  const showLogHintOption = options.showLogHint !== false;
   const diagCopyFormat = options.diagCopyFormat === "line" ? "line" : "block";
   let changelogMarkdown = typeof options.changelogMarkdown === "string" ? options.changelogMarkdown : null;
   let snapshot = null;
@@ -1026,9 +1072,139 @@ function mountUpdatePanel(container, options) {
   let queue = null;
   let receipt = null;
   let requestId = null;
-  let lastError = null;
-  let lastErrorKind = null;
-  let lastDiag = null;
+  const latchKey = `${pluginId}${profileNameOption ?? ""}`;
+  let latch = null;
+  try {
+    latch = PANEL_FAILURE_LATCHES.get(latchKey) ?? null;
+    if (latch?.volatile) latch = null;
+  } catch {
+    latch = null;
+  }
+  function saveLatch() {
+    try {
+      if (latch && !latch.volatile) {
+        if (!PANEL_FAILURE_LATCHES.has(latchKey) && PANEL_FAILURE_LATCHES.size >= 100) {
+          const oldest = PANEL_FAILURE_LATCHES.keys().next();
+          if (!oldest.done) PANEL_FAILURE_LATCHES.delete(oldest.value);
+        }
+        PANEL_FAILURE_LATCHES.set(latchKey, latch);
+      } else PANEL_FAILURE_LATCHES.delete(latchKey);
+    } catch {
+    }
+  }
+  function latchNow() {
+    try {
+      const n = Date.now();
+      return Number.isFinite(n) ? n : null;
+    } catch {
+      return null;
+    }
+  }
+  function setLatch(next) {
+    latch = next;
+    saveLatch();
+  }
+  function clearLatch() {
+    if (!latch) return;
+    latch = null;
+    saveLatch();
+  }
+  function currentEnvPair() {
+    return { hostKind: hostKind ?? envHostKind, profileName: profileNameOption ?? envProfileName };
+  }
+  function latchFromReply(reply, source) {
+    const env = currentEnvPair();
+    return {
+      code: failureCodeOf(
+        { error: reply["error"], errorKind: reply["errorKind"] },
+        source === "install" ? "install-failed" : "check-failed"
+      ),
+      kind: typeof reply["errorKind"] === "string" && reply["errorKind"].trim() ? reply["errorKind"].trim() : null,
+      detail: null,
+      diag: Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null,
+      requestId: source === "install" ? requestId : null,
+      checkId: source === "install" ? receipt?.checkId ?? null : null,
+      runningVersion: snapshot?.runningVersion ?? null,
+      installedVersion: snapshot?.installedVersion ?? null,
+      latestVersion: snapshot?.latestVersion ?? null,
+      hostKind: env.hostKind,
+      profileName: env.profileName,
+      source,
+      volatile: false,
+      jobId: null,
+      atMs: latchNow()
+    };
+  }
+  function latchFromJob(job, snap) {
+    const env = currentEnvPair();
+    const message = typeof job.message === "string" ? job.message : null;
+    const detail = message && message.includes(":") ? message.slice(message.indexOf(":") + 1).trim() || null : message;
+    return {
+      code: messageCodeOf(message) || "install-failed",
+      kind: null,
+      detail,
+      // 快照里没有 diag：保留锁存里既有的（多半是致命安装回包自带的），没有即缺省说人话
+      diag: latch?.diag ?? null,
+      requestId: job.requestId ?? latch?.requestId ?? requestId,
+      checkId: receipt?.checkId ?? latch?.checkId ?? null,
+      runningVersion: snap?.runningVersion ?? snapshot?.runningVersion ?? null,
+      installedVersion: snap?.installedVersion ?? snapshot?.installedVersion ?? null,
+      latestVersion: snap?.latestVersion ?? snapshot?.latestVersion ?? null,
+      hostKind: env.hostKind ?? latch?.hostKind ?? null,
+      profileName: env.profileName ?? latch?.profileName ?? null,
+      source: "install",
+      volatile: false,
+      jobId: typeof job.id === "string" ? job.id : null,
+      atMs: latchNow()
+    };
+  }
+  function volatileLatch(source) {
+    const env = currentEnvPair();
+    return {
+      code: "check-failed",
+      kind: null,
+      detail: null,
+      diag: null,
+      requestId,
+      checkId: receipt?.checkId ?? null,
+      runningVersion: snapshot?.runningVersion ?? null,
+      installedVersion: snapshot?.installedVersion ?? null,
+      latestVersion: snapshot?.latestVersion ?? null,
+      hostKind: env.hostKind,
+      profileName: env.profileName,
+      source,
+      volatile: true,
+      jobId: null,
+      atMs: latchNow()
+    };
+  }
+  function backfillLatch(s) {
+    if (!latch) return;
+    let touched = false;
+    if (latch.runningVersion === null && s.runningVersion) {
+      latch.runningVersion = s.runningVersion;
+      touched = true;
+    }
+    if (latch.installedVersion === null && s.installedVersion) {
+      latch.installedVersion = s.installedVersion;
+      touched = true;
+    }
+    if (latch.latestVersion === null && s.latestVersion) {
+      latch.latestVersion = s.latestVersion;
+      touched = true;
+    }
+    if (touched) saveLatch();
+  }
+  function tripleChanged(s) {
+    if (!latch) return false;
+    backfillLatch(s);
+    const pairs = [
+      [latch.runningVersion, s.runningVersion ?? null],
+      [latch.installedVersion, s.installedVersion ?? null],
+      [latch.latestVersion, s.latestVersion ?? null]
+    ];
+    return pairs.some(([a, b]) => a !== null && b !== null && a !== b);
+  }
   let copyNotice = null;
   let noticeExpiresAt = 0;
   let busyAct = null;
@@ -1061,8 +1237,10 @@ function mountUpdatePanel(container, options) {
       queue,
       busyAct,
       skippedLatest,
-      lastError,
-      errorKind: lastErrorKind,
+      lastError: latch?.code ?? null,
+      errorKind: latch?.kind ?? null,
+      failure: latch ? { requestId: latch.requestId, checkId: latch.checkId, atMs: latch.atMs, source: latch.source, volatile: latch.volatile } : null,
+      showLogHint: showLogHintOption,
       changelogMarkdown,
       mode,
       showOthers,
@@ -1078,7 +1256,7 @@ function mountUpdatePanel(container, options) {
       container.innerHTML = nextHTML;
     }
   }
-  function applyStatusReply(reply) {
+  function applyStatusReply(reply, via) {
     if (!isObject(reply)) return;
     if (reply["ok"] === true) {
       const s = asSnapshot(reply["snapshot"]);
@@ -1096,13 +1274,29 @@ function mountUpdatePanel(container, options) {
         if (typeof pn === "string" && pn.trim()) envProfileName = pn.trim();
         if (typeof hk === "string" && hk.trim()) envHostKind = hk.trim();
       }
-      lastError = null;
-      lastErrorKind = null;
-      lastDiag = Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null;
+      const jobState = snapshot?.job?.state ?? null;
+      if (jobState === "installing" || jobState === "verifying") {
+        clearLatch();
+      } else if (jobState === "completed" || jobState === "restart-required") {
+        clearLatch();
+      } else if ((jobState === "failed" || jobState === "interrupted") && snapshot?.job) {
+        setLatch(latchFromJob(snapshot.job, snapshot));
+      } else if (via === "install") {
+        clearLatch();
+      } else if (snapshot && tripleChanged(snapshot)) {
+        clearLatch();
+      } else if (via === "check" && latch?.source === "check") {
+        clearLatch();
+      } else if (latch?.volatile) {
+        clearLatch();
+      }
     } else {
-      lastError = typeof reply["error"] === "string" ? reply["error"] : "check-failed";
-      lastErrorKind = typeof reply["errorKind"] === "string" && reply["errorKind"].trim() ? reply["errorKind"].trim() : null;
-      lastDiag = Object.prototype.hasOwnProperty.call(reply, "diag") ? reply["diag"] : null;
+      const errText = typeof reply["error"] === "string" ? reply["error"].trim() : "";
+      const kindText = typeof reply["errorKind"] === "string" ? reply["errorKind"].trim() : "";
+      if ((kindText || errText) === "update-busy") {
+      } else {
+        setLatch(latchFromReply(reply, via === "install" ? "install" : "check"));
+      }
       try {
         const env = reply["env"];
         if (isObject(env)) {
@@ -1188,12 +1382,10 @@ function mountUpdatePanel(container, options) {
     try {
       const reply = await call(phoneNames.updateStatus, queueArgs());
       if (!mounted) return;
-      applyStatusReply(reply);
+      applyStatusReply(reply, "refresh");
     } catch {
       if (!mounted) return;
-      lastError = "check-failed";
-      lastErrorKind = null;
-      lastDiag = null;
+      setLatch(volatileLatch("check"));
     }
     render();
     maybeAutoChangelog();
@@ -1210,13 +1402,11 @@ function mountUpdatePanel(container, options) {
         try {
           const reply = await call(phoneNames.updateCheck, queueArgs());
           if (!mounted) return;
-          applyStatusReply(reply);
+          applyStatusReply(reply, "check");
           changelogFailedAt.clear();
         } catch {
           if (!mounted) return;
-          lastError = "check-failed";
-          lastErrorKind = null;
-          lastDiag = null;
+          setLatch(volatileLatch("check"));
         } finally {
           busyAct = null;
           if (copyNotice === "\u6B63\u5728\u67E5\u65B0\u7248\u2026") copyNotice = null;
@@ -1234,13 +1424,28 @@ function mountUpdatePanel(container, options) {
           if (!receipt) {
             const checked = await call(phoneNames.updateCheck, queueArgs());
             if (!mounted) return;
-            applyStatusReply(checked);
+            applyStatusReply(checked, "check");
           }
           if (!mounted) return;
           if (!receipt) {
-            lastError = "check-expired";
-            lastErrorKind = "check-expired";
-            lastDiag = null;
+            const expiredEnv = currentEnvPair();
+            setLatch({
+              code: "check-expired",
+              kind: "check-expired",
+              detail: null,
+              diag: null,
+              requestId,
+              checkId: null,
+              runningVersion: snapshot?.runningVersion ?? null,
+              installedVersion: snapshot?.installedVersion ?? null,
+              latestVersion: snapshot?.latestVersion ?? null,
+              hostKind: expiredEnv.hostKind,
+              profileName: expiredEnv.profileName,
+              source: "install",
+              volatile: false,
+              jobId: null,
+              atMs: latchNow()
+            });
             render();
             return;
           }
@@ -1251,12 +1456,10 @@ function mountUpdatePanel(container, options) {
             ...queueArgs()
           });
           if (!mounted) return;
-          applyStatusReply(reply);
+          applyStatusReply(reply, "install");
         } catch {
           if (!mounted) return;
-          lastError = "check-failed";
-          lastErrorKind = null;
-          lastDiag = null;
+          setLatch(volatileLatch("install"));
         } finally {
           busyAct = null;
           if (copyNotice === "\u6B63\u5728\u5B89\u88C5\u2026") copyNotice = null;
@@ -1298,25 +1501,49 @@ function mountUpdatePanel(container, options) {
       }
       case "copy-diag": {
         const jobCode = snapshot?.job?.state === "failed" ? messageCodeOf(snapshot.job.message) || "install-failed" : "";
-        const code = failureCodeOf(
-          { error: lastError, errorKind: lastErrorKind },
-          jobCode || snapshot?.blockedReason || "check-failed"
-        );
-        const detail = snapshot?.job?.message && snapshot.job.message.includes(":") ? snapshot.job.message.slice(snapshot.job.message.indexOf(":") + 1) : snapshot?.job?.message;
+        if (!latch && !jobCode && !snapshot?.blockedReason && snapshot) {
+          const stateLine = snapshot.canInstall && snapshot.latestVersion ? `\u6709\u65B0\u7248 ${snapshot.latestVersion} \u53EF\u88C5\uFF08\u5F53\u524D ${snapshot.runningVersion}\uFF09` : "\u5DF2\u662F\u6700\u65B0\uFF0C\u65E0\u9700\u66F4\u65B0\u3002";
+          const queueName = queueTextOf(queue?.position ?? null);
+          const envBits = [
+            `\u63D2\u4EF6=${pluginId}`,
+            `\u5BBF\u4E3B=${hostKind ?? envHostKind ?? "\u672A\u77E5"}`,
+            `\u4F7F\u7528\u8303\u56F4=${profileNameOption ?? envProfileName ?? "\u672A\u77E5"}`,
+            `\u961F\u5217=${queueName}`
+          ];
+          if (requestId) envBits.push(`\u8BF7\u6C42=${requestId}`);
+          if (receipt?.checkId) envBits.push(`\u68C0\u67E5=${receipt.checkId}`);
+          const segs = [
+            `[update-diag] \u5F53\u524D\u65E0\u5931\u8D25\uFF1A${stateLine}`,
+            `\u7248\u672C\uFF1A\u8FD0\u884C ${snapshot.runningVersion}\uFF0F\u78C1\u76D8 ${snapshot.installedVersion ?? "\u672A\u77E5"}\uFF0F\u8FDC\u7AEF ${snapshot.latestVersion ?? "\u672A\u67E5\u8FC7"}`,
+            `\u6765\u6E90\uFF1A${envBits.join(" \xB7 ")}`
+          ].map((s) => redactForCopy(s));
+          const text2 = diagCopyFormat === "line" ? segs.join(" \xB7 ") : segs.join("\n");
+          try {
+            await copyText(text2);
+            sayCopy("\u5DF2\u590D\u5236\u5F53\u524D\u72B6\u6001\uFF08\u65E0\u5931\u8D25\uFF09\uFF0C\u76F4\u63A5\u7C98\u7ED9\u63D2\u4EF6\u4F5C\u8005\u5373\u53EF\uFF08\u5DF2\u8131\u654F\uFF09\u3002");
+          } catch {
+            sayCopy("\u590D\u5236\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u9009\u4E2D\u4E0A\u9762\u7684\u4FE1\u606F\u3002");
+          }
+          render();
+          return;
+        }
+        const frozen = latch;
+        const code = frozen?.code ?? failureCodeOf({ error: null, errorKind: null }, jobCode || snapshot?.blockedReason || "check-failed");
+        const detail = frozen?.detail ?? (snapshot?.job?.message && snapshot.job.message.includes(":") ? snapshot.job.message.slice(snapshot.job.message.indexOf(":") + 1) : snapshot?.job?.message);
         const text = buildUpdateDiagCopy({
           pluginId,
           code,
           detail,
-          runningVersion: snapshot?.runningVersion ?? null,
-          installedVersion: snapshot?.installedVersion ?? null,
-          latestVersion: snapshot?.latestVersion ?? null,
-          hostKind: hostKind ?? envHostKind,
-          profileName: profileNameOption ?? envProfileName,
+          runningVersion: frozen?.runningVersion ?? snapshot?.runningVersion ?? null,
+          installedVersion: frozen?.installedVersion ?? snapshot?.installedVersion ?? null,
+          latestVersion: frozen?.latestVersion ?? snapshot?.latestVersion ?? null,
+          hostKind: frozen?.hostKind ?? hostKind ?? envHostKind,
+          profileName: frozen?.profileName ?? profileNameOption ?? envProfileName,
           queuePosition: queue?.position ?? null,
-          requestId,
-          checkId: receipt?.checkId ?? null,
+          requestId: frozen?.requestId ?? requestId,
+          checkId: frozen?.checkId ?? receipt?.checkId ?? null,
           route: null,
-          diag: lastDiag,
+          diag: frozen?.diag ?? null,
           manual,
           format: diagCopyFormat
         });
@@ -1329,6 +1556,12 @@ function mountUpdatePanel(container, options) {
         render();
         return;
       }
+      case "dismiss-failure": {
+        clearLatch();
+        sayCopy("\u5DF2\u786E\u8BA4\u8BE5\u5931\u8D25\u63D0\u793A\uFF1B\u4E0B\u6B21\u67E5\u65B0\u7248\u6216\u5B89\u88C5\u5C06\u91CD\u65B0\u8BC4\u4F30\u3002");
+        render();
+        return;
+      }
       case "toggle-queue": {
         showOthers = !showOthers;
         await refresh();
@@ -1514,6 +1747,7 @@ export {
   emptyQueueState,
   failureCodeOf,
   failureCopy,
+  formatLatchTime,
   hasVisibleSections,
   isHeadOfQueue,
   isKnownFailureCode,

package/dist/store.js

@@ -8,6 +8,7 @@ import { emptyBatchSession, normalizeBatchSession } from "./batch.js";
 import { normalizeQueueState } from "./queue.js";
 import { validReleaseVersion } from "./service.js";
 import { sanitizeDetail } from "./redaction.js";
+import { LOG_EVENT_INSTALL_EXEC } from "./log-events.js";
 const LEGACY_SEGMENT = "updates";
 const LEGACY_DIR_PLUGIN = LEGACY_PLUGIN_ID;
 const JOB_STATES = ["installing", "verifying", "restart-required", "completed", "failed", "interrupted"];
@@ -496,7 +497,7 @@ function emitInstall(parts, recipe, ok, exitCode, durationMs) {
   if (typeof log !== "function") return;
   try {
     const pluginId = part(parts.pluginId ?? null);
-    log("info", "update.install.exec", {
+    log("info", LOG_EVENT_INSTALL_EXEC, {
       route: recipe ? recipe.route : "none",
       ok: ok === true,
       exitCode: typeof exitCode === "number" ? exitCode : null,

package/package.json

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