dsh-plugin-update 0.7.1 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.9.0] - 2026-10-08
+
+### Added
+- 批量详情独立动作矩阵（#84）：详情弹窗按单插件内核只读 + 批量自出动作行，支持单查 / 重试 / 复制诊断 / 复制手工 / 跳过，行单查透 `phoneNames`、诊断进 `diag/env/queue`；死按钮摘净、不嵌套滚动；文案零新增。
+- 批量两段式决策 ADR-0004 proposed（#86）：先全查再串行装（生产者 `checkAll` + 消费者复用 `driveLocked/runBatch`）、查并发取 3、消费前重查（不做常驻 reader）、公平性有界与回退线；本版只落决策不改驱动。
+- 主题新增 `newOkText`（#71 修订 Q1）：done 行新版走绿 `newOkText`，其余带箭头行走红 `newText`，相等无箭头；README 键表同步，深浅 / 档案 / forced-colors 回退。
+
+### Changed
+- 总账吃知识（#73 口径 = #82 推荐 A）+ 世界账与轮次账分家（#90）：无轮次 pending 行按知识四态（有新版进可更新 / 已是最新进已最新 / 无知识与查失败仍待查），有轮次与 checking 行恒走执行态；终态 current / 无重启 done 行被更新鲜知识推翻为可更新（`lastCheckedAt > 会话行 updatedAt` 且快照比对确有新版），陈旧知识与失败检查永不推翻；入口徽标 `batchEntrySummary` 同口径（含 openOn='has-update' 在轮不开面板）。
+- 检查诚实语义（#90 R2/R5 + #73）：宿主 `defaultCheck` 回包成功却无版本永不判 current，改判 `check-failed`；知识“查过但无版本”判 never（回“还没查过”），不再坍缩为“已是最新”；知识查失败归待查，不冒充安装失败（顶部不再喊“N 家安装失败”）。
+- 驱动进行中检查回忙（#90 R4）+ 装类在途轮询放行：`checkPhone` 在 `driveActive` 时回 `update-busy`，不用旧表冒充 fresh 结果；批量驱动收尾前可观测中间进度。
+- 判定收敛（#73 code-review）：新增 `sessionEntriesOf/entryPhaseOf/isUnfinishedEntry` 与 `knowledgeVerdictOf` 唯一判定，总账与行共用“在轮 / 知识”两处判定，注释正错（首个匹配即返、任一条目非终态即在轮）。
+
+### Fixed
+- 明细行版本与对齐一致性（#83）：知识孤版红 + 入口吃知识，会话目标赢知识；三列网格（名 5em / 版 18ch / 态 1fr）与 #71 无回归。
+- 单面板宏忙守卫与批量一致（#87）：installing / verifying 快照与 busyAct 在途时查 / 装两键同灰，只加 disabled，不换文案不加键。
+- 详情 row-skip 非法版本与单面板同口径（#88）：不记不 toast 静默重绘；entry locale 注释正错。
+- 重启后待重启自动回查清零（#91）：任务完成态换算落盘（restart-required→completed）， done + 待重启在快照已生效时清零、真未生效时保留；只读失败不展示陈旧待重启。
+- 单面板安装门控稳定（#87 附带）：settled 等自动查回包；抖动预留与闪空行留存沿用既有载体（68 预留 + 焦点滚动 + 轮询让路，74 prefs-only）。
+
+门禁：`npm test` 869 例（868 过 / 1 跳过既有 derive-client / 0 失败）+ `gate:bilingual` 四道硬门禁过（文案零新增，312 draft 未动；`--release` 仍如实红，非阻断）。
+
+## [0.8.0] - 2026-10-07
+
+### Added
+- 入口件无新版摆法 `upToDateDisplay`（`note` / `button`（默认） / `tooltip`）：默认按钮本身即`已是最新 X.Y.Z`（单按钮不占宽，可点再查，hover 回`检查更新`暗示动作；无新版走中性弱边、hover 才走主色，复用既有 token，不新增文案与 token）；`tooltip` 按钮仍是`检查更新`、版本收进悬停；`note` 回右侧小字旧样子（显式传回）。入口 `label()` 与按钮正文同口径，`badge` 形态不受影响；README 2.5 节补自由度与参数说明，单测覆盖三摆法与非法校验。
+
+### Fixed
+- 查新版瞬时抖动补强（面板）：忙闲两帧同高（动作区按钮 nowrap + 最小宽预留、转圈槽常驻）+ 横幅／复制区最小高占位，查新版与轮询回包帧不再跳动。
+- 入口件深色默认主题补 `text-muted`（`#9ca3af`），按钮直显弱边在深底可读。
+- 批量 prefs-only 存偏好回归测试补齐（#74）：偏好保存不闪空行、失败保留行（测试覆盖，行为零变更）。
+
 ## [0.7.1] - 2026-10-06
 
 ### Fixed

package/README.md

@@ -144,28 +144,29 @@ mountUpdatePanel(slot, { pluginId: 'my-notes-plugin', prefix: 'notes', call: hos
 
 可选档案卷主题（纸面浅色案卷风，不替换默认）：挂载时加 `theme: 'archive'` 即换肤（右上大印章「待查/可装/安装中/待重启/受阻/已最新」+ 横幅小印章一字 + profile 牌 + 待重启衬线横幅配手绘 SVG 标 + 窄屏印章固定 + 省略号逐字折叠 + 浅深双主题跟随系统），内核 DOM 顺序不动、复制诊断常在；不传即最小可用默认深色样式。运行时用 `panel.setTheme('archive' | 'default')` 可切。入口件与批量面板是同一个 `theme` 参数，取值同一套。
 
-主题变量覆盖（第三方换肤）：四个 UI 口（单面板、批量面板、入口件、批量入口件）都收 `themeTokens`，键为语义名，一次传入即换肤，不传即零回归。入口件打开的 dialog 面板同步透传；运行时用 `setThemeTokens({...})` 即时换肤，传 `undefined` 即清掉覆盖：
-
-```js
-mountUpdatePanel(el, { pluginId: 'p', prefix: 'notes', call,
-  theme: 'archive',
-  themeTokens: { primary: '#c8402a', bg: '#fffdf6', radiusButton: '3px' },
-})
-```
-
-键与样式表里的 `--dsh-update-*` 变量一一对应（括号里是变量名），手写 CSS 变量等价生效：
-
-| 组 | 键（变量） |
-|---|---|
-| 文字背景边线 | `text`、`textMuted`、`bg`、`bgSoft`、`border`、`borderStrong`、`buttonBg` |
-| 主色焦点 | `primary`、`primaryDeep`、`focus` |
-| 状态四组 | `okBg / okBorder / okText`、`warnBg / warnBorder / warnText`、`badBg / badBorder / badText`、`busyBg / busyBorder / busyText` |
-| 字体阴影 | `fontSans`、`fontSerif`、`fontMono`、`shadow` |
-| 圆角 | `radiusPanel`、`radiusButton`、`radiusBadge` |
-| 入口件尺寸 | `entryFontSize`、`entryPadding`、`entryBorderRadius`、`entryScale`（数字，大于 0） |
-
-三条约束：颜色只收 hex（`#rgb`／`#rrggbb`／`#rrggbbaa`）或英文名单词（含 `transparent`），`rgb()`／`color-mix()` 请自行换算成 hex；其余值走注入检查（分号引号括号等不许过，见 `sizing` 同口径）；未知键与非法值挂载即抛错，不静默吞掉。被覆盖的 token 不再跟随深色模式（内联值固定，调用方自己保证深浅可读）。
-
+主题变量覆盖（第三方换肤）：四个 UI 口（单面板、批量面板、入口件、批量入口件）都收 `themeTokens`，键为语义名，一次传入即换肤，不传即零回归。入口件打开的 dialog 面板同步透传；运行时用 `setThemeTokens({...})` 即时换肤，传 `undefined` 即清掉覆盖：
+
+```js
+mountUpdatePanel(el, { pluginId: 'p', prefix: 'notes', call,
+  theme: 'archive',
+  themeTokens: { primary: '#c8402a', bg: '#fffdf6', radiusButton: '3px' },
+})
+```
+
+键与样式表里的 `--dsh-update-*` 变量一一对应（括号里是变量名），手写 CSS 变量等价生效：
+
+| 组 | 键（变量） |
+|---|---|
+| 文字背景边线 | `text`、`textMuted`、`bg`、`bgSoft`、`border`、`borderStrong`、`buttonBg` |
+| 主色焦点 | `primary`、`primaryDeep`、`focus` |
+| 状态四组 | `okBg / okBorder / okText`、`warnBg / warnBorder / warnText`、`badBg / badBorder / badText`、`busyBg / busyBorder / busyText` |
+| 批量新版 | `newText`（未装好红）、`newOkText`（已装好绿） |
+| 字体阴影 | `fontSans`、`fontSerif`、`fontMono`、`shadow` |
+| 圆角 | `radiusPanel`、`radiusButton`、`radiusBadge` |
+| 入口件尺寸 | `entryFontSize`、`entryPadding`、`entryBorderRadius`、`entryScale`（数字，大于 0） |
+
+三条约束：颜色只收 hex（`#rgb`／`#rrggbb`／`#rrggbbaa`）或英文名单词（含 `transparent`），`rgb()`／`color-mix()` 请自行换算成 hex；其余值走注入检查（分号引号括号等不许过，见 `sizing` 同口径）；未知键与非法值挂载即抛错，不静默吞掉。被覆盖的 token 不再跟随深色模式（内联值固定，调用方自己保证深浅可读）。
+
 类型定义随包分发（`dsh-plugin-update/panel` 的 `.d.ts`），不用自编译；面板离线可读，与包版本绑定。
 
 整组件 HTTP 版（无 `host.call` 环境即跑：浏览器面板经 HTTP POST 直达宿主网关，只传三样）：
@@ -204,12 +205,13 @@ const entry = mountUpdateEntry(document.getElementById('upd-entry'), {
 | 摆什么 | `button` / `badge` / `inline` | `button` | 按钮；只给一个状态点；面板本体直接嵌进来 |
 | 什么时候查 | `mount` / `never` | `mount` | 进页面静默查一次（**只调 `.updateStatus`，只读**）；`never` 则只在点击时查 |
 | 点了做什么 | `has-update` / `always` / `manual` / `direct` | `has-update` | 有新版才开面板；检查完总是开；交给 `onActivate` 自己跳；点开即弹窗、不预查 |
+| 无新版摆哪 | `button` / `tooltip` / `note` | `button` | 版本即按钮本身；收进悬停；回右侧小字旧样子 |
 
-按钮文案随状态自己变（按宿主语言单语渲染：中文界面纯中文、英文界面纯英文，一次只出现一种语言）：`检查更新` / `有新版 1.1.0` / `正在安装…` / `待重启` / `更新失败，点此查看`（英文见集中字典同 key）。
+按钮文案随状态自己变（按宿主语言单语渲染：中文界面纯中文、英文界面纯英文，一次只出现一种语言）：`检查更新`（还没查到）/ `已是最新 X.Y.Z`（无新版，默认即按钮本身）/ `有新版 1.1.0` / `正在安装…` / `待重启` / `更新失败，点此查看`（英文见集中字典同 key）。
 
 语言跟随（单语）：入口件默认跟随 `document.documentElement.lang` > `navigator.languages` > 中文兜底；显式覆盖传 `locale: 'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }`（对象形态可接宿主语言服务，切换即时重绘，`unmount` 后停订；无 DOM 环境不抛，落中文）。
 
-无新版时原地那句小字（`已是最新 X.Y.Z`）只在 `has-update` 下出现：不想看它就用 `openOn: 'always'`（检查完总是开弹窗，无新版在弹窗里看“已是最新”）或 `openOn: 'direct'`（点开即弹窗，连预查都省了，面板挂载即自查；徽标形态仍走回调口径）。
+无新版时版本号摆哪（`upToDateDisplay`，缺省 `'button'`）：`button` 即按钮本身就是`已是最新 X.Y.Z`（单按钮不占宽，可点再查，hover 回`检查更新`暗示动作；无新版中性弱边，hover 才走主色）；`tooltip` 按钮还是`检查更新`、版本收进悬停；`note` 回旧样子（按钮旁右侧小字，只在 `openOn: 'has-update'` 下点击确认无新版后出现）。旧版默认即 `note` 的样子，要回去就显式传 `upToDateDisplay: 'note'`。想连按钮都不留痕，就用 `openOn: 'always'`（检查完总是开弹窗，无新版在弹窗里看“已是最新”）或 `openOn: 'direct'`（点开即弹窗，连预查都省了，面板挂载即自查；徽标形态仍走回调口径）。
 
 按钮尺寸（跟头行其他控件同高/整体缩放）：传 `sizing` 只改按钮本体，不碰面板；不传即默认外观。`scale` 是整体缩放（默认 `1`，如 `1.2` 放大、`0.9` 缩小），原来写在容器上的 `zoom` 可整体搬进来：
 

package/dist/entry-batch.d.ts

@@ -15,10 +15,19 @@ export type BatchEntryAutoCheck = 'mount' | 'never';
 export type BatchEntryOpenOn = 'has-update' | 'always' | 'manual' | 'direct';
 /** 批量入口件的状态档：只用来算文案与 data-state，不另立状态机。 */
 export type BatchEntryStateKind = 'idle' | 'update' | 'busy' | 'restart' | 'failed';
-/** 算文案要的全部输入：批量七行 + 最近一次批量电话的失败稳定码（没查过、没失败为 null）。 */
+/** 算文案要的全部输入：批量七行 + 最近一次批量电话的失败稳定码（没查过、没失败为 null）+ 知识账本 + 会话（后两样只做展示，不参与安装决策；缺省即旧语义）。 */
 export interface UpdateBatchEntryState {
     rows: readonly BatchRowView[] | null;
     error: string | null;
+    /** 知识账本 inventory（batchStatus/batchCheck 回包里的同形状透传；#83 与面板总账同口径）。 */
+    inventory?: unknown;
+    /**
+     * 会话（同回包里透传）：只用来认「有没做完的一轮」——在轮行走执行态、不吃知识，
+     * 徽标才与面板总账同一句话（#73 / #82 §6 细则 3、ADR-0003 §2）。缺省即当无轮次。
+     * 连带影响：在轮时聚合档位是 idle（不是 update），openOn='has-update' 因此不会开面板——
+     * 徽标说「检查更新」、点一下真去查，与面板同一句话。
+     */
+    session?: unknown;
 }
 /** 聚合后的读数（onActivate 与测试共用同一份，不各算一份）。 */
 export interface BatchEntrySummary {
@@ -89,7 +98,7 @@ export interface UpdateBatchEntryController {
     unmount(): void;
 }
 /**
- * 聚合读数：计数唯一出处 batchLedgerCounts（与面板总账同一份，忙失败占位翻回可更新）。
+ * 聚合读数：计数唯一出处 batchLedgerCounts（含 inventory 即与面板总账同一份知识口径，忙失败占位翻回可更新）。
  * hasUpdate = 忙/失败/待重启/可更新任一非零（openOn has-update 按它开面板；全 settled/待查/跳过即 idle）。
  * v2 单语：label 与 HTML 出口同语言（lang 显式入参，缺省跟随全局；zh 口径逐字兼容旧中文）。
  */

package/dist/entry-batch.js

@@ -26,7 +26,9 @@ function escapeHtml(value) {
 }
 function batchEntrySummary(state, lang) {
   const rows = state?.rows ?? null;
-  const counts = batchLedgerCounts(Array.isArray(rows) ? rows : []);
+  const inventory = state?.inventory ?? void 0;
+  const session = state?.session;
+  const counts = batchLedgerCounts(Array.isArray(rows) ? rows : [], inventory, session);
   const total = Array.isArray(rows) ? rows.length : 0;
   let kind;
   if (!Array.isArray(rows) || rows.length === 0) {
@@ -178,6 +180,8 @@ function mountUpdateBatchEntry(container, options) {
   const ENTRY_SELECTOR = "[data-dsh-upd-entry]";
   let rows = null;
   let error = null;
+  let inventory = null;
+  let session = null;
   let note = null;
   let loaded = false;
   let activating = false;
@@ -205,7 +209,7 @@ function mountUpdateBatchEntry(container, options) {
     return isObject(reply) ? reply : {};
   }
   function stateOf() {
-    return { rows, error };
+    return { rows, error, inventory, session };
   }
   function summaryOf() {
     return batchEntrySummary(stateOf(), currentLang());
@@ -241,6 +245,8 @@ function mountUpdateBatchEntry(container, options) {
     }
     const next = asRows(reply["rows"]);
     if (next) rows = next;
+    if (isObject(reply) && "inventory" in reply) inventory = reply["inventory"] ?? null;
+    if (isObject(reply) && "session" in reply) session = reply["session"] ?? null;
     error = null;
     loaded = true;
   }

package/dist/entry.d.ts

@@ -12,6 +12,8 @@ export type EntryAutoCheck = 'mount' | 'never';
  * `manual` 交给 onActivate；`direct` 点开即弹窗、不预查（面板挂载即自查；badge 仍走回调口径）。
  */
 export type EntryOpenOn = 'has-update' | 'always' | 'manual' | 'direct';
+/** 无新版时版本号摆哪：`note` 右侧小字（旧默认）；`button` 按钮本身即版本（默认）；`tooltip` 收进悬停。 */
+export type UpToDateDisplay = 'note' | 'button' | 'tooltip';
 /** 入口件主题（与面板同一套取值，切换即换肤）。 */
 export type EntryTheme = UpdatePanelTheme;
 /** 入口件的状态档：只用来算文案与 data-state，不另立状态机。 */
@@ -52,6 +54,8 @@ export interface UpdateEntryOptions {
     autoCheck?: EntryAutoCheck;
     /** 缺省 'has-update'：有新版才开面板，没有就只在原地给一句提示。 */
     openOn?: EntryOpenOn;
+    /** 无新版时版本号摆哪：缺省 'button'（按钮本身即版本，单按钮不占宽）；'note' 回旧样子（右侧小字）；'tooltip' 收进悬停。 */
+    upToDateDisplay?: UpToDateDisplay;
     /** 覆盖默认按钮文案（不传就用状态联动文案）。 */
     label?: string;
     /** 按钮尺寸覆盖（#69）：见 EntrySizing；不传即零回归，badge/inline 不受影响。 */
@@ -89,8 +93,9 @@ export interface UpdateEntryController {
     unmount(): void;
 }
 /**
- * 状态档：快照六字段 + 失败码推出，顺序固定（活任务 > 待重启 > 失败 > 有新版 > 待查）。
- * 待重启是正常终态（不是失败），所以排在失败前面；正在装的任务比一条陈旧的失败码更可信。
+ * 状态档：快照六字段 + 失败码推出，顺序固定（活任务 > 失败 > 待重启 > 有新版 > 待查）。
+ * 失败码是最近一次通话的新证据，快照是上一次成功的旧读数：新证据赢（#91）。
+ * 待重启仍是正常终态，但只在无新失败时展示；正在装的任务比一条陈旧的失败码更可信。
  */
 export declare function entryStateKind(state: UpdateEntryState | null | undefined): EntryStateKind;
 /**

package/dist/entry.js

@@ -8,6 +8,11 @@ import {
 } from "./panel.js";
 import { BILINGUAL_CSS, copyHTML, copyText } from "./bilingual.js";
 import { resolveLang, subscribeLang } from "./lang.js";
+function upToDateVersionOf(snapshot, error) {
+  if (error || !snapshot || hasUpdateOf(snapshot)) return null;
+  const v = snapshot.runningVersion;
+  return typeof v === "string" && v.trim() ? v.trim() : null;
+}
 function hasUpdateOf(snapshot) {
   if (!snapshot) return false;
   const latest = snapshot.latestVersion;
@@ -18,12 +23,12 @@ function entryStateKind(state) {
   const snapshot = state?.snapshot ?? null;
   const job = snapshot?.job ?? null;
   if (job && (job.state === "installing" || job.state === "verifying")) return "busy";
-  if (snapshot && (snapshot.blockedReason === "pending-restart" || job?.state === "restart-required")) {
-    return "restart";
-  }
   if (state && state.error || job && (job.state === "failed" || job.state === "interrupted")) {
     return "failed";
   }
+  if (snapshot && (snapshot.blockedReason === "pending-restart" || job?.state === "restart-required")) {
+    return "restart";
+  }
   if (hasUpdateOf(snapshot)) return "update";
   return "idle";
 }
@@ -123,6 +128,9 @@ const UPDATE_ENTRY_CSS = [
   '.dsh-upd-entry[data-state="update"] .dsh-upd-entry-dot{background:var(--dsh-update-ok-border,#059669)}',
   '.dsh-upd-entry[data-state="busy"] .dsh-upd-entry-dot,.dsh-upd-entry[data-state="restart"] .dsh-upd-entry-dot{background:var(--dsh-update-warn-border,#d97706)}',
   '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-dot{background:var(--dsh-update-bad-border,#dc2626)}',
+  // C 直显（upToDateDisplay='button'）：无新版时按钮本身即版本，走中性弱边（不抢有新版的红/绿），hover 才走 primary 暗示可再查；复用既有 token，不加新键。
+  '.dsh-upd-entry[data-known="uptodate"] .dsh-upd-entry-btn{border-color:var(--dsh-update-border,#d1d5db);color:var(--dsh-update-text-muted,#6b7280)}',
+  '.dsh-upd-entry[data-known="uptodate"] .dsh-upd-entry-btn:hover{border-color:var(--dsh-update-primary,#2563eb);color:var(--dsh-update-primary,#2563eb)}',
   // 小字自带底（深色宿主 + 浅色变量时也读得出；浅底宿主上只是多一圈细线，不抢戏）。
   ".dsh-upd-entry-note{font-size:12.5px;opacity:.9;background:var(--dsh-update-bg,#ffffff);border:1px solid var(--dsh-update-border,#e5e7eb);border-radius:var(--dsh-update-radius-badge,4px);padding:1px 8px}",
   '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-note{background:var(--dsh-update-bg);border-color:var(--dsh-update-border-strong);color:var(--dsh-update-text)}',
@@ -133,7 +141,7 @@ const UPDATE_ENTRY_CSS = [
   '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-btn{border-color:var(--dsh-update-border-strong);background:var(--dsh-update-bg);color:var(--dsh-update-text);border-radius:var(--dsh-update-entry-border-radius,3px)}',
   '.dsh-upd-entry[data-theme="archive"] .dsh-upd-entry-btn:hover{border-color:var(--dsh-update-primary);color:var(--dsh-update-primary)}',
   '@media (prefers-color-scheme: dark){.dsh-upd-entry[data-theme="archive"]{--dsh-update-text:#ece5d3;--dsh-update-text-muted:#a89c83;--dsh-update-border-strong:#5c4e3b;--dsh-update-primary:#e0684e;--dsh-update-bg:#1e1a15}}',
-  "@media (prefers-color-scheme: dark){.dsh-upd-entry{color:#e5e7eb}",
+  "@media (prefers-color-scheme: dark){.dsh-upd-entry{color:#e5e7eb;--dsh-update-text-muted:#9ca3af}",
   ".dsh-upd-entry-btn{--dsh-update-button-bg:#1f2937;--dsh-update-border:#374151}}"
 ].join("\n");
 const ENTRY_ATTR = "data-dsh-upd-entry";
@@ -179,6 +187,10 @@ function mountUpdateEntry(container, options) {
   if (openOn !== "has-update" && openOn !== "always" && openOn !== "manual" && openOn !== "direct") {
     throw new Error(`[dsh-plugin-update] \u70B9\u51FB\u53BB\u5411\u975E\u6CD5\uFF1A\u53EA\u6536 has-update / always / manual / direct\uFF08\u6536\u5230 ${JSON.stringify(options.openOn)}\uFF09`);
   }
+  const upToDateDisplay = options.upToDateDisplay ?? "button";
+  if (upToDateDisplay !== "note" && upToDateDisplay !== "button" && upToDateDisplay !== "tooltip") {
+    throw new Error(`[dsh-plugin-update] invalid upToDateDisplay: expected note / button / tooltip (got ${JSON.stringify(options.upToDateDisplay)})`);
+  }
   if (options.theme !== void 0 && options.theme !== "default" && options.theme !== "archive") {
     throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
   }
@@ -237,7 +249,13 @@ function mountUpdateEntry(container, options) {
     return { snapshot, error };
   }
   function currentLabel() {
-    return labelOverride ?? entryLabelFor(stateOf(), currentLang());
+    if (labelOverride) return labelOverride;
+    const lang = currentLang();
+    if (!activating && upToDateDisplay === "button" && entryStateKind(stateOf()) === "idle") {
+      const v = upToDateVersionOf(snapshot, error);
+      if (v) return copyText("entry.note.up-to-date", lang, { version: v });
+    }
+    return entryLabelFor(stateOf(), lang);
   }
   function hasUpdate() {
     return hasUpdateOf(snapshot);
@@ -248,18 +266,24 @@ function mountUpdateEntry(container, options) {
   function entryHTML() {
     const kind = entryStateKind(stateOf());
     const lang = currentLang();
-    const labelHTML = labelOverride ? escapeHtml(labelOverride) : activating ? copyHTML("entry.action.checking", lang) : copyHTML(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf()));
-    const labelText = labelOverride ?? (activating ? copyText("entry.action.checking", lang) : copyText(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf())));
+    const knownUpToDate = !activating && kind === "idle" ? upToDateVersionOf(snapshot, error) : null;
+    const buttonMode = !labelOverride && upToDateDisplay === "button" && knownUpToDate;
+    const tooltipMode = !labelOverride && upToDateDisplay === "tooltip" && knownUpToDate;
+    const labelHTML = labelOverride ? escapeHtml(labelOverride) : activating ? copyHTML("entry.action.checking", lang) : buttonMode && knownUpToDate ? copyHTML("entry.note.up-to-date", lang, { version: knownUpToDate }) : copyHTML(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf()));
+    const labelText = labelOverride ?? (activating ? copyText("entry.action.checking", lang) : buttonMode && knownUpToDate ? copyText("entry.note.up-to-date", lang, { version: knownUpToDate }) : copyText(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf())));
+    const titleText = labelOverride ? labelOverride : activating ? copyText("entry.action.checking", lang) : buttonMode && knownUpToDate ? copyText(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf())) : tooltipMode && knownUpToDate ? copyText("entry.note.up-to-date", lang, { version: knownUpToDate }) : labelText;
     const busyAttr = activating ? ' disabled aria-busy="true"' : "";
     const themeAttr = theme === "archive" ? ' data-theme="archive"' : "";
     const tokensStyle = themeTokensStyleFor(themeTokens ?? void 0);
     const styleBody = [sizingStyle, tokensStyle].filter((part) => part).join(";");
     const styleAttr = styleBody ? ` style="${styleBody}"` : "";
-    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">${copyHTML("entry.note.up-to-date", lang, { version: noteVersion })}</span>` : "";
+    const knownAttr = buttonMode ? ' data-known="uptodate"' : "";
+    const displayAttr = ` data-uptodate="${upToDateDisplay}"`;
+    const control = variant === "badge" ? `<button type="button" class="dsh-upd-entry-dot" ${ENTRY_ATTR}="activate" title="${escapeHtml(titleText)}" aria-label="${escapeHtml(labelText)}"${busyAttr}></button>` : `<button type="button" class="dsh-upd-entry-btn" ${ENTRY_ATTR}="activate" title="${escapeHtml(titleText)}" aria-label="${escapeHtml(labelText)}"${busyAttr}>${labelHTML}</button>`;
+    const noteHTML = upToDateDisplay === "note" && noteVersion ? `<span class="dsh-upd-entry-note" data-dsh-upd-note="1">${copyHTML("entry.note.up-to-date", lang, { version: noteVersion })}</span>` : "";
     return `<style>${UPDATE_ENTRY_CSS}
 ${BILINGUAL_CSS}</style>
-<span class="dsh-upd-entry" data-variant="${variant}" data-state="${kind}"${themeAttr}${styleAttr}>${control}${noteHTML}</span>`;
+<span class="dsh-upd-entry" data-variant="${variant}" data-state="${kind}"${displayAttr}${knownAttr}${themeAttr}${styleAttr}>${control}${noteHTML}</span>`;
   }
   function render() {
     if (!mounted) return;
@@ -361,7 +385,7 @@ ${BILINGUAL_CSS}</style>
       openDialog();
       return;
     }
-    noteVersion = snapshot.runningVersion;
+    if (upToDateDisplay === "note") noteVersion = snapshot.runningVersion;
     render();
   }
   function setTheme(next) {

package/dist/host-batch.js

@@ -203,6 +203,7 @@ const EMPTY_CACHE = {
   manual: null,
   queue: null,
   profileName: null,
+  hostKind: null,
   error: null,
   diag: null
 };
@@ -235,11 +236,21 @@ async function callPhone(rt, name, args) {
     if ("snapshot" in value) next.snapshot = value["snapshot"] ?? null;
     if ("manual" in value) next.manual = firstText(value["manual"]);
     if ("queue" in value) next.queue = value["queue"] ?? null;
-    if ("env" in value) next.profileName = firstText(asRecord(value["env"])["profileName"]);
+    if ("env" in value) {
+      next.profileName = firstText(asRecord(value["env"])["profileName"]);
+      next.hostKind = firstText(asRecord(value["env"])["environmentKind"]);
+    }
     next.error = null;
     next.diag = null;
   } else {
     next.diag = "diag" in value ? value["diag"] ?? null : null;
+    if ("env" in value) {
+      const envRec = asRecord(value["env"]);
+      const pn = firstText(envRec["profileName"]);
+      const hk = firstText(envRec["environmentKind"]);
+      if (pn !== null) next.profileName = pn;
+      if (hk !== null) next.hostKind = hk;
+    }
   }
   rt.cache = next;
   return value;
@@ -249,7 +260,7 @@ async function defaultCheck(rt) {
   if (reply["ok"] !== true) return { kind: "failed", error: codeOfReply(reply) };
   const snapshot = snapshotOf(reply);
   const latest = firstText(snapshot["latestVersion"]);
-  if (!latest) return { kind: "current" };
+  if (!latest) return { kind: "failed", error: "check-failed" };
   if (isVersionSkipped(await skippedVersionsOf(rt), latest)) return { kind: "skipped", version: latest };
   const base = firstText(snapshot["installedVersion"], snapshot["runningVersion"]);
   if (base) {
@@ -490,6 +501,33 @@ function createMultiHostUpdate(deps = {}, options) {
       return null;
     }
   }
+  async function reconcileRestart(rt, entry) {
+    if (entry.phase !== "done" || entry.restartRequired !== true) return null;
+    const snapshot = asRecord(rt.cache.snapshot);
+    const running = firstText(snapshot["runningVersion"]);
+    const installed = firstText(snapshot["installedVersion"]);
+    if (!running || !installed) return null;
+    const target = entry.targetVersion ?? installed;
+    if (!target) return null;
+    if (running !== target) return null;
+    if (installed !== running) return null;
+    if (firstText(snapshot["blockedReason"]) === "pending-restart") return null;
+    const job = snapshot["job"];
+    const jobState = job && typeof job === "object" && !Array.isArray(job) ? firstText(job["state"]) : null;
+    if (jobState === "restart-required") return null;
+    try {
+      const latest = await readSession();
+      const current = batchEntryOf(latest, entry.key);
+      if (!current || current.phase !== "done" || current.restartRequired !== true) return null;
+      const marked = markBatchEntry(latest, entry.key, { phase: "done", restartRequired: false, error: null }, now());
+      if (!marked.changed) return null;
+      await saveSession(marked.session);
+      const corrected = batchEntryOf(marked.session, entry.key);
+      return corrected ? { session: marked.session, entry: corrected } : null;
+    } catch {
+      return null;
+    }
+  }
   async function buildRows(session, refresh) {
     let current = session;
     const rows = [];
@@ -505,6 +543,13 @@ function createMultiHostUpdate(deps = {}, options) {
           }
         }
       }
+      if (entry && !driveActive) {
+        const correctedRestart = await reconcileRestart(rt, entry);
+        if (correctedRestart) {
+          current = correctedRestart.session;
+          entry = correctedRestart.entry;
+        }
+      }
       const phase = entry ? entry.phase : "pending";
       rows.push({
         key: rt.spec.key,
@@ -517,6 +562,7 @@ function createMultiHostUpdate(deps = {}, options) {
         manual: rt.cache.manual,
         queue: rt.cache.queue,
         profileName: rt.cache.profileName,
+        hostKind: rt.cache.hostKind,
         phoneNames: rt.host.phoneNames,
         // 新增两格（#25 解法三，只增不改）：该目标的宿主插件标识，与最近一次失败回包的诊断。
         pluginId: rt.pluginId,
@@ -647,44 +693,43 @@ function createMultiHostUpdate(deps = {}, options) {
   async function checkPhone() {
     const refuse = denied();
     if (refuse) return refuse;
+    if (driveActive) return { ok: false, error: "update-busy", errorKind: "update-busy" };
     const session = await readSession();
-    if (!driveActive) {
-      const at = now();
-      let prev = emptyBatchInventory();
+    const at = now();
+    let prev = emptyBatchInventory();
+    try {
+      prev = await readInventory();
+    } catch {
+      prev = emptyBatchInventory();
+    }
+    const entries = { ...prev.entries };
+    for (const rt of runtimes) {
       try {
-        prev = await readInventory();
-      } catch {
-        prev = emptyBatchInventory();
-      }
-      const entries = { ...prev.entries };
-      for (const rt of runtimes) {
-        try {
-          const outcome = await rt.check(rt.spec.key, rt.spec);
-          rt.cache = { ...rt.cache, error: outcome.kind === "failed" ? outcome.error : null };
-          const snapshot = asRecord(rt.cache.snapshot);
-          const installed = firstText(snapshot["installedVersion"], snapshot["runningVersion"]);
-          const canInstallRaw = snapshot["canInstall"];
-          const canInstall = typeof canInstallRaw === "boolean" ? canInstallRaw : null;
-          if (outcome.kind === "update") {
-            entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: outcome.version, canInstall, error: null };
-          } else if (outcome.kind === "current") {
-            entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: installed, canInstall: false, error: null };
-          } else if (outcome.kind === "skipped") {
-            entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: outcome.version, canInstall: false, error: null };
-          } else {
-            entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: firstText(snapshot["latestVersion"]), canInstall, error: outcome.error };
-          }
-        } catch (error) {
-          const code = errorPayloadOf(error).error;
-          rt.cache = { ...rt.cache, error: code };
-          const snapshot = asRecord(rt.cache.snapshot);
-          entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: firstText(snapshot["installedVersion"], snapshot["runningVersion"]), latestVersion: firstText(snapshot["latestVersion"]), canInstall: typeof snapshot["canInstall"] === "boolean" ? snapshot["canInstall"] : null, error: code };
+        const outcome = await rt.check(rt.spec.key, rt.spec);
+        rt.cache = { ...rt.cache, error: outcome.kind === "failed" ? outcome.error : null };
+        const snapshot = asRecord(rt.cache.snapshot);
+        const installed = firstText(snapshot["installedVersion"], snapshot["runningVersion"]);
+        const canInstallRaw = snapshot["canInstall"];
+        const canInstall = typeof canInstallRaw === "boolean" ? canInstallRaw : null;
+        if (outcome.kind === "update") {
+          entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: outcome.version, canInstall, error: null };
+        } else if (outcome.kind === "current") {
+          entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: installed, canInstall: false, error: null };
+        } else if (outcome.kind === "skipped") {
+          entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: outcome.version, canInstall: false, error: null };
+        } else {
+          entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: installed, latestVersion: firstText(snapshot["latestVersion"]), canInstall, error: outcome.error };
         }
+      } catch (error) {
+        const code = errorPayloadOf(error).error;
+        rt.cache = { ...rt.cache, error: code };
+        const snapshot = asRecord(rt.cache.snapshot);
+        entries[rt.spec.key] = { lastCheckedAt: at, installedVersion: firstText(snapshot["installedVersion"], snapshot["runningVersion"]), latestVersion: firstText(snapshot["latestVersion"]), canInstall: typeof snapshot["canInstall"] === "boolean" ? snapshot["canInstall"] : null, error: code };
       }
-      try {
-        await writeInventory(normalizeBatchInventory({ version: 1, updatedAt: at, entries }, at));
-      } catch {
-      }
+    }
+    try {
+      await writeInventory(normalizeBatchInventory({ version: 1, updatedAt: at, entries }, at));
+    } catch {
     }
     return await table(session, false);
   }

package/dist/panel-batch.d.ts

@@ -72,7 +72,7 @@ export interface BatchPanelOptions {
     autoResume?: boolean;
 }
 /** 面板可点的动作（HTML 上 data-act 一一对应；测试走同一条路）。 */
-export type BatchPanelActionKind = 'check' | 'install' | 'resume' | 'cancel' | 'row-install' | 'row-skip' | 'row-resume-skip' | 'row-cancel-queue' | 'row-copy-manual' | 'row-copy-diag' | 'toggle-details' | 'restart' | 'close' | 'toggle-check-on-open';
+export type BatchPanelActionKind = 'check' | 'install' | 'resume' | 'cancel' | 'row-install' | 'row-check' | 'row-skip' | 'row-resume-skip' | 'row-cancel-queue' | 'row-copy-manual' | 'row-copy-diag' | 'toggle-details' | 'restart' | 'close' | 'toggle-check-on-open';
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface BatchPanelContainer {
     innerHTML: string;
@@ -127,8 +127,14 @@ export interface BatchLedgerCounts {
  * 失败优先（失败行永远算失败，不算待重启）；其余按相位落档；不用重启的终态才算「已最新」。
  * 例外一处：「忙失败占位」（phase=failed 但 error=update-busy）其实是**排队**不是失败——
  * 宿主忙时先写占位再回 update-busy，面板把它翻回「可更新」，免得总账把它报成失败。
+ * 无轮次 pending 行看知识（#73 口径 = #82 报告 §6 推荐 A），条件与行展示同一处（isInUnfinishedRound）：
+ * 有新版进可更新、已是最新进已最新、没有结果（无知识 / 查失败）仍待查；
+ * checking 行与「有没做完一轮」的行永远走执行态（待查），都不吃知识。
+ * 终态 current / 无重启 done 行看世界账（#90 世界账与轮次账分家）：知识更新鲜且确有新版即进可更新，
+ * 否则沿旧结论（已最新），免得陈旧知识或失败的检查翻转已收尾的轮次。
+ * 不传 inventory 即无知识；不传 session 即当无轮次（旧调用零回归）。
  */
-export declare function batchLedgerCounts(rows: readonly BatchRowView[]): BatchLedgerCounts;
+export declare function batchLedgerCounts(rows: readonly BatchRowView[], inventory?: unknown, session?: unknown): BatchLedgerCounts;
 /** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新；#64 单语：缺省 zh 零回归）。 */
 export declare function batchLedgerText(counts: BatchLedgerCounts, lang?: unknown): string;
 /**
@@ -164,7 +170,7 @@ export declare function batchRowKnowledgeText(row: BatchRowView, entry: BatchKno
  * 一行的版本展示（#71 Q3：永远显示当前版；有新版才 `当前 → 最新`）。
  * latest 只做展示，不参与安装决策：会话目标版优先（安装语义），无会话目标时才看知识最新版。
  * - 会话有目标版：current（快照运行版优先）→ 会话目标（current 缺失时占位 `?`，与旧口径一致）。
- * - 会话无目标：current（快照优先，缺失退知识 installedVersion）→ 知识 latest（仅当两者皆有且不等；相等即已是最新，只显当前）。
+ * - 会话无目标：current（快照优先，缺失退知识 installedVersion）→ 知识 latest（不等即 → 红；相等即已是最新，只显当前；current 缺失而 latest 有即 `? → latest` 红，与会话缺当前同例）。
  * - 两者皆无：current 为 null、latest 为 null、hasUpdate 为 false（调用方不画版本 span）。
  */
 export interface BatchRowVersionParts {
@@ -204,7 +210,7 @@ export interface BatchPanelRenderInput {
     noticeKey?: string | null;
     /** 键 -> 该行已取到的日志全文（只传有文本的；取不到与没展开即中性提示，不挡安装）。 */
     changelogs?: Record<string, string | null>;
-    /** 轮次会话（有未终态行才画控制区；不传按行相位回退旧口径，兼容旧快照）。 */
+    /** 轮次会话（有未终态行才画控制区，并决定在轮的行与总账吃不吃知识；不传按行相位回退旧口径，兼容旧快照）。 */
     session?: unknown;
     /** 知识账本（无轮次时行按知识展示；只做展示，不参与安装决策）。 */
     inventory?: unknown;

package/dist/panel-batch.js

@@ -16,6 +16,7 @@ import {
   failureCopy,
   isKnownFailureCode,
   normalizePanelTheme,
+  readDiagTolerant,
   renderUpdatePanelHTML,
   themeTokensStyleFor
 } from "./panel.js";
@@ -35,7 +36,7 @@ function buildBatchPhoneNames(prefix) {
     prefsSave: p + ".batchPrefsSave"
   };
 }
-function batchLedgerCounts(rows) {
+function batchLedgerCounts(rows, inventory, session) {
   const counts = {
     updatable: 0,
     installing: 0,
@@ -51,13 +52,21 @@ function batchLedgerCounts(rows) {
     else if (phase === "failed") counts.failed += 1;
     else if (phase === "installing") counts.installing += 1;
     else if (phase === "ready") counts.updatable += 1;
-    else if (phase === "pending" || phase === "checking") counts.pending += 1;
+    else if (phase === "pending")
+      counts[isInUnfinishedRound(session, row.key) ? "pending" : ledgerKnowledgeBucket(knowledgeEntryOf(inventory, row.key))] += 1;
+    else if (phase === "checking") counts.pending += 1;
     else if (phase === "skipped") counts.skipped += 1;
     else if (row.restartRequired === true) counts.restart += 1;
-    else counts.settled += 1;
+    else counts[worldUpdateVersion(row, knowledgeEntryOf(inventory, row.key), sessionUpdatedAtOf(session, row.key)) ? "updatable" : "settled"] += 1;
   }
   return counts;
 }
+function ledgerKnowledgeBucket(entry) {
+  const verdict = knowledgeVerdictOf(entry);
+  if (verdict === "update") return "updatable";
+  if (verdict === "current") return "settled";
+  return "pending";
+}
 function batchLedgerText(counts, lang) {
   const l = langOf(lang);
   const parts = [];
@@ -91,6 +100,13 @@ function knowledgeEntryOf(inventory, key) {
     error: typeof e["error"] === "string" ? e["error"] : null
   };
 }
+function knowledgeVerdictOf(entry) {
+  if (!entry) return "never";
+  if (entry.error) return "failed";
+  if (entry.latestVersion && entry.installedVersion) return entry.latestVersion !== entry.installedVersion ? "update" : "current";
+  if (entry.latestVersion && !entry.installedVersion) return "update";
+  return "never";
+}
 function langOf(lang) {
   try {
     return normalizeLangTag(typeof lang === "string" ? lang : resolveLang(lang));
@@ -105,34 +121,52 @@ function batchText(key, lang, values) {
     return "";
   }
 }
-function hasUnfinishedRows(rows, session) {
-  if (isObject(session)) {
-    const entries = session["entries"];
-    if (Array.isArray(entries)) {
-      for (const item of entries) {
-        if (!isObject(item)) continue;
-        const phase = item["phase"];
-        if (typeof phase === "string" && !isTerminalPhase(asBatchPhase(phase))) return true;
-      }
-      return false;
-    }
+function sessionEntriesOf(session) {
+  if (!isObject(session)) return null;
+  const entries = session["entries"];
+  if (!Array.isArray(entries)) return null;
+  return entries.filter((item) => isObject(item));
+}
+function entryPhaseOf(entry) {
+  const phase = entry["phase"];
+  return typeof phase === "string" ? asBatchPhase(phase) : null;
+}
+function isUnfinishedEntry(entry) {
+  const phase = entryPhaseOf(entry);
+  return phase !== null && !isTerminalPhase(phase);
+}
+function isInUnfinishedRound(session, key) {
+  const entries = sessionEntriesOf(session);
+  if (entries === null) return false;
+  return entries.some((entry) => entry["key"] === key && isUnfinishedEntry(entry));
+}
+function sessionUpdatedAtOf(session, key) {
+  const entries = sessionEntriesOf(session);
+  if (entries === null) return null;
+  for (const entry of entries) {
+    if (entry["key"] !== key) continue;
+    const at = entry["updatedAt"];
+    if (typeof at === "number" && Number.isFinite(at)) return at;
   }
+  return null;
+}
+function worldUpdateVersion(row, knowledge, sessionUpdatedAt) {
+  const phase = asBatchPhase(row.phase);
+  if (phase !== "current" && !(phase === "done" && row.restartRequired !== true)) return null;
+  if (!knowledge || knowledge.error) return null;
+  if (sessionUpdatedAt !== null && !(knowledge.lastCheckedAt > sessionUpdatedAt)) return null;
+  const parts = batchRowVersionParts(row, knowledge);
+  return parts.hasUpdate && parts.latest ? parts.latest : null;
+}
+function hasUnfinishedRows(rows, session) {
+  const entries = sessionEntriesOf(session);
+  if (entries !== null) return entries.some(isUnfinishedEntry);
   if (rows.length === 0) return false;
   return !rows.every((row) => isTerminalPhase(asBatchPhase(row.phase)));
 }
 function unfinishedCount(rows, session) {
-  if (isObject(session)) {
-    const entries = session["entries"];
-    if (Array.isArray(entries)) {
-      let n = 0;
-      for (const item of entries) {
-        if (!isObject(item)) continue;
-        const phase = item["phase"];
-        if (typeof phase === "string" && !isTerminalPhase(asBatchPhase(phase))) n += 1;
-      }
-      return n;
-    }
-  }
+  const entries = sessionEntriesOf(session);
+  if (entries !== null) return entries.filter(isUnfinishedEntry).length;
   return rows.filter((row) => !isTerminalPhase(asBatchPhase(row.phase))).length;
 }
 function batchRowStatus(row, skippedVersion, lang) {
@@ -162,17 +196,10 @@ function batchRowStatus(row, skippedVersion, lang) {
 }
 function batchRowKnowledgeText(row, entry, lang) {
   if (asBatchPhase(row.phase) !== "pending" || !entry) return null;
-  if (entry.error) return batchText("batch.row.failed", lang);
-  if (entry.latestVersion && entry.installedVersion && entry.latestVersion !== entry.installedVersion) {
-    return batchText("batch.row.update", lang, { version: entry.latestVersion });
-  }
-  if (entry.latestVersion && entry.installedVersion && entry.latestVersion === entry.installedVersion) {
-    return batchText("batch.row.current", lang);
-  }
-  if (entry.latestVersion && !entry.installedVersion) {
-    return batchText("batch.row.update", lang, { version: entry.latestVersion });
-  }
-  if (entry.lastCheckedAt > 0) return batchText("batch.row.current", lang);
+  const verdict = knowledgeVerdictOf(entry);
+  if (verdict === "update" && entry.latestVersion) return batchText("batch.row.update", lang, { version: entry.latestVersion });
+  if (verdict === "current") return batchText("batch.row.current", lang);
+  if (verdict === "failed") return batchText("batch.row.failed", lang);
   return batchText("batch.row.never", lang);
 }
 function batchRowVersionParts(row, knowledge) {
@@ -188,14 +215,15 @@ function batchRowVersionParts(row, knowledge) {
   const latest = knowledge && typeof knowledge.latestVersion === "string" && knowledge.latestVersion ? knowledge.latestVersion : null;
   if (current && latest && latest !== current) return { current, latest, hasUpdate: true };
   if (current) return { current, latest: null, hasUpdate: false };
-  if (latest) return { current: latest, latest: null, hasUpdate: false };
+  if (latest) return { current: null, latest, hasUpdate: true };
   return { current: null, latest: null, hasUpdate: false };
 }
 function batchRowVersionHTML(row, knowledge) {
   const parts = batchRowVersionParts(row, knowledge);
   if (parts.hasUpdate && parts.latest) {
     const cur = parts.current ?? "?";
-    return '<span class="dsh-upd-bver"><span class="dsh-upd-bver-cur">' + escapeHtml(cur) + '</span><span class="dsh-upd-bver-arrow" aria-hidden="true"> \u2192 </span><span class="dsh-upd-bver-new">' + escapeHtml(parts.latest) + "</span></span>";
+    const newCls = asBatchPhase(row.phase) === "done" ? "dsh-upd-bver-new-ok" : "dsh-upd-bver-new";
+    return '<span class="dsh-upd-bver"><span class="dsh-upd-bver-cur">' + escapeHtml(cur) + '</span><span class="dsh-upd-bver-arrow" aria-hidden="true"> \u2192 </span><span class="' + newCls + '">' + escapeHtml(parts.latest) + "</span></span>";
   }
   if (parts.current) return '<span class="dsh-upd-bver">' + escapeHtml(parts.current) + "</span>";
   return "";
@@ -216,7 +244,7 @@ function renderBatchPanelHTML(input) {
   const expandedKey = typeof input.expandedKey === "string" && input.expandedKey ? input.expandedKey : null;
   const lastError = typeof input.lastError === "string" && input.lastError ? input.lastError : null;
   const loaded = input.loaded === void 0 ? rows.length > 0 : input.loaded === true;
-  const counts = batchLedgerCounts(rows);
+  const counts = batchLedgerCounts(rows, input.inventory, input.session);
   const installing = counts.installing > 0;
   const macroBusy = input.inFlight === true || installing;
   const total = rows.length;
@@ -238,7 +266,8 @@ function renderBatchPanelHTML(input) {
     changelogMarkdown: null,
     lang,
     knowledge: null,
-    inRound: false
+    inRound: false,
+    worldLatest: null
   };
   const parts = [];
   parts.push('<div class="dsh-upd-batch-head">');
@@ -257,24 +286,13 @@ function renderBatchPanelHTML(input) {
   const showControls = total > 0 && hasUnfinishedRows(rows, session ?? void 0);
   const prefs = isObject(input.prefs) ? input.prefs : null;
   const checkOnOpen = prefs === null ? null : prefs["checkOnOpen"] === false ? false : true;
-  function roundEntryPhase(key) {
-    if (!session) return null;
-    const entries = session["entries"];
-    if (!Array.isArray(entries)) return null;
-    for (const item of entries) {
-      if (!isObject(item)) continue;
-      const e = item;
-      if (e["key"] === key && typeof e["phase"] === "string") return e["phase"];
-    }
-    return null;
-  }
   parts.push('<div class="dsh-upd-btable">');
   for (const row of rows) {
     const raw = skippedVersions[row.key];
     const skipped = typeof raw === "string" && raw ? raw : null;
     const expanded = row.key === expandedKey;
-    const entryPhase = roundEntryPhase(row.key);
-    const inRound = entryPhase !== null && !isTerminalPhase(asBatchPhase(entryPhase));
+    const inRound = isInUnfinishedRound(input.session, row.key);
+    const knowledge = !inRound ? knowledgeEntryOf(input.inventory, row.key) : null;
     parts.push(
       rowSetHTML(row, {
         ...ctx,
@@ -283,8 +301,9 @@ function renderBatchPanelHTML(input) {
         notice: expanded && row.key === detailNoticeKey ? notice : null,
         changelogMarkdown: expanded && typeof changelogs[row.key] === "string" ? changelogs[row.key] : null,
         lang,
-        knowledge: asBatchPhase(row.phase) === "pending" && !inRound ? knowledgeEntryOf(input.inventory, row.key) : null,
-        inRound
+        knowledge,
+        inRound,
+        worldLatest: worldUpdateVersion(row, knowledge, sessionUpdatedAtOf(input.session, row.key))
       })
     );
   }
@@ -386,7 +405,7 @@ function rowSetHTML(row, ctx) {
   const queued = isQueuedRow(row);
   const position = queued ? queuePositionOf(row) : null;
   const versionHTML = batchRowVersionHTML(row, ctx.knowledge);
-  const rowStatusText = queued ? batchQueuedStatus(position, ctx.lang) : ctx.inRound ? batchRowKnowledgeText(row, ctx.knowledge, ctx.lang) ?? batchRowStatus(row, skipped, ctx.lang) : batchRowPendingStatus(row, ctx.knowledge, ctx.lang) ?? batchRowStatus(row, skipped, ctx.lang);
+  const rowStatusText = queued ? batchQueuedStatus(position, ctx.lang) : ctx.worldLatest !== null ? batchText("batch.row.update", ctx.lang, { version: ctx.worldLatest }) : ctx.inRound ? batchRowKnowledgeText(row, ctx.knowledge, ctx.lang) ?? batchRowStatus(row, skipped, ctx.lang) : batchRowPendingStatus(row, ctx.knowledge, ctx.lang) ?? batchRowStatus(row, skipped, ctx.lang);
   const actions = [];
   const off = ctx.inFlight ? " disabled" : "";
   if (phase === "installing") {
@@ -427,7 +446,7 @@ function rowSetHTML(row, ctx) {
     const withCode = escaped.includes(codeEsc) ? escaped.replace(codeEsc, "<code>" + codeEsc + "</code>") : escaped;
     return '<span class="dsh-upd-bfail">' + withCode + "</span>";
   })() : "";
-  const main = '<button type="button" class="dsh-upd-brow-main" data-act="toggle-details" data-key="' + keyAttr + '" aria-expanded="' + (ctx.expanded ? "true" : "false") + '"><span class="dsh-upd-updot" data-tone="' + dotToneOf(row, phase, skipped, queued) + '"></span><span class="dsh-upd-bname">' + escapeHtml(titleOf(row, ctx.titles)) + "</span>" + versionHTML + '<span class="dsh-upd-bstat">' + escapeHtml(rowStatusText) + (ctx.inRound && !queued ? "\uFF08" + escapeHtml(batchText("batch.row.unfinished-tag", ctx.lang)) + "\uFF09" : "") + "</span>" + failLine + "</button>";
+  const main = '<button type="button" class="dsh-upd-brow-main" data-act="toggle-details" data-key="' + keyAttr + '" aria-expanded="' + (ctx.expanded ? "true" : "false") + '"><span class="dsh-upd-updot" data-tone="' + dotToneOf(row, phase, skipped, queued, ctx.worldLatest) + '"></span><span class="dsh-upd-bname">' + escapeHtml(titleOf(row, ctx.titles)) + "</span>" + versionHTML + '<span class="dsh-upd-bstat">' + escapeHtml(rowStatusText) + (ctx.inRound && !queued ? "\uFF08" + escapeHtml(batchText("batch.row.unfinished-tag", ctx.lang)) + "\uFF09" : "") + "</span>" + failLine + "</button>";
   const detail = ctx.expanded ? '<div class="dsh-upd-bdetail" data-key="' + keyAttr + '">' + detailActionsHTML(row, ctx) + (ctx.notice !== null ? '<div class="dsh-upd-bdetail-notice" role="status">' + escapeHtml(ctx.notice) + "</div>" : "") + detailHTML(row, ctx) + "</div>" : "";
   return '<div class="dsh-upd-brow-set" data-key="' + keyAttr + '"><div class="dsh-upd-brow" data-phase="' + escapeHtml(phase) + '" data-key="' + keyAttr + '"' + (queued ? ' data-queued="1"' : "") + ">" + main + '<span class="dsh-upd-brow-actions">' + actions.join("") + "</span></div>" + detail + "</div>";
 }
@@ -449,6 +468,7 @@ function detailHTML(row, ctx) {
     theme: ctx.theme,
     themeTokens: ctx.themeTokens,
     profileName: typeof row.profileName === "string" && row.profileName ? row.profileName : null,
+    hostKind: typeof row.hostKind === "string" && row.hostKind ? row.hostKind : null,
     actions: "none"
   }, ctx.lang);
   return stripActionButtons(html);
@@ -477,6 +497,11 @@ function detailActionsHTML(row, ctx) {
       '<button type="button" data-act="row-install" data-key="' + keyAttr + '" data-primary="1"' + off + ">" + escapeHtml(ctx.busy ? batchText("batch.row-action.queue", ctx.lang) : version !== null ? batchText("batch.row-action.install-version", ctx.lang, { version }) : batchText("batch.row-action.install-generic", ctx.lang)) + "</button>"
     );
   }
+  if (phase !== "installing" && singleCheckPhoneOf(row) !== null) {
+    buttons.push(
+      '<button type="button" data-act="row-check" data-key="' + keyAttr + '"' + off + ">" + escapeHtml(batchText("batch.action.check", ctx.lang)) + "</button>"
+    );
+  }
   if (!queued && phase === "ready" && ctx.skipped === null && version !== null) {
     buttons.push(
       '<button type="button" data-act="row-skip" data-key="' + keyAttr + '"' + off + ">" + escapeHtml(batchText("batch.row-action.skip", ctx.lang)) + "</button>"
@@ -498,11 +523,12 @@ function detailActionsHTML(row, ctx) {
 function stripActionButtons(html) {
   return html.replace(/<button\b[^>]*data-action=[^>]*>[\s\S]*?<\/button>/g, "");
 }
-function dotToneOf(row, phase, skipped, queued) {
+function dotToneOf(row, phase, skipped, queued, worldLatest = null) {
   if (phase === "failed" && !queued) return "bad";
   if (phase === "installing" || phase === "checking") return "busy";
   if (queued) return "warn";
   if (row.restartRequired === true) return "warn";
+  if (worldLatest !== null) return "todo";
   if (phase === "ready") return skipped === null ? "todo" : "idle";
   if (phase === "current" || phase === "done") return "ok";
   return "idle";
@@ -534,11 +560,15 @@ const UPDATE_BATCH_PANEL_CSS = [
   ".dsh-upd-bver-cur{opacity:.65}",
   ".dsh-upd-bver-arrow{opacity:.6}",
   ".dsh-upd-bver-new{color:var(--dsh-update-new-text,#dc2626);font-weight:700}",
+  ".dsh-upd-bver-new-ok{color:var(--dsh-update-new-ok-text,#047857);font-weight:700}",
   ".dsh-upd-bstat{font-size:12.5px;opacity:.9;min-width:0;overflow-wrap:anywhere}",
   ".dsh-upd-bfail{grid-column:1/-1;display:block;font-size:12.5px;color:var(--dsh-update-bad-border,#dc2626)}",
   ".dsh-upd-batch{--dsh-update-new-text:#dc2626}",
+  ".dsh-upd-batch{--dsh-update-new-ok-text:#047857}",
   "@media (prefers-color-scheme: dark){.dsh-upd-batch{--dsh-update-new-text:#f87171}}",
+  "@media (prefers-color-scheme: dark){.dsh-upd-batch{--dsh-update-new-ok-text:#34d399}}",
   "@media (forced-colors: active){.dsh-upd-bver-new{color:CanvasText}}",
+  "@media (forced-colors: active){.dsh-upd-bver-new-ok{color:CanvasText}}",
   ".dsh-upd-blist{font-size:12.5px;margin-top:2px}",
   ".dsh-upd-batch-ledger{margin:8px 0 0;font-size:13px;opacity:.85}",
   ".dsh-upd-batch-more{margin-top:6px}",
@@ -576,7 +606,10 @@ const UPDATE_BATCH_PANEL_ARCHIVE_CSS = [
   '.dsh-upd[data-theme="archive"] .dsh-upd-bver{font-family:var(--dsh-update-font-mono);color:var(--dsh-update-text-muted)}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-bver-cur{opacity:.75}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-bver-new{color:var(--dsh-update-new-text,#b3261e)}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-bver-new-ok{color:var(--dsh-update-new-ok-text,#1a7f37)}',
+  '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="archive"] .dsh-upd-batch{--dsh-update-new-ok-text:#8fd6a4}}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-batch{--dsh-update-new-text:#b3261e}',
+  '.dsh-upd[data-theme="archive"] .dsh-upd-batch{--dsh-update-new-ok-text:#1a7f37}',
   '@media (prefers-color-scheme: dark){.dsh-upd[data-theme="archive"] .dsh-upd-batch{--dsh-update-new-text:#ef8a7d}}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-batch-ledger{color:var(--dsh-update-text-muted)}',
   '.dsh-upd[data-theme="archive"] .dsh-upd-batch-sum{color:var(--dsh-update-text)}',
@@ -622,6 +655,12 @@ function queuedRequestIdOf(row) {
   }
   return null;
 }
+function singleCheckPhoneOf(row) {
+  const phones = isObject(row.phoneNames) ? row.phoneNames : null;
+  if (!phones) return null;
+  const check = phones["updateCheck"];
+  return typeof check === "string" && check ? check : null;
+}
 function cancelQueuePhoneOf(row) {
   const phones = isObject(row.phoneNames) ? row.phoneNames : null;
   if (!phones) return null;
@@ -694,6 +733,21 @@ function jobFailureOf(row) {
   const detail = message.slice(at + 1).trim();
   return { code: code || null, detail: detail || null };
 }
+function diagStructuredSuffix(diagValue) {
+  const t = readDiagTolerant(diagValue);
+  const parts = [];
+  if (t.stage) parts.push("stage=" + t.stage);
+  if (t.route) parts.push("route=" + t.route);
+  if (t.method) parts.push("method=" + t.method);
+  if (typeof t.httpStatus === "number") parts.push("HTTP=" + String(t.httpStatus));
+  if (typeof t.exitCode === "number") parts.push("exit=" + String(t.exitCode));
+  if (typeof t.latencyMs === "number") parts.push("latency=" + String(t.latencyMs) + "ms");
+  if (t.registryHost) parts.push("source=" + t.registryHost);
+  if (t.action) parts.push("action=" + t.action);
+  if (t.requestId) parts.push("request=" + t.requestId);
+  if (t.checkId) parts.push("check=" + t.checkId);
+  return parts.length > 0 ? parts.join(" \xB7 ") : null;
+}
 function diagTextOf(row, lang) {
   const snapshot = isObject(row.snapshot) ? row.snapshot : null;
   const queue = isObject(row.queue) ? row.queue : null;
@@ -701,7 +755,9 @@ function diagTextOf(row, lang) {
   const text = (value) => typeof value === "string" && value ? value : null;
   const job = jobFailureOf(row);
   const diagDetail = diag ? text(diag["detail"]) : null;
-  const detail = diagDetail !== null ? diagDetail : job !== null && job.detail !== null ? job.detail + batchText("batch.diag.source-job", langOf(lang)) : null;
+  const baseDetail = diagDetail !== null ? diagDetail : job !== null && job.detail !== null ? job.detail + batchText("batch.diag.source-job", langOf(lang)) : null;
+  const structured = diagStructuredSuffix(row.diag);
+  const detail = baseDetail !== null && structured !== null ? baseDetail + " [" + structured + "]" : baseDetail ?? structured;
   const input = {
     pluginId: pluginIdOf(row),
     code: job !== null && job.code !== null ? job.code : row.error || "check-failed",
@@ -828,6 +884,7 @@ function mountUpdateBatchPanel(container, options) {
   let notice = null;
   let noticeKey = null;
   let inFlight = false;
+  let inFlightIsCheck = false;
   let loaded = false;
   let refreshing = false;
   let confirmCancelArmed = false;
@@ -1072,10 +1129,25 @@ function mountUpdateBatchPanel(container, options) {
       return;
     }
     if (reply["ok"] === true) {
-      const session = normalizeBatchSession(reply["session"]);
-      const parsed = readRows(reply["rows"]);
-      rows = parsed.length > 0 ? parsed : rowsFromSession(session);
-      lastSession = session;
+      const hasSession = "session" in reply && reply["session"] !== void 0;
+      const hasRows = "rows" in reply && reply["rows"] !== void 0;
+      if (!hasSession && !hasRows) {
+        if (isObject(reply["prefs"])) lastPrefs = reply["prefs"];
+        return;
+      }
+      if (hasSession) {
+        const session = normalizeBatchSession(reply["session"]);
+        lastSession = session;
+        if (hasRows) {
+          const parsed = readRows(reply["rows"]);
+          rows = parsed.length > 0 ? parsed : rowsFromSession(session);
+        } else {
+          rows = rowsFromSession(session);
+        }
+      } else {
+        const parsed = readRows(reply["rows"]);
+        if (parsed.length > 0) rows = parsed;
+      }
       if (isObject(reply["inventory"])) {
         lastInventory = reply["inventory"];
         const at = reply["inventory"]["updatedAt"];
@@ -1110,6 +1182,7 @@ function mountUpdateBatchPanel(container, options) {
   async function phone(name, args, busyRowKey = null) {
     if (!mounted || inFlight) return null;
     inFlight = true;
+    inFlightIsCheck = name === phones.check;
     clearNotice();
     render();
     let out = null;
@@ -1129,6 +1202,7 @@ function mountUpdateBatchPanel(container, options) {
       out = null;
     } finally {
       inFlight = false;
+      inFlightIsCheck = false;
       if (mounted) render();
     }
     maybeAutoRowChangelog(expandedKey);
@@ -1207,6 +1281,10 @@ function mountUpdateBatchPanel(container, options) {
         const row = typeof key === "string" && key ? rowOfKey(key) : null;
         const version = row ? latestVersionOf(row) : null;
         if (!row || !version) return;
+        if (!validReleaseVersion(version)) {
+          render();
+          return;
+        }
         try {
           skipStoreFor(pluginIdOf(row)).skip(version);
         } catch {
@@ -1227,6 +1305,49 @@ function mountUpdateBatchPanel(container, options) {
         render();
         return;
       }
+      // 「查这一家」（#84）：走该家自己的单插件查新版电话（行 phoneNames 透传；老宿主没给即无入口）。
+      // 单插件回包形状与批量回包不同，不进 applyReply：成功靠随后一次 refresh 把新快照读回来；
+      // 失败只在该行留一句失败回执（failureCopy 已有键），行相位不动，不编造。
+      case "row-check": {
+        const row = typeof key === "string" && key ? rowOfKey(key) : null;
+        if (!row) return;
+        const phoneName = singleCheckPhoneOf(row);
+        if (phoneName === null) return;
+        if (inFlight) return;
+        inFlight = true;
+        inFlightIsCheck = true;
+        clearNotice();
+        render();
+        try {
+          const reply = await call(phoneName, { includeEnv: true, includeQueue: true });
+          if (!mounted) return;
+          if (isObject(reply) && reply["ok"] !== true) {
+            const rec = reply;
+            const kind2 = typeof rec["errorKind"] === "string" && rec["errorKind"].trim() ? rec["errorKind"].trim() : "";
+            const err = typeof rec["error"] === "string" && rec["error"].trim() ? rec["error"].trim() : "";
+            const code = kind2 || err || "check-failed";
+            const copy = failureCopy(code, currentLang());
+            say(copy ? copy.zh + "\uFF5C" + copy.act : code, row.key);
+          }
+        } catch {
+          if (mounted) {
+            const copy = failureCopy("check-failed", currentLang());
+            say(copy ? copy.zh + "\uFF5C" + copy.act : "check-failed", row.key);
+          }
+        } finally {
+          inFlight = false;
+          inFlightIsCheck = false;
+        }
+        try {
+          for (const k of [...rowFailedAt.keys()]) {
+            if (k === row.key || k.startsWith(row.key + "\0")) rowFailedAt.delete(k);
+          }
+        } catch {
+        }
+        await refresh();
+        maybeAutoRowChangelog(expandedKey);
+        return;
+      }
       // 「取消排队」：走**该家自己的**单插件安装电话（宿主支持 cancelQueued：只撤自己那条 waiting，
       // 不碰别家、也不碰正在装的拥有者）。批量取消会清掉整轮会话，所以这里绝不用它顶。
       case "row-cancel-queue": {
@@ -1440,7 +1561,7 @@ function mountUpdateBatchPanel(container, options) {
   }
   const timer = getTimer();
   const handle = timer.set(() => {
-    if (inFlight) return;
+    if (inFlight && inFlightIsCheck) return;
     void refresh();
   }, pollMs);
   try {

package/dist/panel.d.ts

@@ -39,6 +39,8 @@ export interface UpdateThemeTokens {
     busyText?: string;
     /** 有新版版本号的醒目红（#71 Q1 专用；缺省跟随坏项红的对比度口径，深浅主题另覆）。 */
     newText?: string;
+    /** 已装好新版版本号的绿色（#71 状态跟随修订：done 行走绿，其余走红；深浅主题另覆）。 */
+    newOkText?: string;
     fontSans?: string;
     fontSerif?: string;
     fontMono?: string;

package/dist/panel.js

@@ -39,6 +39,7 @@ const THEME_TOKEN_VARS = {
   busyBorder: "--dsh-update-busy-border",
   busyText: "--dsh-update-busy-text",
   newText: "--dsh-update-new-text",
+  newOkText: "--dsh-update-new-ok-text",
   fontSans: "--dsh-update-font-sans",
   fontSerif: "--dsh-update-font-serif",
   fontMono: "--dsh-update-font-mono",
@@ -74,7 +75,8 @@ const THEME_TOKEN_COLOR_KEYS = /* @__PURE__ */ new Set([
   "busyBg",
   "busyBorder",
   "busyText",
-  "newText"
+  "newText",
+  "newOkText"
 ]);
 function themeTokensError(raw) {
   return new Error(`[dsh-plugin-update] \u4E3B\u9898\u53C2\u6570 themeTokens \u975E\u6CD5\uFF1A\u53EA\u6536\u5DF2\u77E5 token \u952E\uFF08\u989C\u8272\u7528 hex \u6216\u82F1\u6587\u540D\uFF0C\u5B57\u4F53/\u5706\u89D2/\u9634\u5F71/\u5C3A\u5BF8\u4E3A\u5B89\u5168 CSS \u503C\uFF0CentryScale \u4E3A\u5927\u4E8E 0 \u7684\u6709\u9650\u6570\uFF09\uFF08\u6536\u5230 ${JSON.stringify(raw ?? null)})`);
@@ -479,24 +481,6 @@ function panelViewModelCore(input, lang) {
       queueNote
     };
   }
-  if (snapshot.blockedReason === "pending-restart") {
-    const latest = snapshot.latestVersion ?? snapshot.installedVersion ?? "";
-    return {
-      banner: {
-        kind: "restart",
-        // 文案照原型（archive.html:329）：不带 emoji——警示由横幅左侧的手绘 SVG 标承担，
-        // 印章在状态一侧，两者各司其职，不再三重标记。
-        title: copyText("panel.banner.restart-title", l, { latest }),
-        action: blockedCopy("pending-restart", l)?.action ?? ""
-      },
-      installEnabled: false,
-      installLabel: copyText("panel.action.install", l),
-      skippedLatest: false,
-      showManual: manual ? true : false,
-      showReset: false,
-      queueNote
-    };
-  }
   if (jobState === "installing" || jobState === "verifying") {
     const ver = typeof job?.targetVersion === "string" && job.targetVersion.trim() ? job.targetVersion.trim() : "";
     let installingTitle = copyText("panel.banner.installing-title", l, { version: ver || " " });
@@ -534,6 +518,24 @@ function panelViewModelCore(input, lang) {
       queueNote
     };
   }
+  if (snapshot.blockedReason === "pending-restart") {
+    const latest = snapshot.latestVersion ?? snapshot.installedVersion ?? "";
+    return {
+      banner: {
+        kind: "restart",
+        // 文案照原型（archive.html:329）：不带 emoji——警示由横幅左侧的手绘 SVG 标承担，
+        // 印章在状态一侧，两者各司其职，不再三重标记。
+        title: copyText("panel.banner.restart-title", l, { latest }),
+        action: blockedCopy("pending-restart", l)?.action ?? ""
+      },
+      installEnabled: false,
+      installLabel: copyText("panel.action.install", l),
+      skippedLatest: false,
+      showManual: manual ? true : false,
+      showReset: false,
+      queueNote
+    };
+  }
   if (snapshot.blockedReason) {
     const copy = blockedCopy(snapshot.blockedReason, l);
     const stop = l === "en" ? "." : "\u3002";
@@ -696,6 +698,15 @@ const UPDATE_PANEL_CSS = [
   '.dsh-upd-actions button:first-child:not([aria-busy="true"])::after{content:"";display:inline-block;width:11px;height:11px;margin-left:8px;visibility:hidden}',
   ".dsh-upd-banner{min-height:1.2em}",
   ".dsh-upd-strip{min-height:48px}",
+  // —— 查新版瞬时抖动补强：忙闲两帧同高 + 横幅不动（只追加覆盖，不改上面既有串）——
+  ".dsh-upd-actions{align-content:flex-start}",
+  ".dsh-upd-actions button{white-space:nowrap}",
+  ".dsh-upd-actions button:first-child{min-width:10em}",
+  '.dsh-upd-actions button[data-primary="1"]{min-width:9em}',
+  ".dsh-upd-banner{min-height:3.4em;display:flex;flex-direction:column;justify-content:center}",
+  ".dsh-upd-banner{animation:none}",
+  ".dsh-upd-copy{min-height:1.75em}",
+  ".dsh-upd-copy--empty{visibility:hidden}",
   "@media (prefers-color-scheme: dark){.dsh-upd{--dsh-update-text:#e5e7eb;--dsh-update-bg:#111827;--dsh-update-border:#374151;",
   "--dsh-update-button-bg:#1f2937;--dsh-update-bg-soft:#1f2937;--dsh-update-primary:#3b82f6;--dsh-update-focus:#93c5fd;",
   // 横幅深色覆盖：底色用低透明度同色系（不是浅色原值），边线提亮，保证「深底浅字」可读。
@@ -912,9 +923,12 @@ function renderUpdatePanelKernel(input, view, lang) {
     const busyAct = input.busyAct;
     const checkBusy = busyAct === "check";
     const installBusy = busyAct === "install";
+    const jobState = snapshot?.job?.state;
+    const snapshotBusy = jobState === "installing" || jobState === "verifying";
+    const macroBusy = busyAct === "check" || busyAct === "install" || snapshotBusy;
     actions.push('<div class="dsh-upd-actions">');
     actions.push(
-      (checkBusy ? `<button type="button" data-action="check" disabled aria-busy="true" title="${escapeHtml(copyText("panel.action.checking-busy-title", l))}">${escapeHtml(copyText("panel.action.checking-busy", l))}</button>` : `<button type="button" data-action="check" title="${escapeHtml(copyText("panel.action.check-title", l))}">${escapeHtml(copyText("panel.action.check", l))}</button>`) + (installBusy ? `<button type="button" data-action="install" data-primary="1" disabled aria-busy="true" title="${escapeHtml(copyText("panel.action.installing-busy-title", l))}">${escapeHtml(copyText("panel.action.installing-busy", l))}</button>` : `<button type="button" data-action="install" data-primary="1" title="${escapeHtml(copyText("panel.action.install-title", l))}"${view.installEnabled ? "" : " disabled"}>${escapeHtml(view.installLabel)}</button>`)
+      (checkBusy ? `<button type="button" data-action="check" disabled aria-busy="true" title="${escapeHtml(copyText("panel.action.checking-busy-title", l))}">${escapeHtml(copyText("panel.action.checking-busy", l))}</button>` : `<button type="button" data-action="check" title="${escapeHtml(copyText("panel.action.check-title", l))}"${macroBusy ? " disabled" : ""}>${escapeHtml(copyText("panel.action.check", l))}</button>`) + (installBusy ? `<button type="button" data-action="install" data-primary="1" disabled aria-busy="true" title="${escapeHtml(copyText("panel.action.installing-busy-title", l))}">${escapeHtml(copyText("panel.action.installing-busy", l))}</button>` : `<button type="button" data-action="install" data-primary="1" title="${escapeHtml(copyText("panel.action.install-title", l))}"${macroBusy || !view.installEnabled ? " disabled" : ""}>${escapeHtml(view.installLabel)}</button>`)
     );
     if (snapshot?.latestVersion && !view.skippedLatest && view.banner.kind === "update") {
       actions.push(`<button type="button" data-action="skip" title="${escapeHtml(copyText("panel.action.skip-title", l))}">${escapeHtml(copyText("panel.action.skip", l))}</button>`);
@@ -1084,6 +1098,7 @@ ${changelogHTML}
       }
     }
     if (copyNotice) errLines.push(`<div class="dsh-upd-copy" role="status">${escapeHtml(copyNotice)}</div>`);
+    else errLines.push('<div class="dsh-upd-copy dsh-upd-copy--empty" aria-hidden="true"></div>');
     chapters.push(chapterOf(4, errLines.join(""), "", l));
   }
   chapters.push(

package/dist/service.js

@@ -364,16 +364,32 @@ function createUpdateCore(ports) {
       job
     };
   }
+  function jobsEqual(a, b) {
+    if (a === b) return true;
+    if (!a || !b) return false;
+    return a.id === b.id && a.state === b.state && a.targetVersion === b.targetVersion && a.message === b.message && (a.requestId ?? null) === (b.requestId ?? null);
+  }
+  async function healedJob(env) {
+    const loaded = await loadJob();
+    const healed = healJob(loaded, env);
+    if (!jobsEqual(loaded, healed)) {
+      try {
+        await saveJob(healed);
+      } catch {
+      }
+    }
+    return healed;
+  }
   async function status() {
     const env = await ports.readInstalled();
-    const job = healJob(await loadJob(), env);
+    const job = await healedJob(env);
     return buildSnapshot(env, job);
   }
   async function check() {
     if (checking) return checking;
     if (checked?.checkId && ports.now() - lastCheckAt < RECHECK_WINDOW_MS) {
       const env = await ports.readInstalled();
-      const snapshot = buildSnapshot(env, healJob(await loadJob(), env));
+      const snapshot = buildSnapshot(env, await healedJob(env));
       return { snapshot, receipt: snapshot.canInstall ? toReceipt() : null };
     }
     lastCheckAt = ports.now();
@@ -389,7 +405,7 @@ function createUpdateCore(ports) {
           installationKey: env.installationKey,
           blockedReason: satisfiesNodeRange(ports.nodeVersion, release2.nodeRange) ? null : "incompatible-node"
         };
-        const snapshot = buildSnapshot(env, healJob(await loadJob(), env));
+        const snapshot = buildSnapshot(env, await healedJob(env));
         return { snapshot, receipt: snapshot.canInstall ? toReceipt() : null };
       } catch (error) {
         if (checked) checked = { ...checked, checkId: null, expiresAt: 0 };

package/package.json

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