Introduction

The core philosophy of DeepSeek Harness (dsh) is “everything is a plugin.” In the community plugin catalog, lynkr-dsh-plugin is a tool for integrating Lynkr into dsh. Its main purpose is to address cost and routing issues when invoking models from multiple providers.

Plugin Overview

Name: lynkr-dsh-plugin
Maintainer: Fast-Editor
Purpose: DeepSeek Harness (dsh) plugin for registering Lynkr as a custom OpenAI-compatible provider.

Lynkr is a self-hosted LLM tiered routing gateway supporting 15+ providers such as Anthropic, OpenAI, Azure, Bedrock, Ollama, and DeepSeek. This plugin registers Lynkr in dsh’s configuration so that dsh can send requests through Lynkr.

Core Features

  1. Custom provider registration: Register Lynkr in DeepSeek Harness as a standard OpenAI-compatible endpoint.
  2. Intelligent routing: Leverage Lynkr to automatically route requests to the lowest-cost available model tier among 15+ providers based on request complexity.

Installation

Install it using dsh’s plugin manager:

dsh plugin --profile <your-profile> add lynkr-dsh-plugin

Usage Steps

After installation, the configuration file is updated automatically. You need to complete the following steps:

  1. Configure environment variables
    Set the Lynkr API key environment variable:
   export LYNKR_API_KEY=anything
  1. Start Lynkr
    Make sure the Lynkr service is running:
   lynkr start
  1. Select it in dsh
    Select the lynkr provider in DeepSeek Harness’s model selector. The actual model tier invoked by dsh is determined by the Lynkr server based on request difficulty.

Configuration Details

The plugin writes the following configuration block to $DSH_HOME/settings.yaml:

llm-pi-ai:
  providers:
    lynkr:
      apiKeyEnv: LYNKR_API_KEY
      api: openai-completions
      baseURL: http://127.0.0.1:8081/v1
      models:
        - id: lynkr-auto

Note: The plugin is designed to “never overwrite” existing lynkr configuration entries and will not touch settings for other providers. If automatic merging fails, it prints the YAML code block above so it can be added manually.

Applicable Scenarios and Caveats

  • Unofficial plugin: This plugin has no affiliation with DeepSeek and is not officially endorsed by DeepSeek.
  • Developer preview: The plugin loader API in DeepSeek Harness is in developer preview and may undergo breaking changes.
  • Written against documentation: The plugin source was written based on documents released by DeepSeek and has not been tested in a live dsh environment. It is currently unclear whether dsh’s plugin loader fully accepts the exact shape of this plugin.
  • Manual fallback: Due to API uncertainty, the plugin includes a fallback mechanism. If automatic configuration fails, it prints the YAML code block so the configuration can be added manually to keep the service available.

Summary

lynkr-dsh-plugin provides dsh users with a convenient way to connect to the Lynkr gateway. It is suitable for developers who want to leverage Lynkr’s tiered routing capability to optimize model invocation costs.