原生窗口启动器kkaktus463/dsh-plugin-desktop

dsh-plugin-desktop

在原生窗口中打开 DeepSeek Harness Web UI，而不是浏览器标签页。

该插件不会自行启动 harness。它加载时进程已经在监听端口，因此窗口只是连接过去。
归属权保持在一处：harness 的生命周期长于窗口，关闭窗口绝不会让服务器停止。

前置条件

窗口本身是独立的应用 DSH Desktop。插件负责找到并启动它；若不
存在，界面仍留在浏览器中，同时向日志写入一条警告。

目前仅支持 Windows。

安装

dsh plugin --profile web add dsh-plugin-desktop

从本地目录安装：

dsh plugin --profile web add ./dsh-plugin-desktop

不启动 harness，仅确认配置层已生效：

dsh --profile web --dump-config

配置

组合包的 patch 已经从 webStartup 服务读取地址和端口，也就是 web 应用实际绑定的
值。

| 字段 | 含义 |
|---|---|
| port | harness 端口，默认取自 webStartup。 |
| host | 地址。仅在回环地址上才会打开窗口。 |
| executable | 自动查找失败时，dsh-desktop.exe 的完整路径。 |

查找顺序为 %LOCALAPPDATA%\DSH Desktop、%LOCALAPPDATA%\Programs\DSH Desktop、
%PROGRAMFILES%\DSH Desktop，随后是 PATH。

在自己的 profile 中覆盖路径 —— $DSH_HOME/profiles/web/cordis.patch.yml：

- id: desktop
config:
executable: 'C:\Tools\DSH Desktop\dsh-desktop.exe'

patch 会替换该配置行的整个 config，因此覆盖时必须重述所有需要的字段，而不只是
被修改的那一个。

行为

- 服务器绑定在非回环地址上 —— 不打开窗口，并在日志中说明原因：此时浏览器才是合适
的载体。
- 应用已在运行 —— 再次启动会唤起已打开的窗口。
- 插件被卸载 —— 窗口关闭，harness 继续运行。

许可证

MIT。