dsh-plugin-update 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [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,28 @@ 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` |
+| 字体阴影 | `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 +204,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.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 不受影响。 */

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;
@@ -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/panel-batch.d.ts

@@ -127,8 +127,11 @@ export interface BatchLedgerCounts {
  * 失败优先（失败行永远算失败，不算待重启）；其余按相位落档；不用重启的终态才算「已最新」。
  * 例外一处：「忙失败占位」（phase=failed 但 error=update-busy）其实是**排队**不是失败——
  * 宿主忙时先写占位再回 update-busy，面板把它翻回「可更新」，免得总账把它报成失败。
+ * 无轮次 pending 行看知识（#73：与行展示同口径，四态镜像 batchRowKnowledgeText）：
+ * 有新版进可更新、已是最新进已最新、查失败进失败、无知识仍待查；
+ * checking 行永远走执行态（待查），不吃知识。不传 inventory 即无知识（旧语义）。
  */
-export declare function batchLedgerCounts(rows: readonly BatchRowView[]): BatchLedgerCounts;
+export declare function batchLedgerCounts(rows: readonly BatchRowView[], inventory?: unknown): BatchLedgerCounts;
 /** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新；#64 单语：缺省 zh 零回归）。 */
 export declare function batchLedgerText(counts: BatchLedgerCounts, lang?: unknown): string;
 /**

package/dist/panel-batch.js

@@ -35,7 +35,7 @@ function buildBatchPhoneNames(prefix) {
     prefsSave: p + ".batchPrefsSave"
   };
 }
-function batchLedgerCounts(rows) {
+function batchLedgerCounts(rows, inventory) {
   const counts = {
     updatable: 0,
     installing: 0,
@@ -51,13 +51,22 @@ 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[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;
   }
   return counts;
 }
+function ledgerKnowledgeBucket(entry) {
+  if (!entry) return "pending";
+  if (entry.error) return "failed";
+  if (entry.latestVersion && entry.installedVersion) return entry.latestVersion !== entry.installedVersion ? "updatable" : "settled";
+  if (entry.latestVersion && !entry.installedVersion) return "updatable";
+  if (entry.lastCheckedAt > 0) return "settled";
+  return "pending";
+}
 function batchLedgerText(counts, lang) {
   const l = langOf(lang);
   const parts = [];
@@ -216,7 +225,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);
   const installing = counts.installing > 0;
   const macroBusy = input.inFlight === true || installing;
   const total = rows.length;
@@ -1072,10 +1081,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"];

package/dist/panel.js

@@ -696,6 +696,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;",
   // 横幅深色覆盖：底色用低透明度同色系（不是浅色原值），边线提亮，保证「深底浅字」可读。
@@ -1084,6 +1093,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/package.json

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