dsh-plugin-update 0.5.8 → 0.7.0

package/dist/entry.js

@@ -3,7 +3,8 @@ import { DEFAULT_PREFIX, MIN_PANEL_POLL_MS, buildPhoneNames } from "./config.js"
 import {
   failureCodeOf,
   mountUpdatePanel,
-  normalizePanelTheme
+  normalizePanelTheme,
+  themeTokensStyleFor
 } from "./panel.js";
 import { BILINGUAL_CSS, copyHTML, copyText } from "./bilingual.js";
 import { resolveLang, subscribeLang } from "./lang.js";
@@ -62,11 +63,51 @@ function entryLabelFor(state, lang) {
   const l = lang ?? resolveLang();
   return copyText(entryBilingualKeyFor(state), l, entryBilingualValuesFor(state));
 }
+function entrySizingError(raw) {
+  return new Error(`[dsh-plugin-update] \u5165\u53E3\u4EF6\u5C3A\u5BF8\u53C2\u6570 sizing \u975E\u6CD5\uFF1A\u53EA\u6536 fontSize / padding / borderRadius\uFF08\u975E\u7A7A CSS \u503C\uFF09\u4E0E scale\uFF08\u5927\u4E8E 0 \u7684\u6709\u9650\u6570\uFF09\uFF08\u6536\u5230 ${JSON.stringify(raw ?? null)})`);
+}
+function isSafeEntryCssValue(value) {
+  const v = value.trim();
+  if (!v || v.length > 200) return false;
+  if (/[;"'<>`{}!&]/.test(v)) return false;
+  if (/url\s*\(/i.test(v)) return false;
+  if (/expression\s*\(/i.test(v)) return false;
+  if (/javascript\s*:/i.test(v)) return false;
+  return true;
+}
+function entrySizingStyleFor(sizing) {
+  if (sizing === void 0 || sizing === null) return "";
+  if (typeof sizing !== "object" || Array.isArray(sizing)) throw entrySizingError(sizing);
+  for (const key of Object.keys(sizing)) {
+    if (key !== "fontSize" && key !== "padding" && key !== "borderRadius" && key !== "scale") {
+      throw entrySizingError(sizing);
+    }
+  }
+  const parts = [];
+  const { fontSize, padding, borderRadius, scale } = sizing;
+  if (fontSize !== void 0) {
+    if (typeof fontSize !== "string" || !isSafeEntryCssValue(fontSize)) throw entrySizingError(sizing);
+    parts.push(`--dsh-update-entry-font-size:${fontSize.trim()}`);
+  }
+  if (padding !== void 0) {
+    if (typeof padding !== "string" || !isSafeEntryCssValue(padding)) throw entrySizingError(sizing);
+    parts.push(`--dsh-update-entry-padding:${padding.trim()}`);
+  }
+  if (borderRadius !== void 0) {
+    if (typeof borderRadius !== "string" || !isSafeEntryCssValue(borderRadius)) throw entrySizingError(sizing);
+    parts.push(`--dsh-update-entry-border-radius:${borderRadius.trim()}`);
+  }
+  if (scale !== void 0) {
+    if (typeof scale !== "number" || !Number.isFinite(scale) || scale <= 0) throw entrySizingError(sizing);
+    parts.push(`--dsh-update-entry-scale:${String(scale)}`);
+  }
+  return parts.join(";");
+}
 const UPDATE_ENTRY_CSS = [
-  '.dsh-upd-entry{display:inline-flex;align-items:center;gap:8px;font:13px/1.6 system-ui,"Microsoft YaHei",sans-serif;color:var(--dsh-upd-fg,#1f2937)}',
-  ".dsh-upd-entry-btn{font:inherit;border:1px solid var(--dsh-upd-line,#d1d5db);border-radius:6px;",
-  "background:var(--dsh-upd-btn,#f9fafb);color:inherit;padding:4px 12px;cursor:pointer}",
-  ".dsh-upd-entry-btn:hover{border-color:var(--dsh-upd-primary,#2563eb)}",
+  '.dsh-upd-entry{display:inline-flex;align-items:center;gap:8px;font:13px/1.6 var(--dsh-update-font-sans,system-ui,"Microsoft YaHei",sans-serif);font-size:var(--dsh-update-entry-font-size,13px);color:var(--dsh-update-text,#1f2937)}',
+  ".dsh-upd-entry-btn{font:inherit;border:1px solid var(--dsh-update-border,#d1d5db);border-radius:var(--dsh-update-entry-border-radius,6px);",
+  "background:var(--dsh-update-button-bg,#f9fafb);color:inherit;padding:var(--dsh-update-entry-padding,4px 12px);zoom:var(--dsh-update-entry-scale,1);cursor:pointer}",
+  ".dsh-upd-entry-btn:hover{border-color:var(--dsh-update-primary,#2563eb)}",
   ".dsh-upd-entry-btn,.dsh-upd-entry-dot{transition:background-color .15s ease,border-color .15s ease,color .15s ease,transform .06s ease}",
   ".dsh-upd-entry-btn:active:not(:disabled){transform:translateY(1px)}",
   ".dsh-upd-entry-btn:disabled,.dsh-upd-entry-dot:disabled{opacity:.55;cursor:wait}",
@@ -74,25 +115,26 @@ const UPDATE_ENTRY_CSS = [
   "border:2px solid currentColor;border-top-color:transparent;border-radius:50%;animation:dsh-upd-entry-spin .8s linear infinite}",
   "@keyframes dsh-upd-entry-spin{to{transform:rotate(360deg)}}",
   '@media (prefers-reduced-motion: reduce){.dsh-upd-entry-btn,.dsh-upd-entry-dot{transition:none}.dsh-upd-entry-btn[aria-busy="true"]::after{animation:none}}',
-  ".dsh-upd-entry-btn:focus-visible,.dsh-upd-entry-dot:focus-visible{outline:2px solid var(--dsh-upd-focus,#2563eb);outline-offset:1px}",
-  '.dsh-upd-entry[data-state="update"] .dsh-upd-entry-btn{border-color:var(--dsh-upd-ok-line,#059669);color:var(--dsh-upd-ok-line,#059669)}',
-  '.dsh-upd-entry[data-state="restart"] .dsh-upd-entry-btn{border-color:var(--dsh-upd-warn-line,#d97706);color:var(--dsh-upd-warn-line,#d97706)}',
-  '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-btn{border-color:var(--dsh-upd-bad-line,#dc2626);color:var(--dsh-upd-bad-line,#dc2626)}',
-  ".dsh-upd-entry-dot{width:10px;height:10px;padding:0;border:0;border-radius:50%;background:var(--dsh-upd-line,#9ca3af);cursor:pointer}",
-  '.dsh-upd-entry[data-state="update"] .dsh-upd-entry-dot{background:var(--dsh-upd-ok-line,#059669)}',
-  '.dsh-upd-entry[data-state="busy"] .dsh-upd-entry-dot,.dsh-upd-entry[data-state="restart"] .dsh-upd-entry-dot{background:var(--dsh-upd-warn-line,#d97706)}',
-  '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-dot{background:var(--dsh-upd-bad-line,#dc2626)}',
+  ".dsh-upd-entry-btn:focus-visible,.dsh-upd-entry-dot:focus-visible{outline:2px solid var(--dsh-update-focus,#2563eb);outline-offset:1px}",
+  '.dsh-upd-entry[data-state="update"] .dsh-upd-entry-btn{border-color:var(--dsh-update-ok-border,#059669);color:var(--dsh-update-ok-border,#059669)}',
+  '.dsh-upd-entry[data-state="restart"] .dsh-upd-entry-btn{border-color:var(--dsh-update-warn-border,#d97706);color:var(--dsh-update-warn-border,#d97706)}',
+  '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-btn{border-color:var(--dsh-update-bad-border,#dc2626);color:var(--dsh-update-bad-border,#dc2626)}',
+  ".dsh-upd-entry-dot{width:10px;height:10px;padding:0;border:0;border-radius:50%;background:var(--dsh-update-border,#9ca3af);cursor:pointer}",
+  '.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)}',
   // 小字自带底（深色宿主 + 浅色变量时也读得出；浅底宿主上只是多一圈细线，不抢戏）。
-  ".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="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)}',
+  ".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)}',
+  '.dsh-upd-entry[data-theme="archive"]{--dsh-update-text:#1a1a1a;--dsh-update-text-muted:#6f675a;--dsh-update-border-strong:#c4b896;--dsh-update-primary:#c8402a;--dsh-update-bg:#fffdf6;',
+  '--dsh-update-font-serif:Georgia,"Songti SC","STSong","SimSun",serif;',
+  'font-family:var(--dsh-update-font-serif,Georgia,"Songti SC","STSong","SimSun",serif);color:var(--dsh-update-text)}',
   // 按钮脸自己不透明（深色宿主 + 浅色系统变量时也读得出；hover 红在深浅底上都可见）。
-  '.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}}',
+  '.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}",
-  ".dsh-upd-entry-btn{--dsh-upd-btn:#1f2937;--dsh-upd-line:#374151}}"
+  ".dsh-upd-entry-btn{--dsh-update-button-bg:#1f2937;--dsh-update-border:#374151}}"
 ].join("\n");
 const ENTRY_ATTR = "data-dsh-upd-entry";
 const ENTRY_SELECTOR = "[data-dsh-upd-entry]";
@@ -137,8 +179,8 @@ 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`);
   }
-  if (options.theme !== void 0 && options.theme !== "default" && options.theme !== "archive" && options.theme !== "d5-paper") {
-    throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08d5-paper \u4E3A\u65E7\u522B\u540D\u4ECD\u53EF\u7528\uFF09\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
+  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`);
   }
   let theme = normalizePanelTheme(options.theme ?? "default");
   const pollMs = options.pollMs;
@@ -146,6 +188,9 @@ function mountUpdateEntry(container, options) {
     throw new Error(`[dsh-plugin-update] \u9762\u677F\u8F6E\u8BE2\u95F4\u9694\u975E\u6CD5\uFF1A\u4E0D\u5F97\u5C0F\u4E8E 250 \u6BEB\u79D2\uFF08\u6536\u5230 ${JSON.stringify(options.pollMs)}\uFF09`);
   }
   const labelOverride = typeof options.label === "string" && options.label ? options.label : null;
+  const sizingStyle = entrySizingStyleFor(options.sizing ?? void 0);
+  themeTokensStyleFor(options.themeTokens ?? void 0);
+  let themeTokens = options.themeTokens;
   const localeOpt = options.locale ?? void 0;
   if (localeOpt !== void 0 && localeOpt !== null) {
     const isStr = typeof localeOpt === "string";
@@ -207,11 +252,14 @@ function mountUpdateEntry(container, options) {
     const labelText = labelOverride ?? (activating ? copyText("entry.action.checking", lang) : copyText(entryBilingualKeyFor(stateOf()), lang, entryBilingualValuesFor(stateOf())));
     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>` : "";
     return `<style>${UPDATE_ENTRY_CSS}
 ${BILINGUAL_CSS}</style>
-<span class="dsh-upd-entry" data-variant="${variant}" data-state="${kind}"${themeAttr}>${control}${noteHTML}</span>`;
+<span class="dsh-upd-entry" data-variant="${variant}" data-state="${kind}"${themeAttr}${styleAttr}>${control}${noteHTML}</span>`;
   }
   function render() {
     if (!mounted) return;
@@ -256,6 +304,7 @@ ${BILINGUAL_CSS}</style>
       prefix,
       mode,
       theme,
+      themeTokens,
       pollMs,
       profileName,
       autoChangelog: options.autoChangelog,
@@ -316,13 +365,19 @@ ${BILINGUAL_CSS}</style>
     render();
   }
   function setTheme(next) {
-    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`);
+    if (next !== "default" && next !== "archive") {
+      throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
     }
     theme = normalizePanelTheme(next);
     if (panel) void panel.setTheme(theme);
     else render();
   }
+  function setThemeTokens(next) {
+    themeTokensStyleFor(next ?? void 0);
+    themeTokens = next ?? void 0;
+    if (panel) void panel.setThemeTokens(themeTokens);
+    else render();
+  }
   function onClick(ev) {
     if (!mounted) return;
     try {
@@ -381,7 +436,7 @@ ${BILINGUAL_CSS}</style>
   if (variant === "inline") mountPanel("embedded");
   else render();
   if (autoCheck === "mount") void refresh();
-  return { refresh, open, close, label: currentLabel, setTheme, unmount };
+  return { refresh, open, close, label: currentLabel, setTheme, setThemeTokens, unmount };
 }
 export {
   UPDATE_ENTRY_CSS,
@@ -390,6 +445,7 @@ export {
   entryBilingualTextFor,
   entryBilingualValuesFor,
   entryLabelFor,
+  entrySizingStyleFor,
   entryStateKind,
   mountUpdateEntry
 };

package/dist/host-batch.js

@@ -19,10 +19,13 @@ import { createHostUpdate } from "./host.js";
 import { defaultHomeDir } from "./reader.js";
 import { compareReleaseVersions } from "./service.js";
 import {
-  createBatchDiskPorts,
+  createBatchOwnerPorts,
   createSkipDiskPorts,
   createUpdateQueuePorts,
-  isVersionSkipped
+  emptyBatchInventory,
+  isVersionSkipped,
+  normalizeBatchInventory,
+  normalizeBatchPrefs
 } from "./store.js";
 const DEFAULT_DRAIN_INTERVAL_MS = 5e3;
 const MIN_DRAIN_INTERVAL_MS = 1e3;
@@ -405,31 +408,56 @@ function createMultiHostUpdate(deps = {}, options) {
     return runtime;
   });
   const runtimeByKey = new Map(runtimes.map((rt) => [rt.spec.key, rt]));
-  const batchPorts = batchScope && batchScope.profileDir ? createBatchDiskPorts(batchScope.homeDir, batchScope.profileDir) : null;
+  const ownerPorts = batchScope && batchScope.profileDir ? createBatchOwnerPorts(batchScope.homeDir, batchScope.profileDir, prefix) : null;
   let memSession = null;
+  let memInventory = null;
+  let memPrefs = {};
   let driveActive = false;
   let liveSession = null;
   let lastRun = null;
   let drainTimer = null;
   let disposed = false;
   async function readSession() {
-    if (batchPorts) return await batchPorts.readBatch();
+    if (ownerPorts) return await ownerPorts.readBatch();
     return memSession ?? emptyBatchSession();
   }
   async function saveSession(session) {
-    if (batchPorts) {
-      await batchPorts.writeBatch(session);
+    if (ownerPorts) {
+      await ownerPorts.writeBatch(session);
       return;
     }
     memSession = session;
   }
   async function clearSession() {
-    if (batchPorts) {
-      await batchPorts.clearBatch();
+    if (ownerPorts) {
+      await ownerPorts.clearBatch();
       return;
     }
     memSession = emptyBatchSession();
   }
+  async function readInventory() {
+    if (ownerPorts) return await ownerPorts.readInventory();
+    return memInventory ?? emptyBatchInventory();
+  }
+  async function writeInventory(inventory) {
+    if (ownerPorts) {
+      await ownerPorts.writeInventory(inventory);
+      return;
+    }
+    memInventory = inventory;
+  }
+  async function readPrefs() {
+    if (ownerPorts) return await ownerPorts.readPrefs();
+    return memPrefs;
+  }
+  async function writePrefs(prefs) {
+    const normalized = normalizeBatchPrefs(prefs);
+    if (ownerPorts) {
+      await ownerPorts.writePrefs(normalized);
+      return;
+    }
+    memPrefs = normalized;
+  }
   function newSessionId() {
     const suffix = String(randomId() ?? "").replace(/[^A-Za-z0-9._~-]/g, "").slice(0, 24);
     return now().toString(36) + "-" + (suffix || hash8(String(now())));
@@ -499,7 +527,19 @@ function createMultiHostUpdate(deps = {}, options) {
   }
   async function table(session, refresh = true) {
     const built = await buildRows(session, refresh);
-    return { ok: true, session: built.session, rows: built.rows, progress: progressOf(built.session) };
+    let inventory = emptyBatchInventory();
+    let prefs = {};
+    try {
+      inventory = await readInventory();
+    } catch {
+      inventory = emptyBatchInventory();
+    }
+    try {
+      prefs = await readPrefs();
+    } catch {
+      prefs = {};
+    }
+    return { ok: true, session: built.session, rows: built.rows, progress: progressOf(built.session), inventory, prefs };
   }
   function denied() {
     if (!scopeError) return null;
@@ -609,14 +649,42 @@ function createMultiHostUpdate(deps = {}, options) {
     if (refuse) return refuse;
     const session = await readSession();
     if (!driveActive) {
+      const at = now();
+      let prev = emptyBatchInventory();
+      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) {
-          rt.cache = { ...rt.cache, error: errorPayloadOf(error).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 {
+      }
     }
     return await table(session, false);
   }
@@ -682,11 +750,12 @@ function createMultiHostUpdate(deps = {}, options) {
     if (refuse) return refuse;
     if (driveActive) return { ok: false, error: "update-busy", errorKind: "update-busy" };
     const disk = await readSession();
-    if (disk.entries.length === 0) return await table(disk);
+    const hadUnfinished = disk.entries.length > 0 && !isBatchFinished(disk);
+    if (!hadUnfinished) return { ...await table(disk), resumed: false };
     const resumed = resumeBatchSession(disk, now());
     if (resumed !== disk) await saveSession(resumed);
     try {
-      return await table(await drive(resumed, null, Number.POSITIVE_INFINITY));
+      return { ...await table(await drive(resumed, null, Number.POSITIVE_INFINITY)), resumed: true };
     } catch (error) {
       return { ok: false, ...errorPayloadOf(error) };
     }
@@ -727,12 +796,32 @@ function createMultiHostUpdate(deps = {}, options) {
       void tickDrain();
     }, drainIntervalMs);
   }
+  async function prefsPhone() {
+    const refuse = denied();
+    if (refuse) return refuse;
+    return { ok: true, prefs: await readPrefs() };
+  }
+  async function prefsSavePhone(args) {
+    const refuse = denied();
+    if (refuse) return refuse;
+    const current = await readPrefs();
+    const next = { ...current };
+    if ("checkOnOpen" in args) {
+      const v = args["checkOnOpen"];
+      if (typeof v !== "boolean") return { ok: false, error: "check-failed", errorKind: "check-failed" };
+      next.checkOnOpen = v;
+    }
+    await writePrefs(next);
+    return { ok: true, prefs: next };
+  }
   const phoneNames = {
     status: prefix + ".batchStatus",
     check: prefix + ".batchCheck",
     install: prefix + ".batchInstall",
     resume: prefix + ".batchResume",
-    cancel: prefix + ".batchCancel"
+    cancel: prefix + ".batchCancel",
+    prefs: prefix + ".batchPrefs",
+    prefsSave: prefix + ".batchPrefsSave"
   };
   function phone(fn) {
     return async (args) => {
@@ -749,6 +838,8 @@ function createMultiHostUpdate(deps = {}, options) {
   handlers[phoneNames.install] = phone((args) => installPhone(args));
   handlers[phoneNames.resume] = phone(() => resumePhone());
   handlers[phoneNames.cancel] = phone(() => cancelPhone());
+  handlers[phoneNames.prefs] = phone(() => prefsPhone());
+  handlers[phoneNames.prefsSave] = phone((args) => prefsSavePhone(args));
   for (const rt of runtimes) {
     for (const name of Object.keys(rt.host.handlers)) {
       const handler = rt.host.handlers[name];

package/dist/http.d.ts

@@ -11,8 +11,8 @@ export declare const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15000;
 /** 单插件电话动作名（旧三电话与 src/config.ts PHONE_ACTIONS 同字面，不另起字面；#38 加 updateChangelog）。 */
 export declare const HTTP_PHONE_ACTIONS: readonly ["updateStatus", "updateCheck", "updateInstall", "updateChangelog"];
 export type HttpPhoneAction = (typeof HTTP_PHONE_ACTIONS)[number];
-/** 批量五电话动作名（与 src/panel-batch.ts buildBatchPhoneNames 同字面，不另起字面；同一内核）。 */
-export declare const HTTP_BATCH_ACTIONS: readonly ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];
+/** 批量七电话动作名（与 src/panel-batch.ts buildBatchPhoneNames 同字面，不另起字面；同一内核）。 */
+export declare const HTTP_BATCH_ACTIONS: readonly ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel", "batchPrefs", "batchPrefsSave"];
 export type HttpBatchAction = (typeof HTTP_BATCH_ACTIONS)[number];
 /** 逐电话覆写表：键为全电话名（prefix.动作）或短动作名；未知键拒绝。 */
 export type HttpRoutes = Record<string, string>;

package/dist/http.js

@@ -11,7 +11,7 @@ const DEFAULT_HTTP_CHECK_TIMEOUT_MS = 15e3;
 const DEFAULT_HTTP_INSTALL_TIMEOUT_MS = 16 * 6e4;
 const DEFAULT_HTTP_STATUS_TIMEOUT_MS = 15e3;
 const HTTP_PHONE_ACTIONS = ["updateStatus", "updateCheck", "updateInstall", "updateChangelog"];
-const HTTP_BATCH_ACTIONS = ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel"];
+const HTTP_BATCH_ACTIONS = ["batchStatus", "batchCheck", "batchInstall", "batchResume", "batchCancel", "batchPrefs", "batchPrefsSave"];
 function isAbsoluteUrl(value) {
   return /^https?:\/\//i.test(value);
 }

package/dist/panel-batch.d.ts

@@ -1,4 +1,4 @@
-import { type UpdatePanelTheme } from './panel.js';
+import { type UpdatePanelTheme, type UpdateThemeTokens } from './panel.js';
 /** 一行要画的东西（宿主回包里的形状）。 */
 export interface BatchRowView {
     key: string;
@@ -32,6 +32,8 @@ export interface BatchPanelOptions {
     call: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     /** 主题：与单插件面板同一套（缺省 default）。 */
     theme?: UpdatePanelTheme;
+    /** 主题变量覆盖：见 panel 的 UpdateThemeTokens；批量根 + 展开详情行全继承，不传即零回归。 */
+    themeTokens?: UpdateThemeTokens;
     /** 摆放形态：内嵌或弹窗（缺省 embedded）。 */
     mode?: BatchPanelMode;
     /** 轮询间隔（毫秒，缺省 1500，下限 250）。 */
@@ -55,13 +57,22 @@ export interface BatchPanelOptions {
      */
     onCloseRequested?: () => void | Promise<void>;
     /**
-     * 语言覆盖（#60 窗口期占位：本票只加选项不消费，传了暂不生效，消费留给 #61-#66）。
+     * 语言覆盖（#59 起消费：新文案走集中字典单语渲染；既有散落文案保持基线不变）。
      * 形态与入口件一致：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }。
      */
     locale?: unknown;
+    /**
+     * 打开面板自动查（#59 D3）：缺省 true。false 即手动挡（行为回今天，只修文案）。
+     * 优先级：用户偏好（prefs.json）> 本选项 > 缺省。
+     */
+    checkOnOpen?: boolean;
+    /**
+     * 自动继续未终态轮次（#59 Q3：与显式按钮并存，常开）。false 可关（测试与特殊集成用）。
+     */
+    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';
+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';
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface BatchPanelContainer {
     innerHTML: string;
@@ -73,23 +84,27 @@ export interface BatchPanelController {
     refresh(): Promise<void>;
     act(action: BatchPanelActionKind, key?: string): Promise<void>;
     setTheme(theme: UpdatePanelTheme): void;
+    /** 换一套主题变量（重绘；传 undefined 即清掉覆盖，回主题默认）。 */
+    setThemeTokens(tokens: UpdateThemeTokens | undefined): void;
     setMode(mode: BatchPanelMode): void;
     unmount(): void;
 }
-/** 批量五个电话名（与宿主侧 MultiHostUpdate.phoneNames 同一形状）。 */
+/** 批量七个电话名（与宿主侧 MultiHostUpdate.phoneNames 同一形状）。 */
 export interface BatchPhoneNames {
     status: string;
     check: string;
     install: string;
     resume: string;
     cancel: string;
+    prefs: string;
+    prefsSave: string;
 }
 /** 批量面板轮询口径（默认 1.5 秒、下限 250 毫秒，与单插件面板同一套下限）。 */
 export declare const BATCH_PANEL_POLL: {
     readonly defaultMs: 1500;
     readonly minMs: 250;
 };
-/** 批量电话名拼法：前缀 + 五个固定动作名（前缀形状校验与单插件面板同一套）。 */
+/** 批量电话名拼法：前缀 + 七个固定动作名（前缀形状校验与单插件面板同一套）。 */
 export declare function buildBatchPhoneNames(prefix: string): BatchPhoneNames;
 export interface BatchLedgerCounts {
     /** phase=ready：有新版、还没安装。 */
@@ -114,23 +129,42 @@ export interface BatchLedgerCounts {
  * 宿主忙时先写占位再回 update-busy，面板把它翻回「可更新」，免得总账把它报成失败。
  */
 export declare function batchLedgerCounts(rows: readonly BatchRowView[]): BatchLedgerCounts;
-/** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新）。 */
-export declare function batchLedgerText(counts: BatchLedgerCounts): string;
+/** 分类计数 → 一句话总账（只出现非零档，顺序固定：可更新 · 安装中 · 待查 · 待重启 · 失败 · 已跳过 · 已最新；#64 单语：缺省 zh 零回归）。 */
+export declare function batchLedgerText(counts: BatchLedgerCounts, lang?: unknown): string;
 /**
  * 排队中的状态词：只回答「还要等多久」。位置从该行的队列视图来。
  * queue.ts 的 position 是 waiting 顺位（队首为 1、0 = 自己正在装），而正在装的那一家也压在这一家前面，
  * 所以「前方 N 个」= position N（队首那家前方正好 1 个：正在装的拥有者）。
  * 位置取不到（宿主只记了忙、没给占位读数）就说「等前面安装完」，不猜数字。
  */
-export declare function batchQueuedStatus(position: number | null): string;
+export declare function batchQueuedStatus(position: number | null, lang?: unknown): string;
+/** 知识账本里的一行（只做展示，不参与安装决策）。 */
+export interface BatchKnowledgeEntry {
+    lastCheckedAt: number;
+    installedVersion: string | null;
+    latestVersion: string | null;
+    canInstall: boolean | null;
+    error: string | null;
+}
+/** 有未终态行（控制区出现条件：盘上有没做完的一轮）。 */
+export declare function hasUnfinishedRows(rows: readonly BatchRowView[], session?: unknown): boolean;
+export declare function unfinishedCount(rows: readonly BatchRowView[], session?: unknown): number;
 /**
  * 一行的状态词：只回答一个问题——这家的**下一步**是什么。
  * 中文可执行，不写相位英文（相位只留在 data-phase 属性上，给人看的这句永远是动作）。
+ * （#59 D2：调用方在无轮次 + 有知识时优先用 batchRowKnowledgeText；本函数语义冻结，旧快照不动。）
+ */
+export declare function batchRowStatus(row: BatchRowView, skippedVersion?: string | null, lang?: unknown): string;
+/**
+ * 无轮次时的知识行（#59 D2）：pending + 有知识即按知识展示；有轮次未做完仍走执行态。
+ * 无知识（从没查过）回 null，调用方回退旧 pending 文案。
  */
-export declare function batchRowStatus(row: BatchRowView, skippedVersion?: string | null): string;
+export declare function batchRowKnowledgeText(row: BatchRowView, entry: BatchKnowledgeEntry | null, lang?: unknown): string | null;
 export interface BatchPanelRenderInput {
     rows?: readonly BatchRowView[];
     theme?: UpdatePanelTheme;
+    /** 主题变量覆盖：见 panel 的 UpdateThemeTokens；写到批量根上，详情行经继承生效。 */
+    themeTokens?: UpdateThemeTokens;
     mode?: BatchPanelMode;
     /** 当前展开的那一家（键）；null 即全部收起。 */
     expandedKey?: string | null;
@@ -151,15 +185,23 @@ export interface BatchPanelRenderInput {
     noticeKey?: string | null;
     /** 键 -> 该行已取到的日志全文（只传有文本的；取不到与没展开即中性提示，不挡安装）。 */
     changelogs?: Record<string, string | null>;
+    /** 轮次会话（有未终态行才画控制区；不传按行相位回退旧口径，兼容旧快照）。 */
+    session?: unknown;
+    /** 知识账本（无轮次时行按知识展示；只做展示，不参与安装决策）。 */
+    inventory?: unknown;
+    /** 偏好（底部勾选的受控状态；不传不画勾选）。 */
+    prefs?: unknown;
+    /** 语言（单语渲染新文案用；不传跟随全局信号）。 */
+    lang?: unknown;
 }
 /** 整面板 HTML（含样式；重绘即整体替换 innerHTML，故每次都带 style 也只留一份）。 */
 export declare function renderBatchPanelHTML(input: BatchPanelRenderInput): string;
 export declare const UPDATE_BATCH_PANEL_CSS: string;
 /**
- * 批量面板的 D5 皮肤（#20 同一套口径：只换颜色/字体/间距，不改顺序、不藏东西）。
+ * 批量面板的 Archive 皮肤（#20 同一套口径：只换颜色/字体/间距，不改顺序、不藏东西）。
  * 卷宗抬头右侧给大印章留 120px（与单插件面板档案头同一处理）。
  */
-export declare const UPDATE_BATCH_PANEL_D5_CSS: string;
+export declare const UPDATE_BATCH_PANEL_ARCHIVE_CSS: string;
 /**
  * 挂批量面板（调用方一行即跑）：
  * ```js