Introduction¶

In the DSH ecosystem, model providers can be implemented as plugins; the community directory is an independent site and is not equivalent to the official app store. For developers who wish to use OpenCode Zen’s free models within dsh, manually managing model directories, metadata, reasoning depth, and error messages can be tedious. dsh-opencode-zen-free-provider, maintained by jiesou, is designed to integrate OpenCode Zen’s free models into dsh.

What is this¶

One-sentence positioning: dsh-opencode-zen-free-provider is the OpenCode Zen Free provider for dsh.

It mainly does a few things:

• Integrate OpenCode Zen’s free models into dsh for use.
• When the plugin starts, sync the model directory and all metadata from OpenCode Zen and models.dev, fetching only once without polling.
• License is MIT.

Core Features¶

Model List¶

The model list requires no configuration. Upon plugin startup, it automatically syncs and filters all free models from the remote.

Failure Fallback¶

If fetching fails at startup, the plugin can still mount normally and serves routes with an empty directory.

Context Length¶

The MiMo V2.5 backend additionally supports up to 1M context. This applies only to the MiMo V2.5 backend and cannot be inferred for all models.

Reasoning Depth¶

Reasoning depth only exposes the levels accepted by the upstream. Default indicates that the reasoning_effort field is not sent; Off sends the upstream’s literal disable value (e.g., none, off).

Error Messages¶

OpenCode Zen returns non-credential rejections (such as free quota expiration or regional restrictions) as HTTP 401/403. dsh categorizes these status codes as invalid API keys. This plugin preserves the real cause in the terminal error event; true authentication failures still follow the AUTH flow, and unparseable content is passed through transparently.

Installation and Usage¶

Install from npm¶

dsh plugin --profile web add @jiesou/dsh-opencode-zen-free-provider

Install from GitHub¶

dsh plugin --profile web add github:jiesou/dsh-opencode-zen-free-provider

Dependency Versions¶

The package.json declares peerDependencies, including version requirements such as @deepseek-ai/cordis >=4.0.1 <5. It is recommended to confirm that the current dsh environment meets these requirements before installation.

Enablement¶

After installation, you can start using it by selecting OpenCode Zen Free and a model on the Web Models page.

Typical Usage¶

Select Reasoning Depth¶

Default indicates that the reasoning_effort field is not sent, leaving the decision to the upstream; Off sends the upstream’s literal disable value (e.g., none, off).

Handling Network Retries¶

For models like Ox Alpha that frequently encounter network errors, it is recommended to manually set:

- id: opencode-zen-free-provider
  name: '@jiesou/dsh-opencode-zen-free-provider'
  config:
    retryPolicy:
      mode: always

Applicable Scenarios and Notes¶

• Suitable: Developers who want to use OpenCode Zen free models in dsh and do not want to manually maintain model directories, metadata, and error messages.
• Permissions: The plugin runs with the current dsh process permissions; source code and license should be checked before installation.
• Rate Limiting: OpenCode’s Free models will be rate-limited based on IP.
• Error Codes: OpenCode Zen’s non-credential rejections are returned as HTTP 401/403; the plugin will preserve the parseable real cause; true authentication failures still follow the AUTH flow.
• Context: 1M context is explicitly applicable to the MiMo V2.5 backend.
• Installation Source: Supports installation from npm or GitHub.

Conclusion¶

The core value of dsh-opencode-zen-free-provider is integrating OpenCode Zen’s free models into dsh: synchronizing the model directory and metadata at startup, exposing reasoning depth according to upstream rules, and preserving more specific rejection reasons in error events.

GitHub: https://github.com/jiesou/dsh-opencode-zen-free-provider
Directory page (Not found in the captured materials for this update): https://www.skillhub.cn/plugins/jiesou/dsh-opencode-zen-free-provider