wwewtech/numes-deepseek-harness ↗★ 2
numes-deepseek-harness
Zero-dependency local proxy wiring Numes's $0 :free model pool into DSH as an OpenAI-compatible provider, with never-give-up retries, Retry-After-aware backoff, and auto-discovery.
Install
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:wwewtech/numes-deepseek-harnessREADME
Read the full README ↗usage.cost: 0
## ⚠️ Honest limits
- **`$0` ≠ unlimited.** Free offers appear and vanish with provider prices; auto-discovery keeps the list current but cannot conjure capacity. If every free offer is gone, rounds keep failing *honestly*.
- **`$0` ≠ instant.** The free pool measured 50–85s to first token (short pings: ~3–8s). Set a generous `max_tokens` (1500+) — reasoning tokens eat the budget, and `max_tokens: 40` yields an empty answer with `finish_reason: "length"`.
- **`$0` ≠ private.** Providers declare their own data policies; read them before sending secrets. The proxy itself never logs your key or prompts.
- **Not a Numes or DeepSeek product.** Independent glue, verified on DSH Desktop 0.2.2-rc.3 with a USD key on 17 Nov 2026. DSH rc.4/rc.5 only change server-side search and bug fixes, not the provider setup this repo documents.
## 🖼️ Visual tour
Terminal
DSH model picker (real screenshot)
Retry flow



🛡️ `dsh-model-picker.png` and `dsh-model-list.png` are **real screenshots** from DSH Desktop 0.2.2-rc.3 showing the bundle-installed provider. `terminal.png` and `flow.png` are illustrative mockups. SVG originals in [`docs/assets/`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/).
---
## 📚 Everything else
| | |
|---|---|
| 🇷🇺 **Полный гайд (рекомендуется)** | [docs/SETUP.ru.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.ru.md) — от установки DSH до первого ответа, с разбором ошибок |
| 🇬🇧 Full setup guide | [docs/SETUP.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.md) — the same, in English |
| 🇨🇳 **中文全指南** | [docs/SETUP.zh.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/SETUP.zh.md) — 完整安装、排错与 API 用法 |
| 🇨🇳 **中国人(README)** | [README.zh.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/README.zh.md) — 项目总览 |
| 🔧 Proxy reference | [tools/README.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/tools/README.md) — every env var, header, and behaviour |
| ⚙️ DSH config blocks | [configs/](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/configs/) — direct and proxy routes |
| 📦 DSH bundle | [`.dsh-plugin/manifest.json`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/.dsh-plugin/manifest.json) + root `package.json` — `dsh plugin add github:wwewtech/numes-deepseek-harness` |
| 📋 Changelog | [CHANGELOG.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/CHANGELOG.md) — what changed in each version |
| 🛡️ Security & contributing | [SECURITY.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/SECURITY.md) · [CONTRIBUTING.md](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/CONTRIBUTING.md) |
| 🧪 **Examples** | [`examples/`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/examples/) — curl, Python, PowerShell, Node, tool-calls |
| 📸 **Real screenshots** | [`dsh-model-picker.png`](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/dsh-model-picker.png) · [`dsh-model-list.png`](https://raw.githubusercontent.com/wwewtech/numes-deepseek-harness/cca2fb2241d548d36e9b35a11e9726e490274dd0/docs/assets/dsh-model-list.png) |
## ✅ What CI checks
Every push runs [`.github/workflows/ci.yml`](https://github.com/wwewtech/numes-deepseek-harness/blob/cca2fb2241d548d36e9b35a11e9726e490274dd0/.github/workflows/ci.yml), which verifies the claims made above rather than trusting them:
- the proxy parses, boots, and answers `/health` with a non-empty chain;
- the **paid-model guard really returns `400`** for a non-free id, before any network I/O;
- every relative Markdown link resolves;
- no Numes key (or GitHub token) is committed;
- each config lists only `:free` Numes ids;
- the source still contains the guard, `max_price`, backoff, `Retry-After`, discovery, and fatal-abort code the README advertises;
- the **root `package.json`** declares `dsh.bundle.patch`, `.dsh-plugin/manifest.json` references a real `cordis.patch.yml`, and the listed entry file exists;
- **7 integration tests** (`tests/proxy.test.mjs`) covering the guard, `/health`, `/status`, `/v1/models`, chain override, unknown routes and bad JSON.
Run the same checks locally:
```bash
node tools/check-repo.mjs
npm test
📄 License
MIT. Not affiliated with DeepSeek or Numes. Applies Numes ToS and AUP; no account automation, no quota evasion.