@goodandready/dsh-key-rotation 0.8.8 → 0.8.11

package/lib/client.js

@@ -9,7 +9,7 @@
 // manual route typing is ever needed. The plugin derives the fallback chain and
 // auto-creates clone routes from the key count.
 //
-// Localization: source strings are English only (ctx.locale.register(NS, { en })).
+// Localization: source strings are English; Chinese is a first-class locale (en + zh).
 // Other languages come from the DSH core locale service / translation plugins
 // via props.t (slot locale: NS). Active locale prefers ctx.locale.getSnapshot().active,
 // else first navigator.languages entry, else 'en' — same fallback chain as DSH core.
@@ -143,16 +143,176 @@ window.__ModuleLoader__.load({
       recentFailures: 'Recent failures ({n})',
       noActivePools: 'No active pools',
       headerPoolsTitle: 'Key rotation pools',
-      pausedBudget: 'paused',
+            pausedBudget: 'paused',
       sortUsage: 'Sort by usage',
+      testingAllProgress: 'Testing {n}/{total}…',
+      liveEventStream: 'Live Event Stream',
+      liveEventStreamEmpty: 'No rotation events recorded',
+      eventAt: 'Time',
+      eventKey: 'Key',
+      eventReason: 'Reason',
+      eventCooldown: 'Cooldown',
+      quotaResetIn: 'Reset in {time}',
+      routingStrategyLabel: 'Routing Strategy',
+      routingStrategyRoundRobin: 'Round-Robin (default)',
+      routingStrategyLeastLoaded: 'Least-Loaded (concurrency)',
+      routingStrategyLowestLatency: 'Lowest-Latency (p95)',
+      proactiveGuardLabel: 'Proactive Rate-Limit Guard',
+      proactiveGuardHint: 'Pre-emptively pause keys when remaining quota or Retry-After header indicates limit before hitting 429',
+      selfHealingLabel: 'Auto-Unbreak Interval (min)',
+      selfHealingHint: 'Periodic free model check to revive broken keys (0 to disable)',
     };
 
-    // Коды, на которых имеет смысл переключать ключ. Список из хоста
-    // (DEFAULT_SWITCH_CODES); конфиг может содержать и свои — они показываются
-    // отдельными отмеченными галочками, чтобы правило нельзя было потерять.
+    
+    const zh = {
+      title: '密钥轮换',
+      'header.title': '密钥轮换与故障转移',
+      'header.sub': '自动化多密钥轮换、429/5xx指数退避冷却、断路器保护及凭证安全 (~/.dsh/.credentials.yaml)。',
+      'header.pools_badge': '个活跃密钥池',
+      'header.keys_badge': '个已配置密钥',
+      sectionStats: '密钥池健康与遥测',
+      sectionStatsDesc: '活跃密钥池、健康凭证和故障转移状态的实时遥测。',
+      sectionFailover: '故障转移触发器与错误代码',
+      sectionFailoverDesc: '选择触发自动切换至下一个可用密钥的错误条件。',
+      sectionTiming: '时间与轮换计划',
+      sectionTimingDesc: '配置冷却持续时间和定期轮换计划窗口。',
+      sectionBackup: '备份与快照',
+      sectionBackupDesc: '导出或导入提供商密钥池，并创建完整插件配置快照。',
+      statPools: '已配置密钥池',
+      statKeys: '总密钥数',
+      statHealthy: '健康 / 就绪',
+      loadDistribution: '流量分布',
+      statRequests: '请求',
+      noTrafficYet: '暂无流量记录',
+      confirm: '确认',
+      cancel: '取消',
+      confirmResetTitle: '重置 {p} 的冷却状态？',
+      confirmResetDesc: '这将立即清除所有故障计数、冷却计时器并重置断路器。',
+      confirmRemoveProvTitle: '移除提供商 {p}？',
+      confirmRemoveProvDesc: '确定要从轮换中移除该提供商及其所有已配置密钥吗？',
+      filterAll: '全部',
+      filterReady: '就绪',
+      filterCooldown: '冷却中',
+      filterErrors: '存在错误',
+      subtitle: '按提供商 API 密钥轮换：密钥池、配额/限流错误自动故障转移、冷却与恢复。',
+      cardDesc: '按提供商 API 密钥轮换：密钥池、配额/限流错误自动故障转移、冷却与恢复。',
+      loading: '加载中…',
+      notRegistered: '未注册',
+      removeKey: '移除密钥',
+      removeProvider: '移除提供商',
+      addKey: '+ 添加密钥',
+      addKeyTitle: '添加 API 密钥',
+      noProviders: 'DSH 尚未注册任何提供商 — 暂无可选项目。',
+      addProvider: '+ 添加提供商',
+      desc: '按提供商的 API 密钥轮换。为每个提供商列出其 API 密钥（环境变量名，存储在 DSH 凭据中）。插件按顺序通过提供商的密钥路由模型，并在配额/速率限制失败时切换到下一个。',
+      cooldown: '故障后冷却时间 (毫秒)',
+      scheduleDays: '轮换计划 (天数，0=关闭)',
+      switchCodes: '切换代码 (逗号分隔)',
+      providersTitle: '提供商与其密钥',
+      save: '保存',
+      discard: '放弃',
+      saving: '保存中…',
+      moveUp: '上移',
+      moveDown: '下移',
+      keyActive: '使用中',
+      keyReady: '就绪',
+      keyCooling: '冷却中，{s}秒',
+      keyMissing: '凭证不存在',
+      switchesNone: '暂无切换',
+      switchesSome: '切换次数: {n} · 上次: {reason}, {ago}',
+      justNow: '刚刚',
+      minutesAgo: '{n} 分钟前',
+      hoursAgo: '{n} 小时前',
+      codesTitle: '在这些故障时切换',
+      keyValuePlaceholder: '粘贴密钥，然后保存',
+      keySave: '保存密钥',
+      keySaved: '已保存',
+      keyFromEnv: '来自环境变量，此处只读',
+      keyWriteFailed: '无法存储密钥: {msg}',
+      notSecretShape: '已保存，但该值看起来不像 API 密钥 - 请检查是否有拼写错误',
+      rpmTitle: '请求/分钟: 已用 {u}, 剩余 {r}',
+      budgetLabel: '预算:',
+      exportCsv: '导出 CSV',
+      weightHint: '轮换权重：该密钥参与循环的次数 (1 = 等分)',
+      retestBroken: '重新测试',
+      retestFail: '重新测试失败 - 密钥仍然不可用',
+      snapshotExport: '快照 ⬇',
+      snapshotImport: '恢复',
+      keyHint: '该值存储在 DSH 凭据中，绝不会发送回浏览器 — 仅显示其最后 5 个字符。名称已自动生成；悬停在密钥上可查看其使用的名称。',
+      brokenKey: '已损坏 (3× 认证失败)',
+      keyExpired: '已过期',
+      keyExpiringSoon: '{n} 天后过期',
+      exportPools: '导出',
+      exportOne: '⬇',
+      usedAgo: '{ago}前使用',
+      importPools: '导入',
+      importEnv: '导入 .env',
+      resetCooldown: '重置冷却',
+      testAll: '测试所有密钥',
+      testing: '测试中…',
+      testKey: '测试',
+      testOk: '正常',
+      testFail: '失败',
+      poolExhausted: '密钥池耗尽 — 所有密钥冷却中',
+      resetting: '重置中…',
+      keyLabel: '密钥 {n}',
+      undoProvider: '提供商已移除',
+      undoKey: '密钥已移除',
+      undo: '撤销',
+      emptyTitle: '暂无密钥池',
+      emptyDesc: '添加提供商及至少一个 API 密钥名称以开始轮换。',
+      errorTitle: '无法加载设置',
+      retry: '重试',
+      unavailableTitle: '设置桥接不可用',
+      unavailableDesc: '宿主未暴露 dsh-key-rotation 设置命名空间。请重新打开设置或检查插件是否已启用。',
+      modalClose: '关闭对话框',
+      dialogLabel: '确认',
+      loadChartAria: '密钥流量分布',
+      bulkCooldownPlaceholder: '批量冷却时间 (毫秒)',
+      bulkApply: '应用到所选项',
+      bulkRemove: '删除所选项',
+      confirmBulkRemoveTitle: '删除 {n} 个提供商？',
+      confirmBulkRemoveDesc: '所选提供商及其所有密钥将从轮换中移除。操作后可立即撤销一次。',
+      selectProvider: '选择提供商 {p}',
+      activeBadge: '活跃',
+      healthScoreTitle: '健康评分',
+      totalRequestsTitle: '总请求数',
+      exportProvider: '导出此提供商',
+      recentFailures: '近期故障 ({n})',
+      noActivePools: '无活跃密钥池',
+      headerPoolsTitle: '密钥轮换池',
+      pausedBudget: '已暂停',
+      sortUsage: '按使用量排序',
+      testingAllProgress: '正在测试 {n}/{total}…',
+      liveEventStream: '实时事件流',
+      liveEventStreamEmpty: '暂无轮换事件记录',
+      eventAt: '时间',
+      eventKey: '密钥',
+      eventReason: '原因',
+      eventCooldown: '冷却',
+      quotaResetIn: '{time} 后重置',
+      routingStrategyLabel: '路由策略',
+      routingStrategyRoundRobin: '轮询 (默认)',
+      routingStrategyLeastLoaded: '最低负载 (并发)',
+      routingStrategyLowestLatency: '最低延迟 (p95)',
+      proactiveGuardLabel: '前瞻性限流防护',
+      proactiveGuardHint: '当响应中的剩余配额或 Retry-After 头提示即将超限时，预先冷却密钥以防触发 429',
+      selfHealingLabel: '自愈检查间隔 (分钟)',
+      selfHealingHint: '定期轻量探测以自动恢复损坏密钥 (0 为禁用)',
+    };
+
+    // Codes worth switching on. Host list is DEFAULT_SWITCH_CODES; config may
+    // add extras — those render as separate checked boxes so a custom rule is
+    // not dropped on first save.
     const KNOWN_CODES = ['QUOTA', 'RATE_LIMIT', 'SERVER', 'TIMEOUT', 'TRANSPORT', 'EMPTY_RESPONSE', 'UNKNOWN_MODEL', 'AUTH'];
 
     // #273: keep the settings list item mounted if the section throws.
+        const bestEffort = (label, fn) => {
+          try { return fn(); } catch (err) {
+            try { console.debug('[dsh-key-rotation] best-effort ' + label, err); } catch { /* console unavailable */ }
+            return undefined;
+          }
+        };
     class KeyRotationErrorBoundary extends React.Component {
       constructor(props) {
         super(props);
@@ -162,7 +322,7 @@ window.__ModuleLoader__.load({
         return { error };
       }
       componentDidCatch(error, info) {
-        try { console.error('[dsh-key-rotation] settings card crashed', error, info); } catch (_) {}
+        bestEffort('error-boundary.log', () => { console.error('[dsh-key-rotation] settings card crashed', error, info); });
       }
       render() {
         if (this.state.error) {
@@ -179,7 +339,7 @@ window.__ModuleLoader__.load({
       }
     }
 
-    /** Опрос статуса ротации, пока раздел настроек открыт (smart polling). */
+    /** Poll rotation status while the settings section is open (smart polling). */
     function useRotationStatus() {
       const [byProvider, setByProvider] = React.useState({});
       React.useEffect(() => {
@@ -194,7 +354,7 @@ window.__ModuleLoader__.load({
               for (const entry of data.providers) map[entry.provider] = entry;
               setByProvider(map);
             })
-            .catch(() => { /* статус необязателен: карточка остаётся редактором */ });
+            .catch(() => { /* status is optional: card stays a working editor */ });
         };
         pull();
         const id = setInterval(pull, 4000);
@@ -209,7 +369,7 @@ window.__ModuleLoader__.load({
       return byProvider;
     }
 
-    /** Последний probe-результат по каждому ключу (#219): /sandbox-cache (smart polling). */
+    /** Latest probe result per key (#219): /sandbox-cache (smart polling). */
     function useProbeCache() {
       const [cache, setCache] = React.useState({});
       React.useEffect(() => {
@@ -219,7 +379,7 @@ window.__ModuleLoader__.load({
           fetch('/dsh-key-rotation/sandbox-cache', { headers: { accept: 'application/json' } })
             .then((r) => (r.ok ? r.json() : null))
             .then((data) => { if (alive && data) setCache(data); })
-            .catch(() => { /* кэш не критичен: карточка работает и без него */ });
+            .catch(() => { /* cache is non-critical: card works without it */ });
         };
         pull();
         const id = setInterval(pull, 4000);
@@ -243,10 +403,9 @@ window.__ModuleLoader__.load({
       return t('hoursAgo').replace('{n}', String(Math.round(sec / 3600)));
     }
 
-    // Разметка карточки: сетка, а не набор inline-стилей. Фиксированные ширины
-    // здесь уже приводили к тому, что имя ключа обрезалось, а кнопки наезжали
-    // на поле значения, поэтому имя занимает свою строку, а служебная строка
-    // под ним ужимается сама.
+    // Card layout uses a grid, not ad-hoc inline widths. Fixed widths used to
+    // clip key names and collide actions with the value field, so the name owns
+    // its own row and the meta row shrinks on its own.
     const CARD_CSS = [
       '.krot{display:flex;flex-direction:column;gap:20px;max-width:960px;padding:6px 0 24px;box-sizing:border-box}',
       '.krot-header{display:flex;flex-direction:column;gap:8px;padding-bottom:16px;border-bottom:1px solid var(--dsw-alias-border-l2)}',
@@ -254,7 +413,7 @@ window.__ModuleLoader__.load({
       '.krot-page-sub{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.5}',
       '.krot p{margin:0}',
       '.krot-hint{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.4}',
-      '.krot-err{font-size:13px;color:var(--dsw-alias-state-error-primary);padding:10px 14px;border-radius:8px;background:rgba(239,68,68,0.1);display:flex;align-items:center;gap:8px}',
+      '.krot-err{font-size:13px;color:var(--dsw-alias-state-error-primary);padding:10px 14px;border-radius:8px;background:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 10%, transparent);display:flex;align-items:center;gap:8px}',
       '.krot-label{font-size:13px;font-weight:500;color:var(--dsw-alias-label-primary)}',
       '.krot-field{display:flex;flex-direction:column;gap:6px}',
       '.krot-in{background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;height:36px;font-family:inherit;min-width:0;width:100%;box-sizing:border-box;transition:border-color .15s ease}',
@@ -277,15 +436,15 @@ window.__ModuleLoader__.load({
       '.krot-load-legend{display:flex;flex-wrap:wrap;gap:8px;margin-top:6px;font-size:11px}',
       '.krot-load-item{display:inline-flex;align-items:center;gap:4px}',
       '.krot-load-dot{width:7px;height:7px;border-radius:50%}',
-      '.krot-modal-backdrop{position:fixed;top:0;left:0;right:0;bottom:0;background:rgba(0,0,0,0.55);z-index:9999;display:flex;align-items:center;justify-content:center;backdrop-filter:blur(2px)}',
-      '.krot-modal-card{width:90%;max-width:420px;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;box-shadow:0 12px 36px rgba(0,0,0,0.28);padding:20px;display:flex;flex-direction:column;gap:12px}',
+      '.krot-modal-backdrop{position:fixed;top:0;left:0;right:0;bottom:0;background:var(--dsw-alias-bg-overlay, color-mix(in srgb, var(--dsw-alias-bg-layer-1, #000) 55%, transparent));z-index:9999;display:flex;align-items:center;justify-content:center;backdrop-filter:blur(2px)}',
+      '.krot-modal-card{width:90%;max-width:420px;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;box-shadow:0 12px 36px color-mix(in srgb, var(--dsw-alias-bg-layer-1, #000) 28%, transparent);padding:20px;display:flex;flex-direction:column;gap:12px}',
       '.krot-modal-title{font-size:16px;font-weight:600;color:var(--dsw-alias-label-primary)}',
       '.krot-modal-desc{font-size:13px;color:var(--dsw-alias-label-secondary);line-height:1.45}',
       '.krot-modal-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:8px}',
       '.krot-badge{font-size:12px;padding:3px 10px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);display:inline-flex;align-items:center;gap:5px;font-weight:500;white-space:nowrap}',
-      '.krot-badge-ok{border-color:var(--dsw-alias-state-success-primary);color:var(--dsw-alias-state-success-primary);background:rgba(16,185,129,0.08)}',
-      '.krot-badge-warn{border-color:var(--dsw-alias-state-warning-primary);color:var(--dsw-alias-state-warning-primary);background:rgba(245,158,11,0.08)}',
-      '.krot-badge-bad{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary);background:rgba(239,68,68,0.08)}',
+      '.krot-badge-ok{border-color:var(--dsw-alias-state-success-primary);color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb, var(--dsw-alias-state-success-primary, #10b981) 8%, transparent)}',
+      '.krot-badge-warn{border-color:var(--dsw-alias-state-warning-primary);color:var(--dsw-alias-state-warning-primary);background:color-mix(in srgb, var(--dsw-alias-state-warning-primary, #f59e0b) 8%, transparent)}',
+      '.krot-badge-bad{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 8%, transparent)}',
       '.krot-prov{display:flex;flex-direction:column;gap:12px;border:1px solid var(--dsw-alias-border-l2);border-radius:10px;background:var(--dsw-alias-bg-layer-2);padding:14px 16px}',
       '.krot-prov-head{display:flex;gap:10px;align-items:center;flex-wrap:wrap}',
       '.krot-prov-head select{flex:1;min-width:180px}',
@@ -303,18 +462,22 @@ window.__ModuleLoader__.load({
       '.krot-btn:hover:not(:disabled){background:var(--dsw-alias-bg-layer-4,var(--dsw-alias-bg-layer-2));border-color:var(--dsw-alias-label-dimmed,var(--dsw-alias-border-l2))}',
       '.krot-btn-primary,.krot-save{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3);border-color:transparent;font-weight:600}',
       '.krot-btn-primary:hover:not(:disabled),.krot-save:hover:not(:disabled){background:var(--dsw-alias-label-primary)!important;color:var(--dsw-alias-bg-layer-3)!important;opacity:0.88}',
-      '.krot-btn-danger{color:var(--dsw-alias-state-error-primary);border-color:rgba(239,68,68,0.3)}',
-      '.krot-btn-danger:hover:not(:disabled){background:rgba(239,68,68,0.12)!important;border-color:rgba(239,68,68,0.5)}',
+      '.krot-btn-danger{color:var(--dsw-alias-state-error-primary);border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 30%, transparent)}',
+      '.krot-btn-danger:hover:not(:disabled){background:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 12%, transparent)!important;border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 50%, transparent)}',
       '.krot-btn:disabled{opacity:0.45;cursor:not-allowed}',
       '.krot-foot{display:flex;gap:10px;align-items:center;flex-wrap:wrap}',
       '.krot-filter-bar{display:flex;gap:8px;margin:4px 0 10px;flex-wrap:wrap}',
       '.krot-pill{appearance:none;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l2);border-radius:999px;padding:4px 12px;font-size:12px;font-weight:500;color:var(--dsw-alias-label-secondary);cursor:pointer;transition:all .15s ease}',
       '.krot-pill:hover{background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary)}',
       '.krot-pill-active{background:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3)!important;font-weight:600}',
-      '.krot-pill-warn{border-color:rgba(245,158,11,0.3);color:var(--dsw-alias-state-warning-primary)}',
-      '.krot-pill-err{border-color:rgba(239,68,68,0.3);color:var(--dsw-alias-state-error-primary)}',
-      '.krot-alert-ok{padding:10px 14px;border-radius:8px;background:rgba(16,185,129,0.1);color:var(--dsw-alias-state-success-primary);font-size:13px;display:flex;align-items:center;gap:10px}',
-      '.krot-alert-bad{padding:10px 14px;border-radius:8px;background:rgba(239,68,68,0.1);color:var(--dsw-alias-state-error-primary);font-size:13px;display:flex;align-items:center;gap:10px}',
+      '.krot-pill-warn{border-color:color-mix(in srgb, var(--dsw-alias-state-warning-primary, #f59e0b) 30%, transparent);color:var(--dsw-alias-state-warning-primary)}',
+      '.krot-pill-err{border-color:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 30%, transparent);color:var(--dsw-alias-state-error-primary)}',
+      '.krot-alert-ok{padding:10px 14px;border-radius:8px;background:color-mix(in srgb, var(--dsw-alias-state-success-primary, #10b981) 10%, transparent);color:var(--dsw-alias-state-success-primary);font-size:13px;display:flex;align-items:center;gap:10px}',
+      '.krot-alert-bad{padding:10px 14px;border-radius:8px;background:color-mix(in srgb, var(--dsw-alias-state-error-primary, #ef4444) 10%, transparent);color:var(--dsw-alias-state-error-primary);font-size:13px;display:flex;align-items:center;gap:10px}',
+      '.krot-event-stream{display:flex;flex-direction:column;gap:6px;margin-top:8px;padding:10px 12px;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:8px}',
+      '.krot-event-row{display:flex;align-items:center;gap:8px;font-size:12px;padding:4px 0;border-bottom:1px solid var(--dsw-alias-border-l1)}',
+      '.krot-event-time{font-family:ui-monospace,Menlo,Consolas,monospace;color:var(--dsw-alias-label-tertiary);font-size:11px}',
+      ':root{--krot-chart-4:var(--dsw-alias-state-brand-primary);--krot-chart-5:var(--dsw-alias-state-error-primary);--krot-chart-6:var(--dsw-alias-state-success-primary)}',
       '.krot-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none}',
       '.krot-card-header{appearance:none;width:100%;font:inherit;color:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:12px;display:flex;align-items:center;gap:12px;padding:14px 16px}',
       '.krot-card-head-text{display:flex;flex-direction:column;flex:1;gap:4px;min-width:0}',
@@ -324,7 +487,7 @@ window.__ModuleLoader__.load({
       '.krot-card-body{border-top:1px solid var(--dsw-alias-border-l2);margin:0 16px;padding:16px 0 8px}',
       '.krot-header-chip{display:inline-flex;align-items:center;gap:6px;height:26px;padding:0 10px;border-radius:999px;border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);font-size:12px;font-weight:600;cursor:pointer;position:relative;user-select:none;transition:all .15s ease}',
       '.krot-header-chip:hover{background:var(--dsw-alias-interactive-bg-hover,var(--dsw-alias-bg-layer-3));border-color:var(--dsw-alias-border-l1);transform:translateY(-0.5px)}',
-      '.krot-popover{position:absolute;top:calc(100% + 6px);right:0;z-index:10000;min-width:220px;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:12px 14px;box-shadow:0 16px 40px rgba(0,0,0,.45),0 2px 8px rgba(0,0,0,.15);backdrop-filter:blur(16px);-webkit-backdrop-filter:blur(16px);display:flex;flex-direction:column;gap:8px;text-align:left}',
+      '.krot-popover{position:absolute;top:calc(100% + 6px);right:0;z-index:10000;min-width:220px;background:var(--dsw-alias-bg-layer-3);border:1px solid var(--dsw-alias-border-l2);border-radius:12px;padding:12px 14px;box-shadow:0 16px 40px color-mix(in srgb, var(--dsw-alias-bg-layer-1, #000) 45%, transparent),0 2px 8px color-mix(in srgb, var(--dsw-alias-bg-layer-1, #000) 15%, transparent);backdrop-filter:blur(16px);-webkit-backdrop-filter:blur(16px);display:flex;flex-direction:column;gap:8px;text-align:left}',
       '.krot-pop-title{font-size:11px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;color:var(--dsw-alias-label-secondary)}',
       '.krot-pop-row{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:4px 0}',
       '.krot-pop-name{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary);display:flex;align-items:center;gap:8px}',
@@ -342,13 +505,13 @@ window.__ModuleLoader__.load({
     }
 
     /**
-     * Имя переменной под новый ключ.
+     * Env-var name for a newly added key.
      *
-     * Пользователь его больше не печатает: первый ключ провайдера получает имя
-     * вида <PROVIDER>_API_KEY, следующие — тот же корень с суффиксом _2, _3…
-     * Корень берётся у уже существующих ключей, чтобы вручную заведённые имена
-     * не ломались, и проверяется на занятость по ВСЕМ провайдерам — иначе два
-     * провайдера незаметно делили бы одну учётную запись.
+     * Users no longer type it: the first key of a provider becomes
+     * <PROVIDER>_API_KEY, later keys reuse that root with _2, _3… suffixes.
+     * The root is taken from existing keys so hand-made names keep working,
+     * and uniqueness is checked across ALL providers — otherwise two providers
+     * would silently share one credential.
      */
     // nextKeyRef also in lib/client-helpers.js
     function nextKeyRef(providerId, existingKeys, allRefs) {
@@ -493,13 +656,14 @@ window.__ModuleLoader__.load({
           cancelAnimationFrame(id);
           const prev = modalReturnFocusRef.current;
           if (prev && typeof prev.focus === 'function') {
-            try { prev.focus(); } catch (_) {}
+            bestEffort('modal.returnFocus', () => { prev.focus(); });
           }
         };
       }, [confirmModal]);
       const [testing, setTesting] = React.useState('');
       const [testResult, setTestResult] = React.useState({});
       const [testAllProvider, setTestAllProvider] = React.useState('');
+      const [testingProgress, setTestingProgress] = React.useState({});
       const [secretDraft, setSecretDraft] = React.useState({});
       const [secretError, setSecretError] = React.useState('');
       const stashUndo = (u) => { setUndo(u); if (undoTimer.current) clearTimeout(undoTimer.current); undoTimer.current = setTimeout(() => setUndo(null), 5000); };
@@ -727,8 +891,7 @@ window.__ModuleLoader__.load({
         stashUndo({ type: 'provider', index: pIndex, entry: arr[pIndex] });
         return { ...cur, providers: arr.filter((_, i) => i !== pIndex) };
       });
-      // Порядок ключей = порядок попыток, поэтому его надо менять кнопками,
-      // а не перепечатыванием имён.
+      // Key order is attempt order — move it with buttons, do not retype names.
       const moveKey = (pIndex, kIndex, delta) => setField((cur) => {
         const providers = [...(cur.providers ?? [])];
         const entry = { ...(providers[pIndex] ?? {}) };
@@ -763,8 +926,8 @@ window.__ModuleLoader__.load({
         return { ...cur, providers };
       });
 
-      // Коды из конфига, которых нет в известном списке, показываем тоже:
-      // иначе галочки молча выбросили бы чужое правило при первом сохранении.
+      // Config codes missing from the known list still render as checked items;
+      // otherwise the checkboxes would silently drop a custom rule on first save.
       const selectedCodes = new Set(Array.isArray(val.switchCodes) ? val.switchCodes : []);
       const codeList = [...KNOWN_CODES, ...[...selectedCodes].filter((c) => !KNOWN_CODES.includes(c))];
       const toggleCode = (code, on) => setField((cur) => {
@@ -834,8 +997,8 @@ window.__ModuleLoader__.load({
         title: (opts && opts.title) || undefined,
       }, labelText);
 
-      // Точка состояния ключа: цвет и подпись читаются с одного взгляда,
-      // а «ключ не найден» ловит опечатку в имени env, которая иначе молчит.
+      // Key state dot: color and label read at a glance; "key not found"
+      // catches an env-name typo that would otherwise stay silent.
       const keyStatus = (providerId, ref) => {
         const hit = keyInfo(providerId, ref);
         if (!hit) return null;
@@ -904,8 +1067,7 @@ window.__ModuleLoader__.load({
           const typed = secretDraft[rowKey];
           const fromEnv = Boolean(info && info.source === 'env');
 
-          // Имя ключа занимает свою строку целиком: раньше оно обрезалось и
-          // соседние ключи выглядели одинаково.
+          // Key name owns a full row so neighbouring keys stay distinguishable.
           const nameRow = [
             h('span', { className: 'krot-num', key: 'n' }, String(kIndex + 1)),
             h('span', { key: 'i', className: 'krot-name', title: key + ' (click to copy)', style: { cursor: 'copy' }, onClick: () => {
@@ -1046,13 +1208,13 @@ window.__ModuleLoader__.load({
           });
           const total = keyUsages.reduce((acc, x) => acc + x.usage, 0);
           const palette = [
-            'var(--dsw-alias-state-brand-primary, #6366f1)',
-            'var(--dsw-alias-state-success-primary, #10b981)',
-            'var(--dsw-alias-state-warning-primary, #f59e0b)',
-            'var(--dsw-alias-state-info-primary, #3b82f6)',
-            '#8b5cf6',
-            '#ec4899',
-            '#14b8a6',
+            'var(--dsw-alias-state-brand-primary)',
+            'var(--dsw-alias-state-success-primary)',
+            'var(--dsw-alias-state-warning-primary)',
+            'var(--dsw-alias-state-info-primary)',
+            'var(--krot-chart-4)',
+            'var(--krot-chart-5)',
+            'var(--krot-chart-6)',
           ];
           return h('div', { className: 'krot-load-chart' },
             h('div', { className: 'krot-load-header' },
@@ -1124,6 +1286,24 @@ window.__ModuleLoader__.load({
               return h('span', { className: 'krot-tail', title: t('healthScoreTitle'), style: { flex: 'none', color, fontWeight: 700 } }, String(score));
             })(),
             (() => { const ps = status[entry.provider]; const tot = ps && typeof ps.totalUsage === 'number' ? ps.totalUsage : null; return tot !== null ? h('span', { className: 'krot-tail', title: t('totalRequestsTitle'), style: { flex: 'none' } }, String(tot)) : null; })(),
+            (() => {
+              const q = status.quota || (providerStatus && providerStatus.quota);
+              let nearestReset = null;
+              if (q && typeof q === 'object') {
+                for (const k of (entry.keys || [])) {
+                  const entryQ = q[k];
+                  if (entryQ && typeof entryQ.reset === 'number' && entryQ.reset > Date.now()) {
+                    if (!nearestReset || entryQ.reset < nearestReset) nearestReset = entryQ.reset;
+                  }
+                }
+              }
+              if (!nearestReset) return null;
+              const diffMs = nearestReset - Date.now();
+              if (diffMs <= 0) return null;
+              const mins = Math.ceil(diffMs / 60000);
+              const timeStr = mins > 60 ? Math.floor(mins / 60) + 'h ' + (mins % 60) + 'm' : mins + 'm';
+              return h('span', { className: 'krot-badge krot-badge-warn', title: 'Quota window reset' }, t('quotaResetIn').replace('{time}', timeStr));
+            })(),
             btn('✕', () => setConfirmModal({
               title: t('confirmRemoveProvTitle').replace('{p}', entry.provider),
               desc: t('confirmRemoveProvDesc'),
@@ -1135,7 +1315,8 @@ window.__ModuleLoader__.load({
           filterBar,
           loadChart,
           h('div', { className: 'krot-keys' }, keyRows),
-          h('div', { className: 'krot-foot' },
+          h(UpdaterSection, { t }),
+      h('div', { className: 'krot-foot' },
             btn(t('addKey'), () => addKey(pIndex), { title: t('addKeyTitle') }),
             switchesLine,
             budgetLine,
@@ -1144,7 +1325,26 @@ window.__ModuleLoader__.load({
             (providerStatus && Array.isArray(providerStatus.events) && providerStatus.events.length > 0 ? h('div', { style: { display: 'flex', gap: '2px', alignItems: 'end', height: '24px', marginTop: '4px' } }, (() => { const now = Date.now(); const buckets = Array(24).fill(0); for (const ev of providerStatus.events) { const h = Math.floor((now - ev.at) / 3600000); if (h >= 0 && h < 24) buckets[23 - h]++; } const max = Math.max(1, ...buckets); return buckets.map((c, i) => h('div', { key: i, title: c + ' switches', style: { flex: 1, background: c ? 'var(--dsw-alias-state-warning-primary)' : 'var(--dsw-alias-border-l2)', height: (c / max * 24) + 'px', minHeight: '2px', borderRadius: '2px' } })); })()) : null),
             // #224: 7-day switches per day (client-side, from the same events)
             (providerStatus && Array.isArray(providerStatus.events) && providerStatus.events.length > 0 ? h('div', { style: { display: 'flex', gap: '2px', alignItems: 'end', height: '16px', marginTop: '2px' } }, (() => { const now = Date.now(); const days = Array(7).fill(0); for (const ev of providerStatus.events) { const d = Math.floor((now - ev.at) / 86400000); if (d >= 0 && d < 7) days[6 - d]++; } const max = Math.max(1, ...days); return days.map((c, i) => h('div', { key: i, title: c + ' switches · day -' + (6 - i), style: { flex: 1, background: c ? 'var(--dsw-alias-state-info-primary, var(--dsw-alias-state-warning-primary))' : 'var(--dsw-alias-border-l2)', height: (c / max * 16) + 'px', minHeight: '2px', borderRadius: '2px' } })); })()) : null),
-            (providerStatus && Array.isArray(providerStatus.events) && providerStatus.events.length > 0 ? h('details', { style: { fontSize: '11px', marginTop: '6px' } }, h('summary', null, t('recentFailures').replace('{n}', String(providerStatus.events.length))), h('ul', { style: { margin: '4px 0 0', paddingLeft: '16px' } }, providerStatus.events.slice().reverse().map((ev, i) => h('li', { key: i, style: ev.type === 'probe' ? { opacity: .5 } : null }, new Date(ev.at).toLocaleTimeString() + ' ' + (ev.type === 'probe' ? '[probe] ' : '') + ev.ref + ' ' + ev.reason + ' cd=' + ev.cooldownMs)) )) : null),
+            (providerStatus && Array.isArray(providerStatus.events) && providerStatus.events.length > 0 ? h('details', { className: 'krot-event-stream' },
+              h('summary', { style: { display: 'flex', alignItems: 'center', gap: '8px', cursor: 'pointer', fontWeight: 600, fontSize: '12px' } },
+                h('span', null, '📜 ' + t('liveEventStream')),
+                h('span', { className: 'krot-badge' }, String(providerStatus.events.length))
+              ),
+              h('div', { style: { display: 'flex', flexDirection: 'column', gap: '4px', marginTop: '8px' } },
+                providerStatus.events.slice().reverse().map((ev, i) => {
+                  const isHeal = ev.type === 'heal' || ev.reason === 'auto-unbreak' || ev.reason === 'self-heal';
+                  const isBad = ev.code === 'AUTH' || ev.reason === 'AUTH' || ev.type === 'broken';
+                  const badgeClass = isHeal ? 'krot-badge-ok' : isBad ? 'krot-badge-bad' : 'krot-badge-warn';
+                  const timeStr = ev.at ? new Date(ev.at).toLocaleTimeString() : '';
+                  return h('div', { key: i, className: 'krot-event-row' },
+                    h('span', { className: 'krot-event-time' }, timeStr),
+                    h('span', { className: 'krot-tail' }, ev.ref || 'pool'),
+                    h('span', { className: 'krot-badge ' + badgeClass }, String(ev.reason || ev.code || ev.type)),
+                    ev.cooldownMs > 0 ? h('span', { style: { fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, 'cd: ' + Math.round(ev.cooldownMs / 1000) + 's') : null
+                  );
+                })
+              )
+            ) : null),
             btn(t('resetCooldown'), () => setConfirmModal({
               title: t('confirmResetTitle').replace('{p}', entry.provider),
               desc: t('confirmResetDesc'),
@@ -1152,7 +1352,7 @@ window.__ModuleLoader__.load({
               danger: false,
               onConfirm: () => doReset(entry.provider),
             }), { disabled: !(providerStatus && providerStatus.switches > 0) || resetting === entry.provider, title: t('resetCooldown') }),
-            btn(testAllProvider === entry.provider ? t('testing') : t('testAll'), () => doTestAll(entry.provider), { disabled: testAllProvider === entry.provider, title: t('testAll') }),
+            btn(testAllProvider === entry.provider ? (testingProgress[entry.provider] ? t('testingAllProgress').replace('{n}', testingProgress[entry.provider].split('/')[0]).replace('{total}', testingProgress[entry.provider].split('/')[1]) : t('testing')) : t('testAll'), () => doTestAll(entry.provider), { disabled: testAllProvider === entry.provider, title: t('testAll') }),
             exportCsv,
           ),
         );
@@ -1276,6 +1476,26 @@ window.__ModuleLoader__.load({
         h('div', { className: 'krot-grid-2' },
           field(t('cooldown'), textInput(String(val.cooldownMs ?? 60000), (v) => setField((cur) => ({ ...cur, cooldownMs: Number(v) || 0 })))),
           field(t('scheduleDays'), textInput(String(val.rotationScheduleDays ?? 0), (v) => setField((cur) => ({ ...cur, rotationScheduleDays: Number(v) || 0 }))))
+        ),
+        h('div', { className: 'krot-grid-3', style: { marginTop: '10px' } },
+          field(t('routingStrategyLabel'), h('select', {
+            className: 'krot-in',
+            value: val.routingStrategy ?? 'round-robin',
+            onChange: (e) => setField((cur) => ({ ...cur, routingStrategy: e.target.value })),
+          }, [
+            h('option', { key: 'round-robin', value: 'round-robin' }, t('routingStrategyRoundRobin')),
+            h('option', { key: 'least-loaded', value: 'least-loaded' }, t('routingStrategyLeastLoaded')),
+            h('option', { key: 'lowest-latency', value: 'lowest-latency' }, t('routingStrategyLowestLatency')),
+          ])),
+          field(t('selfHealingLabel'), textInput(String(val.selfHealingIntervalMinutes ?? 30), (v) => setField((cur) => ({ ...cur, selfHealingIntervalMinutes: Number(v) || 0 })))),
+          field(t('proactiveGuardLabel'), h('label', { style: { display: 'flex', alignItems: 'center', gap: '8px', height: '36px', cursor: 'pointer' } }, [
+            h('input', {
+              type: 'checkbox',
+              checked: val.proactiveRateLimitGuard ?? true,
+              onChange: (e) => setField((cur) => ({ ...cur, proactiveRateLimitGuard: e.target.checked })),
+            }),
+            h('span', { style: { fontSize: '13px', color: 'var(--dsw-alias-label-secondary)' } }, t('proactiveGuardLabel')),
+          ]))
         )
       );
 
@@ -1475,7 +1695,7 @@ window.__ModuleLoader__.load({
     }
 
     function apply(ctx) {
-      ctx.effect(() => ctx.locale.register(NS, { en }), 'dsh-key-rotation: dictionaries');
+      ctx.effect(() => ctx.locale.register(NS, { en, zh }), 'dsh-key-rotation: dictionaries');
       // Header chip (#201): status dot in the session header utilities slot,
       // same slot dsh-gitea / dsh-subscriptions use for their header widgets.
       ctx.effect(() => {
@@ -1495,7 +1715,72 @@ window.__ModuleLoader__.load({
       // Collapsible card in Settings -> Plugins -> Plugin settings
       // (settings.plugin.item), matching Model Sync / Spendmeter / Vision Bridge.
       // key MUST equal the settings namespace (NS), else the tab silently skips it.
-      function KeyRotationCard(props) {
+      
+  function UpdaterSection({ t }) {
+    const [state, setState] = React.useState({ phase: 'idle', current: '', latest: '', message: '' });
+    const load = React.useCallback(async () => {
+      setState((s) => ({ ...s, phase: 'loading', message: '' }));
+      try {
+        const res = await fetch('/api/dsh-key-rotation/update', { headers: { 'x-dsh-plugin-update': '1' } });
+        const data = await res.json();
+        if (!res.ok) throw new Error(data?.error?.message || t('updateFailed'));
+        setState({
+          phase: data.updateAvailable ? 'available' : 'current',
+          current: data.currentVersion || '',
+          latest: data.latestVersion || '',
+          message: data.updateAvailable ? t('updateAvailable') : t('updateNone'),
+        });
+      } catch (e) {
+        setState({ phase: 'error', current: '', latest: '', message: e?.message || t('updateFailed') });
+      }
+    }, [t]);
+    React.useEffect(() => { load(); }, [load]);
+    const run = async () => {
+      setState((s) => ({ ...s, phase: 'running', message: t('updateRunning') }));
+      try {
+        const res = await fetch('/api/dsh-key-rotation/update', {
+          method: 'POST',
+          headers: { 'x-dsh-plugin-update': '1', 'content-type': 'application/json' },
+        });
+        const data = await res.json();
+        if (!res.ok) throw new Error(data?.error?.message || t('updateFailed'));
+        setState({
+          phase: 'done',
+          current: data.currentVersion || '',
+          latest: data.installedVersion || data.latestVersion || '',
+          message: t('updateRestart'),
+        });
+      } catch (e) {
+        setState({ phase: 'error', current: '', latest: '', message: e?.message || t('updateFailed') });
+      }
+    };
+    return h('div', { className: 'krot-update', style: { marginTop: 12, paddingTop: 12, borderTop: '1px solid var(--dsw-alias-border-l2)' } },
+      h('div', { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' } },
+        h('span', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)' } },
+          t('currentVersion') + ': ' + (state.current || '—')),
+        state.latest ? h('span', { style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)' } },
+          t('latestVersion') + ': ' + state.latest) : null,
+        h('button', {
+          className: 'krot-btn',
+          type: 'button',
+          disabled: state.phase === 'running' || state.phase === 'loading',
+          onClick: load,
+        }, t('updateCheck')),
+        state.phase === 'available' ? h('button', {
+          className: 'krot-btn krot-btn-primary',
+          type: 'button',
+          disabled: state.phase === 'running',
+          onClick: run,
+        }, t('updateRun')) : null,
+      ),
+      state.message ? h('div', {
+        className: state.phase === 'error' ? 'krot-alert-bad' : state.phase === 'done' ? 'krot-alert-ok' : '',
+        style: { marginTop: 8, fontSize: 12 },
+      }, state.message) : null,
+    );
+  }
+
+  function KeyRotationCard(props) {
         const locale = useLocale();
         const t = resolveT(props);
         const [open, setOpen] = React.useState(false);
@@ -1518,11 +1803,31 @@ window.__ModuleLoader__.load({
             KeyRotationCard,
           ));
       } catch (e) {
-        try { console.error('[dsh-key-rotation] settings.plugin.item register failed', e); } catch (_) {}
+        bestEffort('slots.register.log', () => { console.error('[dsh-key-rotation] settings.plugin.item register failed', e); });
       }
     }
 
     module.exports = { apply, inject: ['slots', 'locale', 'settingsScope'] };
     return module.exports;
   },
+    updateCheck: 'Check for updates',
+    updateAvailable: 'Update available',
+    updateNone: 'Plugin is up to date',
+    updateRun: 'Update now',
+    updateRestart: 'Update installed. Restart DSH to load the new version.',
+    updateRunning: 'Updating…',
+    updateFailed: 'Update failed',
+    currentVersion: 'Current version',
+    latestVersion: 'Latest version',
+
+    updateCheck: '检查更新',
+    updateAvailable: '有可用更新',
+    updateNone: '插件已是最新版本',
+    updateRun: '立即更新',
+    updateRestart: '更新已安装。请重启 DSH 以加载新版本。',
+    updateRunning: '更新中…',
+    updateFailed: '更新失败',
+    currentVersion: '当前版本',
+    latestVersion: '最新版本',
+
 });