deepseek-harness-desktop README

The project's README from github.com/microtree9/deepseek-harness-desktop. As one markdown file: README.md.

DeepSeek Harness Desktop

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:<port>/                    │
│                                                                           │
└───────────────────────────────────────────────────────────────────────────┘
        ▲ 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 重新下载即可。

相关项目

许可证

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

⭐ ⭐ ⭐

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

deepseek-harness-desktop (microtree9/deepseek-harness-desktop)

Searching Database…

What is this?An unofficial community-made Windows desktop wrapper for DeepSeek Harness. It bundles the official runtime inside the app so it works out of the box without installing Node.js or npm separately.
Is this the official DeepSeek Harness app?No, it is an independent community project with no affiliation, endorsement, or sponsorship from DeepSeek. It is just an Electron shell around the official DeepSeek Harness runtime.
Do I need an API key or any dev tools set up first?No Node.js or npm is needed since the official runtime is bundled. After launching, you configure your model service's API key directly in the app UI.
Any install pitfalls I should expect?The unsigned binary can trigger a Windows SmartScreen warning (click 'More info' then 'Run anyway'). Installation also writes tens of thousands of files, so with real-time antivirus protection enabled it can take tens of minutes.
Does it run on macOS or Linux too?No, only Windows is supported — the project distributes a single NSIS .exe installer for Windows.
Does the desktop shell store my API key?No, the wrapper never touches or stores any keys; they live only inside the official DeepSeek Harness configuration.
How does it avoid port conflicts with other local apps?It uses the official default port 127.0.0.1:3080 if free, and automatically shifts to the next available port if it's occupied.
What happens if the bundled service crashes on startup?A failure page appears showing the error message, the tail of the live log, a retry button, and a shortcut to the full log file.
How do I keep up with new official DeepSeek Harness releases?The official harness is pinned as a bundled dependency. When upstream ships a new version, this project follows up with a matching release you can redownload from Releases.
Can I open multiple instances of the app?No, it uses a single-instance lock, so launching it again just focuses the existing window instead of opening a new one.
Creator
microtree9
Size
0.1 MB
Stars
129
Age
2mo
Commits · 90 Days