在 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接口,用于检测服务状态及可用路由。
安装与启用¶
- 安装插件。根据当前使用的 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
- 启动 Harness:运行
dsh web。 - 在界面中导航至 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 仓库。