dsh-plugin-update 0.5.4 → 0.5.6

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.5.6] - 2026-10-06
+
+### Added
+- 弹窗分栏滚动、更新日志折叠与动效体系；双语防倒退门禁四道检查（文案源／快照／契约／零 draft）与自测（#56）。
+
+### Fixed
+- 用户路径抛错锁存非瞬态化（#58）：查／装动作的传输抛错改为非瞬态锁存（安装抛错码为 install-failed，不再冒充查失败），轮询不再洗掉；抛错原文脱敏后进复制摘要；安装内补查失败精确归因到查阶段；轮询抛错仍瞬态自愈。
+
+## [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;
@@ -383,21 +383,23 @@ const UPDATE_BATCH_PANEL_CSS = [
   ".dsh-upd-bdetail{margin:2px 0 10px;overflow:visible}",
   ".dsh-upd .dsh-upd-bdetail .dsh-upd{max-width:none}",
   ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd{max-height:none;overflow:visible}",
+  ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd-body{overflow:visible}",
+  ".dsh-upd-overlay .dsh-upd-bdetail .dsh-upd-body .dsh-upd-chap-head{position:static}",
   "@media (prefers-color-scheme: dark){.dsh-upd-batch-title i{color:var(--dsh-upd-focus,#93c5fd)}}",
   "@media (prefers-reduced-motion: reduce){.dsh-upd-batch *{transition:none !important;animation:none !important}}"
 ].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 +997,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' | 'toggle-changelog' | '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;
     /** 与宿主通话的函数（面板侧唯一的宿主接触面）。 */
@@ -84,6 +86,8 @@ export interface UpdatePanelController {
     setTheme(theme: UpdatePanelTheme): Promise<void>;
     /** 切换排队可见性（重查一次，位置口径不变）。 */
     setShowOthers(show: boolean): Promise<void>;
+    /** 收起/展开更新日志（纯视图态，不调电话；轮询与换肤不丢）。 */
+    setChangelogCollapsed(collapsed: boolean): Promise<void>;
     /**
      * 换一版更新日志后重绘（#23：宿主侧备好新文本后调用；传 null/空串即回中性提示）。
      * 只换日志节，安装门控只跟快照，一字不动。
@@ -235,7 +239,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,13 +250,32 @@ export interface PanelRenderInput extends PanelViewInput {
      * 缺省即静默（输出与旧版一字不差）；只在挂载器置忙的那次 render 里传。
      */
     busyAct?: 'check' | 'install' | null;
+    /** 失败引用（失败档案的查询键；缺省即无失败，不画卷宗）。 */
+    failure?: PanelFailureRef | null;
+    /** 日志指引开关：false 即藏通用日志行（失败证据行不受影响）。 */
+    showLogHint?: boolean;
     /**
      * 动作面归谁：`default`（缺省）由内核画动作按钮；`none` 只画内容、不画按钮。
      * 给「调用方自己提供动作面」的场景（如批量面板的详情：动作由批量面板经自己的通道提供）。
      * 只读渲染下五章内容、进度条、「已跳过」提示一字不减，只是没有动作按钮。
      */
     actions?: 'default' | 'none';
+    /**
+     * 更新日志折叠（仅挂载态内部用：用户点了 02 章标题行的收起/展开）。
+     * 缺省即展开（安全日志必显、可查找；只读渲染下恒展开）。
+     */
+    changelogCollapsed?: boolean;
+}
+/** 内核渲染用的失败引用（只读快照：证据仍在锁存里，这里只传展示键）。 */
+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 也只留一份）。 */