DeepSeek Harness (DSH) 默认通过浏览器访问其 Web UI。对于习惯本地应用的开发者来说,每次启动都打开标签页略显繁琐。dsh-plugin-desktop 插件提供了一种替代方案,它允许 DSH 的 Web 界面在本地原生窗口中运行,而不是作为浏览器标签页。
这是一个由 kkaktus463 维护的插件。它的核心作用是拦截 DSH 的 Web 启动请求,将其呈现为桌面窗口。它不会启动新的 Harness 进程,而是将现有进程附加到窗口上。所有权保持在一个地方:Harness 的生命周期长于窗口,关闭窗口永远不会停止服务器。
核心功能¶
该插件提供以下能力:
- 在原生窗口中打开 DeepSeek Harness Web UI。
- 将现有服务器进程附加到窗口。
- 允许配置 host、port 和 executable。
- 检查并启动 DSH Desktop 应用程序。
安装与启用¶
使用官方 CLI 安装插件:
dsh plugin --profile web add dsh-plugin-desktop
如果使用本地目录,可以使用:
dsh plugin --profile web add ./dsh-plugin-desktop
安装后,检查配置是否生效(不启动 Harness):
dsh --profile web --dump-config
典型用法¶
默认情况下,插件会从环境变量或搜索路径中查找 dsh-desktop.exe。如果自动查找失败,可以在配置文件中指定路径。
配置文件位置通常为 $DSH_HOME/profiles/web/cordis.patch.yml:
- id: desktop
config:
executable: 'C:\Tools\DSH Desktop\dsh-desktop.exe'
注意:补丁会替换整行 config,因此覆盖必须重申它需要的每个字段,而不仅仅是更改的字段。
适用场景与注意¶
- 系统要求:目前仅支持 Windows 系统。
- 依赖:需要安装 DSH Desktop 应用程序,否则会显示警告,界面将回退到浏览器。
- 权限与行为:插件以当前 DSH 进程的权限运行。关闭原生窗口不会停止 DeepSeek Harness 服务器,服务器生命周期独立于窗口。
- 网络绑定:如果服务器绑定到非环回地址(如 0.0.0.0 或局域网 IP),窗口不会打开,因为此时浏览器是更合适的访问入口。
通过这个插件,可以将 DSH 的开发体验更贴近桌面应用。该插件遵循 MIT 许可证。更多细节可查阅 GitHub 仓库:https://github.com/kkaktus463/dsh-plugin-desktop