dsh-desktop
DeepSeek Harness 桌面端:自动拉起 dsh web 服务并在独立窗口加载 UI(macOS / Windows / Linux)
安装
此插件尚未提供可验证的 bundle,或兼容性检查未通过。请先阅读仓库说明。 阅读完整 README ↗
说明文档
阅读完整 README ↗DeepSeek Harness Desktop
把 DeepSeek Harness(dsh web)封装成跨平台桌面应用:双击图标即可打开,无需每次手动启动服务、再开浏览器输网址。
支持 macOS / Windows / Linux,官方 logo 图标(白色星标衬黑底)。
特性
- 一键启动:自动拉起
dsh web服务(默认端口 3080),就绪后加载 UI - 智能复用:如果服务已经在运行(比如你在终端里跑过
dsh web),直接复用,不重复启动 - 生命周期管理:退出应用时自动关闭它自己拉起的服务进程;复用已有服务时不会误关别人的
- 独立窗口:无地址栏、无标签页,固定到 Dock / 任务栏后和原生 App 体验一致
- 官方图标:DeepSeek 官方 logo(白色星标衬黑底),矢量渲染
- 服务守护:服务进程意外退出时弹窗提示,可一键重启
- 复用你的配置:直接使用本机
~/.dsh(Windows 为C:\Users\\.dsh)下现有的 profile、插件、会话数据,与命令行体验完全一致
安装
从 Releases 下载对应系统的安装包:
| 平台 | 安装包 |
|---|---|
| macOS | DeepSeek-Harness-*-mac-arm64.dmg(Apple Silicon)或 -mac-x64.dmg(Intel) |
| Windows | DeepSeek-Harness-Setup-*.exe(安装器)或 DeepSeek-Harness-Portable-*.exe(免安装) |
| Linux | DeepSeek-Harness-*.AppImage |
前置条件:桌面端是 DeepSeek Harness 的"壳",需要本机装有
dshCLI。 只要你在终端跑过一次npx @deepseek-ai/dsh web(或在终端全局安装过dsh),桌面端就能自动发现并复用; 找不到时也会提示你用 npx 在线启动(需要联网)。
未签名说明:未配置签名密钥的构建产物没有代码签名,首次打开时系统可能拦截:
- macOS:右键点击 App →「打开」(Gatekeeper 提示仅首次出现);或终端执行
xattr -dr com.apple.quarantine- Windows:SmartScreen 提示时点「更多信息」→「仍要运行」
想要正式分发(无拦截、可公证):参见 docs/SIGNING.md —— 配置 Apple Developer ID 签名 + 公证、Windows 证书签名(OV / Azure Trusted Signing / SignPath),CI 已内置全部密钥注入。
工作原理
- 启动时探测
http://127.0.0.1:3080是否已有 DSH 服务(按首页的__DSH_BOOT__标记判断) - 没有则在本机查找
dshCLI(查找顺序:$DSH_CLI→ npm 全局安装 → npx 缓存,取最新),找不到则询问是否用npx在线启动 - 用 Electron 自带的 Node 运行时( + )启动 ,不依赖用户 shell 的 PATH