前言¶
DSH 的理念是「一切皆插件」，扩展能力通常以插件方式挂到 dsh 进程上。对于已经在用 dsh Web UI、但希望以桌面窗口方式使用的场景，ahikl/dsh-desktop 提供了一个桌面端插件：使用 Electron 包装 dsh Web UI，并提供系统托盘与自定义标题栏。
这是什么¶
dsh-desktop 是 ahikl 维护的 DeepSeek Harness 桌面端插件。它是一个 out-of-tree 插件，不修改 dsh 源码，也不把 Electron 引入 dsh 依赖树。许可证为 MIT。
核心功能¶
下面介绍几个桌面端能力。
- 使用 Electron 加载 dsh Web UI。
- 无边框窗口 + dsh 风格标题栏，自动跟随主题。
- 系统托盘：显示主窗口、打开浏览器、退出。
- 关闭窗口时最小化到托盘。
- URL 解析优先级：
--url> Web Server 端口 > 自动启动dsh web。
安装与启用¶
先安装插件，再运行 desktop 命令：
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop
如果要显式指定 Web UI 地址，使用 --url：
dsh --profile desktop desktop --url http://127.0.0.1:3080
0.3.1 及以下版本已废弃，请使用最新版。
典型用法¶
没有安装 dsh-web-app 时，桌面插件会自动启动官方 Web UI：
dsh plugin --profile desktop add @ahikl/dsh-desktop electron
dsh --profile desktop desktop
已经安装 dsh-web-app 时，可以按下面的组合安装，再运行：
dsh plugin --profile desktop add @ahikl/dsh-desktop @deepseek-ai/dsh-web-app electron
dsh --profile desktop desktop
经过上面的步骤，桌面端会按 --url、Web Server 端口、自动启动 dsh web 的顺序解析目标地址。
适用场景与注意¶
适合希望把 dsh Web UI 放到桌面窗口中使用、需要托盘入口和标题栏的开发者。
注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
package.json声明electron为可选 peerDependency。- 该插件不修改 dsh 源码，也不把 Electron 引入 dsh 依赖树。
链接¶
- GitHub：https://github.com/ahikl/dsh-desktop
- 目录页：https://www.skillhub.cn/plugins/ahikl/dsh-desktop
