桌面外壳客户端 SZMY-haruhi/dsh-desktop-shell

dsh-desktop-shell

DeepSeek Harness（dsh）桌面客户端 / 纯 Electron 外壳。
不打包任何 dsh 代码。启动时执行 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open，读取命令行打印的 dsh web: 行（形如 http://127.0.0.1:3080/?token=...），再把这个带启动 token 的地址载入窗口。自 0.1.2 起裸地址不会换到会话 cookie，页面会 401。版本钉在已测过的 0.2.0-rc.2，换版本时改 main.js。对所有插件完全透明。

界面预览

纯壳对插件透明——以下为 DSH Desktop 窗口化运行 dsh web 的实拍，皮肤与插件市场均原样生效。

| 深色 | 浅色 |
| Dark | Light |

社区皮肤 dsh-web-ui-all（全量皮肤包）—— 纯壳直接加载，无需修改：

dsh-web-ui-all

插件市场 dsh-market —— 打包版对 dsh-plugin 生态无影响，可正常浏览/安装：

Plugin Market

运行

前置

- Node.js ^22.19 || >=24（dsh 本体要求；外壳也用它来拉起 npx）
- 推荐 pnpm@11.7.0，npm/yarn 亦可

发行版

下载 DSH Desktop Shell Setup 0.1.1.exe 安装后双击 DSH Desktop Shell，首次启动自动 npx 拉取 @deepseek-ai/dsh@0.2.0-rc.2 并打开 Web UI。

源码

git clone https://github.com/<you>/dsh-desktop-shell.git
cd dsh-desktop-shell/dsh-desktop-electron
pnpm install
pnpm start # 调试：拉起本地 npx dsh web
pnpm run build # 打包：electron-builder → dist/DSH Desktop Shell Setup 0.1.1.exe（~80MB，含 Chromium）

无需克隆 deepseek-harness。npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open 是唯一真源，对应上游 dsh web --no-open（web-app 手册）。

架构

main.js 负责 spawn（--no-open，管道读取 stdout/stderr）→ 匹配 dsh web: http(s)://…?token=… → BrowserWindow 加载该地址。关窗口只藏到托盘；托盘「退出」或进程退出时才结束子进程。与所有 dsh-plugin 无冲突（透明壳）。

配置

无配置文件。main.js 常量：启动命令 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web --no-open、等待 dsh web: 行 180s、窗口 1280×800。默认监听仍是上游的 127.0.0.1:3080，实际打开的是命令行打印的 URL。再次打开窗口时加载该源站的 /，不再重复使用启动 token。

模型可见性

无。作为独立宿壳，不贡献提示词片段、工具 schema 或会话事件；模型可见行为完全由被拉起的 dsh 进程及其插件决定。

已知限制

- 固定端口： 外壳不传 --port。上游默认 127.0.0.1:3080。端口被占用时，启动页显示失败，而不会去加载别人的服务。
- 单实例： requestSingleInstanceLock() 会把已有窗口调到前台。
- 托盘： 点关闭只隐藏窗口。托盘「退出」或应用退出时才停止我们拉起的 dsh web。没有开机自启。
- 就绪： 等待 dsh web: 行，最多 180 秒。超时会结束我们的子进程。失败页有「重试」。
- Chromium 体积： NSIS 安装包大约 81MB，因为 Electron 自带 Chromium。
- Windows 优先： shell: true 以便走 npx.cmd。退出时优先 taskkill 我们的进程树；只有失败时才按端口查找，并且本地地址必须整列相等、PID 必须是我们的进程或其子进程。
- POSIX 进程组： 子进程 detached，正常退出、SIGINT、SIGTERM 会给整个进程组发 SIGTERM。SIGKILL 抓不到，可能留下孤儿 dsh web。

许可

MIT，与上游一致。

作者

感谢 Star ❤️ — tonkatsu258 · 个人网站