dsh-llm-newapi
English | 中文
Use your NewAPI gateway in DeepSeek Harness (dsh). The plugin adds a NewAPI settings page for credentials, model discovery and model parameters, plus streaming text and tool calls. It requires no changes to dsh.
Choose a compatible version
Install the host and plugin as a pair. Status checked on September 11, 2026.
| dsh host | Plugin | Status |
|---|
0.1.1-rc.2 | 0.8.4 | Published; plugin npm latest |
0.1.2-rc.1 | 0.8.6-rc.1 | Published; the last release for that host line |
0.1.5-rc.1, 0.1.5-rc.2 | 0.8.6-rc.2 | Published; superseded by 0.8.6-rc.3 |
0.1.5-rc.1, 0.1.5-rc.2 | 0.8.6-rc.3 | Current release; npm next, GitHub Pre-release. Adds the select-all box to the fetched-model picker |
Plugin 0.8.6-rc.3 targets the 0.1.5 host line and rejects the older 0.1.2-rc.1 host with an explicit upgrade message; 0.1.2-rc.1 users stay on plugin 0.8.6-rc.1. Both 0.1.5-rc.1 and 0.1.5-rc.2 were verified: they ship identical lib/** code, and the plugin builds byte-identical output against either. See the compatibility assessment (Chinese).
Releases stay on the pre-release channel: npm next and a GitHub Pre-release. Nothing here promotes a stable version or moves the plugin's latest tag, which stays on 0.8.4. The host and plugin have separate release channels; their respective latest versions are not necessarily compatible.
Install exact versions
You need Node.js, npm and pnpm. Repository CI uses Node.js 24. Install the host with npm, then install the plugin from the npm registry into dsh's web profile.
Published RC pair (dsh 0.1.2-rc.1)
npm install -g @deepseek-ai/dsh@0.1.2-rc.1
npm install -g pnpm
dsh plugin --profile web add --save-exact dsh-llm-newapi@0.8.6-rc.1
Pair for the older host
npm install -g @deepseek-ai/dsh@0.1.1-rc.2
npm install -g pnpm
dsh plugin --profile web add --save-exact dsh-llm-newapi@0.8.4
Choose one pair. --save-exact records an exact plugin dependency so a later dependency update does not switch versions automatically. Use dsh plugin to manage the profile; installing dsh-llm-newapi globally by itself does not register it there.
New host pair: run only after rc.2 is published
rc.2 is not published yet. These are the planned commands. Check that the version exists before installing:
npm view dsh-llm-newapi@0.8.6-rc.3 version
npm install -g @deepseek-ai/dsh@0.1.5-rc.2
npm install -g pnpm
dsh plugin --profile web add --save-exact dsh-llm-newapi@0.8.6-rc.3
Check that the plugin is enabled
Open $DSH_HOME/profiles/web/package.json. With no DSH_HOME override, this is .dsh/profiles/web/package.json under your home directory.
Ensure dsh.profile.bundles contains dsh-llm-newapi. Host 0.1.5 registers installed bundle plugins automatically. On an older host or an existing profile where the entry is missing, append it once and preserve the other entries. This is a JSON fragment to check, not a replacement for the entire file:
{
"dsh": {
"profile": {
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"dsh-llm-newapi"
]
}
}
}
Check the installed versions, then restart dsh Web:
dsh --version
dsh plugin --profile web list dsh-llm-newapi
dsh web
First use
- Open NewAPI in dsh Web settings.
- Enter your gateway URL, such as
https://your-gateway.example/v1, and API key. Include /v1; do not enter the full /chat/completions path.
- Click Fetch models, select the models you need and add the selected entries.
- Optionally fetch model information from models.dev. Review context limits, output limits and reasoning efforts before applying values.
- Click Save, then choose a model under the
newapi provider in the conversation model picker.
Model discovery queries your gateway for available models. models.dev is a public parameter catalog; a match does not establish that your gateway supports a model or feature. Save after applying catalog values.
Capabilities and limits
| Feature | Behavior |
|---|
| Text, reasoning content and tool calls | Streaming supported; an explicit reasoning effort is sent as reasoning_effort |
| Image input | The adapter currently declares text-only input |
| Model discovery | Queries /models and filters names containing embed, rerank or ranker; this is not a capability probe |
| Model parameters | Edit manually or match against models.dev; verify against your gateway |
| API key | Saved through settings, never echoed; a blank input preserves the stored key |
| Multiple gateways | One newapi route and one gateway configuration are currently supported |
Upgrading and troubleshooting
Check the version table, stop dsh Web and back up your dsh configuration and session data before upgrading. Install the target host and exact plugin version, keep the existing bundle entry and restart. The plugin retains the llm-newapi settings namespace and newapi credential reference.
Host 0.1.5 migrates session data; older hosts cannot directly read migrated sessions. Reinstalling an older npm version alone is not a complete rollback. See the upstream migration guide.
| Symptom | Check first |
|---|
| No NewAPI settings page | The web profile, bundle entry, host compatibility and whether Web was restarted |
| Missing credential | Enter and save the key in NewAPI settings; the plugin does not read NEWAPI_API_KEY |
| Discovery fails | The /v1 base URL, API key and gateway support for /models |
| Empty model list | Name-based filtering; manually add a model only if it supports chat-completions |
| models.dev download fails | Network and proxy settings; the plugin proxy applies to this download, while host 0.1.5 also applies environment proxy settings |
| Missing-peer warnings during install | dsh supplies host packages. If installation and startup succeed, do not install duplicate host packages just to silence these warnings; investigate actual startup errors separately |
Documentation
The detailed guides below are currently in Chinese:
See GitHub Releases for published changes and downloadable packages.
