README
📦 @goodandready/dsh-key-rotation
Enterprise-Grade Transparent API Key Rotation, Rate-Limit Pre-emption & Failover Cascade for DeepSeek Harness
🇬🇧 English •
🇷🇺 Русский •
🇨🇳 中文说明
⭐ If you like this plugin, please star it on GitHub — it shows me that the plugin is useful to you and motivates me to keep developing it.
🐛 If you find a bug or would like to request a feature, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version.
Enterprise-Grade Transparent API Key Rotation, Rate-Limit Pre-emption & Failover Cascade for DeepSeek Harness
🇬🇧 English • 🇷🇺 Русский • 🇨🇳 中文说明
|
⭐ If you like this plugin, please star it on GitHub — it shows me that the plugin is useful to you and motivates me to keep developing it.
🐛 If you find a bug or would like to request a feature, open a GitHub issue in any language — I will review your proposal and implement useful suggestions in a future plugin version. |
⚡ Overview & The Problem
🚀 What's New in v0.8.11 (One-click Updater & Quality Gate)
- Plugin updater in Settings: see current/latest version and update from the card without leaving DSH (
#307). - Safer best-effort side effects: intentional non-critical failures log at debug instead of silent empty
catch(#315). - Theme-only client colors and production-path test cleanup (
#311,#314). - Leaner publication set: agent-only files no longer ship in git/npm (
#308).
🚀 What's New in v0.8.10 (Stream Concurrency Hardening & Auto-Pruning)
- Zero Concurrency Leaks: Guaranteed release of stream concurrency slots via deterministic
try ... finallyblock, preventing key starvation during clean finishes or client stream aborts. - Robust Probe Retry: Added transient network socket error retry (
PROBE_RETRY_DELAY_MS) inSandboxRunner.probeModelsbefore marking keys as broken. - Memory & State Pruning: Automated pruning of removed/stale keys from internal pool maps during periodic sweep cycles.
🚀 What's New in v0.8.9 (Routing Evolution & UI)
- Proactive Rate-Limit Guard: Automatic key pausing based on
x-ratelimit-remaining-*andRetry-Afterheaders before hitting 429 errors. - Self-Healing / Auto-Unbreak: Periodic background probe via free
/modelsendpoint to automatically revive broken keys without token burn. - Latency-Aware Routing: Selectable strategies:
round-robin,least-loaded(concurrency), andlowest-latency(p95 latency). - UI Evolution in
dsh-clinebotStyle: Sequential batch "Test All Keys" runner with live progress, Live Event Stream drawer, and Quota Reset countdown badge. - Native Dual Language Support: Native English (
en) and Chinese (zh) UI dictionaries.
🛠️ What's New in v0.8.0 (Stability)
- 🔌 Circuit breaker: after N consecutive provider failures the circuit opens and requests fail fast (
CIRCUIT_OPEN) until a cool-down; half-open probes recover automatically. - 🕒 Monotonic clock: cooldown/breaker durations use process monotonic time so NTP steps cannot invert remaining times.
- 📮 Non-blocking webhooks: alerts go through a bounded queue with backoff — stream rotation never waits on webhook HTTP.
- 🧱 Atomic I/O helpers: crash-safe writes; corrupt JSON never overwrites previous in-memory state.
- 🧹 Clone-route GC: orphaned auto-created clone routes are dropped from the runtime set.
- 🧭 Error taxonomy: explicit switch/surface/soft classification for 408/425/429/5xx, sockets and gRPC codes.
- 📡 Status extras: per-provider
circuitplusmeta.expectedClones/meta.notifyQueue. - 🧪 Smoke harness: scripted 429 → next-key → success path in
test/smoke-rotation-080.test.mjs.
🚀 What's New in v0.8.67
- 📥 Full Pool Config Export & Import (#504): Masked export for safe sharing, full backup export with AES-256-GCM encryption (PBKDF2), diff preview mode, and import with merge/replace strategies.
- ⚡ Quick Actions in Chat Header Popover (#499): Instant key management directly from the conversation toolbar — skip to next key, reset cooldowns, or pause problematic keys via
/dsh-key-rotation/quick-action.
🚀 What's New in v0.8.66
- ⏳ Dynamic Reset Scheduler (#498): Reads upstream
retry-afterandx-ratelimit-reset-*headers to set exact cooldowns (+250ms safety jitter) and schedules immediate unref wake-up timers when the upstream reset window rolls over. - 💰 Upstream Balance Inspector & Credit Tracking (#495): Live balance checks for DeepSeek, SiliconFlow, OpenRouter, and OpenAI via
/dsh-key-rotation/balance, pre-emptive empty balance protection (EMPTY_BALANCE_PAUSED), persistent balance cache, and WebUI💰 Balancepills.
更多「安全與驗證」外掛
dsh-uumit-remote
作者 uumit-ai
為 DeepSeek Harness 提供遠端訪問能力,支援從其他裝置連線和使用會話。
精選已評估安全與驗證JavaScript
53115
dsh-auto-review
作者 perrylink
第二模型 AI 自動評審:只讀評審子智慧體對審批請求返回結構化允許或拒絕結論,預設關閉、全程可審計。
精選已評估安全與驗證TypeScript
2539
cc-safety-net
作者 kenryu42
面向 AI 程式設計智慧體的執行前安全防護外掛,在工具呼叫前攔截破壞性 Git、檔案操作和敏感檔案訪問,相容多種編碼 Agent 與命令列工具。
精選已評估安全與驗證TypeScript
2,08099
dsh-permission-rules
作者 perrylink
Claude Code 風格宣告式許可權規則:按序 allow/deny/ask 匹配工具、引數與工作區路徑
精選已評估安全與驗證TypeScript
1404
