dsh-freeroute: DeepSeek Harness 免费模型聚合插件

前言¶

DeepSeek Harness (dsh) 提供了插件化的扩展能力。dsh-freeroute 是一个针对模型推理场景的插件，它通过聚合多个提供免费额度的上游模型服务，解决了单一模型源不稳定或额度耗尽的问题。

插件定位¶

这是一个由 0xrushmoon 维护的免费模型聚合插件，属于模型推理类工具。它通过注册 freeroute 模型提供商，连接内置及远程的免费额度上游。

核心功能¶

透明故障转移：在第一个 Token 到达会话之前，系统会自动切换上游。如果当前上游失败、限流或密钥失效，请求会转移到下一个可用节点。
多 Key 轮转：每个上游支持最多 8 个 API Key。当单个 Key 出现认证或限流错误时，系统会对该 Key 进行冷却处理并切换到下一个，直到找到可用 Key。
失败可见性：面板会显示警告信息，明确指出“第 N 把 Key 失效”，便于排查问题。
隐私保护：默认情况下，API Key 显示为掩码（••••••），只有点击“显示”后才会显示完整密钥。密钥仅存储在凭证服务中，不会出现在明文配置文件里。
内置免费上游：集成了 OpenCode Zen、B.AI、OpenRouter、SenseNova 等内置免费上游。
三层配置：配置优先级为内置目录 -> 远程目录 -> 用户补丁。

安装与启用¶

确保环境满足 Node.js ≥ 18，然后执行以下命令安装：

dsh plugin --profile web add dsh-freeroute

安装后，模型选择器中将出现 freeroute/auto（自动故障转移）和 freeroute/<upstream>/<model>（固定模型）选项。

典型用法¶

插件内置了一个 OpenAI 兼容的本地端点（默认端口 3080），其他工具可直接调用该接口使用免费模型池。

API 调用示例：

    curl http://127.0.0.1:3080/freeroute/v1/chat/completions \
      -H 'content-type: application/json' \
      -d '{"messages":[{"role":"user","content":"hello"}]}'

配置 API Key：在插件提供的“免费”面板设置中配置上游的 API Key。
使用模型：在 OpenAI 兼容端点中，将模型名设置为 auto，让系统自动选择优先级最高的上游。

注意事项¶

运行环境：插件以当前 dsh 进程的权限运行。
代理设置：全局代理默认关闭，可在设置中配置。
免费额度：这里指的是提供商合法的免费额度，而非共享账号池。

生态背景¶

DeepSeek Harness (dsh) 的理念是“一切皆插件”，社区目录与 DeepSeek 官方无官方从属关系。

插件主页：https://www.skillhub.cn/plugins/0xrushmoon/dsh-freeroute
源码地址：https://github.com/0xrushmoon/dsh-freeroute