@goodandready/dsh-key-rotation 0.7.31 → 0.7.33

package/README.md

@@ -28,6 +28,15 @@
 
 ## ⚡ Overview & The Problem
 
+### 🛠️ What's New in v0.7.33 (Stability & Bugfix Release)
+- **🔍 Resolved Key Probing BaseURL**: Fixed `resolveBaseUrl` to map key credential refs to owning provider pools, restoring live `probeModels` testing.
+- **🛡️ Guarded Cascade Recursion**: Prevented call stack overflow in cross-provider failover when circular cascade chains occur.
+- **🕒 Accurate Midnight PST Resets**: Corrected UTC-8 timezone calculation offset sign for calendar quota reset windows.
+- **🧹 Lifecycle Timer Cleanup**: Wrapped `canaryTimer` and `selfHealTimer` in Cordis effect scopes, eliminating background orphaned intervals on hot reload.
+- **⚡ Stale Lock Recovery in Load Balancer**: Added expired lock detection to `pickLeastLoaded` for uninterrupted least-connections routing.
+- **🌐 Full Chinese Localization**: Added complete `zh` locale dictionary to the React settings dashboard for comprehensive 3-language parity.
+
+
 ### 🚀 What's New in v0.7.31
 - **⚡ O(1) TokenBucket Accumulator**: Upgraded rate limiting math to O(1) time and zero-allocation memory with adaptive header synchronization.
 - **🛡️ Soft vs Hard Backoff**: Differentiates transient infrastructure drops (502/503/timeouts: 10s flat cooldown) from hard quota errors (progressive doubling).

package/README.ru.md

@@ -28,6 +28,15 @@
 
 ## ⚡ Обзор и решаемая проблема
 
+### 🛠️ Что нового в версии 0.7.33 (Хотфикс и повышение стабильности)
+- **🔍 Исправление проверки ключей**: Функция `resolveBaseUrl` теперь сопоставляет ref ключа с его пулом, восстанавливая работу живого тестирования моделей.
+- **🛡️ Защита от зацикливания каскада**: Устранена возможность переполнения стека при взаимных кольцевых цепочках failover.
+- **🕒 Точный сброс квот по PST**: Исправлен знак часового смещения UTC-8 для корректного сброса лимитов в полночь по тихоокеанскому времени.
+- **🧹 Очистка таймеров в жизненном цикле**: Таймеры `canaryTimer` и `selfHealTimer` переведены на эффекты Cordis, исключая утечки при горячей перезагрузке.
+- **⚡ Сброс зависших блокировок**: Алгоритм `pickLeastLoaded` теперь учитывает протухшие блокировки при выборе наименее нагруженного ключа.
+- **🌐 Полная китайская локализация**: Добавлен словарь `zh` в веб-интерфейс настроек для соблюдения стандарта трёх языков (EN/RU/ZH).
+
+
 ### 🚀 Что нового в версии 0.7.31
 - **⚡ $O(1)$ Накопитель TokenBucket**: Оптимизация математики лимитов до $O(1)$ по времени и без аллокаций памяти с адаптивной синхронизацией по заголовкам.
 - **🛡️ Разделение Soft / Hard сбоев**: Кратковременные сетевые сбои (502/503/таймауты) получают короткий 10-секундный кулдаун без штрафного удвоения.

package/README.zh.md

@@ -28,6 +28,15 @@
 
 ## ⚡ 概述与核心痛点
 
+### 🛠️ v0.7.33 版本新特性 (稳定性与问题修复)
+- **🔍 修复密钥探测 BaseURL 解析**：`resolveBaseUrl` 现已支持从密钥 ref 反查归属提供商池，恢复在线模型连通性探测。
+- **🛡️ 防御级联无限递归**：在跨提供商故障转移中增加递归深度防护，彻底杜绝循环级联导致的堆栈溢出。
+- **🕒 纠正 PST 太平洋时间配额重置**：修复 UTC-8 时区偏移符号，确保日配额在太平洋时间午夜准时重置。
+- **🧹 定时器生命周期自动回收**：将金丝雀探测与自愈定时器纳入 Cordis 效应生命周期，消除热重载遗留孤儿定时器。
+- **⚡ 负载均衡超时锁自动释放**：`pickLeastLoaded` 算法现已检测过期连接锁，确保最小连接调度不发生偏移。
+- **🌐 完整中文界面本地化**：为 React 设置面板补充全部 `zh` 语言包，实现标准的三语（英/俄/中）无缝对齐。
+
+
 ### 🚀 v0.7.31 版本新特性
 - **⚡ O(1) 令牌桶累加器**：将速率限制计算升级为 O(1) 时间复杂度与零内存分配，并支持响应头自适应同步。
 - **🛡️ 软/硬故障分级退避**：区分临时网络抖动（502/503/超时获得 10 秒平缓冷却）与硬性配额超限（指数退避倍增）。

package/lib/client.js

@@ -164,6 +164,76 @@ window.__ModuleLoader__.load({
       resetting: 'Сброс…',
       keyLabel: 'Ключ {n}',
     };
+    const zh = {
+      title: '密钥轮换',
+      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}',
+    };
+
 
     // Коды, на которых имеет смысл переключать ключ. Список из хоста
     // (DEFAULT_SWITCH_CODES); конфиг может содержать и свои — они показываются
@@ -318,7 +388,7 @@ window.__ModuleLoader__.load({
     }
 
     function KeyRotationSection(props) {
-      const DICT = props.locale === 'ru' ? ru : en;
+      const DICT = props.locale === 'ru' ? ru : (props.locale === 'zh' ? zh : en);
       const t = makeT(DICT, en);
       const [state, setState] = React.useState({ status: 'loading', value: null, revision: 0, error: '', providers: [] });
       const [draft, setDraft] = React.useState(null);
@@ -1050,7 +1120,7 @@ window.__ModuleLoader__.load({
       // key MUST equal the settings namespace (NS), else the tab silently skips it.
       function KeyRotationCard(props) {
         const locale = useLocale();
-        const t = makeT(locale === 'ru' ? ru : en, en);
+        const t = makeT(locale === 'ru' ? ru : (locale === 'zh' ? zh : en), en);
         const [open, setOpen] = React.useState(false);
         return h('div', { className: 'krot-card' + (open ? ' krot-card-open' : '') },
           h('button', { type: 'button', className: 'krot-card-header', 'aria-expanded': open, onClick: () => setOpen((v) => !v) },

package/lib/concurrency.js

@@ -1,72 +1,73 @@
-// concurrency.js — per-key in-flight counter + least-connections picking (issue #193).
-
-export const CONCURRENCY_DEFAULT_LIMIT = 0;
-export const CONCURRENCY_STALE_LOCK_MS = 5 * 60 * 1000;
-
-export class ConcurrencyTracker {
-  constructor(opts) {
-    opts = opts || {};
-    const limit = opts.limit !== undefined ? opts.limit : CONCURRENCY_DEFAULT_LIMIT;
-    this._limit = (Number.isFinite(limit) && limit >= 0) ? Math.floor(limit) : 0;
-    this._staleMs = opts.staleMs || CONCURRENCY_STALE_LOCK_MS;
-    this._inFlight = new Map();
-  }
-
-  isEnabled() { return this._limit > 0; }
-  get limit() { return this._limit; }
-
-  acquire(ref, now) {
-    now = now || Date.now();
-    if (!this.isEnabled()) return true;
-    let e = this._inFlight.get(ref);
-    if (!e) {
-      e = { count: 0, lastAcquired: now };
-      this._inFlight.set(ref, e);
-    }
-    if (now - e.lastAcquired > this._staleMs) {
-      e.count = 0;
-    }
-    if (e.count >= this._limit) return false;
-    e.count += 1;
-    e.lastAcquired = now;
-    return true;
-  }
-
-  release(ref, now) {
-    now = now || Date.now();
-    const e = this._inFlight.get(ref);
-    if (!e) return;
-    e.count = Math.max(0, e.count - 1);
-    e.lastAcquired = now;
-  }
-
-  snapshot() {
-    const out = {};
-    for (const [k, v] of this._inFlight) out[k] = { count: v.count };
-    return out;
-  }
-
-  pickLeastLoaded(candidates, now) {
-    now = now || Date.now();
-    if (!Array.isArray(candidates) || candidates.length === 0) return null;
-    let best = null;
-    let bestCount = Infinity;
-    for (const ref of candidates) {
-      const e = this._inFlight.get(ref);
-      const count = e ? e.count : 0;
-      if (this.isEnabled() && count >= this._limit) continue;
-      if (count < bestCount) {
-        best = ref;
-        bestCount = count;
-      }
-    }
-    return best;
-  }
-
-  clear(ref) {
-    if (ref) this._inFlight.delete(ref);
-    else this._inFlight.clear();
-  }
-
-  get size() { return this._inFlight.size; }
-}
+// concurrency.js — per-key in-flight counter + least-connections picking (issue #193).
+
+export const CONCURRENCY_DEFAULT_LIMIT = 0;
+export const CONCURRENCY_STALE_LOCK_MS = 5 * 60 * 1000;
+
+export class ConcurrencyTracker {
+  constructor(opts) {
+    opts = opts || {};
+    const limit = opts.limit !== undefined ? opts.limit : CONCURRENCY_DEFAULT_LIMIT;
+    this._limit = (Number.isFinite(limit) && limit >= 0) ? Math.floor(limit) : 0;
+    this._staleMs = opts.staleMs || CONCURRENCY_STALE_LOCK_MS;
+    this._inFlight = new Map();
+  }
+
+  isEnabled() { return this._limit > 0; }
+  get limit() { return this._limit; }
+
+  acquire(ref, now) {
+    now = now || Date.now();
+    if (!this.isEnabled()) return true;
+    let e = this._inFlight.get(ref);
+    if (!e) {
+      e = { count: 0, lastAcquired: now };
+      this._inFlight.set(ref, e);
+    }
+    if (now - e.lastAcquired > this._staleMs) {
+      e.count = 0;
+    }
+    if (e.count >= this._limit) return false;
+    e.count += 1;
+    e.lastAcquired = now;
+    return true;
+  }
+
+  release(ref, now) {
+    now = now || Date.now();
+    const e = this._inFlight.get(ref);
+    if (!e) return;
+    e.count = Math.max(0, e.count - 1);
+    e.lastAcquired = now;
+  }
+
+  snapshot() {
+    const out = {};
+    for (const [k, v] of this._inFlight) out[k] = { count: v.count };
+    return out;
+  }
+
+  pickLeastLoaded(candidates, now) {
+    now = now || Date.now();
+    if (!Array.isArray(candidates) || candidates.length === 0) return null;
+    let best = null;
+    let bestCount = Infinity;
+    for (const ref of candidates) {
+      const e = this._inFlight.get(ref);
+      let count = e ? e.count : 0;
+      if (e && now - e.lastAcquired > this._staleMs) count = 0;
+      if (this.isEnabled() && count >= this._limit) continue;
+      if (count < bestCount) {
+        best = ref;
+        bestCount = count;
+      }
+    }
+    return best;
+  }
+
+  clear(ref) {
+    if (ref) this._inFlight.delete(ref);
+    else this._inFlight.clear();
+  }
+
+  get size() { return this._inFlight.size; }
+}