dsh-plugin-update 0.5.7 → 0.6.0

package/dist/entry.d.ts

@@ -1,6 +1,7 @@
 import { type UpdatePanelContainer, type UpdatePanelTheme } from './panel.js';
 import type { UpdateSnapshot } from './ports.js';
 import { type BilingualKey } from './bilingual.js';
+import { type AppLang, type LocaleOption } from './lang.js';
 /** 入口件的形态。 */
 export type EntryVariant = 'button' | 'badge' | 'inline';
 /** 什么时候主动查一次（只读，联网一次）。 */
@@ -20,6 +21,24 @@ export interface UpdateEntryState {
     snapshot: UpdateSnapshot | null;
     error: string | null;
 }
+/**
+ * 入口件按钮尺寸覆盖（#69）：只影响 button 本体（字号/内边距/圆角/整体缩放），不碰 dialog 面板。
+ * 缺省（不传）保持现状、零回归；badge 圆点与 inline 内嵌不读这些变量，天然不受影响。
+ * 实现口径与现有 `--dsh-upd-*` 颜色变量一致：本选项只是把同样的 CSS 变量以内联方式写到容器上，
+ * 手写 CSS 变量（`--dsh-update-entry-font-size` / `--dsh-update-entry-padding` /
+ * `--dsh-update-entry-border-radius` / `--dsh-update-entry-scale`）同样生效，两者等价。
+ * `scale` 即宿主临时方案里容器 `zoom: 1` 开关的正式形态：改一个数即缩放（默认 1）。
+ */
+export interface EntrySizing {
+    /** 按钮字号（CSS font-size 值，如 '12px'），不传即 13px 默认。 */
+    fontSize?: string;
+    /** 按钮内边距（CSS padding 值，如 '2px 8px'），不传即 '4px 12px' 默认。 */
+    padding?: string;
+    /** 按钮圆角（CSS border-radius 值，如 '8px'），不传即默认主题 6px / archive 主题 3px。 */
+    borderRadius?: string;
+    /** 整体缩放（对应 CSS `zoom`，如 1.2 放大、0.9 缩小），须为大于 0 的有限数，不传即 1。 */
+    scale?: number;
+}
 export interface UpdateEntryOptions {
     pluginId: string;
     /** 单插件电话前缀（与宿主侧一致）。 */
@@ -27,7 +46,7 @@ export interface UpdateEntryOptions {
     /** 调宿主电话：(phoneName, args) => Promise<reply>。 */
     call: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     variant?: EntryVariant;
-    /** 主题：`default` 最小可用深色，`archive` 档案卷纸面浅色（`d5-paper` 为旧别名仍可用）。 */
+    /** 主题：`default` 最小可用深色，`archive` 档案卷纸面浅色（仍可用）。 */
     theme?: UpdatePanelTheme;
     /** 缺省 'mount'：进页面静默查一次（只读）。'never' 则只在用户点击时查。 */
     autoCheck?: EntryAutoCheck;
@@ -35,6 +54,10 @@ export interface UpdateEntryOptions {
     openOn?: EntryOpenOn;
     /** 覆盖默认按钮文案（不传就用状态联动文案）。 */
     label?: string;
+    /** 按钮尺寸覆盖（#69）：见 EntrySizing；不传即零回归，badge/inline 不受影响。 */
+    sizing?: EntrySizing;
+    /** 语言覆盖（#60 v2）：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }，不传即跟随 html[lang] > navigator > zh。 */
+    locale?: LocaleOption;
     profileName?: string;
     pollMs?: number;
     /**
@@ -68,16 +91,21 @@ export interface UpdateEntryController {
 export declare function entryStateKind(state: UpdateEntryState | null | undefined): EntryStateKind;
 /**
  * 入口件双语 key（#54 底座调用链）：与 entryStateKind 同一输入（快照 + 失败码），分支只认稳定码，永不读文案。
- * 数据层只传 key + {version} 运行时值，表现层经 bilingualHTML 拼语义块。
+ * 数据层只传 key + {version} 运行时值，表现层经 copyHTML 拼单语块。
  */
 export declare function entryBilingualKeyFor(state: UpdateEntryState | null | undefined): BilingualKey;
-/** 双语插值（运行时值永不翻译：同一 version 在中英两 span 各出现一次）。 */
+/** 双语插值（运行时值永不翻译：同一 version 在单语块里原样透传，冻结词元两语言逐字相同）。 */
 export declare function entryBilingualValuesFor(state: UpdateEntryState | null | undefined): Record<string, string>;
-/** 一路调用链的语义块 HTML（entryHTML 按钮正文唯一来源，无覆盖时必走此函数）。 */
-export declare function entryBilingualHTMLFor(state: UpdateEntryState | null | undefined): string;
-/** 属性位纯文本双语（title / aria-label 用，放不下 HTML 时的同内容平面版）。 */
-export declare function entryBilingualTextFor(state: UpdateEntryState | null | undefined): string;
-/** 入口件文案（唯一出处：测试与接入方都读它，不各写一份）。 */
-export declare function entryLabelFor(state: UpdateEntryState | null | undefined): string;
+/** 一路调用链的单语块 HTML（entryHTML 按钮正文唯一来源，无覆盖时必走此函数；lang 显式入参，缺省跟随全局）。 */
+export declare function entryBilingualHTMLFor(state: UpdateEntryState | null | undefined, lang?: AppLang | string | null): string;
+/** 属性位纯文本单语（title / aria-label 用，放不下 HTML 时的同内容平面版；与 HTML 出口同语言）。 */
+export declare function entryBilingualTextFor(state: UpdateEntryState | null | undefined, lang?: AppLang | string | null): string;
+/** 入口件文案第二出口（唯一出处：测试与接入方都读它；与 HTML 出口同语言，v2 起按 lang 取字典，不再硬编码中文）。 */
+export declare function entryLabelFor(state: UpdateEntryState | null | undefined, lang?: AppLang | string | null): string;
+/**
+ * `sizing` → 容器 style 属性体（纯函数：同一输入永远算出同一串；空/缺省回空串，即不写 style）。
+ * 非法即抛（未知键、空串、注入字符、非正有限 scale 都不收）。
+ */
+export declare function entrySizingStyleFor(sizing: EntrySizing | null | undefined): string;
 export declare const UPDATE_ENTRY_CSS: string;
 export declare function mountUpdateEntry(container: UpdatePanelContainer, options: UpdateEntryOptions): UpdateEntryController;

package/dist/entry.js

@@ -5,11 +5,8 @@ import {
   mountUpdatePanel,
   normalizePanelTheme
 } from "./panel.js";
-import { BILINGUAL_CSS, bilingualHTML, bilingualText } from "./bilingual.js";
-const LABEL_IDLE = "\u68C0\u67E5\u66F4\u65B0";
-const LABEL_FAILED = "\u66F4\u65B0\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B";
-const LABEL_BUSY = "\u6B63\u5728\u5B89\u88C5\u2026";
-const LABEL_RESTART = "\u5F85\u91CD\u542F";
+import { BILINGUAL_CSS, copyHTML, copyText } from "./bilingual.js";
+import { resolveLang, subscribeLang } from "./lang.js";
 function hasUpdateOf(snapshot) {
   if (!snapshot) return false;
   const latest = snapshot.latestVersion;
@@ -53,33 +50,63 @@ function entryBilingualValuesFor(state) {
   }
   return {};
 }
-function entryBilingualHTMLFor(state) {
-  return bilingualHTML(entryBilingualKeyFor(state), entryBilingualValuesFor(state));
+function entryBilingualHTMLFor(state, lang) {
+  const l = lang ?? resolveLang();
+  return copyHTML(entryBilingualKeyFor(state), l, entryBilingualValuesFor(state));
 }
-function entryBilingualTextFor(state) {
-  return bilingualText(entryBilingualKeyFor(state), entryBilingualValuesFor(state));
+function entryBilingualTextFor(state, lang) {
+  const l = lang ?? resolveLang();
+  return copyText(entryBilingualKeyFor(state), l, entryBilingualValuesFor(state));
 }
-function entryLabelFor(state) {
-  switch (entryStateKind(state)) {
-    case "busy":
-      return LABEL_BUSY;
-    case "restart":
-      return LABEL_RESTART;
-    case "failed":
-      return LABEL_FAILED;
-    case "update": {
-      const latest = state?.snapshot?.latestVersion;
-      return typeof latest === "string" && latest.trim() ? `\u6709\u65B0\u7248 ${latest.trim()}` : LABEL_IDLE;
+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);
     }
-    default:
-      return LABEL_IDLE;
   }
+  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}",
@@ -87,25 +114,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]";
@@ -150,8 +178,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;
@@ -159,6 +187,22 @@ 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);
+  const sizingAttr = sizingStyle ? ` style="${sizingStyle}"` : "";
+  const localeOpt = options.locale ?? void 0;
+  if (localeOpt !== void 0 && localeOpt !== null) {
+    const isStr = typeof localeOpt === "string";
+    const isObj = typeof localeOpt === "object" && typeof localeOpt.getActive === "function";
+    if (!isStr && !isObj) {
+      throw new Error("[dsh-plugin-update] invalid locale: expected zh / en / BCP47 or { getActive(), subscribe? }");
+    }
+    if (isStr && !localeOpt.trim()) {
+      throw new Error("[dsh-plugin-update] invalid locale: empty string");
+    }
+  }
+  function currentLang() {
+    return resolveLang(localeOpt);
+  }
   const profileName = typeof options.profileName === "string" && options.profileName ? options.profileName : null;
   const onActivate = typeof options.onActivate === "function" ? options.onActivate : null;
   const call = options.call;
@@ -191,7 +235,7 @@ function mountUpdateEntry(container, options) {
     return { snapshot, error };
   }
   function currentLabel() {
-    return labelOverride ?? entryLabelFor(stateOf());
+    return labelOverride ?? entryLabelFor(stateOf(), currentLang());
   }
   function hasUpdate() {
     return hasUpdateOf(snapshot);
@@ -201,15 +245,16 @@ function mountUpdateEntry(container, options) {
   }
   function entryHTML() {
     const kind = entryStateKind(stateOf());
-    const labelHTML = labelOverride ? escapeHtml(labelOverride) : activating ? bilingualHTML("entry.action.checking") : entryBilingualHTMLFor(stateOf());
-    const labelText = labelOverride ?? (activating ? bilingualText("entry.action.checking") : entryBilingualTextFor(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 busyAttr = activating ? ' disabled aria-busy="true"' : "";
     const themeAttr = theme === "archive" ? ' data-theme="archive"' : "";
     const control = variant === "badge" ? `<button type="button" class="dsh-upd-entry-dot" ${ENTRY_ATTR}="activate" title="${escapeHtml(labelText)}" aria-label="${escapeHtml(labelText)}"${busyAttr}></button>` : `<button type="button" class="dsh-upd-entry-btn" ${ENTRY_ATTR}="activate"${busyAttr}>${labelHTML}</button>`;
-    const noteHTML = noteVersion ? `<span class="dsh-upd-entry-note" data-dsh-upd-note="1">${bilingualHTML("entry.note.up-to-date", { version: noteVersion })}</span>` : "";
+    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}${sizingAttr}>${control}${noteHTML}</span>`;
   }
   function render() {
     if (!mounted) return;
@@ -258,6 +303,7 @@ ${BILINGUAL_CSS}</style>
       profileName,
       autoChangelog: options.autoChangelog,
       changelogMarkdown: options.changelogMarkdown ?? null,
+      locale: localeOpt,
       // 面板点「关闭」即走入口件的完整关闭（收 dialog + 还原按钮 + 重查一次），不再是面板自己停轮询。
       onCloseRequested: () => close(),
       call: panelCall
@@ -313,8 +359,8 @@ ${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);
@@ -344,6 +390,10 @@ ${BILINGUAL_CSS}</style>
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    try {
+      unsubLang();
+    } catch {
+    }
     const opened = panel;
     panel = null;
     panelMode = null;
@@ -360,6 +410,9 @@ ${BILINGUAL_CSS}</style>
     } catch {
     }
   }
+  const unsubLang = subscribeLang(() => {
+    render();
+  }, localeOpt);
   try {
     container.addEventListener?.("click", onClick);
   } catch {
@@ -380,6 +433,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);
 }