DSH (DeepSeek Harness) uses a plugin-based architecture. When developers use agents, they often need to call paid models or manage keys and failover across multiple free model sources. The following section introduces dsh-freeroute, which addresses these pain points.

What is this

dsh-freeroute is a free model aggregation plugin for DeepSeek Harness. It is maintained by user dushaobindoudou. It registers a freeroute model provider and supports automatic failover and fixed models.

Core Features

The plugin has the following capabilities:

  1. Registers a freeroute model provider (supports automatic failover and fixed models).
  2. Multi-key rotation and visibility into key invalidation.
  3. Local OpenAI-compatible endpoint.
  4. Automatic failover before the first token arrives.
  5. Handles rate limits and key invalidation.

Installation and Enablement

Before installing, ensure that the environment meets the following requirement: Node.js ≥ 18.

Run the following command to install the plugin:

dsh plugin --profile web add dsh-freeroute

Typical Usage

After installation, it can be used in the following ways:

  1. Configure the API key and run it.
  2. Use the local endpoint for testing:
curl http://127.0.0.1:3080/freeroute/v1/chat/completions
  1. Register the adapter in code:
llm.registerAdapter(['freeroute'], adapter)

Notes

When using this plugin, note the following:

  • Free refers only to the provider’s legitimate free tier, not to shared account pools.
  • Keys are stored only in the credential service, not in configuration files in plaintext.
  • The plugin runs with the permissions of the current DSH process.

Summary

dsh-freeroute aggregates free-tier model sources, simplifying the configuration process and providing failover capability. More details can be found in the plugin directory or the GitHub repository.