@eddyskywalker/dsh-chatgpt-subscription 0.54.0 → 0.55.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## 0.55.0 - 2026-11-02
+
+- **[i18n] 宿主侧也能说中英俄：一条镜像缝把界面语言送进线路名与宿主文案**
+  - **现状**：设置卡与 Hub 早就有 zh/en 两套字典、俄语语言包（#65）也已覆盖 14 个命名空间，但**宿主说的话只有中文**——`providerInfo()` 的线路名、额度失败、429 冷却、登录流程与号池报错全是中文常量，英文/俄语界面照样显示中文。
+  - **缝**：宿主没有 locale 服务，harness 的 `LlmProviderInfo` 也不带语言位。于是由客户端把 `ctx.locale.getSnapshot().active` 镜像到新的 `POST /i18n/locale`（沿用既有同源 POST 校验），宿主侧一个模块级运行时在任何出话时刻读取它。默认语言是 `zh`，没被镜像过的安装保持原话术。
+  - 新增 `src/shared/i18n-contracts.ts`（`zh-CN`→`zh`、`ru-RU`→`ru`、未知→`zh`）与 `src/host/common/i18n/`（运行时、`t()` 插值、三份字典；`en`/`ru` 用 `Record<HostLocaleKey, string>` 由类型强制与中文键集对齐）。
+  - **线路名**：13 个 `providerInfo()` 改走 `localizedProviderName()`；Hub 卡片名与详情页标题改走新增的 `cardName.<id>` 键（三语）。
+  - **文案**：ChatGPT 号池、Antigravity 429、WorkBuddy（登录流程 + 号池）、Qoder（登录 / 令牌 / 额度 / 路由 / 凭据）、Step Code（登录阶段 / 授权地址 / 号池 / 路由 / 凭据）、GLM（额度接口 / 三条 429 冷却 / ZCode 登录全流程 / 路由）的用户可见文案全部入字典；**中文模板逐字保留**，因此既有断言一条未改。
+  - **进度更新**新增 `ru` 语言档（`auto` / `zh` / `en` / `ru`）与 `locale/progress-updates/ru.json`。
+  - 仍为中文（有意保留）：各线路 mapper 与兑换链的**内部诊断**、开发者日志、静态模型目录描述、widget-board 看板文案（后者本身已中英双写在一个字符串里）。
+  - **验证**：`npm run typecheck` 0 错误；全量 Vitest 357 文件 / **6550 项通过**（另有 2 文件 / 9 项跳过）；`lib/` 干净重建后 `npm run build` 与 `npm pack --dry-run` 通过；真机 GUI 三语视觉验收（同 1280×800、深色主题）：中文与改动前逐字一致，English / Русский 下 Hub 卡片名与新增语言档正确切换。
+
 ## 0.54.0 - 2026-11-02
 
 - **[provider parity] 对照官方 Agent / 客户端修复其余线路的能力与性能差异**：

package/lib/client.js

@@ -9319,7 +9319,7 @@ window.__ModuleLoader__.load({
 		* 除 adopt 与 connection/test 外，全部走共享的 { ok, value } 信封，
 		* 因此答案都是裸 DTO——createLineApi 已经把信封拆掉了。
 		*/
-		const api$12 = createLineApi(GLM_CODING_PLAN_ROUTE_PREFIX, "GLM（ZCode 账号）");
+		const api$12 = createLineApi(GLM_CODING_PLAN_ROUTE_PREFIX, GLM_CODING_PLAN_PROVIDER_NAME);
 		const get$2 = api$12.get;
 		const post$3 = api$12.post;
 		function messageOf$2(cause) {
@@ -20327,6 +20327,23 @@ window.__ModuleLoader__.load({
 			if (!response.ok || !envelope.ok) throw new Error(envelope.error?.message ?? "Request failed");
 		}
 		/** Card order on the overview; also the former tab order. */
+		/**
+		* Card name for one provider in the language in force.
+		*
+		* The dictionary owns the name so a language pack can translate it; the
+		* descriptor's literal is what a build without that key renders, and comparing
+		* the lookup against the key itself is how a miss is recognised (the locale
+		* service answers with the key when nothing declares it).
+		*
+		* @param descriptor - Provider whose card is being rendered.
+		* @param t - Bound translator of the hub's namespace.
+		* @returns Localized card name.
+		*/
+		function hubCardName(descriptor, t) {
+			const key = `cardName.${descriptor.id}`;
+			const text = t(key);
+			return text === key ? descriptor.name : text;
+		}
 		const HUB_PROVIDERS = [
 			{
 				id: "chatgpt",
@@ -20534,6 +20551,7 @@ window.__ModuleLoader__.load({
 		function HubProviderCard(props) {
 			const { descriptor, summary, t } = props;
 			const enabled = summary?.enabled ?? true;
+			const cardName = hubCardName(descriptor, t);
 			const annotation = props.toggleError ?? cardAnnotation(summary, descriptor, t);
 			const canToggle = descriptor.setEnabled !== null && (summary?.canToggle ?? true);
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -20542,7 +20560,7 @@ window.__ModuleLoader__.load({
 				className: "dsh-hub-card",
 				"data-enabled": enabled,
 				"aria-label": formatPoolLabel(t("hubCardLabel"), {
-					name: descriptor.name,
+					name: cardName,
 					annotation
 				}),
 				onClick: () => props.onOpen(descriptor.id),
@@ -20558,7 +20576,7 @@ window.__ModuleLoader__.load({
 						className: "dsh-hub-card-copy",
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: "dsh-hub-card-name",
-							children: descriptor.name
+							children: cardName
 						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: `dsh-hub-card-note${props.toggleError !== null || summary?.error === true ? " dsh-hub-note-danger" : ""}`,
 							children: annotation
@@ -20570,7 +20588,7 @@ window.__ModuleLoader__.load({
 							type: "button",
 							role: "switch",
 							"aria-checked": enabled,
-							"aria-label": formatPoolLabel(t(enabled ? "hubSwitchOff" : "hubSwitchOn"), { name: descriptor.name }),
+							"aria-label": formatPoolLabel(t(enabled ? "hubSwitchOff" : "hubSwitchOn"), { name: cardName }),
 							className: "dsh-hub-switch",
 							disabled: props.busy || summary === void 0,
 							onClick: (event) => {
@@ -20907,7 +20925,7 @@ window.__ModuleLoader__.load({
 					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 						className: "dsh-hub-backbar-name",
 						id: "dsh-hub-detail-name",
-						children: descriptor.name
+						children: hubCardName(descriptor, t)
 					})]
 				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 					className: "dsh-hub-detail",
@@ -21118,6 +21136,19 @@ window.__ModuleLoader__.load({
 				stopImportingLabel: "停止导入全部本机登录（当前 {count} 个）",
 				stopImportingBusy: "停止导入中…",
 				stopImportingHint: "停止导入只会让本插件忘记本机 CLI 登录的副本；Codex CLI 自己的登录文件不会被删除或修改。账号池不允许逐条删除借来的凭据，所以这里一次会停止全部导入。",
+				"cardName.chatgpt": "ChatGPT",
+				"cardName.antigravity": "Antigravity",
+				"cardName.command-code": "Command Code",
+				"cardName.kimi-code": "Kimi Code",
+				"cardName.minimax-code": "MiniMax Code",
+				"cardName.glm-coding-plan": "GLM（ZCode 账号）",
+				"cardName.claude": "Claude",
+				"cardName.ollama": "Ollama",
+				"cardName.step-code": "Step Code（Step Plan 订阅）",
+				"cardName.cline-pass": "Cline Pass",
+				"cardName.qoder": "Qoder（订阅）",
+				"cardName.opendesign": "OpenDesign",
+				"cardName.workbuddy": "WorkBuddy",
 				modelChecklistCount: "已启用 {count}/{total}"
 			},
 			en: {
@@ -21315,10 +21346,108 @@ window.__ModuleLoader__.load({
 				stopImportingLabel: "Stop importing all local sign-ins ({count} currently imported)",
 				stopImportingBusy: "Stopping the import…",
 				stopImportingHint: "Stopping the import only makes this plugin forget its copy of the local CLI sign-in; the Codex CLI own sign-in file is never deleted or changed. The account pool does not allow deleting a borrowed credential one at a time, so this stops every import at once.",
+				"cardName.chatgpt": "ChatGPT",
+				"cardName.antigravity": "Antigravity",
+				"cardName.command-code": "Command Code",
+				"cardName.kimi-code": "Kimi Code",
+				"cardName.minimax-code": "MiniMax Code",
+				"cardName.glm-coding-plan": "GLM (ZCode Account)",
+				"cardName.claude": "Claude",
+				"cardName.ollama": "Ollama",
+				"cardName.step-code": "Step Code (Step Plan Subscription)",
+				"cardName.cline-pass": "Cline Pass",
+				"cardName.qoder": "Qoder Subscription",
+				"cardName.opendesign": "OpenDesign",
+				"cardName.workbuddy": "WorkBuddy",
 				modelChecklistCount: "{count}/{total} enabled"
 			}
 		};
 		//#endregion
+		//#region src/shared/i18n-contracts.ts
+		/**
+		* Language ids this plugin speaks, and the one parser that decides which one a
+		* tag means.
+		*
+		* The Host has no locale service of its own: the browser decides the active
+		* language and the Host only learns it because the client mirrors it back. So
+		* both halves must agree on one normalization rule, and this module is it —
+		* shared, dependency-free and identical on both sides of the wire.
+		* @module dsh-chatgpt-subscription/i18n-contracts
+		*/
+		/** Every language this plugin can answer in, in the order a picker shows them. */
+		const SUPPORTED_LOCALES = [
+			"zh",
+			"en",
+			"ru"
+		];
+		/**
+		* Reduce a BCP 47 tag (or anything a caller offers) to one supported language.
+		*
+		* `zh-CN`, `zh_TW` and `ZH` are all `zh`; `ru-RU` is `ru`; an unsupported
+		* language (`fr`, `ja`) and a missing value both fall back to
+		* {@link DEFAULT_LOCALE} rather than throwing — a language hint is never worth
+		* failing a request over.
+		*
+		* @param tag - Candidate tag from a URL, a header, a settings document or an event.
+		* @returns The supported language to answer in.
+		*/
+		function normalizeLocale(tag) {
+			if (typeof tag !== "string") return "zh";
+			const base = tag.trim().toLowerCase().split(/[-_]/)[0];
+			return SUPPORTED_LOCALES.find((id) => id === base) ?? "zh";
+		}
+		//#endregion
+		//#region src/client/common/host-locale-mirror.ts
+		/** How long a switch is coalesced for; one locale change can emit more than once. */
+		const DEBOUNCE_MS = 200;
+		/**
+		* Mirror the active locale into the Host, now and on every later switch.
+		*
+		* @param locale - The plugin context's locale runtime, when the harness has one.
+		* @returns Teardown for the subscription; a no-op when there is no runtime.
+		*/
+		function installHostLocaleMirror(locale) {
+			if (locale === void 0 || typeof locale.getSnapshot !== "function") return () => {};
+			const activeOf = () => {
+				try {
+					return String(locale.getSnapshot().active ?? "");
+				} catch {
+					return "";
+				}
+			};
+			let sent;
+			let timer;
+			let disposed = false;
+			const push = () => {
+				if (disposed) return;
+				const next = normalizeLocale(activeOf());
+				if (next === sent) return;
+				sent = next;
+				fetch(`${ROUTE_PREFIX}/i18n/locale`, {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ locale: next })
+				}).catch(() => {
+					sent = void 0;
+				});
+			};
+			const schedule = () => {
+				if (disposed) return;
+				if (timer !== void 0) clearTimeout(timer);
+				timer = setTimeout(() => {
+					timer = void 0;
+					push();
+				}, DEBOUNCE_MS);
+			};
+			push();
+			const unsubscribe = typeof locale.subscribe === "function" ? locale.subscribe(schedule) : () => {};
+			return () => {
+				disposed = true;
+				if (timer !== void 0) clearTimeout(timer);
+				unsubscribe();
+			};
+		}
+		//#endregion
 		//#region src/client/progress-updates/locales.ts
 		/**
 		* 「进展更新」在 locale 服务里的命名空间。
@@ -21377,6 +21506,7 @@ window.__ModuleLoader__.load({
 			settingsLanguageAuto: "自动（跟随对话）",
 			settingsLanguageZh: "中文",
 			settingsLanguageEn: "English",
+			settingsLanguageRu: "Русский",
 			settingsPanelName: "进展面板",
 			settingsPanelNote: "在右侧栏查看本次会话的全部进展",
 			settingsUnavailable: "这项设置当前不可修改（宿主没有开放配置表单）",
@@ -21423,6 +21553,7 @@ window.__ModuleLoader__.load({
 			settingsLanguageAuto: "Auto (follow the conversation)",
 			settingsLanguageZh: "Chinese",
 			settingsLanguageEn: "English",
+			settingsLanguageRu: "Russian",
 			settingsPanelName: "Progress panel",
 			settingsPanelNote: "See every update from this session in the right sidebar",
 			settingsUnavailable: "This setting cannot be changed right now (the host serves no config form)",
@@ -22212,6 +22343,19 @@ window.__ModuleLoader__.load({
 			stopImportingLabel: "Остановить импорт всех локальных входов (сейчас {count})",
 			stopImportingBusy: "Останавливаем импорт…",
 			stopImportingHint: "Остановка лишь заставляет плагин забыть копию входа локального CLI; собственный файл входа Codex CLI не удаляется и не меняется. Пул аккаунтов не позволяет удалять заимствованные учётные данные по одному, поэтому здесь импорт останавливается сразу для всех.",
+			"cardName.chatgpt": "ChatGPT",
+			"cardName.antigravity": "Antigravity",
+			"cardName.command-code": "Command Code",
+			"cardName.kimi-code": "Kimi Code",
+			"cardName.minimax-code": "MiniMax Code",
+			"cardName.glm-coding-plan": "GLM (аккаунт ZCode)",
+			"cardName.claude": "Claude",
+			"cardName.ollama": "Ollama",
+			"cardName.step-code": "Step Code (подписка Step Plan)",
+			"cardName.cline-pass": "Cline Pass",
+			"cardName.qoder": "Qoder (подписка)",
+			"cardName.opendesign": "OpenDesign",
+			"cardName.workbuddy": "WorkBuddy",
 			modelChecklistCount: "Включено {count}/{total}"
 		};
 		//#endregion
@@ -22793,6 +22937,7 @@ window.__ModuleLoader__.load({
 			settingsLanguageAuto: "Авто (как в диалоге)",
 			settingsLanguageZh: "Китайский",
 			settingsLanguageEn: "English",
+			settingsLanguageRu: "Русский",
 			settingsPanelName: "Панель хода работы",
 			settingsPanelNote: "Показывать все записи этой сессии в правой панели",
 			settingsUnavailable: "Эту настройку сейчас нельзя изменить (Host не предоставляет форму настроек)",
@@ -55234,7 +55379,7 @@ window.__ModuleLoader__.load({
 			const planModePipeline = value.planModePipeline !== false;
 			const dispatchExecutionGuard = value.dispatchExecutionGuard !== false;
 			const threshold = typeof value.progressUpdatesNudgeThreshold === "number" ? value.progressUpdatesNudgeThreshold : 8;
-			const language = value.progressUpdatesLanguage === "zh" || value.progressUpdatesLanguage === "en" ? value.progressUpdatesLanguage : "auto";
+			const language = value.progressUpdatesLanguage === "zh" || value.progressUpdatesLanguage === "en" || value.progressUpdatesLanguage === "ru" ? value.progressUpdatesLanguage : "auto";
 			const [draft, setDraft] = (0, react.useState)(() => String(threshold));
 			(0, react.useEffect)(() => {
 				setDraft(String(threshold));
@@ -55487,6 +55632,10 @@ window.__ModuleLoader__.load({
 									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
 										value: "en",
 										children: translate("settingsLanguageEn")
+									}),
+									/* @__PURE__ */ (0, react_jsx_runtime.jsx)("option", {
+										value: "ru",
+										children: translate("settingsLanguageRu")
 									})
 								]
 							})
@@ -58607,6 +58756,7 @@ window.__ModuleLoader__.load({
 		];
 		function apply(ctx) {
 			installLineLocale(ctx.locale);
+			ctx.effect(() => installHostLocaleMirror(ctx.locale), "dsh-chatgpt-subscription: host locale mirror");
 			installRussianLocale(ctx);
 			ctx.effect(() => ctx.locale.register(NS, dictionaries$2), "dsh-chatgpt-subscription: dictionaries");
 			ctx.effect(() => installStyles(), "dsh-chatgpt-subscription: styles");