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…

129 ·GitHub
Deepseek-harness-desktop
Что это?Неофициальная настольная обёртка для DeepSeek Harness под Windows, сделанная сообществом. Она включает официальный рантайм внутрь приложения, поэтому работает сразу, без отдельной установки Node.js или npm.
Это официальное приложение DeepSeek Harness?Нет, это независимый проект сообщества без какой-либо связи, одобрения или спонсорства со стороны DeepSeek. Это просто Electron-оболочка вокруг официального рантайма DeepSeek Harness.
Нужен ли API-ключ или какие-то инструменты разработки заранее?Node.js и npm не нужны, так как официальный рантайм включён в комплект. После запуска вы настраиваете API-ключ своего модельного сервиса прямо в интерфейсе приложения.
Каких подводных камней при установке ждать?Неподписанный бинарник может вызвать предупреждение Windows SmartScreen (нажмите 'More info', затем 'Run anyway'). Установка также записывает десятки тысяч файлов, поэтому при включённой антивирусной защите в реальном времени она может занять десятки минут.
Работает ли он также на macOS или Linux?Нет, поддерживается только Windows — проект распространяет единственный NSIS-установщик .exe для Windows.
Хранит ли настольная оболочка мой 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 22Releasev0.1.1Aug 22
Age
2mo
Commits · 90 Days