dsh-models-plus:DeepSeek Harness 本地回环路由代理插件

在 DeepSeek Harness 的开发流程中,外部客户端往往需要通过特定的 API 协议直接访问本地模型。手动配置反向代理不仅繁琐,还容易产生版本兼容问题。dsh-models-plus 插件旨在解决这一痛点,通过官方扩展插槽,为 Harness 提供一个开箱即用的本地路由代理服务。

这是一个由用户 gongstudent 维护的插件,隶属于“联网工具”类别。它利用 DSH 的官方扩展机制,在本地运行一个监听回环地址(127.0.0.1)的代理服务,负责将 OpenAI 和 Anthropic 格式的请求转发给 Harness 内部配置的模型提供者。

核心功能

  • 本地回环路由代理:提供一个默认端口为 8317 的本地代理服务,仅绑定 127.0.0.1,确保安全性。
  • 双向协议桥接:支持 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) 协议,允许外部客户端(如 Cline、Claude Dev、Cursor、LibreChat)无缝连接。
  • 零冲突 UI 扩展:通过官方 settings.models.footer 插槽集成,不替换核心包,避免版本更新导致的功能失效或界面空白。
  • 健康检查与路由发现:提供 /health 接口,用于检测服务状态及可用路由。

安装与启用

  1. 安装插件。根据当前使用的 Harness 档案(Web 或 Desktop)选择对应命令:
    dsh plugin --profile web add -w github:gongstudent/dsh-models-plus
或
    dsh plugin --profile desktop add -w github:gongstudent/dsh-models-plus
  1. 启动 Harness:运行 dsh web。
  2. 在界面中导航至 Settings -> Models,插件提供的“Local Route Proxy”卡片将显示在设置页面的底部。

典型用法

启动后,使用 curl 验证服务是否正常:

curl http://127.0.0.1:8317/health

正常响应示例:

{"status":"ok","host":"127.0.0.1","routes":["deepseek","openai","anthropic"],"endpoints":["/v1/chat/completions","/v1/responses","/v1/messages"]}

适用场景与注意

  • 适用场景:需要在本地运行模型,同时希望外部工具能像调用官方 API 一样通过本地端口进行对话的开发者。
  • 重要注意:
    • 该插件仅监听本地回环地址(127.0.0.1),无法从局域网内的其他机器访问。
    • 插件不存储密钥,请求会直接使用 Harness 上游配置好的凭据。
    • 不包含任何遥测数据收集功能。
    • 兼容 Web 和 Desktop 档案(v0.1.x / v0.2.x 及更高版本)。

dsh-models-plus 通过插件化的方式,让本地路由代理变得轻量且稳定。关于更多细节,请查阅插件目录或GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜