deepseek-harness-desktop README

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 保持一致。

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

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

注意事项

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

工作机制

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

129 ·GitHub

Deepseek-harness-desktop

这是什么？

一个由社区制作的非官方 DeepSeek Harness Windows 桌面封装。它把官方运行时打包进应用中，因此开箱即用，无需单独安装 Node.js 或 npm。

这是官方的 DeepSeek Harness 应用吗？

不是，它是一个独立的社区项目，与 DeepSeek 没有任何隶属、认可或赞助关系。它只是套在官方 DeepSeek Harness 运行时外面的一个 Electron 壳。

需要先准备 API 密钥或任何开发工具吗？

由于官方运行时已打包在内，不需要 Node.js 或 npm。启动后，你可以直接在应用界面中配置模型服务的 API 密钥。

安装时有什么坑需要注意吗？

未签名的二进制文件可能触发 Windows SmartScreen 警告（点击“更多信息”再点击“仍要运行”）。安装还会写入数万个文件，在开启实时杀毒防护的情况下可能需要几十分钟。

它也能在 macOS 或 Linux 上运行吗？

不能，只支持 Windows——该项目只发布一个 Windows 的 NSIS .exe 安装程序。

这个桌面外壳会存储我的 API 密钥吗？

不会，这个封装从不接触或存储任何密钥；密钥只存在于官方 DeepSeek Harness 的配置中。

它如何避免与其他本地应用发生端口冲突？

如果 127.0.0.1:3080 这个官方默认端口空闲就使用它，如果被占用则自动切换到下一个可用端口。

如果内置服务在启动时崩溃会怎样？

会出现一个失败页面，显示错误信息、实时日志的末尾、重试按钮以及完整日志文件的快捷方式。

如何跟进官方 DeepSeek Harness 的新版本？

官方 harness 作为捆绑依赖被固定版本。当上游发布新版本时，本项目会跟进发布对应版本，你可以从 Releases 重新下载。

可以打开应用的多个实例吗？

不可以，它使用单实例锁，再次启动只会聚焦到现有窗口，而不会打开新窗口。

What are similar projects?

dsh_desktop, dsh-desktop, dshcode, pilot-harness, DSH-Launcher, jingyun-dsh, oh-dsh, dsh-desktop

Which topics is it in?

dsh-plugin-desktop, dsh-desktop, cordis, electron-app, installer, dsh, harness, deepseek-harness, windows-app, electron, plugin, desktop

Creator: microtree9
Size: 0.1 MB
Stars: 129
Updated: CommitAug 22 Releasev0.1.1Aug 22
Age: 2mo
Commits · 90 Days