Foreword

In the daily use of DSH, integrating models into intelligent agents often involves handling registration, API keys, billing, and other steps. dsh-opencode-zen provides an alternative path: it integrates OpenCode Zen’s free-tier models into the dsh web model selector, allowing you to directly choose a free model to start using.

Below, we will introduce its positioning, core capabilities, installation methods, and important considerations.

What Is This

dsh-opencode-zen is a DSH plugin maintained by xiaozhe7772222, licensed under MIT. Its positioning is:

OpenCode Zen free-tier models for DeepSeek Harness: zero-config public-key provider with quota-aware pacing.

In simple terms, it solves the problem of “quickly using OpenCode Zen’s free models in DSH.” The plugin exposes the opencode provider, integrates 6 free models, and includes built-in 429/5xx backoff and request throttling.

Core Features

  • Integrates 6 free models: DeepSeek V4 Flash, Xiaomi MiMo, Tencent Hunyuan, two NVIDIA Nemotrons, and Laguna S 2.1.
  • Zero configuration, zero cost: No registration, API keys, or billing required.
  • Exposes the opencode provider through the dsh web model selector.
  • Can be used with dsh-api-key-pool for multi-key rotation.
  • Includes built-in 429/5xx backoff and request throttling.
  • Supports streaming, reasoning-content passthrough, and tool calls.
  • Supports reasoning effort: off / low / high / max.
  • Falls back to the official public tier (public) if not configured.
  • Requires DSH 0.8.0+ and the ctx.llm.registerAdapter API; older versions may need manual route registration.

Installation and Enabling

First, confirm that your DSH version meets the requirements: DSH 0.8.0+ with the ctx.llm.registerAdapter API. Older versions may require manual route registration.

  1. Install the plugin:
dsh plugin --profile web add github:xiaozhe7772222/dsh-opencode-zen
  1. Verify the installation:
dsh plugin --profile web list
  1. Restart dsh web, go to Settings → Models, select the opencode provider, and choose a free model. It is recommended to start with deepseek-v4-flash-free.

Typical Usage

Default Zero-Configuration Use

When no keys are set, the plugin falls back to the official public tier (public). After installation and restart, simply enter the model selector and choose the corresponding model.

Using Multiple Key Rotation

If you need to use multiple accounts, you can do the following:

  1. Install dsh-api-key-pool.
  2. Add keys to the opencode pool.
  3. The plugin will automatically rotate the keys.

Using Environment Variables

If explicit configuration is needed, set the following before starting dsh web:

export OPENCODE_ZEN_API_KEY=...

Or:

export OPENCODE_GO_API_KEY=...

Compatibility and Dependency Information

package.json declares peerDependencies:

{
  "@deepseek-ai/cordis": "^4.0.1",
  "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
  "@deepseek-ai/schemastery": "^3.18.1"
}

package.json also declares the dsh bundle patch as:

./cordis.patch.yml

Applicable Scenarios and Notes

Suitable for:

  • Quickly integrating free models into dsh web without processing registration, API keys, or billing.
  • Needing support for streaming, tool calls, and reasoning-content passthrough.
  • Wanting to use dsh-api-key-pool for multi-key rotation.
  • Requiring 429/5xx backoff and request throttling to control quotas.

Notes:

  • Service availability and quota limits are subject to OpenCode Zen’s policies; this plugin is merely a client-side adapter.
  • The free tier has per-IP rate limiting; if you encounter a 429 error, you can wait for 30–60 seconds or use dsh-api-key-pool to rotate keys.
  • The plugin runs with the permissions of the current dsh process; you should review the source code and license before installation.
  • Requires DSH 0.8.0+ with the ctx.llm.registerAdapter API; older versions may need manual route registration.

Conclusion

The value of dsh-opencode-zen lies in integrating OpenCode Zen’s free-tier models into DSH’s model selector in a zero-configuration manner while retaining streaming, tool calls, and quota awareness. It is suitable for scenarios requiring low-cost, quickly usable DSH plugin integration.

GitHub: https://github.com/xiaozhe7772222/dsh-opencode-zen