lynkr-dsh-plugin: 将 Lynkr 注册为 DeepSeek Harness 的自定义 OpenAI 提供商

前言¶

DeepSeek Harness (dsh) 的核心理念是“一切皆插件”。在社区插件目录中，lynkr-dsh-plugin 是一款用于将 Lynkr 集成到 dsh 中的工具。它的主要目的是解决多提供商模型调用时的成本与路由问题。

插件介绍¶

名称: lynkr-dsh-plugin
维护者: Fast-Editor
定位: DeepSeek Harness (dsh) 插件，用于注册 Lynkr 为自定义 OpenAI 兼容提供商。

Lynkr 是一个自托管的 LLM 分层路由网关，支持 Anthropic、OpenAI、Azure、Bedrock、Ollama、DeepSeek 等 15+ 个提供商。这款插件的作用是将 Lynkr 注册到 dsh 的配置中，让 dsh 能够通过 Lynkr 发起请求。

核心功能¶

自定义提供商注册：在 DeepSeek Harness 中注册 Lynkr，将其视为一个标准的 OpenAI 兼容接口。
智能路由：利用 Lynkr 的能力，根据请求复杂度自动路由至 15+ 个提供商中成本最低的可用模型层级。

安装¶

使用 dsh 的插件管理器安装：

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

使用步骤¶

安装后，配置文件会自动更新，你需要完成以下操作：

配置环境变量
设置 Lynkr 的 API 密钥环境变量：

   export LYNKR_API_KEY=anything

启动 Lynkr
确保 Lynkr 服务正在运行：

   lynkr start

在 dsh 中选择
在 DeepSeek Harness 的模型选择器中选择 lynkr 提供商。此时 dsh 实际调用的模型层级由 Lynkr 服务端根据请求难度决定。

配置详情¶

插件会在 $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

注意：插件逻辑设计为“永不覆盖”现有的 lynkr 配置项，也不会触碰其他提供商的设置。如果自动合并失败，它会打印出上述 YAML 代码块供手动添加。

适用场景与注意事项¶

非官方插件：该插件与 DeepSeek 无从属关系，未获其官方认可。
开发预览状态：DeepSeek Harness 的插件加载器 API 处于开发预览阶段，可能存在破坏性变更。
基于文档编写：插件源码是根据 DeepSeek 发布的文档编写的，未经过实际运行的 dsh 环境测试。目前无法确定 dsh 的插件加载器是否完全接受该插件的确切形状。
手动降级：由于 API 的不确定性，插件内置了容错机制。如果自动配置失败，它会打印 YAML 代码块，此时可手动添加配置以保持服务可用。

总结¶

lynkr-dsh-plugin 为 dsh 用户提供了接入 Lynkr 网关的便捷路径，适合希望利用 Lynkr 的分层路由能力来优化模型调用成本的开发者。