omdsh-dev/dsh-llm-fallbacks
An dsh plugin for role-based LLM retry&fallback strategy
dsh-llm-fallbacks provides automatic provider/model fallback chains for DeepSeek Harness: when an agent's LLM requests keep failing — retries exhausted, auth errors, quota exceeded, rate limiting (429) — the plugin switches provider/model along the fallback chain for the current role, and the current step/turn continues on the target model, so tasks are not interrupted by model problems. Time slots rotate the effective root chain by wall-clock windows: each slot row carries its own fallback chain, and the first row whose window contains the current moment replaces the all-day chain for the next root request; the all-day chain stays as the last resort when no slot matches. Four frozen UTC+8 presets (liang-peak, liang-valley, glm-peak, glm-valley) are code constants; GLM presets appear only when zai-coding-cn is configured. The all-day rootChain's tail (Default model) must be exactly one official V4 model — deepseek-official/deepseek-v4-flash XOR deepseek-official/deepseek-v4-pro. A repair script (pnpm repair:fallbacks-switch-logs) fixes sessions created before 0.2.2 that newer dsh releases refuse to load.
Install
dsh plugin --profile web add dsh-llm-fallbacksInstall with dsh plugin --profile web add dsh-llm-fallbacks for the web profile (Settings → Plugins → Fallbacks card) or dsh plugin --profile dsh-tui add dsh-llm-fallbacks for the dsh-tui terminal profile — same plugin, either front end, the only difference is the --profile flag. Pin a version with @<version>. A registry install fetches the built package (dist/), nothing builds on the target machine. Requires Node >= 22 and pnpm >= 10 (badges).
Compatibility
DeepSeek Harness 0.1.1-rc.2; works in both front ends — the web profile (Settings → Plugins → Fallbacks card) and the dsh-tui terminal profile (/fallbacks session diagnostics, /fallbacks config readback, /settings fallbacks section). Node >= 22, pnpm >= 10.
Details
- Repo: omdsh-dev/dsh-llm-fallbacks
- Category: Other
- Stars: 11
- Version: npm dsh-llm-fallbacks (registry, built package); MIT; DSH 0.1.1-rc.2 (badge); dsh tui compatible
- Last push: 2026-09-11
- First seen: 2026-08-07
Recent updates
The current README documents the fallback chain model, time-slot rotation with the four presets, web and dsh-tui surfaces, the pre-0.2.2 session repair workflow, and the full configuration reference (docs/configuration.md, docs/install.md).
FAQ
- Does it work in the terminal profile too?
- Yes — install with dsh plugin --profile dsh-tui add dsh-llm-fallbacks; it exposes /fallbacks diagnostics, /fallbacks config readback, and a /settings fallbacks section.
- What happens when all fallbacks fail?
- The failure walk continues along the chain; the plugin's job is switching provider/model per role so the current turn is not interrupted by model problems.
- Which default model must the root chain end with?
- Exactly one official V4 model — deepseek-official/deepseek-v4-flash XOR deepseek-official/deepseek-v4-pro.
Alternatives
DDDMUC/dsh-free-search · morluto/jacobian · zh667/TokenLedger