桌面客户端 Lotus-c/DSH-Desktop

DSH Desktop

DeepSeek Harness（dsh）的非官方桌面客户端，基于 Tauri 2 构建。

⚠️ 本项目与 DeepSeek 官方无关，DeepSeek 名称与相关商标归其权利方所有。

特性

- 双击即用：自动在后台静默启动 dsh 服务（127.0.0.1:3080），不弹出终端窗口，不打开浏览器
- 内嵌 WebView 直接使用 dsh Web UI
- 系统托盘：单击恢复窗口、双击唤出、菜单支持重试启动 / 查看日志 / 退出
- 真实事件通知：接入 dsh WebSocket 事件源，待审批、提问到达时推送系统通知（可在托盘静音）
- 关闭窗口 = 最小化到托盘，后台服务继续运行，退出应用时才结束服务进程
- 全局快捷键唤出 / 隐藏窗口（按可用性依次尝试 Ctrl+Alt+Space、Ctrl+Alt+D、Ctrl+Alt+H、Alt+Shift+D）
- 下载完成 / 失败通知
- 浅色 / 深色模式适配，任务栏（Windows）自动切换托盘图标
- 首次启动自动下载并管理 Node.js 运行时与 @deepseek-ai/dsh
- dsh 服务异常退出时自动重启

工作原理

DSH Desktop (Tauri)
├─ 托管 Node.js 运行时（首次自动下载） ├─ npm install @deepseek-ai/dsh ├─ 静默启动 dsh web 服务 → http://127.0.0.1:3080 ├─ 内嵌 WebView 加载上述地址 └─ WebSocket 监听 /api/events.mux，转发到系统通知

下载

在 Releases 页面选择对应平台：

| 平台 | 安装包 |
| Windows | .exe（NSIS）、.msi |
| macOS | .dmg（通用二进制，Intel + Apple Silicon） |
| Linux | .deb、.rpm、.AppImage |

说明：

- macOS 安装包使用 ad-hoc 签名（未公证），首次打开请在访达中右键应用选择「打开」，或执行 xattr -dr com.apple.quarantine /Applications/DSH\ Desktop.app。
- Linux AppImage 需要系统支持 FUSE；不支持时可用 ./DSH_Desktop_*.AppImage --appimage-extract-and-run 运行。
- Linux 下系统通知依赖 libnotify / DBus，托盘依赖 AppIndicator；精简发行版请安装 libnotify4、libayatana-appindicator3-1。

开发构建

前置要求：Node.js ≥ 18、Rust stable、对应平台的 Tauri 系统依赖（Tauri 前置依赖）。

npm install
npm run tauri dev

打包：

当前平台全部默认产物
npm run tauri build

指定产物
npm run tauri build -- --bundles nsis,msi # Windows
npm run tauri build -- --bundles app,dmg # macOS
npm run tauri build -- --bundles deb,rpm,appimage # Linux

提示：仓库根目录的 .cargo/config.toml 使用 rsproxy.cn 镜像并 vendor 了 embed-resource，用于 Windows + MinGW 工具链下的本地构建；其他平台 / MSVC 同样兼容。

项目结构

src-tauri/ Tauri 后端（Rust）：服务生命周期、托盘、通知、快捷键、下载 ui/ 启动等待页（服务就绪后跳转到 dsh Web UI） vendor/ Windows GNU 工具链所需的 embed-resource 补丁副本 .github/ CI / 多平台发布工作流

常见问题

- 日志位置
- Windows: %APPDATA%\com.dshdesktop.app\logs\dsh-desktop.log
- macOS: ~/Library/Application Support/com.dshdesktop.app/logs/dsh-desktop.log
- Linux: ~/.local/share/com.dshdesktop.app/logs/dsh-desktop.log
- 端口冲突：如果 3080 端口已被其他 dsh 实例占用，客户端会直接复用该实例。
- 首次启动较慢：需要下载 Node.js 运行时与 dsh 依赖，仅首次发生。

License

MIT