koompi/dsh-desktop

DSH Desktop

DeepSeek Harness 的 Electron 外壳。
它将已发布的 dsh CLI 作为 sidecar 运行，并在窗口中显示 dsh web。
上游代码没有被 fork 或打补丁。

工作原理

1. 捆绑的 Node 24 运行 runtime/node_modules/@deepseek-ai/dsh/lib/bin.js web --port 0 --no-open。
2. dsh web 在操作系统选择的端口上绑定 127.0.0.1，并打印 dsh web: http://127.0.0.1:/?token=...。
3. 主进程在 BrowserWindow 中加载该 URL。
token 会像在浏览器中一样变成 HttpOnly cookie，因此上游的 loopback 绑定、登录和 origin 防护保持不变。
4. 关闭窗口会向 sidecar 发送 SIGTERM，并等待其退出后 Electron 才退出。

会话数据存放在 ~/.dsh（或 $DSH_HOME）中，与 dsh CLI 共享。
环境中的 DSH_TELEMETRY_DISABLED=1 会关闭上游的反馈遥测。

构建

需要 Bun、jq、curl，以及对 nodejs.org、npmjs.org 和 GitHub 的网络访问。

bun install                 # Electron + electron-builder
(cd runtime && bun install) # the upstream dsh runtime
scripts/build-appimage.sh   # fetches Node 24, compiles src/main.ts, builds release/*.AppImage

为当前用户安装构建好的 AppImage（启动器位于 PATH、hicolor 图标、桌面条目；重新构建后再次运行即可升级）：

scripts/install-local.sh

无需打包，直接从源码运行：

scripts/fetch-node.sh
bun run start

从上游拉取更新

整个上游就是一个固定版本的依赖，即 runtime/package.json 中的 @deepseek-ai/dsh。

scripts/update-upstream.sh          # follow the "alpha" npm dist-tag
scripts/update-upstream.sh latest   # follow "latest"
scripts/update-upstream.sh 0.1.3    # pin an exact version
scripts/build-appimage.sh

该脚本会重写版本固定、重新安装，并且除非安装的 CLI 报告目标版本，否则会失败。
请将 runtime/package.json 和 runtime/bun.lock 一起提交。
默认使用 alpha，因为上游在那里发布预发布版本，而 latest 会滞后。

目录结构

| 路径 | 用途 |
|---|---|
| src/main.ts | Electron 主进程：sidecar 启动、窗口、关闭 |
| runtime/package.json | 唯一的上游版本固定 |
| scripts/fetch-node.sh | 经过校验的捆绑 Node 二进制下载 |
| scripts/update-upstream.sh | 升级上游版本固定 |
| scripts/build-appimage.sh | 完整的 AppImage 构建 |
| scripts/install-local.sh | 按用户安装构建好的 AppImage |
| electron-builder.yml | 打包：Node 和 runtime 作为 extraResources 放在 asar 之外 |

已知限制

- 仅支持 Linux AppImage。Windows 和 macOS 需要在 scripts/fetch-node.sh 中提供各平台的 Node，以及各自的 electron-builder 目标。
- 应用图标是 Electron 的默认图标。
- harness 中的原生文件夹选择器使用 zenity 或 kdialog；如果没有它们，则使用应用内浏览器选择器。
- 上游是预发布版本，其会话格式没有兼容性承诺，因此上游升级可能会拒绝旧的 ~/.dsh 数据。