桌面客户端microtree9/deepseek-harness-desktop

DeepSeek Harness 桌面版

DeepSeek Harness 的非官方社区桌面套壳

Windows 上安装方便、开箱即用的 DeepSeek Harness 桌面版。无需安装 Node.js、
npm 或任何环境——官方运行时已捆绑在应用内。

English · DeepSeek Harness · 下载

⚠️ 声明 —— 本项目为独立社区项目，与 DeepSeek 公司无隶属、背书或赞助关系。
DeepSeek Harness 运行时按原样分发，遵循其 MIT 许可证；详见
NOTICE 与 LICENSE。

下载与使用

当前版本内置 DeepSeek Harness 0.1.0-rc.6，应用本体版本与 Releases 保持一致。

1. 打开 Releases 页面，下载最新构建：
DeepSeek.Harness.Desktop.Setup.0.1.1.exe（NSIS 安装包），
按向导完成安装——会创建开始菜单快捷方式与桌面图标。
2. 由于二进制未做代码签名，Windows 可能弹出 SmartScreen 提示，
点击 更多信息 → 仍要运行 即可。
3. 从开始菜单或桌面图标启动，服务就绪后窗口会自动打开。

使用完毕直接关掉窗口，整个进程树会随之退出，不残留任何后台服务。

注意事项

- 应用需要写入上万个文件，在开启实时防护的机器上，安装可能耗时较长
（可能长达数十分钟），属正常现象，请耐心等待，不要中途结束进程。
- 快速安装：把你要安装到的目标文件夹（安装向导中选择的目录）
加入安全软件的信任区/白名单；或者临时关闭安全软件的实时防护，装完再打开。
- 快速启动应用：把安装目录（应用所在的文件夹）加入安全软件的信任区/白名单；
或者临时关闭安全软件的实时防护再启动。

工作机制

1. 单实例锁 —— 重复启动只会聚焦已有窗口。
2. 端口协商 —— 官方默认的 127.0.0.1:3080 空闲则用之，被占用则自动顺延。
3. 捆绑运行时 —— 固定版本的 @deepseek-ai/dsh 通过 Electron 内置 Node
（ELECTRON_RUN_AS_NODE）运行，用户无需预装任何东西。
4. 健康检查 —— 壳轮询本地服务，确认就绪后才加载页面。
5. 失败页 —— 服务崩溃或无法启动时，展示错误信息、实时日志尾部、
重试按钮和日志文件快捷入口。
6. 干净退出 —— 退出时杀掉整个 dsh 进程树（Windows taskkill /T），
不留孤儿进程。

┌──────────────────── DeepSeek Harness Desktop 窗口 ───────────────────────┐
│                                                                           │
│   DeepSeek Harness Web UI  ←  http://127.0.0.1:/                    │
│                                                                           │
└───────────────────────────────────────────────────────────────────────────┘
▲ loadURL                        ▲ 健康检查
│                                │
┌───────┴──────────────┐      ┌──────────┴────────────────────────────────┐
│  Electron 主进程      │ spawn│  dsh web（捆绑的 @deepseek-ai/dsh，        │
│  - 生命周期          ├─────▶│  ELECTRON_RUN_AS_NODE，stdio → 日志文件）  │
│  - 端口选择          │      │  工作区根目录默认 = 用户主目录               │
└──────────────────────┘      └────────────────────────────────────────────┘

配置

| 环境变量 | 作用 |
|---|---|
| DSH_DECK_WORKSPACE | dsh 的工作区根目录（默认：用户主目录），须已存在 |
| DSH_HOME | 原样透传给 dsh；用它隔离或共享与命令行安装的配置 |

日志位置：%APPDATA%/DeepSeek Harness Desktop/logs/deepseek-harness-desktop.log。

常见问题

需要 API Key 吗？
与官方一致：打开后在界面中配置模型服务。桌面壳不接触、不存储任何密钥。

为什么首次启动比较慢？
首次启动需要加载内置运行时的大量小文件；若安全软件开启实时防护逐个扫描，
等待较久属正常，缓解办法见上文「注意事项」。

如何跟上官方更新？
官方 harness 以钉版依赖内置；上游发布新版本后，这里会跟进发对应版本，
从 Releases 重新下载即可。

相关项目

- deepseek-ai/deepseek-harness —— 官方 harness

许可证

套壳自身代码采用 MIT 许可证。捆绑的 DeepSeek Harness 运行时按原样
分发，遵循其 MIT 许可证；详见 NOTICE。

⭐ ⭐ ⭐

如果对您有帮助，希望留下一个 Star。