Fast-Editor/lynkr-dsh-plugin

lynkr-dsh-plugin

一个 DeepSeek Harness（dsh）插件，将 Lynkr —— 一个自托管、多提供商 LLM 分层路由网关 —— 注册为自定义的 OpenAI 兼容提供商。

Lynkr 位于编码代理和聊天客户端之前，将每个请求路由到实际能够处理它的最便宜模型层级（按请求对难度进行分类），覆盖 15+ 个提供商 —— Anthropic、OpenAI、Azure OpenAI、Bedrock、Vertex、OpenRouter、Moonshot、Baidu、Z.AI、Ollama、DeepSeek 等。

非官方 / 社区插件

本插件不隶属于 DeepSeek，也未获得其认可。DeepSeek Harness 自己的仓库不接受对其内置提供商目录的外部拉取请求（参见其 CONTRIBUTING.md）—— 发布一个标记为 dsh-plugin 的包是他们为社区集成所记录的途径，所以这就是本插件所采用的方式。

验证状态 —— 在依赖本插件之前请先阅读

本插件是针对 DeepSeek Harness 的已发布文档（docs/user/develop/basic/publish.md、docs/user/guide/providers.md）编写的，而非针对一个实际运行的 dsh 安装 —— 我在编写时没有可用的安装环境。具体来说，这意味着：

- ✅ TypeScript 源码（src/index.ts）语法有效（已用 Node 的类型剥离加载器检查）。
- ✅ 它写入的 settings.yaml 结构逐字匹配 DeepSeek 自己文档中记录的自定义提供商 schema。
- ✅ package.json → dsh.bundle.patch → cordis.patch.yml → 插件行的接线方式逐字匹配他们文档中记录的 bundle 清单 schema。
- ⚠️ 尚未确认：dsh 实际的插件加载器是否端到端接受这一确切结构（例如 dsh plugin --profile  add lynkr-dsh-plugin 能否成功加载并调用 apply()）。他们的插件 API 表面被明确标记为“开发者预览……快速迭代，伴随破坏兼容性的变更”。

由于这种不确定性，本插件被编写为故障安全：如果加载或 settings.yaml 合并的任何环节未按预期进行，它不会做任何更改，而是打印出需要手动添加的确切 YAML（参见下面的“手动设置”—— 该路径完全不依赖插件加载器，并且始终有效）。

如果你在真实的 dsh 安装上尝试了本插件，请提交 issue 或 PR 说明你的发现 —— 首个真实环境确认将在此处注明。

安装（发布后）

dsh plugin --profile  add lynkr-dsh-plugin

在下次加载时，这会将以下内容添加到 $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

然后：
1. export LYNKR_API_KEY=anything（Lynkr 默认不对本地请求强制认证 —— 如果你已经对其进行了锁定，请将此设置为你的实例实际期望的值）。
2. 确保 Lynkr 正在运行：lynkr start（参见 Lynkr 仓库）。
3. 在 dsh 的模型选择器中选择 lynkr 提供商。你在那里选择的任何模型都只是一个标签——Lynkr 自己的层级路由器会根据请求复杂度在服务端决定真正的后端。

它绝不会覆盖现有的 lynkr 条目，也绝不会触碰任何其他提供商的配置。

手动设置（无需插件）

完全跳过插件，直接将上面的配置块添加到 $DSH_HOME/settings.yaml 中即可。这是插件在自动合并失败时会打印的备用路径，作为你的起点同样有效。

开发

npm install
npm run build

许可证

MIT