dsh-plugin-update 0.5.6 → 0.5.8

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 格式为 Keep-a-Changelog 子集：`Added/Fixed/Changed` 必写，`Deprecated/Removed/Security` 有则透传，`Unreleased` 面板忽略，禁止 git-log 直倒。面板缺日志时中性提示，不挡安装。
 
+## [0.5.8] - 2026-10-06
+
+### Added
+- 语言底座 v2 按宿主语言单语渲染，入口两条链先生效（#60，地图 #51）：新增 `src/lang.ts` 信号层（显式 `locale` > `document.documentElement.lang` > `navigator.languages` > 中文兜底，非中文落英文；单例 `MutationObserver` + 服务订阅，切换即时重绘，`unmount` 停订，无 DOM 落中文）；`bilingual.ts` 新增 `copyHTML/copyText(key, lang, values)` 单语纯函数出口（一次一种语言，单 `span[lang]`），旧 `bilingualHTML/Text` 转为按当前语言包装，字典新增 `batch-entry.*` 6 键（13 键全 `draft`）；`entry/entry-batch` 新增 `locale` 选项全走字典单语块（含聚合口径与 `已是最新` 小字）；`panel/panel-batch` 仅加 `locale` 占位暂不消费（#61-#66 按面迁移）；双语门禁改断言单语（缺语言/混语言即红，冻结词元除外）；`build.mjs` 加 `lang.ts` 单元；README 补单语与窗口期说明。
+
+## [0.5.7] - 2026-10-06
+
+### Fixed
+- 拆入口通道安装禁令（#58 真因）：入口件 HTTP 直挂不再源码级禁 updateInstall（入口件核心本就没有安装代码路径，禁令只连坐入口件打开的面板；真正门禁在宿主侧核心）；入口打开面板后安装电话端到端验证通过。
+
 ## [0.5.6] - 2026-10-06
 
 ### Added

package/README.md

@@ -183,7 +183,9 @@ const entry = mountUpdateEntry(document.getElementById('upd-entry'), {
 | 什么时候查 | `mount` / `never` | `mount` | 进页面静默查一次（**只调 `.updateStatus`，只读**）；`never` 则只在点击时查 |
 | 点了做什么 | `has-update` / `always` / `manual` / `direct` | `has-update` | 有新版才开面板；检查完总是开；交给 `onActivate` 自己跳；点开即弹窗、不预查 |
 
-按钮文案随状态自己变：`检查更新` / `有新版 1.1.0` / `正在安装…` / `待重启` / `更新失败，点此查看`。
+按钮文案随状态自己变（按宿主语言单语渲染：中文界面纯中文、英文界面纯英文，一次只出现一种语言）：`检查更新` / `有新版 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'`（点开即弹窗，连预查都省了，面板挂载即自查；徽标形态仍走回调口径）。
 
@@ -212,10 +214,12 @@ const entry = mountUpdateBatchEntry(document.getElementById('upd-entry'), {
 ```
 
 聚合口径与批量面板总账同一份数法（含「忙失败占位翻回可更新」）：`忙 > 失败 > 待重启 > 可更新 > 待查`，
-文案为 `检查更新` / `N 家可更新` / `正在安装…` / `N 家待重启` / `N 家失败，点此查看`。
+文案按宿主语言单语渲染（中文如左，英文见字典 `batch-entry.*` 同 key），`locale` 选项与单入口同形态，切换即时重绘。
 三自由度与单入口同取值，缺省不同：`openOn` 缺省 `'always'`（查完总是开批量面板；`has-update` 下有事才开，否则原地给总账一句）。
 `autoCheck` 缺省 `'mount'`（只调 `.batchStatus`，只读）；铁律同单入口：任何路径都不自动安装。
 
+窗口期说明（必读）：`mountUpdatePanel` 与 `mountUpdateBatchPanel` 已接受 `locale` 选项（与入口件同形态），但本版本暂不消费——传了不生效，面板内容仍按既有中文渲染；语言跟随的按面迁移在后续版本逐面落地，入口件两条链已先生效。
+
 ### 第 2.6 节：多目标批量更新（一个插件管 N 个插件的更新）
 
 一个插件替自己**和另外几个插件**管更新时，别把 N 个面板并排——用户在那块界面上只问三件事：

package/dist/bilingual.d.ts

@@ -1,30 +1,40 @@
+import { type AppLang } from './lang.js';
 /** 字典版本钉（#53 Q3 解耦）：key 冻即解阻塞 #54，文案按词标 draft/locked；开发钉此版本，转正只换文案不换 key。 */
 export declare const BILINGUAL_DICT_VERSION = "2026-10-06-pin53";
-/** 首批 key 全集（entry 7 键，命名沿 #52 §1 key 提案，area.group.name）。 */
-export type BilingualKey = 'entry.label.idle' | 'entry.label.failed' | 'entry.label.busy' | 'entry.label.restart' | 'entry.label.has-update' | 'entry.action.checking' | 'entry.note.up-to-date';
-/** 一条双语：en/zh 模板 + 成熟度。模板内具名槽如 {version}，运行时值填入（值永不翻译）。 */
+/** key 全集（entry 7 键 + batch-entry 6 键，命名沿 #52 §1 key 提案，area.group.name；既有 7 键 en/zh/draft 不动）。 */
+export type BilingualKey = 'entry.label.idle' | 'entry.label.failed' | 'entry.label.busy' | 'entry.label.restart' | 'entry.label.has-update' | 'entry.action.checking' | 'entry.note.up-to-date' | 'batch-entry.label.idle' | 'batch-entry.label.update' | 'batch-entry.label.busy' | 'batch-entry.label.restart' | 'batch-entry.label.failed' | 'batch-entry.action.checking';
+/** 一条双语：en/zh 模板 + 成熟度。模板内具名槽如 {version}/{count}，运行时值填入（值永不翻译）。 */
 export interface BilingualEntry {
     en: string;
     zh: string;
-    /** true=待母语+域内双签（#53 Q3），false=已双签转正。首批全 draft（无评审不假锁）。 */
+    /** true=待母语+域内双签（#53 Q3），false=已双签转正。首批与新增全 draft（无评审不假锁）。 */
     draft: boolean;
 }
 /**
  * 集中字典（机器源，类型锁死：Record<BilingualKey, BilingualEntry> 缺键即 tsc 报错）。
  * 人读源为 #57 规格 + #53 结论英文定调；英文终稿待母语评审，故全标 draft。
- * zh 逐字等于 entry.ts 现有散落文案（兼容既有测试与接入方 label() 口径）。
+ * zh 逐字等于 entry.ts / entry-batch.ts 既有散落文案（兼容既有测试与接入方 label() 口径）。
  */
 export declare const BILINGUAL_STRINGS: Record<BilingualKey, BilingualEntry>;
 /** 取一条双语原文（类型锁死：未知 key 在 tsc 即拦；运行时未知亦抛，不静默回退）。 */
 export declare function bilingualEntry(key: BilingualKey): BilingualEntry;
 /**
- * 纯文本双语（一行，英文在前中文在后，空白分隔）：用于 title / aria-label 等放不下 HTML 的属性位。
- * 返回原文（未转义），调用方按上下文转义后再拼入属性。
+ * 单语纯文本（v2 主出口，纯函数）：只渲染 lang 那一种语言，不读全局信号。
+ * lang 显式入参（'zh'/'en'/BCP47，缺省 zh）；返回原文（未转义），调用方按上下文转义后再拼入属性。
+ */
+export declare function copyText(key: BilingualKey, lang?: AppLang | string | null, values?: Record<string, unknown>): string;
+/**
+ * 单语语义块 HTML（v2 主出口，纯函数）：一次只出现一种语言，语义块仍带 lang 属性。
+ * lang 显式入参（缺省 zh）；返回已转义可直接拼入 innerHTML 的片段；调用方不得再对整体转义，不得拆 span 重组。
+ */
+export declare function copyHTML(key: BilingualKey, lang?: AppLang | string | null, values?: Record<string, unknown>): string;
+/**
+ * 历史名包装（v2 前叫双语，v2 起为单语，保留旧名见文件头说明）：
+ * 无显式 lang 时按当前语言单语渲染（读全局信号），有覆盖需求请直接用 copyHTML/copyText。
  */
 export declare function bilingualText(key: BilingualKey, values?: Record<string, unknown>): string;
 /**
- * 双语语义块 HTML（唯一渲染出口）：英文在前中文在后，空白分隔，lang 属性齐全。
- * 返回已转义可直接拼入 innerHTML 的片段；调用方不得再对整体转义，不得拆 span 重组。
+ * 历史名包装（见上）：无显式 lang 时按当前语言单语渲染；返回单语块（只含当前语言一个 span）。
  */
 export declare function bilingualHTML(key: BilingualKey, values?: Record<string, unknown>): string;
 /** 是否 draft（供 #56 门禁读零 draft 放行条件；#54 自身不断言零 draft）。 */
@@ -32,8 +42,8 @@ export declare function isDraft(key: BilingualKey): boolean;
 /** 全表 draft key 一览（#56 门禁：空数组才放行合入主分支）。 */
 export declare function draftKeys(): BilingualKey[];
 /**
- * 双语块最小样式（与 UPDATE_ENTRY_CSS 同缝注入）：
- * 平时行内双语（英文前中文后，空白分隔），窄处竖排不断行（@media 360px 以下 column）。
- * 只管排版，不管字重字号（字重间距留给 #55 视觉矩阵验收）。
+ * 单语块最小样式（与 UPDATE_ENTRY_CSS 同缝注入）：
+ * v2 起窄处竖排退场（一次只一种语言，不断行压力消失，#55 横排/竖排结论作废，排版改由 #67 仲裁）；
+ * 只保留 overflow-wrap，不断行不溢出；不管字重字号。
  */
 export declare const BILINGUAL_CSS: string;

package/dist/bilingual.js

@@ -1,4 +1,5 @@
 // AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/bilingual.ts
+import { normalizeLangTag, resolveLang } from "./lang.js";
 const BILINGUAL_DICT_VERSION = "2026-10-06-pin53";
 const BILINGUAL_STRINGS = {
   "entry.label.idle": { en: "Check for updates", zh: "\u68C0\u67E5\u66F4\u65B0", draft: true },
@@ -7,7 +8,13 @@ const BILINGUAL_STRINGS = {
   "entry.label.restart": { en: "Restart required", zh: "\u5F85\u91CD\u542F", draft: true },
   "entry.label.has-update": { en: "Update available {version}", zh: "\u6709\u65B0\u7248 {version}", draft: true },
   "entry.action.checking": { en: "Checking for updates\u2026", zh: "\u6B63\u5728\u67E5\u65B0\u7248\u2026", draft: true },
-  "entry.note.up-to-date": { en: "Up to date {version}", zh: "\u5DF2\u662F\u6700\u65B0 {version}", draft: true }
+  "entry.note.up-to-date": { en: "Up to date {version}", zh: "\u5DF2\u662F\u6700\u65B0 {version}", draft: true },
+  "batch-entry.label.idle": { en: "Check for updates", zh: "\u68C0\u67E5\u66F4\u65B0", draft: true },
+  "batch-entry.label.update": { en: "{count} updates available", zh: "{count} \u5BB6\u53EF\u66F4\u65B0", draft: true },
+  "batch-entry.label.busy": { en: "Installing\u2026", zh: "\u6B63\u5728\u5B89\u88C5\u2026", draft: true },
+  "batch-entry.label.restart": { en: "{count} restarts required", zh: "{count} \u5BB6\u5F85\u91CD\u542F", draft: true },
+  "batch-entry.label.failed": { en: "{count} failed \u2014 View details", zh: "{count} \u5BB6\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B", draft: true },
+  "batch-entry.action.checking": { en: "Checking for updates\u2026", zh: "\u6B63\u5728\u67E5\u65B0\u7248\u2026", draft: true }
 };
 function escapeHtml(value) {
   return String(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -25,15 +32,22 @@ function bilingualEntry(key) {
   if (!hit) throw new Error("[dsh-plugin-update] \u672A\u77E5\u6587\u6848 key\uFF1A" + String(key));
   return hit;
 }
-function bilingualText(key, values) {
+function copyText(key, lang, values) {
+  const l = normalizeLangTag(lang ?? "zh");
   const e = bilingualEntry(key);
-  return formatTemplate(e.en, values) + " " + formatTemplate(e.zh, values);
+  return formatTemplate(l === "en" ? e.en : e.zh, values);
 }
-function bilingualHTML(key, values) {
+function copyHTML(key, lang, values) {
+  const l = normalizeLangTag(lang ?? "zh");
   const e = bilingualEntry(key);
-  const en = escapeHtml(formatTemplate(e.en, values));
-  const zh = escapeHtml(formatTemplate(e.zh, values));
-  return '<span class="dsh-upd-bi"><span lang="en">' + en + '</span> <span lang="zh">' + zh + "</span></span>";
+  const text = escapeHtml(formatTemplate(l === "en" ? e.en : e.zh, values));
+  return '<span class="dsh-upd-bi"><span lang="' + l + '">' + text + "</span></span>";
+}
+function bilingualText(key, values) {
+  return copyText(key, resolveLang(), values);
+}
+function bilingualHTML(key, values) {
+  return copyHTML(key, resolveLang(), values);
 }
 function isDraft(key) {
   return bilingualEntry(key).draft;
@@ -42,9 +56,8 @@ function draftKeys() {
   return Object.keys(BILINGUAL_STRINGS).filter((k) => BILINGUAL_STRINGS[k].draft);
 }
 const BILINGUAL_CSS = [
-  ".dsh-upd-bi{display:inline-flex;align-items:baseline;gap:.5em;max-width:100%}",
-  '.dsh-upd-bi [lang="en"],.dsh-upd-bi [lang="zh"]{overflow-wrap:anywhere}',
-  "@media (max-width:360px){.dsh-upd-bi{flex-direction:column;gap:0}}"
+  ".dsh-upd-bi{display:inline;overflow-wrap:anywhere}",
+  ".dsh-upd-bi [lang]{overflow-wrap:anywhere}"
 ].join("\n");
 export {
   BILINGUAL_CSS,
@@ -53,6 +66,8 @@ export {
   bilingualEntry,
   bilingualHTML,
   bilingualText,
+  copyHTML,
+  copyText,
   draftKeys,
   isDraft
 };

package/dist/entry-batch.d.ts

@@ -1,3 +1,5 @@
+import { type BilingualKey } from './bilingual.js';
+import { type AppLang, type LocaleOption } from './lang.js';
 import { type BatchRowView } from './panel-batch.js';
 import { type UpdatePanelTheme } from './panel.js';
 /** 批量入口件的形态（与单入口同一套取值）。 */
@@ -46,6 +48,8 @@ export interface UpdateBatchEntryOptions {
     openOn?: BatchEntryOpenOn;
     /** 覆盖默认按钮文案（不传就用聚合文案）。 */
     label?: string;
+    /** 语言覆盖（#60 v2）：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }，不传即跟随全局信号。 */
+    locale?: LocaleOption;
     /** 可选：键 -> 中文名覆盖（透传给批量面板）。 */
     titles?: Record<string, string>;
     /** 轮询间隔（毫秒，透传给批量面板；缺省 1500，下限 250）。 */
@@ -79,12 +83,21 @@ export interface UpdateBatchEntryController {
 /**
  * 聚合读数：计数唯一出处 batchLedgerCounts（与面板总账同一份，忙失败占位翻回可更新）。
  * hasUpdate = 忙/失败/待重启/可更新任一非零（openOn has-update 按它开面板；全 settled/待查/跳过即 idle）。
+ * v2 单语：label 与 HTML 出口同语言（lang 显式入参，缺省跟随全局；zh 口径逐字兼容旧中文）。
  */
-export declare function batchEntrySummary(state: UpdateBatchEntryState | null | undefined): BatchEntrySummary;
-/** 状态档（唯一出处：batchEntrySummary，不各写一份）。 */
+export declare function batchEntrySummary(state: UpdateBatchEntryState | null | undefined, lang?: AppLang | string | null): BatchEntrySummary;
+/** 状态档（唯一出处：batchEntrySummary，不各写一份；lang 仅影响 label，不影响档位）。 */
 export declare function batchEntryStateKind(state: UpdateBatchEntryState | null | undefined): BatchEntryStateKind;
-/** 批量入口件文案（唯一出处：测试与接入方都读它，不各写一份）。 */
-export declare function batchEntryLabelFor(state: UpdateBatchEntryState | null | undefined): string;
+/** 批量入口件文案第二出口（唯一出处；与 HTML 出口同语言，v2 起按 lang 取字典）。 */
+export declare function batchEntryLabelFor(state: UpdateBatchEntryState | null | undefined, lang?: AppLang | string | null): string;
+/** 批量 key（与 entryStateKind 同输入，分支只认稳定码与计数，不读文案）。 */
+export declare function batchEntryBilingualKeyFor(state: UpdateBatchEntryState | null | undefined): BilingualKey;
+/** 批量插值（{count} 运行时值永不翻译，冻结词元两语言逐字相同）。 */
+export declare function batchEntryBilingualValuesFor(state: UpdateBatchEntryState | null | undefined): Record<string, string>;
+/** 批量单语块 HTML（按钮正文唯一来源；lang 显式入参，缺省跟随全局）。 */
+export declare function batchEntryBilingualHTMLFor(state: UpdateBatchEntryState | null | undefined, lang?: AppLang | string | null): string;
+/** 批量单语纯文本（title/aria 用；与 HTML 出口同语言）。 */
+export declare function batchEntryBilingualTextFor(state: UpdateBatchEntryState | null | undefined, lang?: AppLang | string | null): string;
 export declare function mountUpdateBatchEntry(container: {
     innerHTML: string;
     addEventListener?: (type: string, listener: (ev: unknown) => void) => void;

package/dist/entry-batch.js

@@ -1,6 +1,8 @@
 // AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/entry-batch.ts
 import { MIN_PANEL_POLL_MS } from "./config.js";
 import { UPDATE_ENTRY_CSS } from "./entry.js";
+import { BILINGUAL_CSS, copyHTML, copyText } from "./bilingual.js";
+import { normalizeLangTag, resolveLang, subscribeLang } from "./lang.js";
 import {
   batchLedgerCounts,
   batchLedgerText,
@@ -11,8 +13,6 @@ import {
   failureCodeOf,
   normalizePanelTheme
 } from "./panel.js";
-const LABEL_IDLE = "\u68C0\u67E5\u66F4\u65B0";
-const LABEL_BUSY = "\u6B63\u5728\u5B89\u88C5\u2026";
 function isObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -23,7 +23,7 @@ function asRows(value) {
 function escapeHtml(value) {
   return String(value).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function batchEntrySummary(state) {
+function batchEntrySummary(state, lang) {
   const rows = state?.rows ?? null;
   const counts = batchLedgerCounts(Array.isArray(rows) ? rows : []);
   const total = Array.isArray(rows) ? rows.length : 0;
@@ -47,22 +47,23 @@ function batchEntrySummary(state) {
     }
   }
   const hasUpdate = counts.installing > 0 || counts.failed > 0 || counts.restart > 0 || counts.updatable > 0;
+  const l = lang !== void 0 && lang !== null ? normalizeLangTag(lang) : resolveLang();
   let label;
   switch (kind) {
     case "busy":
-      label = LABEL_BUSY;
+      label = copyText("batch-entry.label.busy", l);
       break;
     case "failed":
-      label = counts.failed > 0 ? counts.failed + " \u5BB6\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B" : "\u66F4\u65B0\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B";
+      label = counts.failed > 0 ? copyText("batch-entry.label.failed", l, { count: String(counts.failed) }) : copyText("entry.label.failed", l);
       break;
     case "restart":
-      label = counts.restart + " \u5BB6\u5F85\u91CD\u542F";
+      label = copyText("batch-entry.label.restart", l, { count: String(counts.restart) });
       break;
     case "update":
-      label = counts.updatable + " \u5BB6\u53EF\u66F4\u65B0";
+      label = copyText("batch-entry.label.update", l, { count: String(counts.updatable) });
       break;
     default:
-      label = LABEL_IDLE;
+      label = copyText("batch-entry.label.idle", l);
       break;
   }
   return {
@@ -82,8 +83,44 @@ function batchEntrySummary(state) {
 function batchEntryStateKind(state) {
   return batchEntrySummary(state).kind;
 }
-function batchEntryLabelFor(state) {
-  return batchEntrySummary(state).label;
+function batchEntryLabelFor(state, lang) {
+  return batchEntrySummary(state, lang).label;
+}
+function batchEntryBilingualKeyFor(state) {
+  const s = batchEntrySummary(state);
+  switch (s.kind) {
+    case "busy":
+      return "batch-entry.label.busy";
+    case "failed":
+      return s.failed > 0 ? "batch-entry.label.failed" : "entry.label.failed";
+    case "restart":
+      return "batch-entry.label.restart";
+    case "update":
+      return "batch-entry.label.update";
+    default:
+      return "batch-entry.label.idle";
+  }
+}
+function batchEntryBilingualValuesFor(state) {
+  const s = batchEntrySummary(state);
+  switch (s.kind) {
+    case "update":
+      return { count: String(s.updatable) };
+    case "restart":
+      return { count: String(s.restart) };
+    case "failed":
+      return s.failed > 0 ? { count: String(s.failed) } : {};
+    default:
+      return {};
+  }
+}
+function batchEntryBilingualHTMLFor(state, lang) {
+  const l = lang !== void 0 && lang !== null ? normalizeLangTag(lang) : resolveLang();
+  return copyHTML(batchEntryBilingualKeyFor(state), l, batchEntryBilingualValuesFor(state));
+}
+function batchEntryBilingualTextFor(state, lang) {
+  const l = lang !== void 0 && lang !== null ? normalizeLangTag(lang) : resolveLang();
+  return copyText(batchEntryBilingualKeyFor(state), l, batchEntryBilingualValuesFor(state));
 }
 function mountUpdateBatchEntry(container, options) {
   if (!container || typeof container.innerHTML !== "string") {
@@ -117,6 +154,20 @@ function mountUpdateBatchEntry(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 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 titles = options.titles && typeof options.titles === "object" ? options.titles : {};
   const onActivate = typeof options.onActivate === "function" ? options.onActivate : null;
   const call = options.call;
@@ -154,7 +205,7 @@ function mountUpdateBatchEntry(container, options) {
     return { rows, error };
   }
   function summaryOf() {
-    return batchEntrySummary(stateOf());
+    return batchEntrySummary(stateOf(), currentLang());
   }
   function currentLabel() {
     return labelOverride ?? summaryOf().label;
@@ -163,13 +214,15 @@ function mountUpdateBatchEntry(container, options) {
     return {};
   }
   function entryHTML() {
-    const summary = summaryOf();
-    const text = activating ? "\u6B63\u5728\u67E5\u65B0\u7248\u2026" : currentLabel();
+    const lang = currentLang();
+    const summary = batchEntrySummary(stateOf(), lang);
+    const labelHTML = labelOverride ? escapeHtml(labelOverride) : activating ? copyHTML("batch-entry.action.checking", lang) : copyHTML(batchEntryBilingualKeyFor(stateOf()), lang, batchEntryBilingualValuesFor(stateOf()));
+    const labelText = labelOverride ?? (activating ? copyText("batch-entry.action.checking", lang) : copyText(batchEntryBilingualKeyFor(stateOf()), lang, batchEntryBilingualValuesFor(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(text) + '" aria-label="' + escapeHtml(text) + '"' + busyAttr + "></button>" : '<button type="button" class="dsh-upd-entry-btn" ' + ENTRY_ATTR + '="activate"' + busyAttr + ">" + escapeHtml(text) + "</button>";
+    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 = note ? '<span class="dsh-upd-entry-note" data-dsh-upd-note="1">' + escapeHtml(note) + "</span>" : "";
-    return "<style>" + UPDATE_ENTRY_CSS + '</style>\n<span class="dsh-upd-entry" data-variant="' + variant + '" data-state="' + summary.kind + '"' + themeAttr + ">" + control + noteHTML + "</span>";
+    return "<style>" + UPDATE_ENTRY_CSS + "\n" + BILINGUAL_CSS + '</style>\n<span class="dsh-upd-entry" data-variant="' + variant + '" data-state="' + summary.kind + '"' + themeAttr + ">" + control + noteHTML + "</span>";
   }
   function render() {
     if (!mounted) return;
@@ -219,6 +272,7 @@ function mountUpdateBatchEntry(container, options) {
       onRestartRequested: options.onRestartRequested,
       copyText: options.copyText,
       autoChangelog: options.autoChangelog,
+      locale: localeOpt,
       // 面板点「关闭」即走入口件的完整关闭（收 dialog + 还原按钮 + 重查一次），不再是面板自己停轮询。
       onCloseRequested: () => close(),
       call: panelCall
@@ -314,6 +368,10 @@ function mountUpdateBatchEntry(container, options) {
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    try {
+      unsubLang();
+    } catch {
+    }
     const opened = panel;
     panel = null;
     panelMode = null;
@@ -332,6 +390,9 @@ function mountUpdateBatchEntry(container, options) {
     } catch {
     }
   }
+  const unsubLang = subscribeLang(() => {
+    render();
+  }, localeOpt);
   try {
     ;
     container.addEventListener?.("click", onClick);
@@ -348,6 +409,10 @@ function mountUpdateBatchEntry(container, options) {
   return { refresh, open, close, label: currentLabel, summary: summaryOf, setTheme, unmount };
 }
 export {
+  batchEntryBilingualHTMLFor,
+  batchEntryBilingualKeyFor,
+  batchEntryBilingualTextFor,
+  batchEntryBilingualValuesFor,
   batchEntryLabelFor,
   batchEntryStateKind,
   batchEntrySummary,

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';
 /** 什么时候主动查一次（只读，联网一次）。 */
@@ -35,6 +36,8 @@ export interface UpdateEntryOptions {
     openOn?: EntryOpenOn;
     /** 覆盖默认按钮文案（不传就用状态联动文案）。 */
     label?: string;
+    /** 语言覆盖（#60 v2）：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }，不传即跟随 html[lang] > navigator > zh。 */
+    locale?: LocaleOption;
     profileName?: string;
     pollMs?: number;
     /**
@@ -68,16 +71,16 @@ 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;
 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,27 +50,17 @@ 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;
-    }
-    default:
-      return LABEL_IDLE;
-  }
+function entryLabelFor(state, lang) {
+  const l = lang ?? resolveLang();
+  return copyText(entryBilingualKeyFor(state), l, entryBilingualValuesFor(state));
 }
 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)}',
@@ -159,6 +146,20 @@ 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 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 +192,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,12 +202,13 @@ 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>`;
@@ -258,6 +260,7 @@ ${BILINGUAL_CSS}</style>
       profileName,
       autoChangelog: options.autoChangelog,
       changelogMarkdown: options.changelogMarkdown ?? null,
+      locale: localeOpt,
       // 面板点「关闭」即走入口件的完整关闭（收 dialog + 还原按钮 + 重查一次），不再是面板自己停轮询。
       onCloseRequested: () => close(),
       call: panelCall
@@ -344,6 +347,10 @@ ${BILINGUAL_CSS}</style>
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    try {
+      unsubLang();
+    } catch {
+    }
     const opened = panel;
     panel = null;
     panelMode = null;
@@ -360,6 +367,9 @@ ${BILINGUAL_CSS}</style>
     } catch {
     }
   }
+  const unsubLang = subscribeLang(() => {
+    render();
+  }, localeOpt);
   try {
     container.addEventListener?.("click", onClick);
   } catch {

package/dist/http.d.ts

@@ -102,7 +102,12 @@ export interface UpdateEntryHttpOptions extends Omit<UpdateEntryOptions, "call"
     timeout?: number | HttpTimeouts;
     timeoutMs?: number | HttpTimeouts;
 }
-/** 入口件 HTTP 直挂：内部源码级禁安装电话，内核复用 mountUpdateEntry。 */
+/** 入口件 HTTP 直挂：调用通道与面板直挂同一条，内核复用 mountUpdateEntry。
+ *
+ * 通道层不禁安装：入口件核心没有调安装的代码路径（只查 + 打开面板，见 README 铁律），
+ * 禁令只会连坐入口件打开的面板（#58：安装键亮着但永远抛错）；真正的门禁在宿主侧核心
+ *（凭证/排队/安装键/装后校验），面板安装与面板直挂走同一套，不过不少。
+ */
 export declare function mountUpdateEntryHttp(container: UpdatePanelContainer, options: UpdateEntryHttpOptions): UpdateEntryController;
 export interface UpdateBatchPanelHttpOptions extends Omit<BatchPanelOptions, "call" | "prefix"> {
     /** 批量电话前缀（与宿主侧一致；五电话名从它算出，不写字面量）。 */

package/dist/http.js

@@ -261,15 +261,9 @@ function mountUpdateEntryHttp(container, options) {
     throw new Error("[dsh-plugin-update] \u6302 HTTP \u5165\u53E3\u4EF6\u7F3A\u5C11\u914D\u7F6E\uFF1A\u63D2\u4EF6\u6807\u8BC6 pluginId \u4E0E\u7F51\u5173\u6839 baseUrl \u5FC5\u586B");
   }
   const prefix = options.prefix ?? DEFAULT_PREFIX;
-  const rawCall = createHttpCall({ prefix, baseUrl: options.baseUrl, routes: options.routes, fetch: options.fetch, fetchImpl: options.fetchImpl, timeout: options.timeout, timeoutMs: options.timeoutMs });
-  const guarded = async (name, args) => {
-    if (shortActionOf(name) === "updateInstall") {
-      throw new Error("[dsh-plugin-update] \u5165\u53E3\u4EF6\u53EA\u5141\u8BB8\u53EA\u8BFB\u7535\u8BDD\uFF0CupdateInstall \u7981\u6B62\uFF08\u6E90\u7801\u7EA7\uFF09");
-    }
-    return rawCall(name, args);
-  };
+  const call = createHttpCall({ prefix, baseUrl: options.baseUrl, routes: options.routes, fetch: options.fetch, fetchImpl: options.fetchImpl, timeout: options.timeout, timeoutMs: options.timeoutMs });
   const { baseUrl: _b, routes: _r, fetch: _f, fetchImpl: _fi, timeout: _t, timeoutMs: _tm, prefix: _p, ...entryRest } = options;
-  return mountUpdateEntry(container, { ...entryRest, pluginId: options.pluginId, prefix, call: guarded });
+  return mountUpdateEntry(container, { ...entryRest, pluginId: options.pluginId, prefix, call });
 }
 function mountUpdateBatchPanelHttp(container, options) {
   if (!options || typeof options !== "object") {

package/dist/lang.d.ts

@@ -0,0 +1,29 @@
+/** 本包跟随的两种语言：中文（历史行为）与英文（其余语言落英文）。 */
+export type AppLang = 'zh' | 'en';
+/** 显式覆盖的两种形态：稳定码 'zh' | 'en'，或带 getActive/subscribe 的服务对象（可注入假信号源，测试不依赖 jsdom）。 */
+export interface LocaleService {
+    getActive(): string;
+    subscribe?(cb: () => void): () => void;
+}
+/** 入口件/面板/批量挂载点的语言选项：显式覆盖，不传即跟随全局信号。 */
+export type LocaleOption = 'zh' | 'en' | LocaleService | string | null | undefined;
+type LangCallback = (lang: AppLang) => void;
+/**
+ * 归一语言标签：zh* → zh；形如 BCP47 的已知非中文标签 → en；空/垃圾 → zh（零回归）。
+ * 大小写不敏感，_ 视作 -。
+ */
+export declare function normalizeLangTag(tag: unknown): AppLang;
+/**
+ * 解出当前语言：显式覆盖 > html[lang] > navigator.languages > zh。
+ * 纯函数（除读全局信号外无副作用）；无信号永不抛，落 zh。
+ */
+export declare function resolveLang(override?: LocaleOption): AppLang;
+/**
+ * 订阅语言变化：html[lang] 变化或可选服务源触发时回新语言。
+ * 模块级单例：多个挂载件共用一个 MutationObserver；返回 unsubscribe，unmount 后停订。
+ * 无 DOM 环境安全降级：没有 document/MutationObserver 时只记回调、永不触发，不抛。
+ */
+export declare function subscribeLang(cb: LangCallback, override?: LocaleOption): () => void;
+/** 测试/维护用：清空全部订阅并断开单例观察者（正常业务代码不调它）。 */
+export declare function __resetLangState(): void;
+export {};

package/dist/lang.js

@@ -0,0 +1,150 @@
+// AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/lang.ts
+function normalizeLangTag(tag) {
+  if (typeof tag !== "string") return "zh";
+  const s = tag.trim().toLowerCase().replace(/_/g, "-");
+  if (!s) return "zh";
+  if (s === "zh" || s.startsWith("zh-")) return "zh";
+  if (s === "en" || s.startsWith("en-")) return "en";
+  if (/^[a-z]{2,3}(-[a-z0-9]+)*$/.test(s)) return "en";
+  return "zh";
+}
+function readDocumentLang() {
+  try {
+    const g = globalThis;
+    const v = g.document?.documentElement?.lang;
+    if (typeof v === "string" && v.trim()) return v;
+  } catch {
+  }
+  return null;
+}
+function readNavigatorLangs() {
+  try {
+    const g = globalThis;
+    const nav = g.navigator;
+    if (!nav) return [];
+    const out = [];
+    if (Array.isArray(nav.languages)) {
+      for (const c of nav.languages) {
+        if (typeof c === "string" && c.trim()) out.push(c);
+      }
+    }
+    if (typeof nav.language === "string" && nav.language.trim()) out.push(nav.language);
+    return out;
+  } catch {
+    return [];
+  }
+}
+function resolveLang(override) {
+  if (override !== null && typeof override === "object") {
+    try {
+      const fn = override.getActive;
+      if (typeof fn === "function") {
+        const v = fn.call(override);
+        if (typeof v === "string" && v.trim()) return normalizeLangTag(v);
+      }
+    } catch {
+    }
+  } else if (typeof override === "string" && override.trim()) {
+    return normalizeLangTag(override);
+  }
+  const docLang = readDocumentLang();
+  if (docLang !== null) return normalizeLangTag(docLang);
+  const navs = readNavigatorLangs();
+  for (const c of navs) {
+    return normalizeLangTag(c);
+  }
+  return "zh";
+}
+const entries = /* @__PURE__ */ new Set();
+let mo = null;
+function ensureGlobalObserver() {
+  if (mo !== null) return;
+  try {
+    const g = globalThis;
+    const docEl = g.document?.documentElement;
+    const MO = g.MutationObserver;
+    if (!docEl || typeof MO !== "function") return;
+    const obs = new MO(() => {
+      notifyAll();
+    });
+    obs.observe(docEl, { attributes: true, attributeFilter: ["lang"] });
+    mo = obs;
+  } catch {
+    mo = null;
+  }
+}
+function notifyAll() {
+  for (const e of [...entries]) {
+    try {
+      const next = resolveLang(e.override);
+      if (next !== e.last) {
+        e.last = next;
+        e.cb(next);
+      }
+    } catch {
+    }
+  }
+}
+function subscribeLang(cb, override) {
+  if (typeof cb !== "function") throw new Error("[dsh-plugin-update] subscribeLang needs a function");
+  const entry = { cb, override: override ?? void 0, last: resolveLang(override), serviceUnsub: null };
+  entries.add(entry);
+  ensureGlobalObserver();
+  try {
+    if (entry.override !== null && typeof entry.override === "object") {
+      const sub = entry.override.subscribe;
+      if (typeof sub === "function") {
+        const un = sub.call(entry.override, () => {
+          try {
+            const next = resolveLang(entry.override);
+            if (next !== entry.last) {
+              entry.last = next;
+              entry.cb(next);
+            }
+          } catch {
+          }
+        });
+        if (typeof un === "function") entry.serviceUnsub = un;
+      }
+    }
+  } catch {
+  }
+  let done = false;
+  return () => {
+    if (done) return;
+    done = true;
+    entries.delete(entry);
+    try {
+      entry.serviceUnsub?.();
+    } catch {
+    }
+    entry.serviceUnsub = null;
+    if (entries.size === 0) {
+      try {
+        mo?.disconnect();
+      } catch {
+      }
+      mo = null;
+    }
+  };
+}
+function __resetLangState() {
+  for (const e of [...entries]) {
+    try {
+      e.serviceUnsub?.();
+    } catch {
+    }
+  }
+  entries.clear();
+  try {
+    mo?.disconnect();
+  } catch {
+  }
+  mo = null;
+}
+export {
+  __resetLangState,
+  normalizeLangTag,
+  resolveLang,
+  subscribeLang
+};

package/dist/panel-batch.d.ts

@@ -54,6 +54,11 @@ export interface BatchPanelOptions {
      * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
      */
     onCloseRequested?: () => void | Promise<void>;
+    /**
+     * 语言覆盖（#60 窗口期占位：本票只加选项不消费，传了暂不生效，消费留给 #61-#66）。
+     * 形态与入口件一致：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }。
+     */
+    locale?: unknown;
 }
 /** 面板可点的动作（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';

package/dist/panel.d.ts

@@ -68,6 +68,11 @@ export interface UpdatePanelOptions {
      * 不传则回退为只停轮询（unmount），DOM 留给调用方处理。入口件打开的 dialog 已内置（收 dialog + 还原按钮）。
      */
     onCloseRequested?: () => void | Promise<void>;
+    /**
+     * 语言覆盖（#60 窗口期占位：本票只加选项不消费，传了暂不生效，消费留给 #61-#66）。
+     * 形态与入口件一致：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }。
+     */
+    locale?: unknown;
 }
 /** 挂载点：只要有 innerHTML 的容器即可（浏览器元素或测试替身都行）。 */
 export interface UpdatePanelContainer {

package/package.json

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