dsh-magpie-connector 0.4.2 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.5.1 — 2026-11-02
+
+- README 中英首屏改用 deviceScaleFactor 3 的静态 PNG（3300x1920 / 2400x2400），替换旧的低分辨率图与 GIF；同时改为 markdown 图片写法，商店详情页可直接渲染。
+- 仅文档与图片调整，无代码/行为变更。
+
+## 0.5.0 — 2026-10-31
+
+- 设置页与速度选择器支持界面语言：新增 `settings.magpie` 的 zh/en 字典（`src/client/locales.ts`），通过 `ctx.locale` 注册并在 `apply()` 绑定；文案不再硬编码中文，跟随 DSH 界面语言（英文界面下为英文）。未绑定翻译器时（单测、无 locale 服务的宿主）仍回退到中文，行为不变。
+- `dsh.client.inject` 与 peer 依赖补 `@deepseek-ai/dsh-client-locale`。
+- 新增字典键集合一致性与中英切换测试（`test/client-locales.test.ts`）。
+
 ## 0.4.2
 
 - **Only the checked line is re-measured.** 0.4.1 refreshed the whole latency pass after a line check, so every saved row's reading changed even though only one line was checked. `GET /api/dsh-magpie-connector/latency` now accepts `?line=<id>`: the host probes just that saved line and returns only its reading, and the settings page merges it into that row while every other row keeps its previous value. Unknown or unsaved ids measure nothing. The full pass on panel open and after a successful save is unchanged, and there is still no polling.

package/README.md

@@ -2,12 +2,11 @@
 
 English · [简体中文](README.zh.md)
 
-<p align="center">
-  <img src="docs/model-picker.png" alt="Model picker grouped by upstream provider: Magpie (Claude), Magpie (GPT), Magpie (deepseek)" width="49%">
-  <img src="docs/settings.png" alt="Settings: the connection line on top, then models grouped by provider with visibility, default effort and usage cards" width="49%">
-</p>
+![Model picker grouped by upstream provider: Magpie (Claude), Magpie (Codex) and Magpie (Deepseek)](docs/model-picker.en.png)
 
-*Left: model picker grouped by upstream provider. Right: Settings → Magpie — the connection line, then per-provider model visibility, default effort and usage cards. Captured from an isolated DSH host with a local mock Magpie gateway; models and accounts are synthetic.*
+![Settings: the connection line on top, then models grouped by provider with visibility, default effort and usage cards](docs/settings.en.png)
+
+*Top: model picker grouped by upstream provider. Bottom: Settings → Magpie — the connection line, then per-provider model visibility, default effort and usage cards. Captured from an isolated DSH host (English UI) with a local mock Magpie gateway; gateway address, models, account and readings are synthetic.*
 
 ![Magpie connector architecture: Web GUI and Host plugin, credentials and settings, Magpie gateway and upstream providers, optionally through Cloudflare Access](docs/architecture.en.svg)
 
@@ -70,6 +69,7 @@ Need another method — custom headers, mTLS, another zero-trust gateway? **Issu
 - **The transport is deliberately narrow.** Host requests go through a private `undici` dispatcher straight to the configured gateway, never through a global proxy dispatcher. Redirects are rejected; only `GET /models`, `POST /responses`, `POST /chat/completions`, `GET /magpie/quotas/cards` and `POST /magpie/quotas/refresh` are allowed; Magpie GUI `/api/*` management endpoints are never called. Provider egress proxies belong in Magpie.
 - **Not supported:** `stop` sequences fail before any network access (`MAGPIE_STOP_UNSUPPORTED`) because Magpie cannot preserve them across every upstream translation. Usage cards and Codex reset credits are display-only; the plugin never calls account-management or reset endpoints.
 - **Secrets stay out of responses and logs.** Gateway-reflected text is redacted with the current key before it can reach the settings API or logs. Files are written `0600`; the settings API reports only `configured` / `writable`.
+- **The interface follows the DSH UI language.** Since 0.5.0 the settings page and the speed menu ship English and Chinese dictionaries and render in the active DSH language (`ctx.locale`); before 0.5.0 the copy was Chinese-only. A host without a locale service (or a unit test) falls back to the Chinese reference set, so stored settings and behaviour are untouched.
 
 ### Code map
 

package/README.zh.md

@@ -2,12 +2,11 @@
 
 [English](README.md) · 简体中文
 
-<p align="center">
-  <img src="docs/model-picker.png" alt="模型选择器：按上游 provider 分组为 Magpie (Claude)、Magpie (GPT)、Magpie (deepseek)" width="49%">
-  <img src="docs/settings.png" alt="设置页：顶部连接线路，下方按 provider 分组的模型可见性、默认 effort 与用量卡片" width="49%">
-</p>
+![模型选择器：按上游 provider 分组为 Magpie (Claude)、Magpie (Codex)、Magpie (Deepseek)](docs/model-picker.png)
 
-*左：按上游 provider 分组的模型选择器；右：设置 → Magpie，顶部连接线路，下方按 provider 分组的模型可见性、默认 effort 与用量卡片。截图来自隔离 DSH 宿主与本地 mock Magpie 网关，模型和账号均为演示数据。*
+![设置页：顶部连接线路，下方按 provider 分组的模型可见性、默认 effort 与用量卡片](docs/settings.png)
+
+*上：按上游 provider 分组的模型选择器；下：设置 → Magpie，顶部连接线路，下方按 provider 分组的模型可见性、默认 effort 与用量卡片。截自隔离 DSH 宿主与本地 mock Magpie 网关，网关地址、模型和账号均为演示数据。*
 
 ![Magpie connector 架构：Web GUI 与 Host 插件、凭据与设置、Magpie 网关与上游 provider，可选经 Cloudflare Access](docs/architecture.zh.svg)
 
@@ -72,6 +71,7 @@ dsh plugin --profile web add dsh-magpie-connector
 - **传输边界刻意收窄。** host 请求经私有 `undici` dispatcher 直连配置的网关，不经过全局代理 dispatcher；拒绝重定向；只允许 `GET /models`、`POST /responses`、`POST /chat/completions`、`GET /magpie/quotas/cards`、`POST /magpie/quotas/refresh`；从不调用 Magpie GUI 的 `/api/*` 管理接口。厂商出站代理在 Magpie 侧配置。
 - **不支持：** 非空 `stop` 序列会在发请求前失败（`MAGPIE_STOP_UNSUPPORTED`），因为 Magpie 无法在所有上游协议转换中保留 stop。用量卡片与 Codex 重置次数只读展示，插件不会调用账号管理或重置端点。
 - **密钥不会进入响应或日志。** 网关反射的文本在进入设置接口或日志之前会用当前 key 脱敏。写盘文件权限 `0600`；设置接口只报告 `configured` / `writable`。
+- **界面跟随 DSH 语言。** 0.5.0 起设置页与速度菜单带中英文字典，按当前 DSH 界面语言渲染（`ctx.locale`）；0.5.0 之前文案只有中文。宿主没有 locale 服务（或单测环境）时回退到中文参考集，已保存设置与行为不受影响。
 
 ### 代码导览
 

package/docs/SCREENSHOTS.md

@@ -1,6 +1,6 @@
 # Screenshots
 
-| file | kind | source | date | reviewer | verdict | note |
-|---|---|---|---|---|---|---|
-| model-picker.png | screenshot | frame 11 of the 2026-10-28 recording (isolated DSH_HOME instance, temp HOME/XDG/DSH_HOME under /tmp, port 3199; local mock Magpie gateway on loopback with demo models; lossless deviceScaleFactor-2 screenshots of the real Web UI, 1500x880 at 1:1), exported losslessly from the global-palette GIF | 2026-10-29 | lead | pass (reviewed frame: demo workspace and mock models only; no hostname, user, path, token or real session) | 106789 bytes; picker open with Magpie (Claude), Magpie (GPT) and Magpie (deepseek) groups; replaces model-picker.gif because the plugin store does not show GIFs by default |
-| settings.png | screenshot | isolated preview home (`git-common-dir/ws/dsh-home/<op>`, port 3202) running the 0.4.0 worktree build against a local loopback mock Magpie gateway (demo models and usage cards); headless Chrome 156 via agent-browser at 1600x1600 CSS pixels | 2026-10-30 | agent (privacy-reviewed; pending lead acceptance) | pass (reviewed: loopback/mock-only addresses 127.0.0.1 and 10.255.255.1, demo@example.com account, demo models and readings; no real hostname, user, key, path, token or session) | 137797 bytes; 0.4.0 connection section with two lines collapsed by default (fast line with 4-bar latency reading, backup line showing timeout), then the claude group with per-model default effort and its usage card with rounded bars; replaces the 0.3.1 screenshot |
+| model-picker.png | screenshot | 0.5.0 build in an isolated DSH_HOME (temp HOME/DSH_HOME under /tmp, port 3399) against a local loopback mock Magpie gateway; Chinese UI; headless Chrome 156 via CDP at deviceScaleFactor 3, region clip 1100x640 | 2026-11-02 | agent (privacy-reviewed; pending lead acceptance) | pass (reviewed: Chinese UI, demo workspace, loopback gateway address, mock models only; no hostname, user, key, path or real session) | 3300x1920, 195233 bytes; model picker open with Magpie (Claude), Magpie (Codex) and Magpie (Deepseek) groups; Chinese README first image |
+| settings.png | screenshot | same 0.5.0 isolated host and mock gateway; Chinese UI; settings dialog region 800x800 at deviceScaleFactor 3 | 2026-11-02 | agent (privacy-reviewed; pending lead acceptance) | pass (reviewed: Chinese settings copy, demo@example.com account, mock models and readings; no hostname, user, key, path or real session) | 2400x2400, 321018 bytes; connection line with latency, 5 models, per-model default effort and the Claude usage card; Chinese README second image |
+| model-picker.en.png | screenshot | same 0.5.0 isolated host and mock gateway; English UI; region clip 1100x640 at deviceScaleFactor 3 | 2026-11-02 | agent (privacy-reviewed; pending lead acceptance) | pass (reviewed: English UI, demo workspace, loopback gateway address, mock models only; no hostname, user, key, path or real session) | 3300x1920, 188924 bytes; English README first image |
+| settings.en.png | screenshot | same 0.5.0 isolated host and mock gateway; English UI; settings dialog region 800x800 at deviceScaleFactor 3 | 2026-11-02 | agent (privacy-reviewed; pending lead acceptance) | pass (reviewed: English settings copy, demo@example.com account, mock models and readings; no hostname, user, key, path or real session) | 2400x2400, 326190 bytes; English README second image |

package/lib/client/SettingsPage.d.ts

@@ -1,15 +1,5 @@
 import { type Api } from './api.js';
 import { type CheckSnapshot, type SettingsView } from './view-model.js';
-/**
- * Magpie settings section: connection (with an advanced access mode), then
- * per-provider groups (model visibility, DSH-side default effort, read-only
- * usage cards). Cards are read once on open or after a connection write; only
- * user refreshes reread upstream usage — each card refreshes itself, and the
- * connection panel offers "获取模型与用量" only while no card is shown.
- */
-export declare const EMPTY_TEXT = "Magpie \u672A\u8FD4\u56DE\u53EF\u89C1\u7528\u91CF";
-export declare const RESTRICTED_HINT = "\u53D7\u9650\u7684 gateway key \u65E0\u6CD5\u8BA9 Magpie \u9996\u6B21\u8BFB\u53D6\u7528\u91CF\uFF1A\u9700\u8981 Magpie \u7BA1\u7406\u5458\u5148\u5728 Magpie \u4E2D\u8BFB\u53D6\u4E00\u6B21\uFF0C\u6216\u8005\u6539\u7528\u4E0D\u53D7\u9650\u7684 key\u3002";
-export declare const NOT_REREAD = "Magpie \u672A\u91CD\u65B0\u8BFB\u53D6\uFF08\u53EF\u80FD\u5904\u4E8E\u8282\u6D41\u95F4\u9694\u5185\uFF09";
 /**
  * Does this submitted list touch the active line's identity? Only then the old usage cards must
  * disappear before the request is even sent (the host writes credentials before awaiting its

package/lib/client/SettingsPage.js

@@ -4,25 +4,22 @@ import { errorText, failureText, isOk } from './api.js';
 import { lineLatency, parseLatency } from './latency.js';
 import { settingsCss } from './styles.js';
 import { UsageCard } from './UsageCard.js';
+import { t } from './locales.js';
 import { cacheIds, cardKey, checkDiff, checkSignature, formatTime, parseCards, parseCheck, providerOrder, readTime, sameTarget, } from './view-model.js';
 /**
  * Magpie settings section: connection (with an advanced access mode), then
  * per-provider groups (model visibility, DSH-side default effort, read-only
  * usage cards). Cards are read once on open or after a connection write; only
  * user refreshes reread upstream usage — each card refreshes itself, and the
- * connection panel offers "获取模型与用量" only while no card is shown.
+ * connection panel offers "Get models and usage" only while no card is shown.
  */
-export const EMPTY_TEXT = 'Magpie 未返回可见用量';
-export const RESTRICTED_HINT = '受限的 gateway key 无法让 Magpie 首次读取用量：需要 Magpie 管理员先在 Magpie 中读取一次，或者改用不受限的 key。';
-export const NOT_REREAD = 'Magpie 未重新读取（可能处于节流间隔内）';
-const SYNC_KIND = { unauthorized: 'key 无效（401）', forbidden: '无权访问（403）', http: '网关错误', unreachable: '无法连接网关', settings: '设置保存失败', registration: '路由注册失败' };
+const SYNC_KIND = { unauthorized: 'syncKindUnauthorized', forbidden: 'syncKindForbidden', http: 'syncKindHttp', unreachable: 'syncKindUnreachable', settings: 'syncKindSettings', registration: 'syncKindRegistration' };
 /** Human labels for the check kinds the host may report. */
 const CHECK_KIND = {
-    ok: '可达', unauthorized: 'key 无效', forbidden: '无权访问', http: '网关错误', redirect: '被重定向',
-    unreachable: '连不上', timeout: '超时', 'invalid-catalog': '目录无法解析', incomplete: '配置不完整',
-    invalid: '请求无效', busy: '已有检查在进行', pending: '宿主正在保存，稍后再试',
+    ok: 'checkKindOk', unauthorized: 'checkKindUnauthorized', forbidden: 'checkKindForbidden', http: 'checkKindHttp', redirect: 'checkKindRedirect',
+    unreachable: 'checkKindUnreachable', timeout: 'checkKindTimeout', 'invalid-catalog': 'checkKindInvalidCatalog', incomplete: 'checkKindIncomplete',
+    invalid: 'checkKindInvalid', busy: 'checkKindBusy', pending: 'checkKindPending',
 };
-const CHECK_UNSUPPORTED = '当前宿主版本不支持线路检查';
 const ACCESS_FIELDS = ['accessClientId', 'accessClientSecret'];
 /**
  * Does this submitted list touch the active line's identity? Only then the old usage cards must
@@ -50,11 +47,14 @@ export function touchesActiveIdentity(lines, view) {
 }
 /** One line of the read-only snapshot: kind, model count, diff against the cache and latency. */
 export function describeCheck(snapshot, diff, lastSyncAt) {
-    const parts = [CHECK_KIND[snapshot.kind] ?? snapshot.kind];
+    const kindKey = CHECK_KIND[snapshot.kind];
+    const parts = [kindKey === undefined ? snapshot.kind : t(kindKey)];
     if (snapshot.kind === 'ok') {
-        parts.push(`${snapshot.modelCount ?? snapshot.models?.length ?? 0} 个模型`);
+        parts.push(t('checkModelCount', { n: snapshot.modelCount ?? snapshot.models?.length ?? 0 }));
         if (diff)
-            parts.push(diff.added.length === 0 && diff.removed.length === 0 ? `与缓存目录一致${lastSyncAt ? `（缓存于 ${formatTime(lastSyncAt)}）` : ''}` : `多 ${diff.added.length} · 少 ${diff.removed.length}`);
+            parts.push(diff.added.length === 0 && diff.removed.length === 0
+                ? (lastSyncAt ? t('checkMatchesCacheAt', { time: formatTime(lastSyncAt) }) : t('checkMatchesCache'))
+                : t('checkDiffCounts', { added: diff.added.length, removed: diff.removed.length }));
     }
     if (snapshot.gatewayStatus !== undefined)
         parts.push(`HTTP ${snapshot.gatewayStatus}`);
@@ -93,7 +93,7 @@ export function MagpieSettings({ api }) {
     };
     /** One measurement per panel open (and after a successful line write); failures stay silent.
      * With `only`, just that saved line is re-measured and merged in — the other rows keep their
-     * reading instead of all flipping to 测速中 (the line-check refresh). */
+     * reading instead of all flipping to the measuring state (the line-check refresh). */
     const readLatency = async (only) => {
         const epoch = ++latencyEpoch.current;
         if (only === undefined)
@@ -101,7 +101,7 @@ export function MagpieSettings({ api }) {
         else
             setLatency(current => current.phase === 'done' ? { phase: 'done', readings: current.readings, measuring: new Set([only]) } : current);
         const settle = () => {
-            // Superseded by a newer pass: drop the stale result but never leave the row stuck on 测速中.
+            // Superseded by a newer pass: drop the stale result but never leave the row stuck on measuring.
             if (only === undefined)
                 return;
             setLatency(current => current.phase === 'done' ? { phase: 'done', readings: current.readings } : current);
@@ -247,7 +247,7 @@ export function MagpieSettings({ api }) {
                 return;
             // A failed refresh is not a card result: keep what was shown and say why.
             if (!isOk(response)) {
-                setUsageAlert(`刷新失败：${failureText(response)}`);
+                setUsageAlert(t('refreshFailed', { reason: failureText(response) }));
                 return;
             }
             const next = parseCards(response.body, response.status);
@@ -256,7 +256,7 @@ export function MagpieSettings({ api }) {
         }
         catch (error) {
             if (epoch === cardsEpoch.current)
-                setUsageAlert(`刷新失败：${errorText(error)}`);
+                setUsageAlert(t('refreshFailed', { reason: errorText(error) }));
         }
         finally {
             if (epoch === cardsEpoch.current) {
@@ -279,9 +279,9 @@ export function MagpieSettings({ api }) {
         }
     };
     const groupNote = (provider) => noteScope === provider ? { notice, alert: usageAlert } : {};
-    return h('div', { className: 'dmg-settings' }, h('style', null, settingsCss), h('p', { className: 'dmg-intro' }, '通过自托管的 Magpie 网关使用模型。用量卡片只读，打开本页时读取一次，之后只在你点击卡片上的刷新时重新读取。'), settingsError ? h('p', { className: 'dmg-error', role: 'alert' }, `无法读取设置：${settingsError}`) : null, settings ? h(Connection, { settings, saving: savingSettings, mutateSettings, api, latency, onRefreshLatency: (lineId) => { void readLatency(lineId); },
+    return h('div', { className: 'dmg-settings' }, h('style', null, settingsCss), h('p', { className: 'dmg-intro' }, t('intro')), settingsError ? h('p', { className: 'dmg-error', role: 'alert' }, t('settingsReadFailed', { error: settingsError })) : null, settings ? h(Connection, { settings, saving: savingSettings, mutateSettings, api, latency, onRefreshLatency: (lineId) => { void readLatency(lineId); },
         usage: h(UsageStatus, { cards, busy, ...(noteScope === undefined ? { notice, alert: usageAlert } : {}), onFetchAll: () => { void fetchAll(); }, saving: savingSettings }) })
-        : settingsError ? null : h('p', { role: 'status', className: 'dmg-hint' }, '正在读取设置…'), ...providerOrder(groups, cardList).map(provider => h(ProviderGroup, {
+        : settingsError ? null : h('p', { role: 'status', className: 'dmg-hint' }, t('readingSettings')), ...providerOrder(groups, cardList).map(provider => h(ProviderGroup, {
         key: provider, provider,
         group: groups.find(g => g.provider === provider),
         settings,
@@ -309,42 +309,41 @@ function noticeAfter(target, before, next) {
  */
 function UsageStatus({ cards, busy, saving, notice, alert, onFetchAll }) {
     const state = !cards ? 'loading' : cards.status !== 'ok' ? cards.status : cards.cards.length ? 'ok' : 'empty';
-    const message = state === 'loading' ? '正在读取用量…'
-        : state === 'forbidden' ? '当前 gateway key 无权读取用量'
-            : state === 'unconfigured' ? '填写网关地址和 key 后才能读取用量'
-                : state === 'error' ? '读取用量失败'
-                    : state === 'empty' ? EMPTY_TEXT : undefined;
+    const message = state === 'loading' ? t('usageReading')
+        : state === 'forbidden' ? t('usageForbidden')
+            : state === 'unconfigured' ? t('usageUnconfigured')
+                : state === 'error' ? t('usageError')
+                    : state === 'empty' ? t('usageEmpty') : undefined;
     const canFetch = state === 'empty' || state === 'error';
     const lines = [
         message ? h('p', { key: 'm', className: state === 'error' || state === 'forbidden' ? 'dmg-error' : 'dmg-hint', role: 'status' }, message) : null,
         cards?.error && state !== 'ok' ? h('p', { key: 'e', className: 'dmg-error' }, cards.error) : null,
-        state === 'empty' && notice === 'restricted' ? h('p', { key: 'r', className: 'dmg-hint' }, RESTRICTED_HINT) : null,
-        notice === 'not-reread' ? h('p', { key: 'n', className: 'dmg-hint', role: 'status' }, NOT_REREAD) : null,
-        busy && canFetch ? h('p', { key: 'b', className: 'dmg-hint', role: 'status' }, '正在请求 Magpie 重新读取…') : null,
+        state === 'empty' && notice === 'restricted' ? h('p', { key: 'r', className: 'dmg-hint' }, t('restrictedHint')) : null,
+        notice === 'not-reread' ? h('p', { key: 'n', className: 'dmg-hint', role: 'status' }, t('notReread')) : null,
+        busy && canFetch ? h('p', { key: 'b', className: 'dmg-hint', role: 'status' }, t('rereading')) : null,
         alert ? h('p', { key: 'a', className: 'dmg-error', role: 'alert', 'data-usage-alert': '' }, alert) : null,
     ].filter(Boolean);
     if (!lines.length && !canFetch)
         return null;
-    return h('div', { className: 'dmg-usage', 'data-usage-state': state, 'aria-label': '用量' }, ...lines, canFetch ? h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: busy || saving, onClick: onFetchAll }, '获取模型与用量')) : null);
+    return h('div', { className: 'dmg-usage', 'data-usage-state': state, 'aria-label': t('usageLabel') }, ...lines, canFetch ? h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: busy || saving, onClick: onFetchAll }, t('fetchModelsAndUsage'))) : null);
 }
 async function postSettings(api, body) {
     try {
         const response = await api({ method: 'POST', path: 'settings', body });
         if (isOk(response))
             return { view: response.body };
-        return { error: response.status === 409 ? 'key 来自启动环境，不能在这里修改' : `未保存：${failureText(response)}` };
+        return { error: response.status === 409 ? t('envKeyReadonly') : t('notSaved', { reason: failureText(response) }) };
     }
     catch (error) {
-        return { error: `未保存：${errorText(error)}` };
+        return { error: t('notSaved', { reason: errorText(error) }) };
     }
 }
-const ACCESS_MODES = [{ id: 'direct', label: '直连' }, { id: 'cloudflare', label: 'Cloudflare Access' }];
-const INFO_TEXT = '线路按序号优先尝试，连不上自动试下一条；绿色方块表示当前线路；多条线路应指向同一个 Magpie 网关；延迟是 TCP 建连耗时（含 DNS 解析），不是网关健康检查。';
+const ACCESS_MODES = [{ id: 'direct', labelKey: 'direct' }, { id: 'cloudflare', labelKey: 'cloudflareAccess' }];
 const hostnameOf = (baseUrl) => { try {
     return new URL(baseUrl).hostname || baseUrl;
 }
 catch {
-    return baseUrl || '未配置';
+    return baseUrl || t('hostnameUnset');
 } };
 function lineDrafts(settings) {
     const configured = (access) => access?.clientId?.configured === true || access?.clientSecret?.configured === true;
@@ -454,7 +453,7 @@ function Connection({ settings, saving, mutateSettings, api, usage, latency, onR
     };
     const savedLabel = (view) => {
         const index = (view.lines ?? []).findIndex(line => line.id === view.activeLineId);
-        return index >= 0 ? `已保存 · 当前线路 ${index + 1}` : '已保存 · 当前无生效线路';
+        return index >= 0 ? t('savedLine', { n: index + 1 }) : t('savedNoActive');
     };
     const save = () => {
         // A save attempt retires every snapshot: the checked draft is about to become the saved one,
@@ -502,7 +501,7 @@ function Connection({ settings, saving, mutateSettings, api, usage, latency, onR
             }
             const snapshot = parseCheck(response.body);
             if (!snapshot) {
-                setCheckErrors(current => ({ ...current, [draft.draftId]: isOk(response) ? '检查结果无法解析' : failureText(response) }));
+                setCheckErrors(current => ({ ...current, [draft.draftId]: isOk(response) ? t('checkUnparsable') : failureText(response) }));
                 return;
             }
             setChecks(current => ({ ...current, [draft.draftId]: { signature, activeLineId: activeId, result: snapshot } }));
@@ -513,7 +512,7 @@ function Connection({ settings, saving, mutateSettings, api, usage, latency, onR
         }
         catch (error) {
             if (epoch === checkEpoch.current)
-                setCheckErrors(current => ({ ...current, [draft.draftId]: `检查失败：${errorText(error)}` }));
+                setCheckErrors(current => ({ ...current, [draft.draftId]: t('checkFailed', { reason: errorText(error) }) }));
         }
         finally {
             if (epoch === checkEpoch.current) {
@@ -528,7 +527,7 @@ function Connection({ settings, saving, mutateSettings, api, usage, latency, onR
         setCheckErrors(current => { const next = { ...current }; delete next[draftId]; return next; });
     };
     const catalogIds = cacheIds(settings.groups);
-    return h('section', { className: 'dmg-panel', 'aria-label': '连接' }, h('div', { className: 'dmg-head' }, h('h3', null, '连接'), h('span', { className: 'dmg-info', role: 'img', tabIndex: 0, 'aria-label': INFO_TEXT, title: INFO_TEXT }, 'ⓘ')), drafts.length === 0 ? h('p', { className: 'dmg-hint' }, '还没有线路。点击「添加线路」填写网关地址与 key。') : null, h('div', { className: 'dmg-lines' }, ...drafts.map((draft, index) => {
+    return h('section', { className: 'dmg-panel', 'aria-label': t('connection') }, h('div', { className: 'dmg-head' }, h('h3', null, t('connection')), h('span', { className: 'dmg-info', role: 'img', tabIndex: 0, 'aria-label': t('infoText'), title: t('infoText') }, 'ⓘ')), drafts.length === 0 ? h('p', { className: 'dmg-hint' }, t('noLines')) : null, h('div', { className: 'dmg-lines' }, ...drafts.map((draft, index) => {
         const entry = checks[draft.draftId];
         const fresh = entry && entry.signature === checkSignature(draft) && entry.activeLineId === activeId ? entry : undefined;
         return h(LineCard, {
@@ -547,11 +546,11 @@ function Connection({ settings, saving, mutateSettings, api, usage, latency, onR
             onCheck: () => { void runCheck(draft); },
             onClearCheck: () => clearCheck(draft.draftId),
         });
-    })), h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: add }, drafts.length ? '添加备用线路' : '添加线路')), h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: saving || !dirty, onClick: save }, saving ? '保存中…' : '保存'), h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: () => { void post({ resync: true }, '已刷新模型列表'); } }, '刷新模型列表')), h(SyncStatus, { settings }), message ? h('p', { className: message.failed ? 'dmg-error' : 'dmg-ok', ...(message.failed ? { role: 'alert' } : {}) }, message.text) : null, usage);
+    })), h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: add }, drafts.length ? t('addBackupLine') : t('addLine'))), h('div', { className: 'dmg-row' }, h('button', { type: 'button', className: 'dmg-button', disabled: saving || !dirty, onClick: save }, saving ? t('saving') : t('save')), h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: () => { void post({ resync: true }, t('modelsRefreshed')); } }, t('refreshModels'))), h(SyncStatus, { settings }), message ? h('p', { className: message.failed ? 'dmg-error' : 'dmg-ok', ...(message.failed ? { role: 'alert' } : {}) }, message.text) : null, usage);
 }
 function iconButton(name, icon, lineLabel, disabled, onClick, reason) {
-    const action = `${name}线路 ${lineLabel}`;
-    const label = disabled && reason ? `${action}（${reason}）` : action;
+    const action = t('lineAction', { action: name, line: lineLabel });
+    const label = disabled && reason ? t('lineActionReason', { action, reason }) : action;
     const button = h('button', { type: 'button', className: 'dmg-icon-button', 'aria-label': label, 'data-action': name, disabled, onClick }, h('span', { className: 'dmg-icon', 'aria-hidden': true }, icon));
     return disabled ? button : h(Tooltip, { label: action, children: button });
 }
@@ -564,36 +563,36 @@ function LatencySlot({ latency }) {
         attrs['data-latency-ms'] = latency.ms === null || latency.ms === undefined ? '' : String(latency.ms);
     }
     const reading = latency.state === 'done' && latency.ms !== null && latency.ms !== undefined;
-    const text = latency.state === 'measuring' ? '测速中…' : latency.state === 'failed' ? '—' : latency.state === 'done' ? (reading ? `${latency.ms} ms` : '超时') : '';
-    const title = latency.state === 'done' ? (reading ? `TCP 建连耗时 ${latency.ms} ms（含 DNS 解析），不是网关健康检查` : '600ms 内未完成 TCP 建连（可能很慢或不可达）') : undefined;
+    const text = latency.state === 'measuring' ? t('latencyMeasuring') : latency.state === 'failed' ? '—' : latency.state === 'done' ? (reading ? `${latency.ms} ms` : t('latencyTimeout')) : '';
+    const title = latency.state === 'done' ? (reading ? t('latencyTitle', { ms: latency.ms ?? 0 }) : t('latencyTitleTimeout')) : undefined;
     return h('span', { ...attrs, ...(title ? { title } : {}) }, reading ? h('span', { className: 'dmg-bars', 'aria-hidden': true, 'data-level': String(level) }, ...[0, 1, 2, 3].map(index => h('i', { key: index, 'data-on': index < level ? 'true' : 'false' }))) : null, h('span', { className: 'dmg-latency-text' }, text));
 }
 function LineCard({ draft, index, total, saving, active, expanded, latency, checking, checkDisabled, check, checkError, diff, lastSyncAt, onToggle, onChange, onMove, onRemove, onCheck, onClearCheck }) {
     const diffParts = diff ? [
-        diff.added.length ? h('p', { key: 'added', className: 'dmg-hint' }, `多出：${diff.added.join('、')}`) : null,
-        diff.removed.length ? h('p', { key: 'removed', className: 'dmg-hint' }, `缺少：${diff.removed.join('、')}`) : null,
+        diff.added.length ? h('p', { key: 'added', className: 'dmg-hint' }, t('diffAdded', { list: diff.added.join(t('listSeparator')) })) : null,
+        diff.removed.length ? h('p', { key: 'removed', className: 'dmg-hint' }, t('diffRemoved', { list: diff.removed.join(t('listSeparator')) })) : null,
     ].filter(Boolean) : [];
     const lineLabel = String(index + 1);
     const bodyId = `dmg-line-body-${draft.draftId}`;
-    return h('div', { className: 'dmg-line', 'data-line-id': draft.id, 'data-draft': draft.id ? undefined : '', 'data-expanded': expanded ? 'true' : 'false' }, h('div', { className: 'dmg-line-head' }, h('button', { type: 'button', className: 'dmg-line-toggle', 'aria-expanded': expanded, ...(expanded ? { 'aria-controls': bodyId } : {}), 'data-toggle': '', onClick: onToggle }, h('span', { className: 'dmg-chevron', 'aria-hidden': true }, h(IconTriangleRightFillRegular, null)), h('span', { className: 'dmg-line-index' }, `线路 ${lineLabel}`), active ? h('span', { className: 'dmg-active', role: 'img', 'aria-label': '当前线路', title: '当前线路', 'data-active-line': draft.id }) : null, draft.id && !draft.complete ? h('span', { className: 'dmg-unset', 'data-line-incomplete': '' }, '未配置') : null, h('span', { className: 'dmg-line-title' }, `${hostnameOf(draft.baseUrl)}${draft.id ? '' : '（未保存）'}`), h(LatencySlot, { latency })), h('div', { className: 'dmg-line-actions' }, iconButton('上移', h(IconChevronUpOutlineRegular, null), lineLabel, saving || index === 0, () => onMove(-1), '已是第一条'), iconButton('下移', h(IconChevronDownOutlineRegular, null), lineLabel, saving || index === total - 1, () => onMove(1), '已是最后一条'), iconButton('删除', h(IconTrashOutlineRegular, null), lineLabel, saving || total <= 1, onRemove, '仅剩一条'))), expanded ? h('div', { className: 'dmg-line-body', id: bodyId }, h('label', { className: 'dmg-field' }, h('span', null, '网关地址（含 /v1）'), h('input', { className: 'dmg-input', value: draft.baseUrl, disabled: saving, placeholder: 'http://127.0.0.1:3425/v1', onChange: (e) => onChange({ baseUrl: e.target.value }) })), h('label', { className: 'dmg-field' }, h('span', null, `Gateway API key · ${draft.keyConfigured ? '已配置' : '未配置'}${draft.keyWritable ? '' : '（来自启动环境，只读）'}`), h('input', { className: 'dmg-input', type: 'password', autoComplete: 'off', value: draft.apiKey, disabled: saving || !draft.keyWritable,
-        placeholder: draft.keyConfigured ? '留空则保持不变' : '必填', onChange: (e) => onChange({ apiKey: e.target.value }) })), h('div', { className: 'dmg-check', 'data-check': '' }, h('div', { className: 'dmg-row' }, h('button', {
+    return h('div', { className: 'dmg-line', 'data-line-id': draft.id, 'data-draft': draft.id ? undefined : '', 'data-expanded': expanded ? 'true' : 'false' }, h('div', { className: 'dmg-line-head' }, h('button', { type: 'button', className: 'dmg-line-toggle', 'aria-expanded': expanded, ...(expanded ? { 'aria-controls': bodyId } : {}), 'data-toggle': '', onClick: onToggle }, h('span', { className: 'dmg-chevron', 'aria-hidden': true }, h(IconTriangleRightFillRegular, null)), h('span', { className: 'dmg-line-index' }, t('lineIndex', { n: lineLabel })), active ? h('span', { className: 'dmg-active', role: 'img', 'aria-label': t('currentLine'), title: t('currentLine'), 'data-active-line': draft.id }) : null, draft.id && !draft.complete ? h('span', { className: 'dmg-unset', 'data-line-incomplete': '' }, t('unconfigured')) : null, h('span', { className: 'dmg-line-title' }, `${hostnameOf(draft.baseUrl)}${draft.id ? '' : t('unsaved')}`), h(LatencySlot, { latency })), h('div', { className: 'dmg-line-actions' }, iconButton(t('moveUp'), h(IconChevronUpOutlineRegular, null), lineLabel, saving || index === 0, () => onMove(-1), t('firstLine')), iconButton(t('moveDown'), h(IconChevronDownOutlineRegular, null), lineLabel, saving || index === total - 1, () => onMove(1), t('lastLine')), iconButton(t('remove'), h(IconTrashOutlineRegular, null), lineLabel, saving || total <= 1, onRemove, t('onlyLine')))), expanded ? h('div', { className: 'dmg-line-body', id: bodyId }, h('label', { className: 'dmg-field' }, h('span', null, t('baseUrlLabel')), h('input', { className: 'dmg-input', value: draft.baseUrl, disabled: saving, placeholder: 'http://127.0.0.1:3425/v1', onChange: (e) => onChange({ baseUrl: e.target.value }) })), h('label', { className: 'dmg-field' }, h('span', null, t('apiKeyLabel', { state: `${draft.keyConfigured ? t('configured') : t('notConfigured')}${draft.keyWritable ? '' : t('readonlyFromEnv')}` })), h('input', { className: 'dmg-input', type: 'password', autoComplete: 'off', value: draft.apiKey, disabled: saving || !draft.keyWritable,
+        placeholder: draft.keyConfigured ? t('keepBlank') : t('required'), onChange: (e) => onChange({ apiKey: e.target.value }) })), h('div', { className: 'dmg-check', 'data-check': '' }, h('div', { className: 'dmg-row' }, h('button', {
         type: 'button', className: 'dmg-button', 'data-check-run': '',
         disabled: saving || checkDisabled || draft.baseUrl.trim() === '', onClick: onCheck,
-    }, checking ? '检查中…' : '检查线路'), check ? h('button', { type: 'button', className: 'dmg-button', disabled: saving || checking, onClick: onClearCheck }, '清除') : null), h('p', { className: 'dmg-hint' }, '只读快照：不改当前线路，也不写入配置。'), checkError ? h('p', { className: 'dmg-error' }, checkError) : null, check ? h('p', { className: 'dmg-check-line', 'data-check-kind': check.kind }, describeCheck(check, diff, lastSyncAt)) : null, check?.reason ? h('p', { className: 'dmg-hint', 'data-check-reason': '' }, check.reason) : null, check?.models?.length ? h('details', { className: 'dmg-check-models' }, h('summary', null, `模型 id（${check.models.length}）`), ...diffParts, h('p', { className: 'dmg-hint' }, check.models.map(model => model.id).join('、'))) : null), h('details', { className: 'dmg-advanced', open: true, 'data-advanced': '' }, h('summary', null, '高级连接'), h('div', { className: 'dmg-advanced-body' }, h('label', { className: 'dmg-field' }, h('span', null, `接入方式${draft.accessWritable ? '' : '（Access 凭据来自启动环境，只读）'}`), h('select', { className: 'dmg-select', 'aria-label': '接入方式', value: draft.accessMode, disabled: saving || !draft.accessWritable,
-        onChange: (e) => onChange({ accessMode: e.target.value }) }, ...ACCESS_MODES.map(mode => h('option', { key: mode.id, value: mode.id }, mode.label)))), draft.accessMode === 'direct'
-        ? h('p', { className: 'dmg-hint' }, draft.savedAccess ? '保存后将清除已保存的 Cloudflare Access 凭据。' : '网关地址可直接访问时选择（局域网、Tailscale 等组网后的地址）。')
-        : h('p', { className: 'dmg-hint' }, '网关在 Cloudflare Access 之后时选择：填写服务令牌的两项，仅支持 HTTPS。留空保持不变。'), ...(draft.accessMode === 'cloudflare' ? [
+    }, checking ? t('checking') : t('checkLine')), check ? h('button', { type: 'button', className: 'dmg-button', disabled: saving || checking, onClick: onClearCheck }, t('clear')) : null), h('p', { className: 'dmg-hint' }, t('checkReadonly')), checkError ? h('p', { className: 'dmg-error' }, checkError) : null, check ? h('p', { className: 'dmg-check-line', 'data-check-kind': check.kind }, describeCheck(check, diff, lastSyncAt)) : null, check?.reason ? h('p', { className: 'dmg-hint', 'data-check-reason': '' }, check.reason) : null, check?.models?.length ? h('details', { className: 'dmg-check-models' }, h('summary', null, t('modelIds', { n: check.models.length })), ...diffParts, h('p', { className: 'dmg-hint' }, check.models.map(model => model.id).join('、'))) : null), h('details', { className: 'dmg-advanced', open: true, 'data-advanced': '' }, h('summary', null, t('advanced')), h('div', { className: 'dmg-advanced-body' }, h('label', { className: 'dmg-field' }, h('span', null, `${t('accessMode')}${draft.accessWritable ? '' : t('accessReadonly')}`), h('select', { className: 'dmg-select', 'aria-label': t('accessMode'), value: draft.accessMode, disabled: saving || !draft.accessWritable,
+        onChange: (e) => onChange({ accessMode: e.target.value }) }, ...ACCESS_MODES.map(mode => h('option', { key: mode.id, value: mode.id }, t(mode.labelKey))))), draft.accessMode === 'direct'
+        ? h('p', { className: 'dmg-hint' }, draft.savedAccess ? t('directHintClears') : t('directHint'))
+        : h('p', { className: 'dmg-hint' }, t('cloudflareHint')), ...(draft.accessMode === 'cloudflare' ? [
         ['Access Client ID', draft.accessClientId, 'accessClientId'],
         ['Access Client Secret', draft.accessClientSecret, 'accessClientSecret'],
-    ].map(([label, value, field]) => h('label', { key: label, className: 'dmg-field' }, h('span', null, `${label} · ${draft.accessConfigured ? '已配置' : '未配置'}${draft.accessWritable ? '' : '（来自启动环境，只读）'}`), h('input', { className: 'dmg-input', type: 'password', autoComplete: 'off', value,
-        disabled: saving || !draft.accessWritable, placeholder: '留空则保持不变',
+    ].map(([label, value, field]) => h('label', { key: label, className: 'dmg-field' }, h('span', null, t('accessFieldLabel', { field: label, state: `${draft.accessConfigured ? t('configured') : t('notConfigured')}${draft.accessWritable ? '' : t('readonlyFromEnv')}` })), h('input', { className: 'dmg-input', type: 'password', autoComplete: 'off', value,
+        disabled: saving || !draft.accessWritable, placeholder: t('keepBlank'),
         onChange: (e) => onChange({ [field]: e.target.value }) }))) : [])))) : null);
 }
 function SyncStatus({ settings }) {
     const count = (settings.groups ?? []).reduce((n, g) => n + g.models.length, 0);
     const rejected = settings.rejectedOwners ?? [];
     const registration = settings.routeRegistrationError;
-    return h('div', { className: 'dmg-meta', 'data-sync': '' }, settings.lastSyncAt ? h('p', null, `共 ${count} 个模型 · 更新于 `, h('time', { dateTime: settings.lastSyncAt }, formatTime(settings.lastSyncAt))) : null, settings.lastSyncError ? h('p', { className: 'dmg-error' }, `同步失败${settings.lastSyncErrorKind ? `（${SYNC_KIND[settings.lastSyncErrorKind] ?? settings.lastSyncErrorKind}）` : ''}：${settings.lastSyncError}`) : null, registration ? h('p', { className: 'dmg-error', role: 'alert' }, `Magpie 路由注册失败（${registration.code}${registration.route ? `，${registration.route}` : ''}）：需重启 Host 后才能恢复。`) : null, settings.knownOwnersReset ? h('p', { className: 'dmg-hint' }, '归属列表已重置：已保存的归属无效，下次同步会重新建立。') : null, settings.ownerLimitReached ? h('p', { className: 'dmg-hint' }, `归属数量已达上限（32 个），以下归属未能加入：${rejected.join('、')}`) : null);
+    return h('div', { className: 'dmg-meta', 'data-sync': '' }, settings.lastSyncAt ? h('p', null, t('modelsCount', { n: count }), h('time', { dateTime: settings.lastSyncAt }, formatTime(settings.lastSyncAt))) : null, settings.lastSyncError ? h('p', { className: 'dmg-error' }, t('syncFailed', { kind: settings.lastSyncErrorKind ? t('syncFailedKind', { kind: t(SYNC_KIND[settings.lastSyncErrorKind] ?? 'syncKindHttp') }) : '', error: settings.lastSyncError })) : null, registration ? h('p', { className: 'dmg-error', role: 'alert' }, t('routeRegistrationFailed', { code: registration.code, route: registration.route ? `, ${registration.route}` : '' })) : null, settings.knownOwnersReset ? h('p', { className: 'dmg-hint' }, t('ownersReset')) : null, settings.ownerLimitReached ? h('p', { className: 'dmg-hint' }, t('ownerLimitReached', { list: rejected.join(t('listSeparator')) })) : null);
 }
 function ProviderGroup({ provider, group, settings, cards, busy, saving, mutateSettings, onRefresh, notice, alert }) {
     const [error, setError] = useState('');
@@ -623,21 +622,21 @@ function ProviderGroup({ provider, group, settings, cards, busy, saving, mutateS
             return { visibleModels: rest };
         });
     };
-    return h('section', { className: 'dmg-panel', 'data-provider': provider, 'aria-label': provider }, h('div', { className: 'dmg-head' }, h('h3', null, provider), group && !following ? h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: follow }, '跟随网关模型列表') : null), group ? h('p', { className: 'dmg-hint' }, following ? '可见性：跟随网关模型列表，新上架的模型自动出现' : '可见性：只显示勾选的模型，新上架的模型默认隐藏') : null, models.length ? h('div', { className: 'dmg-models' }, ...models.map(model => h(ModelLine, {
+    return h('section', { className: 'dmg-panel', 'data-provider': provider, 'aria-label': provider }, h('div', { className: 'dmg-head' }, h('h3', null, provider), group && !following ? h('button', { type: 'button', className: 'dmg-button', disabled: saving, onClick: follow }, t('followCatalog')) : null), group ? h('p', { className: 'dmg-hint' }, following ? t('visibilityFollow') : t('visibilityManual')) : null, models.length ? h('div', { className: 'dmg-models' }, ...models.map(model => h(ModelLine, {
         key: model.id, model, disabled: saving,
         visible: model.visible ?? (following || (saved[provider] ?? []).includes(model.id)),
         effort: settings?.defaultEfforts?.[model.id],
         onVisible: (visible) => setVisible(model, visible),
         onEffort: (effort) => { void post({ defaultEffort: { model: model.id, effort } }); },
-    }))) : null, cards.length ? h('div', { className: 'dmg-cards' }, ...cards.map(card => h(UsageCard, { key: cardKey(card), card, busy, onRefresh: () => onRefresh(card) }))) : null, notice === 'not-reread' ? h('p', { className: 'dmg-hint', role: 'status' }, NOT_REREAD) : null, alert ? h('p', { className: 'dmg-error', role: 'alert', 'data-usage-alert': '' }, alert) : null, error ? h('p', { className: 'dmg-error', role: 'alert' }, error) : null);
+    }))) : null, cards.length ? h('div', { className: 'dmg-cards' }, ...cards.map(card => h(UsageCard, { key: cardKey(card), card, busy, onRefresh: () => onRefresh(card) }))) : null, notice === 'not-reread' ? h('p', { className: 'dmg-hint', role: 'status' }, t('notReread')) : null, alert ? h('p', { className: 'dmg-error', role: 'alert', 'data-usage-alert': '' }, alert) : null, error ? h('p', { className: 'dmg-error', role: 'alert' }, error) : null);
 }
 function ModelLine({ model, visible, effort, disabled, onVisible, onEffort }) {
     const efforts = model.efforts ?? [];
     // Stale = saved but no longer offered by the gateway (design D7: the client judges this itself).
     const stale = effort !== undefined && !efforts.includes(effort);
     const label = model.name || model.id;
-    return h('div', { className: 'dmg-model', 'data-model': model.id }, h('label', null, h('input', { type: 'checkbox', checked: visible, disabled, 'aria-label': `在选择器中显示 ${label}`, onChange: (e) => onVisible(e.target.checked) }), h('span', null, label), model.name && model.name !== model.id ? h('code', null, model.id) : null), efforts.length ? h('select', {
-        className: 'dmg-select', 'aria-label': `${label} 默认 effort`, disabled,
+    return h('div', { className: 'dmg-model', 'data-model': model.id }, h('label', null, h('input', { type: 'checkbox', checked: visible, disabled, 'aria-label': t('showInPicker', { label }), onChange: (e) => onVisible(e.target.checked) }), h('span', null, label), model.name && model.name !== model.id ? h('code', null, model.id) : null), efforts.length ? h('select', {
+        className: 'dmg-select', 'aria-label': t('defaultEffortAria', { label }), disabled,
         value: effort ?? '', onChange: (e) => onEffort(e.target.value === '' ? null : e.target.value),
-    }, h('option', { value: '' }, '默认 effort：不设置'), stale ? h('option', { value: effort, disabled: true }, `${effort}（网关当前不提供，暂不生效）`) : null, ...efforts.map(id => h('option', { key: id, value: id }, id))) : null);
+    }, h('option', { value: '' }, t('defaultEffortNone')), stale ? h('option', { value: effort, disabled: true }, t('effortStale', { effort })) : null, ...efforts.map(id => h('option', { key: id, value: id }, id))) : null);
 }

package/lib/client/SpeedSelect.js

@@ -1,6 +1,7 @@
 import { createElement as h, useEffect, useRef, useState } from 'react';
 import { isOk } from './api.js';
 import { settingsCss } from './styles.js';
+import { t } from './locales.js';
 /**
  * Composer speed control (`conversation.input.right`): standard / fast for
  * models whose gateway catalog advertises the `priority` service tier. The
@@ -51,9 +52,10 @@ export function createSpeedSetter(api, sessionId) {
     return tier => api({ method: 'POST', path: 'speed', body: { session: sessionId, tier } }).then(isOk, () => false);
 }
 const POLL_MS = 3000;
+/** Tier presentation: the labels live in the locale dictionaries, not here. */
 const TIERS = [
-    { id: 'standard', name: '标准', description: '默认速度与用量' },
-    { id: 'fast', name: '快速', description: '请求带 priority 服务档，更快但消耗更多用量' },
+    { id: 'standard', nameKey: 'speedTierStandard', descriptionKey: 'speedTierStandardDescription' },
+    { id: 'fast', nameKey: 'speedTierFast', descriptionKey: 'speedTierFastDescription' },
 ];
 export function SpeedSelect({ loadSpeed, setSpeed, watchModel }) {
     const [state, setState] = useState(null);
@@ -157,17 +159,17 @@ export function SpeedSelect({ loadSpeed, setSpeed, watchModel }) {
         else
             setFailed(true);
     };
-    const label = `速度 · ${TIERS.find(t => t.id === state.tier).name}`;
+    const label = t('speedLabel', { tier: t(TIERS.find(tier => tier.id === state.tier).nameKey) });
     return h('div', {
         ref: rootRef, className: 'dmg-speed', 'data-magpie-speed': '',
         onKeyDown: (event) => { if (event.key === 'Escape' && open) {
             event.preventDefault();
             setOpen(false);
         } },
-    }, h('style', null, settingsCss), failed ? h('span', { className: 'dmg-error', role: 'alert' }, '速度未保存，请重试') : null, open ? h('div', { className: 'dmg-speed-menu', role: 'menu', 'aria-label': '速度' }, ...TIERS.map(tier => h('button', {
+    }, h('style', null, settingsCss), failed ? h('span', { className: 'dmg-error', role: 'alert' }, t('speedSaveFailed')) : null, open ? h('div', { className: 'dmg-speed-menu', role: 'menu', 'aria-label': t('speedMenu') }, ...TIERS.map(tier => h('button', {
         key: tier.id, type: 'button', role: 'menuitemradio', className: 'dmg-speed-item', 'data-tier': tier.id,
         'aria-checked': tier.id === state.tier, disabled: busy, onClick: () => choose(tier.id),
-    }, h('span', null, tier.id === state.tier ? '✓' : ''), h('span', null, tier.name, h('small', null, tier.description))))) : null, h('button', {
+    }, h('span', null, tier.id === state.tier ? '✓' : ''), h('span', null, t(tier.nameKey), h('small', null, t(tier.descriptionKey)))))) : null, h('button', {
         type: 'button', className: 'dmg-speed-trigger', 'aria-haspopup': 'menu', 'aria-expanded': open, title: label, disabled: busy,
         onClick: () => {
             if (open) {

package/lib/client/UsageCard.js

@@ -1,5 +1,6 @@
 import { createElement as h } from 'react';
 import { formatTime, readTime, windowReading } from './view-model.js';
+import { t } from './locales.js';
 /**
  * One read-only usage card. Every gateway string is a React text child (never
  * HTML), absent fields are omitted, and the only control is "刷新" — there is
@@ -7,7 +8,7 @@ import { formatTime, readTime, windowReading } from './view-model.js';
  */
 const time = (raw) => h('time', { dateTime: raw }, formatTime(raw));
 const fact = (field, label, value) => h('span', { 'data-field': field, key: field }, h('b', null, `${label} `), h('span', { 'data-value': '' }, value));
-const scalar = (value) => typeof value === 'boolean' ? (value ? '是' : '否') : String(value);
+const scalar = (value) => typeof value === 'boolean' ? (value ? t('yes') : t('no')) : String(value);
 const present = (value) => value !== undefined && value !== null && value !== '';
 /** Bar colour: ≤70% normal (blue), above 70 and below 90 warn (orange), 90% and above high (red). */
 export const usageLevel = (used) => used >= 90 ? 'high' : used > 70 ? 'warn' : 'normal';
@@ -15,18 +16,18 @@ function WindowRow({ window }) {
     const reading = windowReading(window);
     const showReset = reading !== undefined && window.unlimited !== true && !present(window.display) && present(window.resetsAt);
     const used = typeof window.used === 'number' && reading?.endsWith('%') ? Math.max(0, Math.min(100, window.used)) : undefined;
-    return h('div', { className: 'dmg-window', 'data-window': '' }, h('div', { className: 'dmg-window-line' }, h('span', null, present(window.name) ? h('span', { 'data-window-name': '' }, window.name) : null, present(window.name) && reading !== undefined ? ' ' : null, reading !== undefined ? h('span', { 'data-reading': '' }, reading) : null), showReset ? h('span', null, '重置于 ', time(window.resetsAt)) : null), used !== undefined ? h('div', { className: 'dmg-track', 'aria-hidden': true }, h('div', { className: 'dmg-fill', 'data-level': usageLevel(used), style: { width: `${used}%` } })) : null);
+    return h('div', { className: 'dmg-window', 'data-window': '' }, h('div', { className: 'dmg-window-line' }, h('span', null, present(window.name) ? h('span', { 'data-window-name': '' }, window.name) : null, present(window.name) && reading !== undefined ? ' ' : null, reading !== undefined ? h('span', { 'data-reading': '' }, reading) : null), showReset ? h('span', null, t('usageResetAt'), time(window.resetsAt)) : null), used !== undefined ? h('div', { className: 'dmg-track', 'aria-hidden': true }, h('div', { className: 'dmg-fill', 'data-level': usageLevel(used), style: { width: `${used}%` } })) : null);
 }
 export function UsageCard({ card, busy, onRefresh }) {
     const read = readTime(card);
     const facts = [
-        present(card.user) && fact('user', '账号', card.user),
-        present(card.plan) && fact('plan', '计划', card.plan),
-        present(card.until) && fact('until', '到期', time(card.until)),
-        present(card.renew) && fact('renew', '续订', scalar(card.renew)),
-        present(card.balance) && fact('balance', '余额', scalar(card.balance)),
-        present(read) && fact('readAt', card.asOf !== undefined ? '旧读数 · 读取于' : '读取于', time(read)),
+        present(card.user) && fact('user', t('usageUser'), card.user),
+        present(card.plan) && fact('plan', t('usagePlan'), card.plan),
+        present(card.until) && fact('until', t('usageUntil'), time(card.until)),
+        present(card.renew) && fact('renew', t('usageRenew'), scalar(card.renew)),
+        present(card.balance) && fact('balance', t('usageBalance'), scalar(card.balance)),
+        present(read) && fact('readAt', card.asOf !== undefined ? t('usageReadAtStale') : t('usageReadAt'), time(read)),
     ].filter(Boolean);
     const resets = card.resets;
-    return h('article', { className: 'dmg-card', 'data-card': '' }, h('div', { className: 'dmg-card-title' }, h('strong', null, present(card.name) ? card.name : card.provider), h('button', { type: 'button', className: 'dmg-button', disabled: busy, onClick: onRefresh }, '刷新')), facts.length ? h('div', { className: 'dmg-facts' }, ...facts) : null, ...(card.windows ?? []).map((window, index) => h(WindowRow, { key: index, window })), resets && typeof resets.count === 'number' ? h('div', { className: 'dmg-facts', 'data-field': 'resets' }, h('span', null, h('b', null, '用量限制重置 '), '剩余 ', h('span', { 'data-reset-count': '' }, String(resets.count)), ' 次'), present(resets.until) ? h('span', null, h('b', null, '过期 '), time(resets.until)) : null) : null, present(card.error) ? h('p', { className: 'dmg-error', 'data-field': 'error', role: 'alert' }, card.error) : null);
+    return h('article', { className: 'dmg-card', 'data-card': '' }, h('div', { className: 'dmg-card-title' }, h('strong', null, present(card.name) ? card.name : card.provider), h('button', { type: 'button', className: 'dmg-button', disabled: busy, onClick: onRefresh }, t('refresh'))), facts.length ? h('div', { className: 'dmg-facts' }, ...facts) : null, ...(card.windows ?? []).map((window, index) => h(WindowRow, { key: index, window })), resets && typeof resets.count === 'number' ? h('div', { className: 'dmg-facts', 'data-field': 'resets' }, h('span', null, h('b', null, t('resetCountLabel')), t('resetRemaining'), h('span', { 'data-reset-count': '' }, String(resets.count)), t('resetRemainingSuffix')), present(resets.until) ? h('span', null, h('b', null, t('resetExpiresLabel')), time(resets.until)) : null) : null, present(card.error) ? h('p', { className: 'dmg-error', 'data-field': 'error', role: 'alert' }, card.error) : null);
 }

package/lib/client/index.d.ts

@@ -12,11 +12,20 @@ interface SlotRegistration {
     label?: () => string;
     inject?: (sessionId: string) => unknown;
 }
+/** Minimal locale face: register the dictionaries once and bind a translator. */
+interface LocaleService {
+    register(namespace: string, dictionaries: {
+        zh: Record<string, string>;
+        en: Record<string, string>;
+    }): unknown;
+    bind(namespace: string): (key: string) => string;
+}
 interface ClientContext {
     slots: {
         inject(name: string, register: () => unknown): void;
         register(registration: SlotRegistration, component: unknown): unknown;
     };
+    locale: LocaleService;
     get(name: string): unknown;
     effect(run: () => () => void, label: string): unknown;
 }

package/lib/client/index.js

@@ -2,9 +2,12 @@ import { MagpieSettings } from './SettingsPage.js';
 import { SpeedSelect, createModelWatcher, createSpeedLoader, createSpeedSetter } from './SpeedSelect.js';
 import { createFetchApi } from './api.js';
 import { registerMagpieSettingsNavIcon } from './settings-nav-icon.js';
+import { NS, bindLocale, en, zh } from './locales.js';
 export const name = 'dsh-magpie-connector/client';
-export const inject = ['slots'];
+export const inject = ['slots', 'locale'];
 export function apply(ctx, api = createFetchApi()) {
+    ctx.effect(() => { ctx.locale.register(NS, { zh, en }); return () => { }; }, 'dsh-magpie-connector: dictionaries');
+    bindLocale(ctx.locale.bind(NS));
     const label = () => 'Magpie';
     ctx.effect(() => registerMagpieSettingsNavIcon(label), 'dsh-magpie-connector: settings nav icon');
     ctx.slots.inject('settings.section', () => ctx.slots.register({