deepseek-harness-desktop README

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

DeepSeek Harness Desktop logo
DeepSeek Harness Desktop

A minimal, local-first, cross-platform desktop shell for DeepSeek Harness.

Official Website

English · 简体中文

Latest release License: MIT Release build macOS Windows Linux

image

DeepSeek Harness Desktop packages the official DeepSeek Harness Web experience as a standalone desktop application. It removes the need to start the CLI manually or manage local ports while preserving the full Harness interface.

This project focuses on desktop hosting. It does not fork, modify, inject into, or reimplement the Harness UI. Models, sessions, settings, plugins, and agent capabilities remain provided by the official @deepseek-ai/dsh package.

[!IMPORTANT] This is an unofficial community wrapper and an early-stage project. It depends on the rapidly evolving @deepseek-ai/[email protected]. The macOS builds are not Apple-notarized, and the Windows builds are not commercially code-signed.

Download

Platform Architecture Package Download
macOS Apple Silicon DMG Download for Apple Silicon
macOS Intel DMG Download for Intel Mac
Windows x64 Setup installer Download Windows installer
Windows x64 Portable ZIP Download Windows ZIP
Linux x64 AppImage Download AppImage
Debian / Ubuntu x64 deb Download deb

All current and historical packages are available on the GitHub Releases page, and you can also download from the Quark Drive mirror: Quark Drive - DeepSeek Harness Desktop v0.3.1

Why this project exists

DeepSeek Harness already provides the complete agent runtime and Web UI. This project supplies the host capabilities required for a desktop product:

Features

Plugin market

Open Settings → Plugin Market to browse and search the community catalog, inspect plugin sources, and install, update, disable, or remove plugins. The catalog is fetched live from awesome-dsh-plugin.com, while package changes use the official dsh plugin --profile web workflow and remain in your local DSH profile.

The desktop package includes [email protected] and a compatible pnpm runtime. Market-triggered process restart is disabled because application lifecycle remains owned by the desktop host; refresh the page or restart DeepSeek Harness Desktop when a plugin indicates that a restart is required.

SSH and remote operations

For optional SSH access, search for dsh-ssh-ops in Settings → Plugin Market. It provides SSH terminals, SFTP, port forwarding, batch commands, and database connections. The plugin has been verified to load with the DSH version bundled by this project.

SSH access is not enabled or installed by default because it handles remote credentials and can execute commands on other machines. Review the plugin source and requested permissions, install it only when needed, then restart DeepSeek Harness Desktop after installation.

[!WARNING] Catalog entries are community-maintained third-party code, not endorsements by DeepSeek or this project. Installed plugins run locally with your user permissions and may access data available to Harness. Review the source, publisher, permissions, and build-script warning before installing.

Installation

macOS

The macOS builds are integrity-signed but are not Apple-notarized. On first launch:

  1. Open the DMG and drag DeepSeek Harness into Applications.
  2. Try to open the app; if macOS blocks it, click Done.
  3. Open System Settings → Privacy & Security.
  4. Find DeepSeek Harness in the Security section and click Open Anyway.
  5. Confirm by clicking Open once more.

This confirmation is normally required only once.

Windows

The Windows installer is not commercially code-signed. If Microsoft Defender SmartScreen appears:

  1. Click More info.
  2. Click Run anyway.
  3. Complete the setup wizard.

Linux

Security model

Runtime architecture

DeepSeek Harness Desktop
├── Electron Main
│   ├── Single-instance window
│   ├── Harness child-process lifecycle
│   ├── Random loopback port and readiness checks
│   └── Platform menu and external-link handling
│
├── Harness Child Process
│   └── @deepseek-ai/dsh web
│       └── http://127.0.0.1:<random-port>
│
└── Sandboxed BrowserWindow
    └── DeepSeek Harness Web UI

Validation status

Platform Packaging Packaged startup Web UI
macOS Apple Silicon DMG / ZIP passed Passed HTTP 200
macOS Intel DMG / ZIP passed Passed HTTP 200
Windows x64 NSIS / ZIP passed Passed HTTP 200
Linux x64 AppImage / deb passed Passed HTTP 200

Every release package is built on a matching GitHub-hosted runner and runs a packaged-app smoke test before publication.

Known limitations

Upstream version and license

The project currently pins @deepseek-ai/[email protected] for reproducible packaging.

The desktop wrapper is available under the MIT License. The bundled DeepSeek Harness, dsh-market, and pnpm packages are also MIT-licensed; their notices are preserved under third-party-licenses.

This project is not affiliated with or endorsed by DeepSeek. DeepSeek Harness and related names belong to their respective owners. The application icon uses the black whale artwork from the upstream DeepSeek Harness Web favicon.

deepseek-harness-desktop (agent-earth/deepseek-harness-desktop)

Searching Database…

254 ·GitHub
Deepseek-harness-desktop
Что это такое?Минималистичное десктопное приложение, которое оборачивает официальный веб-интерфейс DeepSeek Harness (DSH) в отдельную программу — не нужно вручную запускать CLI или разбираться с локальными портами, оно просто открывается как обычное приложение.
Это форк DeepSeek Harness или официальное приложение в десктопной оболочке?Это официальный Harness в десктопной оболочке: модели, сессии, настройки, плагины и возможности агентов по-прежнему берутся из пакета @deepseek-ai/dsh, а оболочка добавляет только хостинг — автозапуск сервиса, окно, упаковку. Это неофициальный проект сообщества.
Нужно ли сначала устанавливать Node.js или CLI DeepSeek Harness?Нет. Приложение включает в себя среду исполнения @deepseek-ai/dsh вместе с pnpm и само запускает и останавливает локальный сервис Harness на случайном порту 127.0.0.1 — отдельный CLI или инструментарий Node.js не требуются.
macOS или Windows заблокируют его при первом запуске?Скорее всего, один раз. Сборки для macOS подписаны, но не нотаризованы, поэтому подтвердите запуск через System Settings → Privacy & Security → Open Anyway. В Windows появится SmartScreen, потому что установщик не имеет цифровой подписи, — нажмите More info → Run anyway.
Для каких платформ есть готовые сборки, а для каких нет?Для macOS есть DMG под Apple Silicon и Intel, для Windows x64 — Setup-установщик и портативный ZIP, а для Linux x64 — AppImage плюс deb для Debian/Ubuntu. Сборок под Windows или Linux ARM64 пока нет; каждый пакет релиза собирается на подходящем GitHub-раннере и проходит дымовой тест упакованного приложения перед публикацией.
Приложение обновляется само?Нет — автоматические обновления не встроены, поэтому новые версии нужно скачивать со страницы GitHub Releases. Кроме того, оболочка фиксирует версию @deepseek-ai/[email protected] для воспроизводимой сборки, а сам DSH сверху — пока RC-версия, которая может быстро меняться.
Есть ли плагин для работы с удалёнными серверами по SSH?Да — найдите dsh-ssh-ops в Settings → Plugin Market. Он добавляет SSH-терминалы, SFTP, проброс портов, пакетные команды и подключения к базам данных, и проверено, что он загружается со встроенной версией DSH. По умолчанию он не установлен, потому что работает с удалёнными учётными данными: сначала изучите его исходный код и разрешения, а после установки перезапустите приложение.
Это официальный продукт DeepSeek?Нет — это неофициальная оболочка от сообщества, не связанная с DeepSeek и не одобренная компанией. Оболочка распространяется по лицензии MIT, а входящие в комплект пакеты DSH, dsh-market и pnpm тоже лицензированы под MIT.
What are similar projects?dsh_desktop, dsh-desktop, DSH-Launcher, Bigfish, DSH-Plugins-Marketplace, oh-dsh, pilot-harness, Minke
Which topics is it in?plugin-marketplace, tray, electron-app, dsh, plugin-system, dsh-plugin, deepseek-harness, electron, deepseek, local-first, coding-agent, security
Creator
agent-earth
Size
0.7 MB
Stars
254
Updated
CommitSep 18Releasev0.3.8Sep 03
Age
2mo
Commits · 90 Days