Jesse-njx/dsh-polyglot

Plugin插件 Native原生 ⭐ 3 MIT Models & Routing模型与路由

dsh-polyglot — 适用于 DSH 的模型切换器:通用的 OpenAI 兼容 ctx.llm 适配器,精选免费/廉价 DeepSeek 预设,速率限制时自动提供方回退

Project Overview项目介绍

dsh-polyglot is a native DeepSeek Harness plugin that acts as an LLM router for any OpenAI-compatible large language model endpoint. It installs directly via the DSH CLI with a single command: dsh plugin --profile web add @dsh-polyglot/bundle, which registers the plugin with a recommended default provider chain that prioritizes free tiers before cheaper paid options. It integrates natively with DSH’s official LLM adapter system, using proper DSH extension seams instead of request interception, so it works seamlessly with all core DSH functionality without breaking changes.

Typical workflow starts after you install the plugin, when you configure API keys for your desired providers via either environment variables or DSH’s built-in credentials UI. You then select the virtual polyglot provider in DSH’s model selector, and any provider without a configured API key is automatically skipped from the rotation. If a provider hits a rate limit, quota error, or 5xx server error, it is put into an exponential backoff cooldown that honors Retry-After headers, and the request automatically retries on the next available provider in your configured chain.

The plugin is released under the permissive MIT open source license, and all pre-built provider presets are stored as JSON data so community contributors can add new providers without modifying core adapter code. Each preset includes a verification timestamp, cost, and limit notes, and there is a planned CI workflow that will regularly ping each endpoint to confirm ongoing availability. Users can override default cooldown settings and provider chains, add custom OpenAI-compatible endpoints including locally hosted LLMs, and view per-provider usage statistics and estimated costs directly from built-in DSH commands.

dsh-polyglot是专为DeepSeek Harness开发的原生LLM路由插件,核心功能是为DSH接入任意兼容OpenAI接口的大模型端点,自带自动故障转移功能。当当前使用的免费大模型提供商触发速率限制时,会自动切换到链中下一个可用提供商,保证用户请求不会因为限流中断服务。

用户可通过dsh命令行一键安装该插件到个人配置文件,安装完成后只需配置对应提供商的API密钥,即可在模型选择器中选中polyglot虚拟提供商。未配置密钥的提供商会被自动跳过,默认链按照“免费→廉价付费”的顺序编排,适合希望日常使用免费大模型、遇到限流自动降级的开发者。

该插件采用MIT许可开源,所有预配置提供商信息都会定期验证更新,每个预配置条目都标注了验证时间、费用和限流说明。用户可自定义配置路由链、冷却参数,也可添加自定义的本地部署或第三方OpenAI兼容端点,使用前需注意免费提供商的服务条款限制。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @dsh-polyglot/bundle

把 Jesse-njx/dsh-polyglot 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-polyglot

The model switch for DSH. Point DeepSeek Harness at any OpenAI-compatible endpoint — with curated presets for free and cheap DeepSeek providers and automatic fallback when a free tier rate-limits you.

What claude-code-router is to Claude Code, dsh-polyglot is to DSH — except DSH's ctx.llm is a sanctioned extension seam, so there is no request interception: the generic adapter and the router are both real LlmAdapter registrations.

  • One generic adapter. A single OpenAI-compatible ctx.llm adapter parameterized by {baseUrl, apiKey, model, headers?, quirks?}. Streaming, tool calls, and usage extraction are all handled; per-provider deviations (reasoning field names, strict tool schemas, cache-folded usage) are small declarative quirks flags, never per-provider code.
  • A router with fallback. On 429 / quota-exceeded / 5xx (or a missing key), the failing provider is marked cooling-down (exponential backoff, honoring Retry-After) and the request is retried on the next provider in the chain. Free tiers rate-limit constantly — automatic failover is the whole product.
  • Provider presets as data. presets/*.json — community PRs add providers without touching the adapter. Each preset carries verifiedAt and free-tier notes so rot is visible.
  • Usage you can see. Every attempt lands in the append-only session log as polyglot/served; /polyglot usage tallies per provider with token counts and estimated cost from preset pricing.

Quick start

Install the bundle into a profile (a DSH profile is an ordered stack of plugin-bundle patch layers):

dsh plugin --profile web add @dsh-polyglot/bundle

The bundle's patch registers the polyglot plugin with the recommended default chain — "code all day for free until something rate-limits, then degrade gracefully to cheapest-paid":

nous-portal → opencode-zen → deepseek-official (5M grant) → kilo

Configure keys through the credentials seam (the web Models page writes them), or export the env names each preset declares:

export NOUS_PORTAL_TOKEN=...      # nous-portal (bearer, manual token for v0.1)
export OPENCODE_API_KEY=...       # opencode-zen
export DEEPSEEK_API_KEY=...       # deepseek-official (new accounts: 5M free tokens, 30 days, no card)
export KILO_API_KEY=...           # kilo (paid fallback rung)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev folio 下一个 Next dsh-ui-agents-pixe →