dsh-modelscope-pool 0.8.0 → 0.10.0

package/lib/index.js

@@ -11,6 +11,8 @@ import { registerPoolProvider, isChatModel } from './provider.js'
 import { createProxy, quotaLike } from './proxy.js'
 import { createQuotaBook, REGIONS } from './quota.js'
 import { createRouter } from './route.js'
+import { makeT } from './i18n.js'
+import { registerWebAdmin, WEB_ADMIN_PATH } from './web.js'
 
 export const name = 'dsh-modelscope-pool'
 
@@ -264,27 +266,30 @@ export function apply(ctx) {
   let keyFocus = ''
   let keyPage = 0
   let deleteArmed = ''
-  const KEYS_PER_PAGE = 40
+  const KEYS_PER_PAGE = 10
   const pickedKey = () => (keyFocus && pool?.keys.some((k) => k.id === keyFocus) ? keyFocus : '')
 
 
-  /** 模型行的显示：短名当标题，真实 id 当副标题，点了设为默认。 */
-  const modelRowOf = (entry, current) => {
+const modelRowOf = (entry, current, t) => {
     const id = String(entry?.id ?? '')
     const isCurrent = id === current
     const regions = entry?.regions ?? []
-    const where = regions.length > 1 ? '国际版 + 国内版' : REGIONS[regions[0]]?.label ?? '站点未知'
+    const where =
+      regions.length > 1
+        ? `${t('regionAi')} + ${t('regionCn')}`
+        : t.region(regions[0])
     return {
       title: entry?.name || id,
-      subtitle: isCurrent ? `当前默认 · ${where}` : where,
-      trailing: isCurrent ? '当前' : '使用',
+      subtitle: isCurrent ? `${t('currentDefault')} · ${where}` : where,
+      trailing: isCurrent ? t('trailingCurrent') : t('trailingUse'),
       icon: isCurrent ? 'check' : 'model',
       tone: isCurrent ? 'good' : undefined,
       action: { id: 'pick-model', args: { model: id } },
     }
   }
 
-  function buildData() {
+  function buildData(locale) {
+    const t = makeT(locale)
     const s = pool ? pool.status() : { total: 0, available: 0, cooling: 0, keys: [], stats: { requests: 0 } }
     const ids = s.keys.map((k) => k.id)
     const q = quota ? quota.sum(ids) : { available: 0, known: 0 }
@@ -293,34 +298,74 @@ export function apply(ctx) {
     const currentModel = modelEntry?.id ?? model
     const models = (catalog?.entries ?? []).filter((entry) => isChatModel(entry.id))
     const routing = router.snapshot()
-    const routed = routing.blockedPairs > 0 ? `已记下 ${routing.blockedPairs} 个「Key×模型」的失败组合（5 分钟内自动跳过）。` : ''
+    const routed =
+      routing.blockedPairs > 0 ? ` ${t('routed', { n: routing.blockedPairs })}` : ''
     const hint =
       s.total === 0
-        ? '还没有 Key：在魔搭复制令牌（ms- 开头）后点输入框上方的「添加 Key」，也可以在下面直接填。'
+        ? t('hintNoKeys')
         : s.cooling > 0
-          ? `无感切换已开：剩余魔粒低于 2 的 Key 已自动停用到次日 00:01，避免撞 429。到点自动恢复。${routed}`
+          ? `${t('hintCooling')}${routed}`
           : model
-            ? `无感切换已开：模型始终是 ${model}，Key 遇到限流、额度不足、没权限会自动换下一个；魔粒低于 2 的 Key 会提前停用。${routed}`
-            : `点「刷新额度」看剩余魔粒；点下面的模型可以设为默认。${routed}`
+            ? `${t('hintModel', { model })}${routed}`
+            : `${t('hintIdle')}${routed}`
+
     // 扇形图：Key 池的状态分布（可用 / 额度不足 / 令牌无效 / 其他冷却）
-    const buckets = { 可用: 0, 额度不足: 0, 令牌无效: 0, '其他冷却': 0 }
-    for (const k of s.keys) {
-      if (k.state === 'ok') buckets['可用']++
-      else if (k.reason === '额度不足' || k.reason === '额度用尽') buckets['额度不足']++
-      else if (k.reason === '令牌无效') buckets['令牌无效']++
-      else buckets['其他冷却']++
-    }
-    const shareCategories = Object.keys(buckets).filter((name) => buckets[name] > 0)
-    const shareValues = shareCategories.map((name) => buckets[name])
+    const order = [
+      ['ready', t('bucketReady'), (k) => k.state === 'ok'],
+      [
+        'low',
+        t('bucketLow'),
+        (k) => k.reason === '额度不足' || k.reason === '额度用尽',
+      ],
+      ['invalid', t('bucketInvalid'), (k) => k.reason === '令牌无效'],
+      [
+        'other',
+        t('bucketOther'),
+        (k) => k.state !== 'ok' && !['额度不足', '额度用尽', '令牌无效'].includes(k.reason),
+      ],
+    ]
+    const counts = order.map(([key, label, test]) => ({
+      key,
+      label,
+      value: s.keys.filter(test).length,
+    }))
+    const live = counts.filter((row) => row.value > 0)
+    const lowCount = counts.find((row) => row.key === 'low')?.value ?? 0
+    const readyCount = counts.find((row) => row.key === 'ready')?.value ?? 0
     const share = {
       kind: 'donut',
-      categories: shareCategories,
-      series: [{ name: 'Key', values: shareValues }],
-      unit: '个',
+      categories: live.map((row) => row.label),
+      series: [{ name: 'Key', values: live.map((row) => row.value) }],
+      unit: t('unitKey'),
       caption:
         s.total === 0
-          ? '还没有 Key'
-          : `共 ${s.total} 个 Key：可用 ${buckets['可用']}，额度不足 ${buckets['额度不足']}，其余冷却中`,
+          ? t('captionNoKeys')
+          : t('captionTotal', { total: s.total, ok: readyCount, low: lowCount }),
+    }
+
+    // 魔粒估算：每个 Key 按满额 250 计，剩余取各 Key 剩余之和（没查到的按满额算，不凭空记「已用」）。
+    const MAGIC_PER_KEY = 250
+    const magicTotal = s.total * MAGIC_PER_KEY
+    const magicUnknown = Math.max(0, s.total - q.known)
+    const magicLeft = q.known > 0 ? q.available + magicUnknown * MAGIC_PER_KEY : magicTotal
+    const magicUsed = Math.max(0, magicTotal - magicLeft)
+    const magic = {
+      total: magicTotal,
+      left: magicLeft,
+      used: magicUsed,
+      caption:
+        s.total === 0
+          ? t('magicCaptionEmpty')
+          : t('magicCaption', {
+              total: magicTotal,
+              keys: s.total,
+              per: MAGIC_PER_KEY,
+              left: magicLeft,
+              used: magicUsed,
+            }),
+      brief: t('magicBarCaption', { left: magicLeft, total: magicTotal }),
+      categories: [t('magicLeft'), t('magicUsed')],
+      series: [{ name: 'Magicubes', values: [magicLeft, magicUsed] }],
     }
 
     const pageCount = Math.max(1, Math.ceil(s.total / KEYS_PER_PAGE))
@@ -336,84 +381,123 @@ export function apply(ctx) {
       ? {
           title: `${focusRow.id} · ${focusRow.masked}`,
           rows: [
-            ['完整令牌', focusRaw?.key ?? '—'],
-            ['版本', REGIONS[focusRow.region]?.label ?? '版本未知'],
+            [t('rowToken'), focusRaw?.key ?? '—'],
+            [t('rowSite'), t.region(focusRow.region)],
             [
-              '额度',
+              t('rowQuota'),
               focusState?.ok
-                ? `${focusState.available} 魔粒（总额 ${focusState.total}，冻结 ${focusState.frozen}）`
+                ? t('quotaDetail', {
+                    n: focusState.available,
+                    total: focusState.total,
+                    frozen: focusState.frozen,
+                  })
                 : focusState
-                  ? `查询失败：${focusState.error}`
-                  : '还没查过',
+                  ? t('quotaFailed', { error: focusState.error })
+                  : t('quotaNever'),
             ],
             [
-              '状态',
+              t('rowState'),
               focusRow.state === 'ok'
-                ? '可用'
+                ? t('stateReady')
                 : focusRow.manual
-                  ? `已禁用（点「恢复」放开）`
-                  : `${focusRow.reason || '冷却中'}${focusRow.untilAt ? ` · 冷却至 ${fmtCN(focusRow.untilAt)}` : ''}`,
+                  ? t('stateManual')
+                  : `${t.reason(focusRow.reason) || t('hintKeyFallback')}${
+                      focusRow.untilAt ? ` · ${t('coolingUntil', { time: fmtCN(focusRow.untilAt) })}` : ''
+                    }`,
+            ],
+            [
+              t('rowFails'),
+              t('failsDetail', {
+                n: focusRow.fails,
+                error: focusRow.lastError || t('none'),
+                used: focusRow.used ? t('usedSuffix', { n: focusRow.used }) : '',
+              }),
             ],
-            ['失败', `${focusRow.fails} 次 · ${focusRow.lastError || '无'}${focusRow.used ? ` · 用过 ${focusRow.used} 次` : ''}`],
           ],
-          hint: '「禁用」= 一直停到点恢复；「停用」= 停到北京时间次日 00:01；「删除」会把令牌从本机文件里去掉。',
+          hint: t('hintKeyDetail'),
         }
-      : { title: '还没选中 Key（回「Key 列表」点一行）', rows: [], hint: '' }
+      : { title: t('focusEmpty'), rows: [], hint: '' }
 
     // 模型列表按站点分组：国际版 → 国内版 → 双站，名字用短名。
     const modelRows = []
-    const modelOrder = ['ai', 'cn']
-    for (const region of modelOrder) {
+    for (const region of ['ai', 'cn']) {
       const group = models.filter((entry) => entry.regions?.length === 1 && entry.regions[0] === region)
       if (group.length === 0) continue
-      modelRows.push({ title: REGIONS[region]?.label ?? region, icon: 'globe', tone: 'info', subtitle: `${group.length} 个模型` })
-      for (const entry of group) modelRows.push(modelRowOf(entry, currentModel))
+      modelRows.push({
+        title: t.region(region),
+        icon: 'globe',
+        tone: 'info',
+        subtitle: t('groupCount', { n: group.length }),
+      })
+      for (const entry of group) modelRows.push(modelRowOf(entry, currentModel, t))
     }
     const both = models.filter((entry) => (entry.regions?.length ?? 0) > 1)
     if (both.length > 0) {
-      modelRows.push({ title: '国际版 + 国内版都有', icon: 'globe', tone: 'info', subtitle: `${both.length} 个模型` })
-      for (const entry of both) modelRows.push(modelRowOf(entry, currentModel))
+      modelRows.push({
+        title: t('groupBoth'),
+        icon: 'globe',
+        tone: 'info',
+        subtitle: t('groupCount', { n: both.length }),
+      })
+      for (const entry of both) modelRows.push(modelRowOf(entry, currentModel, t))
     }
     const unknownRegion = models.filter((entry) => (entry.regions?.length ?? 0) === 0)
     if (unknownRegion.length > 0) {
-      modelRows.push({ title: '站点未知', icon: 'globe', tone: 'info', subtitle: `${unknownRegion.length} 个模型` })
-      for (const entry of unknownRegion) modelRows.push(modelRowOf(entry, currentModel))
+      modelRows.push({
+        title: t('groupUnknown'),
+        icon: 'globe',
+        tone: 'info',
+        subtitle: t('groupCount', { n: unknownRegion.length }),
+      })
+      for (const entry of unknownRegion) modelRows.push(modelRowOf(entry, currentModel, t))
     }
 
     return {
       available: s.available,
       cooling: s.cooling,
       share,
+      shareTitle: t('shareTitle'),
       magicubes: q.known > 0 ? String(q.available) : '—',
+      magic,
       endpoint: endpoint(),
       hint,
       modelTitle:
         models.length === 0
-          ? '模型（还没读到，点下面「重新拉取模型」）'
-          : `${models.length} 个模型 · 当前 ${modelEntry?.name ?? (model || '未选')}`,
+          ? t('modelsTitleEmpty')
+          : t('modelsTitleCount', {
+              n: models.length,
+              current: modelEntry?.name ?? model ?? t('modelNotPicked'),
+            }),
       keyTitle:
         s.total === 0
-          ? 'Key 池（还没有 Key）'
-          : `Key 池 ${s.total} 个 · 第 ${pageNo}/${pageCount} 页（点一行看详情）`,
-      keyPager: s.total > KEYS_PER_PAGE ? `第 ${pageNo}/${pageCount} 页 · 每页 ${KEYS_PER_PAGE} 个` : '',
+          ? t('keyTitleEmpty')
+          : t('keyTitlePage', { total: s.total, page: pageNo, pages: pageCount }),
+      keyPager:
+        s.total > KEYS_PER_PAGE
+          ? t('keyPager', { page: pageNo, pages: pageCount, size: KEYS_PER_PAGE })
+          : '',
       keys: pageKeys.map((k) => {
         const state = quota?.cached(k.id)
-        const used = `用过 ${k.used} 次`
-        const money = state?.ok ? `额度 ${state.available} 魔粒` : state && !state.ok ? `额度未知（${state.error.slice(0, 24)}）` : '额度未查'
-        const region = REGIONS[k.region]?.label ?? '版本未知'
+        const used = t('usedTimes', { n: k.used })
+        const money = state?.ok
+          ? t('quotaLeft', { n: state.available })
+          : state && !state.ok
+            ? t('quotaUnknown', { error: String(state.error).slice(0, 24) })
+            : t('quotaUnchecked')
+        const region = t.region(k.region)
         return {
-          title: `${k.id} · ${k.masked}${k.id === keyFocus ? '（已选中）' : ''}`,
+          title: `${k.id} · ${k.masked}${k.id === keyFocus ? t('selectedMark') : ''}`,
           subtitle: k.reason
-            ? `${k.reason}（失败 ${k.fails} 次）· ${money} · ${region}`
+            ? `${t.reason(k.reason)}（${t('failTimes', { n: k.fails })}）· ${money} · ${region}`
             : `${money} · ${region} · ${used}`,
           trailing:
             k.state === 'ok'
-              ? '可用'
+              ? t('stateReady')
               : k.manual
-                ? '已禁用'
+                ? t('stateDisabled')
                 : k.untilAt
-                  ? `冷却至 ${fmtCN(k.untilAt)}`
-                  : `冷却 ${fmtLeft(k.leftMs)}`,
+                  ? t('coolingUntil', { time: fmtCN(k.untilAt) })
+                  : t('coolingLeft', { time: fmtLeft(k.leftMs) }),
           icon: k.state === 'ok' ? 'cloud' : k.manual ? 'remove' : 'time',
           tone: k.state === 'ok' ? 'good' : k.manual ? 'bad' : 'warn',
           action: { id: 'key-open', args: { id: k.id } },
@@ -423,110 +507,129 @@ export function apply(ctx) {
       models: modelRows,
     }
   }
-
-  const viewPool = {
-    v: 2,
-    type: 'stack',
-    title: '魔搭 Key 池',
-    accent: 'teal',
-    children: [
-      {
-        type: 'row',
-        children: [
-          { type: 'metric', label: '可用', value: { $: 'data.available' }, tone: 'good' },
-          { type: 'metric', label: '冷却', value: { $: 'data.cooling' }, tone: 'warn' },
-          { type: 'metric', label: '魔粒', value: { $: 'data.magicubes' }, tone: 'info' },
-        ],
-      },
-      {
-        type: 'chart',
-        kind: 'donut',
-        categories: { $: 'data.share.categories' },
-        series: { $: 'data.share.series' },
-        caption: { $: 'data.share.caption' },
-      },
-      { type: 'callout', tone: 'info', text: { $: 'data.hint' } },
-      { type: 'text', text: { $: 'data.keyTitle' }, style: { size: 'title', weight: 'bold' } },
-      { type: 'list', items: { $: 'data.keys' } },
-      {
-        type: 'actions',
-        items: [
-          { label: '上一页', icon: 'collapse', action: { id: 'key-prev' } },
-          { label: '下一页', icon: 'expand', action: { id: 'key-next' } },
-        ],
-      },
-      {
-        type: 'actions',
-        items: [
-          { label: '刷新额度', icon: 'refresh', action: { id: 'refresh' } },
-          { label: '测试全部', icon: 'bolt', action: { id: 'test-all' } },
-          { label: '全部恢复', icon: 'play', action: { id: 'restore-all' } },
-        ],
-      },
-      { type: 'text', text: { $: 'data.focusTitle' }, tone: 'muted' },
-      {
-        type: 'form',
-        submitLabel: '添加',
-        submit: 'add-form',
-        children: [{ type: 'textField', label: '添加 Key', bind: 'data.newKey', placeholder: '粘贴 ms- 开头的令牌，可多行' }],
-      },
-    ],
+  const viewPool = (scope, caps) => {
+    const t = makeT(caps?.locale)
+    return {
+      v: 2,
+      type: 'stack',
+      title: t('poolTitle'),
+      accent: 'teal',
+      children: [
+        {
+          type: 'row',
+          children: [
+            { type: 'metric', label: t('metricReady'), value: { $: 'data.available' }, tone: 'good' },
+            { type: 'metric', label: t('metricCooling'), value: { $: 'data.cooling' }, tone: 'warn' },
+            { type: 'metric', label: t('metricMagicubes'), value: { $: 'data.magicubes' }, tone: 'info' },
+          ],
+        },
+        {
+          type: 'progress',
+          label: t('magicLabel'),
+          value: { $: 'data.magic.left' },
+          max: { $: 'data.magic.total' },
+          caption: { $: 'data.magic.brief' },
+          tone: 'good',
+        },
+        { type: 'callout', tone: 'info', text: { $: 'data.hint' } },
+        { type: 'text', text: { $: 'data.keyTitle' }, style: { size: 'title', weight: 'bold' } },
+        { type: 'list', items: { $: 'data.keys' } },
+        {
+          type: 'actions',
+          items: [
+            { label: t('btnRefresh'), icon: 'refresh', action: { id: 'refresh' } },
+            { label: t('btnTestAll'), icon: 'bolt', action: { id: 'test-all' } },
+            { label: t('btnRestoreAll'), icon: 'play', action: { id: 'restore-all' } },
+          ],
+        },
+        {
+          type: 'actions',
+          items: [
+            { label: t('btnPrev'), icon: 'collapse', action: { id: 'key-prev' } },
+            { label: t('btnNext'), icon: 'expand', action: { id: 'key-next' } },
+          ],
+        },
+        {
+          type: 'form',
+          submitLabel: t('formSubmit'),
+          submit: 'add-form',
+          children: [
+            {
+              type: 'textField',
+              label: t('fieldLabel'),
+              bind: 'data.newKey',
+              placeholder: t('fieldPlaceholder'),
+            },
+          ],
+        },
+      ],
+    }
   }
 
-  const viewKey = {
-    v: 2,
-    type: 'stack',
-    title: 'Key 详情',
-    children: [
-      { type: 'text', text: { $: 'data.title' }, style: { size: 'title', weight: 'bold' } },
-      { type: 'keyValue', items: { $: 'data.rows' } },
-      {
-        type: 'actions',
-        items: [
-          { label: '禁用', icon: 'remove', action: { id: 'key-disable' } },
-          { label: '停用', icon: 'clock', action: { id: 'key-stop' } },
-          { label: '恢复', icon: 'play', action: { id: 'key-restore' } },
-          { label: '删除', icon: 'delete', action: { id: 'key-delete' } },
-        ],
-      },
-      { type: 'callout', tone: 'warn', text: { $: 'data.hint' } },
-      { type: 'actions', items: [{ label: '返回 Key 列表', icon: 'list', action: { id: 'key-back' } }] },
-    ],
+  const viewKey = (scope, caps) => {
+    const t = makeT(caps?.locale)
+    return {
+      v: 2,
+      type: 'stack',
+      title: t('keyPanelTitle'),
+      children: [
+        { type: 'text', text: { $: 'data.title' }, style: { size: 'title', weight: 'bold' } },
+        { type: 'keyValue', items: { $: 'data.rows' } },
+        {
+          type: 'actions',
+          items: [
+            { label: t('btnDisable'), icon: 'remove', action: { id: 'key-disable' } },
+            { label: t('btnStop'), icon: 'clock', action: { id: 'key-stop' } },
+            { label: t('btnRestore'), icon: 'play', action: { id: 'key-restore' } },
+            { label: t('btnDelete'), icon: 'delete', action: { id: 'key-delete' } },
+          ],
+        },
+        { type: 'callout', tone: 'warn', text: { $: 'data.hint' } },
+        { type: 'actions', items: [{ label: t('btnBack'), icon: 'list', action: { id: 'key-back' } }] },
+      ],
+    }
   }
 
-  const viewModels = {
-    v: 2,
-    type: 'stack',
-    title: '魔搭模型',
-    children: [
-      { type: 'text', text: { $: 'data.modelTitle' }, style: { size: 'title', weight: 'bold' } },
-      { type: 'list', items: { $: 'data.models' } },
-      { type: 'actions', items: [{ label: '重新拉取模型', icon: 'refresh', action: { id: 'refresh-models' } }] },
-    ],
+  const viewModels = (scope, caps) => {
+    const t = makeT(caps?.locale)
+    return {
+      v: 2,
+      type: 'stack',
+      title: t('modelsPanelTitle'),
+      children: [
+        { type: 'text', text: { $: 'data.modelTitle' }, style: { size: 'title', weight: 'bold' } },
+        { type: 'list', items: { $: 'data.models' } },
+        { type: 'actions', items: [{ label: t('btnReloadModels'), icon: 'refresh', action: { id: 'refresh-models' } }] },
+      ],
+    }
   }
 
-  const buildPoolData = () => {
-    const d = buildData()
+  const buildPoolData = (locale) => {
+    const d = buildData(locale)
     return {
       available: d.available,
       cooling: d.cooling,
       magicubes: d.magicubes,
       share: d.share,
+      magic: d.magic,
       hint: d.hint,
       keyTitle: d.keyTitle,
       keys: d.keys,
       focusTitle: d.focus.title,
     }
   }
-  const buildKeyData = () => {
-    const d = buildData()
-    return { title: d.focus.title, rows: d.focus.rows, hint: d.focus.hint || '回到「魔搭 Key 池」面板，点列表里任意一行就会选中它。' }
+  const buildKeyData = (locale) => {
+    const d = buildData(locale)
+    return {
+      title: d.focus.title,
+      rows: d.focus.rows,
+      hint: d.focus.hint || makeT(locale)('hintKeyFallback'),
+    }
   }
-  const buildModelsData = () => {
-    const d = buildData()
+  const buildModelsData = (locale) => {
+    const d = buildData(locale)
     return { modelTitle: d.modelTitle, models: d.models }
   }
-
   /** 从粘贴的内容里抠出所有令牌：一行一个也行，逗号/空格混着也行。 */
   const parseKeys = (raw) =>
     String(raw ?? '')
@@ -535,11 +638,12 @@ export function apply(ctx) {
       .filter((t) => /^ms-[A-Za-z0-9._-]{8,}$/.test(t))
       .filter((t, i, arr) => arr.indexOf(t) === i)
 
-  const addKey = async (raw) => {
+  const addKey = async (raw, locale) => {
+    const t = makeT(locale)
     const text = String(raw ?? '').trim()
-    if (!text) return { toast: '没读到 Key' }
+    if (!text) return { toast: t('toastNoInput') }
     const tokens = parseKeys(text)
-    if (tokens.length === 0) return { toast: '这不像魔搭令牌（应以 ms- 开头）' }
+    if (tokens.length === 0) return { toast: t('toastNotMs') }
 
     const added = []
     const skipped = []
@@ -548,9 +652,9 @@ export function apply(ctx) {
       if (result.ok) added.push({ id: result.id, token })
       else skipped.push(result.error)
     }
-    if (added.length === 0) return { toast: skipped[0] ?? '没有新增 Key' }
+    if (added.length === 0) return { toast: skipped[0] ?? t('toastNoNew') }
 
-    // 加进来就逐个问额度接口：既能认出国际版/大陆版，也能当场发现令牌无效或额度不够。
+    // 加进来就逐个问额度接口：既能认出站点，也能当场发现令牌无效或额度不够。
     const regions = { ai: 0, cn: 0 }
     let invalid = 0
     let low = 0
@@ -558,7 +662,7 @@ export function apply(ctx) {
       const state = await quota.refreshOne(id, token, { force: true })
       if (!state?.ok) {
         invalid++
-        pool.markFailure(id, '令牌无效', String(state?.error ?? '').slice(0, 80))
+        pool.markFailure(id, '\u4ee4\u724c\u65e0\u6548', String(state?.error ?? '').slice(0, 80))
         continue
       }
       if (state.region) {
@@ -571,13 +675,13 @@ export function apply(ctx) {
     refreshPanel()
     refreshStrip()
 
-    const bits = [`新增 ${added.length} 个`]
-    if (regions.ai > 0) bits.push(`国际版 ${regions.ai}`)
-    if (regions.cn > 0) bits.push(`国内版 ${regions.cn}`)
-    if (low > 0) bits.push(`${low} 个额度不足已停用`)
-    if (invalid > 0) bits.push(`${invalid} 个令牌无效`)
-    if (skipped.length > 0) bits.push(`${skipped.length} 个重复跳过`)
-    return { toast: bits.join('｜') }
+    const bits = [t('addDone', { n: added.length })]
+    if (regions.ai > 0) bits.push(t('addIntl', { n: regions.ai }))
+    if (regions.cn > 0) bits.push(t('addCn', { n: regions.cn }))
+    if (low > 0) bits.push(t('addLow', { n: low }))
+    if (invalid > 0) bits.push(t('addInvalid', { n: invalid }))
+    if (skipped.length > 0) bits.push(t('addSkipped', { n: skipped.length }))
+    return { toast: bits.join(t('joinArrow')) }
   }
 
   ctx.inject(['dshGo'], (dshCtx) => {
@@ -595,14 +699,14 @@ export function apply(ctx) {
       } catch {}
     }
 
-    /** 面板数据推流的通用外壳：内容变了才重绘，面板一关就停。 */
-    const panelData = (build) => (scope, emit) => {
+/** 面板数据推流的通用外壳：内容变了才重绘，面板一关就停。 */
+    const panelData = (build) => (scope, emit, caps) => {
         let stopped = false
         let lastJson = ''
         const tick = () => {
           if (stopped) return
           try {
-            const payload = build()
+            const payload = build(caps?.locale)
             const json = JSON.stringify(payload)
             if (json === lastJson) return // 没有变化就不重绘，界面元素保持稳定
             lastJson = json
@@ -625,18 +729,23 @@ export function apply(ctx) {
     }
 
     const panelActions = {
-        async refresh() {
+        async refresh(scope, event) {
+          const t = makeT(event?.locale)
           await Promise.all([refreshQuota(true), refreshCatalog(true)])
-          return { toast: '额度已更新', refresh: true }
+          return { toast: t('toastQuotaUpdated'), refresh: true }
         },
         async 'pick-model'(scope, event) {
+          const t = makeT(event?.locale)
           const model = String(event?.value?.model ?? '')
           const ok = await selectModel(model)
-          return ok ? { toast: `默认模型：${model}`, refresh: true } : { toast: '模型名不可用' }
+          return ok
+            ? { toast: t('toastModelSet', { model }), refresh: true }
+            : { toast: t('toastModelBad') }
         },
-        async 'test-all'() {
+        async 'test-all'(scope, event) {
+          const t = makeT(event?.locale)
           const keys = pool ? [...pool.keys] : []
-          if (keys.length === 0) return { toast: '池里还没有 Key' }
+          if (keys.length === 0) return { toast: t('toastNoKeys') }
           // 注意不能用 /v1/models 验 Key：那个接口是公开的，什么令牌都返回 200。
           // 真正会校验令牌的是额度接口，而且查额度不扣魔粒。
           const rows = await quota.refresh(
@@ -661,71 +770,79 @@ export function apply(ctx) {
           const ok = rows.filter((r) => r.state?.ok && r.state.available >= QUOTA_FLOOR).length
           const invalid = rows.filter((r) => !r.state?.ok).length
           const short = rows.length - ok - invalid
-          const parts = [`${ok}/${keys.length} 个 Key 可用`]
-          if (short > 0) parts.push(`${short} 个额度不足`)
-          if (invalid > 0) parts.push(`${invalid} 个令牌无效`)
-          return { toast: `测试完成：${parts.join('，')}` }
+          const parts = [t('partOk', { ok, total: keys.length })]
+          if (short > 0) parts.push(t('partShort', { n: short }))
+          if (invalid > 0) parts.push(t('partInvalid', { n: invalid }))
+          return { toast: t('toastTestDone', { parts: parts.join(' · ') }) }
         },
-        'restore-all': async () => {
+        'restore-all': async (scope, event) => {
+          const t = makeT(event?.locale)
           await pool.restoreAll()
           router.clearAll()
           refreshPanel()
           refreshStrip()
-          return { toast: '已把全部 Key 恢复为可用' }
+          return { toast: t('toastRestored') }
         },
         // 单 Key 控制：先点列表里的某一行选中，再用下面四个按钮。
         'key-open'(scope, event) {
+          const t = makeT(event?.locale)
           const id = String(event?.value?.id ?? '')
-          if (!id) return { toast: '没认出这个 Key' }
+          if (!id) return { toast: t('toastNoKeyId') }
           keyFocus = id
           deleteArmed = ''
           return { open: 'panel:key', refresh: true }
         },
-        'key-prev'() {
-          if (keyPage <= 0) return { toast: '已经是第一页了' }
+        'key-prev'(scope, event) {
+          const t = makeT(event?.locale)
+          if (keyPage <= 0) return { toast: t('toastFirstPage') }
           keyPage--
           return { refresh: true }
         },
-        'key-next'() {
+        'key-next'(scope, event) {
+          const t = makeT(event?.locale)
           const pages = Math.max(1, Math.ceil((pool?.keys.length ?? 0) / KEYS_PER_PAGE))
-          if (keyPage >= pages - 1) return { toast: '已经是最后一页了' }
+          if (keyPage >= pages - 1) return { toast: t('toastLastPage') }
           keyPage++
           return { refresh: true }
         },
-        'key-disable'() {
+        'key-disable'(scope, event) {
+          const t = makeT(event?.locale)
           const id = pickedKey()
-          if (!id) return { toast: '先在上面点一行选中一个 Key' }
+          if (!id) return { toast: t('toastNoPick') }
           pool.disable(id, '手动禁用')
           router.clearKey?.(id)
           refreshPanel()
           refreshStrip()
-          return { toast: `${id} 已禁用，点「恢复」才放开`, refresh: true }
+          return { toast: t('toastDisabled', { id }), refresh: true }
         },
-        'key-stop'() {
+        'key-stop'(scope, event) {
+          const t = makeT(event?.locale)
           const id = pickedKey()
-          if (!id) return { toast: '先在上面点一行选中一个 Key' }
+          if (!id) return { toast: t('toastNoPick') }
           pool.stop(id, '手动停用', nextQuotaResetAt())
           router.clearKey?.(id)
           refreshPanel()
           refreshStrip()
-          return { toast: `${id} 停用到北京时间次日 00:01`, refresh: true }
+          return { toast: t('toastStopped', { id }), refresh: true }
         },
-        'key-restore'() {
+        'key-restore'(scope, event) {
+          const t = makeT(event?.locale)
           const id = pickedKey()
-          if (!id) return { toast: '先在上面点一行选中一个 Key' }
+          if (!id) return { toast: t('toastNoPick') }
           pool.restore(id)
           router.clearKey?.(id)
           refreshPanel()
           refreshStrip()
-          return { toast: `${id} 已恢复可用`, refresh: true }
+          return { toast: t('toastRestoredOne', { id }), refresh: true }
         },
-        'key-delete'() {
+        'key-delete'(scope, event) {
+          const t = makeT(event?.locale)
           const id = pickedKey()
-          if (!id) return { toast: '先在上面点一行选中一个 Key' }
+          if (!id) return { toast: t('toastNoPick') }
           // 删令牌不可撤销，要求连点两次。
           if (deleteArmed !== id) {
             deleteArmed = id
-            return { toast: `再点一次「删除」确认删掉 ${id}`, refresh: true }
+            return { toast: t('toastDeleteArm', { id }), refresh: true }
           }
           deleteArmed = ''
           void pool.remove(id).then(() => {
@@ -734,22 +851,22 @@ export function apply(ctx) {
             refreshPanel()
             refreshStrip()
           })
-          return { toast: `${id} 已从本机删除`, refresh: true }
+          return { toast: t('toastDeleted', { id }), refresh: true }
         },
         'add-form': async (scope, event) => {
           const value = event?.value
           const raw = typeof value === 'string' ? value : value?.newKey ?? value?.value ?? ''
-          const result = await addKey(raw)
+          const result = await addKey(raw, event?.locale)
           return { ...result, refresh: true }
         },
         'key-back'() {
           return { open: 'panel:pool' }
         },
-        async 'refresh-models'() {
-          keyPage = keyPage
+        async 'refresh-models'(scope, event) {
+          const t = makeT(event?.locale)
           await refreshCatalog(true)
           refreshPanel()
-          return { toast: '模型列表已重新拉取', refresh: true }
+          return { toast: t('toastModelsReloaded'), refresh: true }
         },
     }
 
@@ -758,7 +875,8 @@ export function apply(ctx) {
     dshGo.panel('models', { view: viewModels, data: panelData(buildModelsData), actions: panelActions })
 
     dshGo.strip('pool-strip', {
-      data(scope, emit) {
+      data(scope, emit, caps) {
+        const t = makeT(caps?.locale)
         let stop = () => {}
         let lastText = ''
         const tick = () => {
@@ -767,9 +885,13 @@ export function apply(ctx) {
           const q = quota ? quota.sum(ids) : { available: 0, known: 0 }
           const payload =
             s.total === 0
-              ? { text: '魔搭 未配置', tone: 'warn' }
+              ? { text: t('stripEmpty'), tone: 'warn' }
               : {
-                  text: `魔搭 ${s.available}/${s.total} · ${q.known > 0 ? `${q.available} 魔粒` : '额度?'}`,
+                  text: t('stripText', {
+                    ok: s.available,
+                    total: s.total,
+                    quota: q.known > 0 ? t('stripQuota', { n: q.available }) : t('stripQuotaUnknown'),
+                  }),
                   tone: s.available > 0 ? 'good' : 'bad',
                 }
           const json = JSON.stringify(payload)
@@ -789,10 +911,10 @@ export function apply(ctx) {
       },
     })
 
-    dshGo.on('addkey', async (scope) => {
+    dshGo.on('addkey', async (scope, event) => {
       const text = String(scope.clipboard ?? '').trim()
-      if (!text) return { toast: '剪贴板里没有文字' }
-      const result = await addKey(text)
+      if (!text) return { toast: makeT(event?.locale)('toastNoClipboard') }
+      const result = await addKey(text, event?.locale)
       return { ...result, refresh: 'pool' }
     })
 
@@ -859,7 +981,7 @@ export function apply(ctx) {
         })()
         const ok = await registerPoolProvider(llmCtx, {
           providerId: 'modelscope-pool',
-          displayName: '魔搭 Key 池',
+          displayName: makeT()('poolTitle'),
           entryId,
           getPort: () => proxy?.port ?? 0,
           getKey: () => config.apiKey,
@@ -908,7 +1030,133 @@ export function apply(ctx) {
   })
 
   // 真正的网关只在引擎里起（检查器没有 webServer，也不会占端口）。
-  ctx.inject(['webServer'], () => {
+  // 网页版 / 桌面版：原生面板只在 dsh-go 里出现，这里补一个同源管理页。
+  ctx.inject(['webServer'], (webCtx) => {
+    const webServer = webCtx?.webServer
+    if (webServer && typeof webServer.register === 'function') {
+      const getState = () => {
+        const status = pool ? pool.status() : { total: 0, available: 0, cooling: 0, keys: [] }
+        const ids = status.keys.map((k) => k.id)
+        const sum = quota ? quota.sum(ids) : { available: 0, known: 0 }
+        const per = 250
+        const total = status.total * per
+        const unknown = Math.max(0, status.total - sum.known)
+        const left = sum.known > 0 ? sum.available + unknown * per : total
+        return {
+          total: status.total,
+          available: status.available,
+          cooling: status.cooling,
+          magic: { total, left, used: Math.max(0, total - left) },
+          model: String(config.model ?? ''),
+          models: (catalog?.entries ?? [])
+            .filter((entry) => isChatModel(entry.id))
+            .map((entry) => ({ id: entry.id, name: entry.name || entry.id, regions: entry.regions ?? [] })),
+          keys: status.keys.map((k) => {
+            const state = quota?.cached(k.id)
+            return {
+              id: k.id,
+              masked: k.masked,
+              region: k.region,
+              state: k.state,
+              reason: k.reason ?? '',
+              manual: Boolean(k.manual),
+              untilAt: k.untilAt ?? 0,
+              used: k.used ?? 0,
+              quota: state?.ok
+                ? { ok: true, available: state.available, total: state.total, frozen: state.frozen }
+                : { ok: false, available: 0, total: 0, frozen: 0, error: state?.error ?? '' },
+            }
+          }),
+        }
+      }
+
+      const doAction = async (action, payload) => {
+        const id = String(payload?.id ?? '')
+        const after = () => {
+          refreshPanel()
+          refreshStrip()
+        }
+        switch (action) {
+          case 'refresh':
+            await refreshQuota(true)
+            await refreshCatalog(true)
+            after()
+            return makeT()('toastQuotaUpdated')
+          case 'test': {
+            const keys = pool ? [...pool.keys] : []
+            if (keys.length === 0) return makeT()('toastNoKeys')
+            const rows = await quota.refresh(
+              keys.map((k) => ({ id: k.id, key: k.key, region: k.region })),
+              { force: true },
+            )
+            for (const [i, row] of rows.entries()) {
+              const key = keys[i]
+              if (row.state?.region) await pool.setRegion(key.id, row.state.region)
+              if (!row.state?.ok) {
+                pool.markFailure(key.id, '令牌无效', String(row.state?.error ?? '').slice(0, 80))
+                continue
+              }
+              if (row.state.available < QUOTA_FLOOR) {
+                pool.markFailure(key.id, '额度不足', `剩余 ${row.state.available} 魔粒`, nextQuotaResetAt())
+                continue
+              }
+              pool.restore(key.id)
+            }
+            after()
+            const t = makeT()
+            const ready = rows.filter((r) => r.state?.ok && r.state.available >= QUOTA_FLOOR).length
+            return t('toastTestDone', { parts: t('partOk', { ok: ready, total: keys.length }) })
+          }
+          case 'restoreAll':
+            await pool.restoreAll()
+            router.clearAll()
+            after()
+            return makeT()('toastRestored')
+          case 'disable':
+            if (!id) return makeT()('toastNoKeyId')
+            pool.disable(id, '手动禁用')
+            router.clearKey?.(id)
+            after()
+            return makeT()('toastDisabled', { id })
+          case 'stop':
+            if (!id) return makeT()('toastNoKeyId')
+            pool.stop(id, '手动停用', nextQuotaResetAt())
+            router.clearKey?.(id)
+            after()
+            return makeT()('toastStopped', { id })
+          case 'restore':
+            if (!id) return makeT()('toastNoKeyId')
+            pool.restore(id)
+            router.clearKey?.(id)
+            after()
+            return makeT()('toastRestoredOne', { id })
+          case 'remove':
+            if (!id) return makeT()('toastNoKeyId')
+            await pool.remove(id)
+            quota?.forget?.(id)
+            after()
+            return makeT()('toastDeleted', { id })
+          case 'add': {
+            const result = await addKey(String(payload?.value ?? ''), undefined)
+            return result?.toast ?? makeT()('toastNoNew')
+          }
+          case 'setModel': {
+            const ok = await selectModel(String(payload?.value ?? ''))
+            return ok ? makeT()('toastModelSet', { model: payload.value }) : makeT()('toastModelBad')
+          }
+          default:
+            throw new Error(`unknown action ${action}`)
+        }
+      }
+
+      try {
+        ctx.effect(() => registerWebAdmin(webServer, { getState, doAction, logger }))
+        logger?.info?.(`modelscope-pool: 网页/桌面端管理页 ${WEB_ADMIN_PATH}`)
+      } catch (error) {
+        logger?.warn?.(`modelscope-pool: 管理页注册失败 ${String(error?.message ?? error)}`)
+      }
+    }
+
     ready
       .then(async () => {
         proxy = createProxy({