在使用 DeepSeek Harness (DSH) 进行智能体开发时,若要在本地运行大模型,通常需要手动配置适配器或调整代码。这不仅增加了环境搭建的复杂度,还可能涉及不必要的云端 API 调用。dsh-plugin-lmstudio 插件旨在简化这一流程,将 LM Studio 的本地推理能力直接映射到 DSH 的对话模型层。
这是什么¶
这是一个 DSH 插件,由 starlightzfy 维护。它通过注入 OpenAI 兼容的路由,让 DSH 的模型选择器能够识别并使用 LM Studio 中加载的本地模型,从而在不消耗云端 API 额度的情况下完成对话。
核心功能¶
- 使用 LM Studio 模型作为 DSH 聊天模型。
- 无需云端 API 额度。
- 通信仅发送到
127.0.0.1:1234。 - 提供默认
lm-studio提供商路由。 - 无需 API 密钥(针对本地服务器)。
安装与启用¶
- 确保已安装 DSH CLI 和 pnpm。
- 执行安装命令:
dsh plugin --profile web add dsh-plugin-lmstudio
- 安装完成后,重启 DSH Web 应用(运行
dsh web),并刷新浏览器页面(通常是 http://127.0.0.1:3080)。
配置与用法¶
- 启动服务与加载模型:在 LM Studio 中进入开发者模式(Developer -> Start Server),默认端口为
1234,并确保至少加载了一个模型。 - 获取模型 ID:在终端执行
curl http://127.0.0.1:1234/v1/models,查看返回数据中的id字段(通常格式为owner/name)。 - 配置模型:可以在 DSH 界面中点击“Settings → Models”下的“ask the endpoint”按钮自动发现模型,或直接编辑配置文件。
- 编辑配置文件:插件内置的
lm-studio路由是基础层,可在$DSH_HOME/settings.yaml中进行覆盖配置。
示例配置:
llm-pi-ai:
providers:
lm-studio:
models:
- id: qwen/qwen3.5-9b
name: Qwen3.5 9B (LM Studio)
contextWindow: 8192
maxTokens: 4096
配置文件支持热重载,无需重启 dsh web。
注意事项¶
- 需要在 LM Studio 中启动服务器(默认端口
1234),且至少加载一个模型。 - 插件以当前 dsh 进程的权限运行,请确保环境安全。
- 如果 LM Studio 启用了密钥认证,需在 DSH 的设置层添加
apiKeyEnv或在请求头中添加Authorization。 - 插件许可证为 MIT。
结尾¶
经过上述配置,DSH 的对话模型层即可接入本地模型。该插件适合需要在本地隔离环境运行模型、避免云端 API 限额限制的开发者。插件仓库与目录链接如下:
- GitHub 仓库
- 插件目录