dsh-plugin-update 0.5.7 → 0.6.0

package/dist/changelog.js

@@ -1,5 +1,7 @@
 // AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/changelog.ts
 import { compareReleaseVersions, validReleaseVersion } from "./service.js";
+import { copyText } from "./bilingual.js";
+import { normalizeLangTag } from "./lang.js";
 const CHANGELOG_FILENAME = "CHANGELOG.md";
 const CHANGELOG_NEUTRAL_HINT = "\u4F5C\u8005\u672A\u63D0\u4F9B\u66F4\u65B0\u8BF4\u660E";
 const CHANGELOG_NEUTRAL_LINE = "\u4F5C\u8005\u672A\u63D0\u4F9B\u66F4\u65B0\u8BF4\u660E\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\u3002";
@@ -109,6 +111,18 @@ function isFenceToggle(line) {
   }
 }
 const BREAKING_BADGE_TEXT = "\u4E0D\u517C\u5BB9";
+function changelogCategoryLabel(cat, lang) {
+  const l = normalizeLangTag(lang ?? "zh");
+  const zh = CHANGELOG_CATEGORY_ZH[cat];
+  if (l === "en") return cat;
+  return zh + "\uFF08" + cat + "\uFF09";
+}
+function changelogFoldedLabel(cat, count, lang) {
+  const l = normalizeLangTag(lang ?? "zh");
+  const n = String(Math.floor(count));
+  if (l === "en") return cat + " (" + n + ")";
+  return CHANGELOG_CATEGORY_ZH[cat] + "\uFF08" + cat + "\uFF09\uFF08" + n + "\uFF09";
+}
 function stripBreakingDecorations(s) {
   try {
     let t = String(s !== null && s !== void 0 ? s : "").trim();
@@ -331,26 +345,31 @@ function countsOf(entry) {
     return { Added: 0, Fixed: 0, Changed: 0, Deprecated: 0, Removed: 0, Security: 0 };
   }
 }
-function truncatedNoteHTML(total, shown) {
+function truncatedNoteHTML(total, shown, lang) {
   try {
+    const l = normalizeLangTag(lang ?? "zh");
     const m = Math.floor(total);
     const n = Math.floor(shown);
-    return '<div class="dsh-upd-changelog-count">\u5171 ' + String(m) + " \u6761\uFF0C\u4EC5\u663E\u793A\u524D " + String(n) + " \u6761</div>";
+    const text = copyText("changelog.truncated.count", l, { m: String(m), n: String(n) });
+    return '<div class="dsh-upd-changelog-count">' + escapeChangelogHtml(text) + "</div>";
   } catch {
     return "";
   }
 }
-function yankedBannerHTML(version) {
+function yankedBannerHTML(version, lang) {
   try {
+    const l = normalizeLangTag(lang ?? "zh");
     const v = typeof version === "string" ? version.trim() : "";
     if (!v) return "";
-    return '<div class="dsh-upd-changelog-yanked" role="alert">\u76EE\u6807\u7248\u672C ' + escapeChangelogHtml(v) + " \u5DF2\u88AB\u4F5C\u8005\u64A4\u56DE\uFF08yanked\uFF09\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\uFF0C\u7EE7\u7EED\u524D\u8BF7\u786E\u8BA4\u3002</div>";
+    const text = copyText("changelog.yanked.banner", l, { version: v });
+    return '<div class="dsh-upd-changelog-yanked" role="alert">' + escapeChangelogHtml(text) + "</div>";
   } catch {
     return "";
   }
 }
-function renderChangelogItem(item) {
+function renderChangelogItem(item, lang) {
   try {
+    const l = normalizeLangTag(lang ?? "zh");
     const s = String(item !== null && item !== void 0 ? item : "");
     if (!s) return "";
     const split = splitBreakingPrefix(s);
@@ -358,22 +377,25 @@ function renderChangelogItem(item) {
     const head = escapeChangelogHtml(split.head);
     const prefix = escapeChangelogHtml(split.prefix);
     const rest = escapeChangelogHtml(split.rest);
-    const badge = '<span class="dsh-upd-breaking-badge" role="img" aria-label="\u7834\u574F\u6027\u53D8\u66F4">' + BREAKING_BADGE_TEXT + "</span> ";
+    const badgeText = copyText("changelog.breaking.badge", l);
+    const badgeAria = copyText("changelog.breaking.aria", l);
+    const badge = '<span class="dsh-upd-breaking-badge" role="img" aria-label="' + escapeChangelogHtml(badgeAria) + '">' + escapeChangelogHtml(badgeText) + "</span> ";
     return "<li>" + head + badge + "<strong>" + prefix + "</strong>" + rest + "</li>";
   } catch {
     return "";
   }
 }
-function renderChangelogSection(entry) {
+function renderChangelogSection(entry, lang) {
   try {
     if (!entry || typeof entry !== "object") return "";
     const version = String(entry.version !== void 0 && entry.version !== null ? String(entry.version) : "").trim();
     if (!version || isUnreleasedVersion(version)) return "";
     if (!hasVisibleSections(entry)) return "";
+    const l = normalizeLangTag(lang ?? "zh");
     const dateRaw = entry.date;
     const date = typeof dateRaw === "string" ? dateRaw : "";
     const yankedFlag = entry.yanked === true;
-    const yankedSuffix = yankedFlag ? " \xB7 \u5DF2\u64A4\u56DE" : "";
+    const yankedSuffix = yankedFlag ? copyText("changelog.yanked.suffix", l) : "";
     const title = (date ? version + " \xB7 " + date : version) + yankedSuffix;
     const counts = countsOf(entry);
     const parts = [];
@@ -382,42 +404,44 @@ function renderChangelogSection(entry) {
     for (const cat of CHANGELOG_MUST_SHOW) {
       const items = Array.isArray(entry.sections ? entry.sections[cat] : null) ? entry.sections[cat] : [];
       if (!items || items.length === 0) continue;
-      const label = cat + " \xB7 " + CHANGELOG_CATEGORY_ZH[cat];
+      const label = changelogCategoryLabel(cat, l);
       parts.push('<div class="dsh-upd-changelog-cat" data-cat="' + cat + '">');
       parts.push('<div class="dsh-upd-changelog-catname">' + escapeChangelogHtml(label) + "</div>");
       const total = counts[cat];
       const shown = items.length;
       if (total > shown) {
-        parts.push(truncatedNoteHTML(total, shown));
+        parts.push(truncatedNoteHTML(total, shown, l));
       }
       parts.push("<ul>");
       for (const item of items) {
         if (!item) continue;
-        const li = renderChangelogItem(item);
+        const li = renderChangelogItem(item, l);
         if (li) parts.push(li);
       }
       parts.push("</ul>");
       if (cat === "Security" && total > shown) {
         const restCount = total - shown;
-        parts.push('<details class="dsh-upd-changelog-security-more"><summary>\u5176\u4F59 ' + String(restCount) + ' \u6761</summary><div class="dsh-upd-changelog-more-note">\u4E3A\u4FDD\u6301\u9762\u677F\u6027\u80FD\uFF0C\u5176\u4F59\u6761\u76EE\u5DF2\u6298\u53E0\uFF0C\u53EF\u67E5\u770B\u539F\u6587\u3002</div></details>');
+        const sumText = copyText("changelog.security.summary", l, { n: String(restCount) });
+        const noteText = copyText("changelog.security.note", l);
+        parts.push('<details class="dsh-upd-changelog-security-more"><summary>' + escapeChangelogHtml(sumText) + '</summary><div class="dsh-upd-changelog-more-note">' + escapeChangelogHtml(noteText) + "</div></details>");
       }
       parts.push("</div>");
     }
     for (const cat of CHANGELOG_FOLDED) {
       const items = Array.isArray(entry.sections ? entry.sections[cat] : null) ? entry.sections[cat] : [];
       if (!items || items.length === 0) continue;
-      const label = cat + " \xB7 " + CHANGELOG_CATEGORY_ZH[cat] + "\uFF08" + String(items.length) + "\uFF09";
+      const label = changelogFoldedLabel(cat, items.length, l);
       parts.push('<details class="dsh-upd-changelog-fold" data-cat="' + cat + '">');
       parts.push("<summary>" + escapeChangelogHtml(label) + "</summary>");
       const total = counts[cat];
       const shown = items.length;
       if (total > shown) {
-        parts.push(truncatedNoteHTML(total, shown));
+        parts.push(truncatedNoteHTML(total, shown, l));
       }
       parts.push("<ul>");
       for (const item of items) {
         if (!item) continue;
-        const li = renderChangelogItem(item);
+        const li = renderChangelogItem(item, l);
         if (li) parts.push(li);
       }
       parts.push("</ul></details>");
@@ -428,12 +452,19 @@ function renderChangelogSection(entry) {
     return "";
   }
 }
-function renderChangelogNeutral() {
-  return `<div class="dsh-upd-changelog-neutral">${escapeChangelogHtml(CHANGELOG_NEUTRAL_LINE)}</div>`;
+function renderChangelogNeutral(lang) {
+  try {
+    const l = normalizeLangTag(lang ?? "zh");
+    const text = copyText("changelog.neutral.line", l);
+    return `<div class="dsh-upd-changelog-neutral">${escapeChangelogHtml(text)}</div>`;
+  } catch {
+    return "";
+  }
 }
 function renderChangelogHTML(entries, opts) {
   try {
-    if (!Array.isArray(entries) || entries.length === 0) return renderChangelogNeutral();
+    const l = normalizeLangTag(opts?.lang ?? "zh");
+    if (!Array.isArray(entries) || entries.length === 0) return renderChangelogNeutral(l);
     const from = opts && typeof opts.from === "string" ? opts.from : null;
     const to = opts && typeof opts.to === "string" ? opts.to : null;
     let ranged;
@@ -449,14 +480,19 @@ function renderChangelogHTML(entries, opts) {
         }
       });
     }
-    if (ranged.length === 0) return renderChangelogNeutral();
-    const blocks = ranged.map((e) => renderChangelogSection(e)).filter((s) => !!s);
-    if (blocks.length === 0) return renderChangelogNeutral();
+    if (ranged.length === 0) return renderChangelogNeutral(l);
+    const blocks = ranged.map((e) => renderChangelogSection(e, l)).filter((s) => !!s);
+    if (blocks.length === 0) return renderChangelogNeutral(l);
     return `<div class="dsh-upd-changelog">
 ${blocks.join("\n")}
 </div>`;
   } catch {
-    return renderChangelogNeutral();
+    try {
+      const ll = normalizeLangTag(opts?.lang ?? "zh");
+      return renderChangelogNeutral(ll);
+    } catch {
+      return "";
+    }
   }
 }
 const CHANGELOG_VALIDATE_HINTS = {
@@ -639,6 +675,8 @@ export {
   RE_VERSION_HEADING,
   RE_VERSION_NUM,
   RE_YANKED,
+  changelogCategoryLabel,
+  changelogFoldedLabel,
   changelogForUpdate,
   countsOf,
   hasVisibleSections,

package/dist/diag.d.ts

@@ -31,6 +31,7 @@
  * 构造全程 best-effort：任何一步异常即回 undefined（调用方按无 diag 的旧形状返回，
  * 新面板×旧载荷仍为正常缺省，不抛）。
  */
+import { type AppLang } from './lang.js';
 /** diag 对象版本：只管大门，新增可选键不 bump，面板永不分支于版本。 */
 export declare const DIAG_VERSION = 1;
 /** 阶段枚举（冻结 6 值，与真实接缝对齐）。 */
@@ -67,6 +68,8 @@ export interface DiagInput {
     environmentKind?: unknown;
     /** 本次电话耗时毫秒（只收有限非负数）。 */
     latencyMs?: unknown;
+    /** 人话兜底渲染语言（#66 单语：缺省 zh 零回归；电话侧无 DOM 信号时仍落 zh，面板侧 free-text 英文混入属正常见 #57 v2 非目标）。 */
+    lang?: AppLang | string | null;
 }
 export interface DiagObject {
     v: number;

package/dist/diag.js

@@ -1,6 +1,8 @@
 // AUTO-GENERATED by node build.mjs — DO NOT EDIT. Source: src/diag.ts
 import { DIAG_INLINE_BUDGET_BYTES, diagByteLength, enforceDiagBudget, resolveRegistryHost, sanitizeDetail } from "./redaction.js";
 import { validReleaseVersion, validRequestId } from "./service.js";
+import { copyText } from "./bilingual.js";
+import { normalizeLangTag } from "./lang.js";
 const DIAG_VERSION = 1;
 const DIAG_STAGES = [
   "read-installed",
@@ -116,7 +118,7 @@ function pickEnvironmentKind(raw) {
 function pickId(raw) {
   return typeof raw === "string" && validRequestId(raw) ? raw.trim() : null;
 }
-function pickDetail(errorCode, error, httpStatus, phoneKind) {
+function pickDetail(errorCode, error, httpStatus, phoneKind, lang) {
   try {
     const rawDetail = error?.detail;
     if (typeof rawDetail === "string" && rawDetail.trim()) {
@@ -132,24 +134,34 @@ function pickDetail(errorCode, error, httpStatus, phoneKind) {
     }
     const code = String(errorCode || "");
     const phone = String(phoneKind || "");
-    let fallback = "\u64CD\u4F5C\u5931\u8D25";
-    if (code === "check-failed" && phone === "update-status") fallback = "\u8BFB\u672C\u5730\u72B6\u6001\u6CA1\u6210\u529F";
-    else if ((code === "check-failed" || code === "internal") && phone === "update-install") fallback = "\u88C5\u524D\u91CD\u9A8C\u53D6\u6570\u6CA1\u6210\u529F";
-    else if (code === "check-failed" && httpStatus === 429) fallback = "\u6E90\u8FD4\u56DE 429\uFF0C\u8FD9\u4E00\u5206\u949F\u8BF7\u6C42\u592A\u591A";
-    else if (code === "check-failed" && typeof httpStatus === "number") fallback = `\u6E90\u8FD4\u56DE ${httpStatus}\uFF0C\u91CD\u8BD5\u4ECD\u5931\u8D25`;
-    else if (code === "check-failed" || code === "internal") fallback = "\u67E5\u65B0\u7248\u6CA1\u6210\u529F\uFF08\u8054\u7F51\u3001\u6E90\u3001\u9650\u6D41\u90FD\u53EF\u80FD\uFF09";
-    else if (code === "invalid-release") fallback = "\u6E05\u5355\u91CC\u7684\u7248\u672C\u53F7\u4E0D\u662F\u5408\u6CD5\u7248\u672C";
-    else if (code === "check-expired") fallback = "\u51ED\u8BC1\u8FC7\u671F\u4E86\uFF0C\u5B89\u88C5\u8BF7\u6C42\u88AB\u62D2";
-    else if (code === "update-busy") fallback = "\u540C\u4E00\u4F7F\u7528\u8303\u56F4\u6B63\u5728\u88C5\u53E6\u4E00\u4E2A";
-    else if (code === "install-failed") fallback = "\u5B89\u88C5\u5931\u8D25";
-    else if (code === "unknown-profile") fallback = "\u4F7F\u7528\u8303\u56F4\u6216\u63D2\u4EF6\u4F4D\u7F6E\u8BA4\u4E0D\u51FA";
-    else if (code === "source-install") fallback = "\u5F53\u524D\u662F\u4ECE\u6E90\u7801\u88C5\u7684\uFF0C\u4E0D\u662F\u6309\u7248\u672C\u53F7\u88C5\u7684";
-    else if (code === "invalid-installation") fallback = "\u5DF2\u88C5\u7684\u5305\u4E0D\u5B8C\u6574";
-    else if (code === "installation-changed") fallback = "\u5B89\u88C5\u4F4D\u7F6E\u5728\u4F7F\u7528\u4E2D\u9014\u53D8\u4E86";
-    else if (code === "pending-restart") fallback = "\u65B0\u7248\u5DF2\u88C5\u5230\u78C1\u76D8\uFF0C\u6B63\u5728\u8DD1\u7684\u8FD8\u662F\u65E7\u7248";
-    else if (code === "incompatible-node") fallback = "\u65B0\u7248\u8981\u6C42\u7684 Node \u4E0E\u5F53\u524D\u8FD0\u884C\u7684\u5BF9\u4E0D\u4E0A";
-    else if (code === "registry-conflict") fallback = "\u672C\u5730\u58F0\u660E\u7684\u7248\u672C\u4E0E\u78C1\u76D8\u5B9E\u9645\u7248\u672C\u4E92\u76F8\u77DB\u76FE";
-    else if (code === "recovery-required") fallback = "\u4E0A\u6B21\u5B89\u88C5\u88AB\u6253\u65AD\uFF0C\u7559\u4E0B\u4E00\u4E2A\u534A\u622A\u4EFB\u52A1";
+    const l = normalizeLangTag(lang ?? "zh");
+    let key = "diag.fallback.generic";
+    let values;
+    if (code === "check-failed" && phone === "update-status") key = "diag.fallback.read-installed";
+    else if ((code === "check-failed" || code === "internal") && phone === "update-install") key = "diag.fallback.revalidate-fetch";
+    else if (code === "check-failed" && httpStatus === 429) key = "diag.fallback.rate-limited";
+    else if (code === "check-failed" && typeof httpStatus === "number") {
+      key = "diag.fallback.http-status";
+      values = { status: String(httpStatus) };
+    } else if (code === "check-failed" || code === "internal") key = "panel.failure.check-failed.title";
+    else if (code === "invalid-release") key = "diag.fallback.invalid-release";
+    else if (code === "check-expired") key = "panel.failure.check-expired.title";
+    else if (code === "update-busy") key = "panel.failure.update-busy.title";
+    else if (code === "install-failed") key = "diag.fallback.install-failed";
+    else if (code === "unknown-profile") key = "diag.fallback.unknown-profile";
+    else if (code === "source-install") key = "diag.fallback.source-install";
+    else if (code === "invalid-installation") key = "diag.fallback.invalid-installation";
+    else if (code === "installation-changed") key = "diag.fallback.installation-changed";
+    else if (code === "pending-restart") key = "diag.fallback.pending-restart";
+    else if (code === "incompatible-node") key = "diag.fallback.incompatible-node";
+    else if (code === "registry-conflict") key = "diag.fallback.registry-conflict";
+    else if (code === "recovery-required") key = "diag.fallback.recovery-required";
+    let fallback;
+    try {
+      fallback = copyText(key, l, values);
+    } catch {
+      fallback = copyText("diag.fallback.generic", "zh");
+    }
     const clean = sanitizeDetail(fallback);
     return clean ? clean : null;
   } catch {
@@ -176,7 +188,7 @@ function buildDiag(input) {
     const httpStatus = pickHttpStatus(stage, input?.error);
     const exitCode = pickExitCode(stage, input?.error);
     const latencyMs = pickLatencyMs(input?.latencyMs);
-    const detail = pickDetail(errorCode, input?.error, httpStatus, phoneKind);
+    const detail = pickDetail(errorCode, input?.error, httpStatus, phoneKind, input?.lang ?? "zh");
     const targetPackageName = pickPackageName(input?.targetPackageName);
     const runningVersion = pickVersion(input?.runningVersion);
     const latestVersion = pickVersion(input?.latestVersion);

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';
 /** 批量入口件的形态（与单入口同一套取值）。 */
@@ -38,14 +40,20 @@ export interface UpdateBatchEntryOptions {
     /** 调宿主电话：(phoneName, args) => Promise<reply>。 */
     call: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     variant?: BatchEntryVariant;
-    /** 主题：与单入口/面板同一套（default/archive，d5-paper 为旧别名仍可用）。 */
+    /** 主题：与单入口/面板同一套（default/archive）。 */
     theme?: UpdatePanelTheme;
     /** 缺省 'mount'：进页面静默查一次（只调 .batchStatus，只读）。'never' 则只在用户点击时查。 */
     autoCheck?: BatchEntryAutoCheck;
+    /** 打开面板自动查（#59 D3，透传给批量面板）：缺省 true；面板按用户偏好 > 本选项 > 缺省，并与入口预查共用知识时间戳去重（一击只查一次）。 */
+    checkOnOpen?: boolean;
+    /** 自动继续未终态轮次（#59 Q3，透传给批量面板）：缺省 true，与显式按钮并存。 */
+    autoResume?: boolean;
     /** 缺省 'always'：查完总是开批量面板（见本类型说明）。 */
     openOn?: BatchEntryOpenOn;
     /** 覆盖默认按钮文案（不传就用聚合文案）。 */
     label?: string;
+    /** 语言覆盖（#60 v2）：'zh' | 'en' | { getActive(): string; subscribe?(cb): () => void }，不传即跟随全局信号。 */
+    locale?: LocaleOption;
     /** 可选：键 -> 中文名覆盖（透传给批量面板）。 */
     titles?: Record<string, string>;
     /** 轮询间隔（毫秒，透传给批量面板；缺省 1500，下限 250）。 */
@@ -79,12 +87,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") {
@@ -108,8 +145,8 @@ function mountUpdateBatchEntry(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;
@@ -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,9 @@ function mountUpdateBatchEntry(container, options) {
       onRestartRequested: options.onRestartRequested,
       copyText: options.copyText,
       autoChangelog: options.autoChangelog,
+      locale: localeOpt,
+      checkOnOpen: options.checkOnOpen,
+      autoResume: options.autoResume,
       // 面板点「关闭」即走入口件的完整关闭（收 dialog + 还原按钮 + 重查一次），不再是面板自己停轮询。
       onCloseRequested: () => close(),
       call: panelCall
@@ -283,8 +339,8 @@ function mountUpdateBatchEntry(container, options) {
     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);
@@ -314,6 +370,10 @@ function mountUpdateBatchEntry(container, options) {
   function unmount() {
     if (!mounted) return;
     mounted = false;
+    try {
+      unsubLang();
+    } catch {
+    }
     const opened = panel;
     panel = null;
     panelMode = null;
@@ -332,6 +392,9 @@ function mountUpdateBatchEntry(container, options) {
     } catch {
     }
   }
+  const unsubLang = subscribeLang(() => {
+    render();
+  }, localeOpt);
   try {
     ;
     container.addEventListener?.("click", onClick);
@@ -348,6 +411,10 @@ function mountUpdateBatchEntry(container, options) {
   return { refresh, open, close, label: currentLabel, summary: summaryOf, setTheme, unmount };
 }
 export {
+  batchEntryBilingualHTMLFor,
+  batchEntryBilingualKeyFor,
+  batchEntryBilingualTextFor,
+  batchEntryBilingualValuesFor,
   batchEntryLabelFor,
   batchEntryStateKind,
   batchEntrySummary,