DeepSeek Harness Desktop

中文 | English

Maintained by ningbai牛逼: If DeepSeek Harness Desktop helps you, consider supporting ningbai牛逼 on Afdian. Your support helps fund servers, testing, and continued maintenance.

Scan to support the project:

DeepSeek Harness Desktop Community

QQ Group: 1105158177

Join the QQ Group

Join the community to discuss:

• Usage and configuration
• Plugins and Skills
• Model setup and usage tips
• Automation workflows
• Themes and desktop pets
• New releases and feature suggestions

GitHub downloads slow in your region?
The community group also provides synchronized copies of the latest installer and a place to get help with installation and usage.

---

DeepSeek Harness Desktop is a community-maintained, open-source AI coding desktop client.

DeepSeek has not yet released a standalone official Desktop product. This project combines the public official DSH Runtime, Web UI, and the Desktop boundaries visible in the official repository into Windows, macOS and Linux desktop applications, then adds community plugins, Skills, task automation, Git, remote development, and desktop integration. It is not an official DeepSeek client and does not reuse or overwrite a future official Desktop identity, data directory, protocol, or update feed.

Supports Windows 10 / 11 x64, with macOS 13+ Apple Silicon arm64 Preview and Linux x64 Preview builds. It is released under the BSD-3-Clause license.

Packages include Node.js and DSH. Windows also bundles Git; macOS and Linux Git operations require system Git.

Product Site · Download Latest · Documentation · Changelog

5.1.0: one release across three platforms, complete output and simpler settings

The formal 5.1.0 Release was published on 2026-10-25 at 15:09:51 UTC with official NPM Runtime/SDK 0.2.1-rc.2 and Electron 44.0.0, without modifying official sources. Tag run 40199647851 passed all three platforms and publication at eb1223ddfee78eccadd76d8022501cd1806d9d3d. All five public installers were independently downloaded and matched actual sizes, SHA-256, GitHub digests and the combined receipt; Windows updater SHA-512 and manifest were also verified.

• Consumer acknowledgements and streaming backpressure retain complete output/history. Async resource reads and HMR rescans preserve authorization, caching and cancellation cleanup, without general percentage speedup claims.
• Installation directories are validated individually, with per-entry registry recovery. First-use market activation requires consent; feedback, translation, automatic updates and project-layout scanning default off, and source replacement uses recoverable transactions. Consent is not an execution sandbox.
• Frameless Dock settings retain 15 destinations, search, controls, advanced details, critical risk notices, selection and keyboard focus. Only dedicated settings windows exclude the floating pet; the main conversation pet and saved configuration remain.
• Windows core passed 28/28 and packaged-full 44/44 without waivers. Real Setup verified fresh installation, separate 4.3.0/5.0.0/5.0.1 upgrades, overlays, restart, uninstall and old provider/session preservation. Official defaults, collapsible tools, model access, Skills, tray behavior and existing entries remain.

Windows Desktop tests passed 1943/1943 with zero skips; macOS/Linux each passed 1906 with 37 existing platform skips and zero failures out of 1943. Scripts passed 213/213 on all three. All packages are unsigned; macOS is unnotarized on arm64/macOS 13+, and macOS/Linux remain Preview. Linux 5.1.0 native evidence is Ubuntu 22.04 only, not historical Ubuntu 24 results. Same-version 5.1.0 beta users must manually download and overlay the formal package; same-version auto-update is not promised. Formal telemetry configuration was verified in all three public payloads, retaining anonymous opt-out metrics; production events were not submitted and ingestion was not verified.

5.1.0 bilingual release notes · Actual three-platform assets · Final Windows screenshot provenance

The originals below come from isolated Windows formal-tag QA: main UI is a real main-WebContents capture, and Dock captures include host and child in the same native window. No diagnostic composites or simulated-model conversations are used. Unconfigured models do not imply authentication. Dock images retain real scroll-edge clipping, not all controls simultaneously visible; these are not macOS/Linux, real paid-flow or power-loss rollback acceptance.

Light settings, unconfigured state	Dark settings, actual scroll position

5.0.1: lighter streaming, clearer sidebars, one release across three platforms

5.0.1 installation packages are published together for Windows x64, macOS arm64 Preview and Linux x64 Preview. Official NPM Runtime remains 0.2.0-rc.2. Native verification, packaging and smoke passed on all three platforms; Windows source regression passed 27/27 and full packaged regression passed 43/43. Disposable Runners verified real fresh installation, 4.3.0 and 5.0.0 overlay upgrades, same-version reinstall and data-preserving relaunch, not every historical version or physical device.

• Clean defaults: new profiles use the official appearance; upgrades preserve existing skins, backgrounds and explicit preferences. All 15 bundled skins remain selectable.
• Lighter streaming: text and Markdown updates avoid repeated sidebar scans while retaining complete Chinese text, code, tool output and turn navigation, never truncating content for speed.
• More sidebar space: tools collapse, expand by keyboard and restore after restart. The footer Dock and Today spending are the sole primary shortcuts, keeping workspaces and conversations accessible.
• Readable dark Dock: opaque panels replace glass effects and warm navigation clears stale palettes. All 15 destinations, feature search and keyboard focus remain; context tooltips avoid repeated flicker.
• Background operation and reliable upgrades: the menu supports tray minimization, restoration and explicit exit. Windows upgrades recognize the existing directory, retaining backups, rollback and old/new model providers.
• Complete workbench and privacy: collaboration, Skills, plugin-detail configuration, independent third-party APIs, bai authorization and history protection remain available. Anonymous metrics exclude user content and credentials.

All packages are unsigned; macOS is unnotarized. Verify the same Release's SHA-256. 5.0.1 release notes and the actual asset receipt define the boundaries. Screenshots use the same-release-commit candidate in isolated Windows acceptance. Configuration images combine simultaneous real host and embedded WebContents captures without injecting user conversations; they are not macOS/Linux screenshots or physical-device acceptance.

Official appearance and collapsed tools	Expanded tools remain accessible
Dark Model Collaboration	Plugin center

5.0.0: reliable upgrades, one version across three platforms

5.0.0 pins the official NPM DSH 0.2.0-rc.2 and uses the public [email protected] carrier with Desktop-owned adaptations, without changing official source. Windows x64, macOS arm64 and Linux x64 are released together after native platform gates passed. Windows passed all 40 packaged regression suites and disposable-runner production Setup checks for fresh installation, 4.3.0 overlay upgrade and relaunch. macOS/Linux remain Preview; all packages are unsigned and macOS is unnotarized. Verify downloads against the same release's SHA-256 receipt and back up important data before upgrading.

• Reliable conversations: authenticated fragmentation carries long histories and tool results across A-to-B-to-A navigation and restart. Limits fail explicitly; history is neither silently truncated nor automatically uploaded.
• Protected upgrades: overlay installation uses transactional backup and rollback. Old and newly added providers, plugin configuration and user disable choices survive Profile refresh; plugin detail options, Skills and usage navigation remain available.
• Simpler model access: bai authorization prefers deepseek-flash from the real directory and refreshes that directory periodically. Missing authorization or rejected keys offer browser sign-in, without automatic top-ups, paid calls or message retries. Independent third-party APIs remain supported.
• Preserved workbench: Task Board, Git, file delivery, model collaboration, pets, 15 skins, SSH and remote access remain available, alongside the restored 4.4.0 branding icon.
• Clear terminal and control boundaries: PowerShell, PowerShell 7, WSL and CMD remain selectable. Agent WSL requires separate approval; Browser Use and Computer Use default off and restore configuration after failed transitions.
• Three platforms and privacy: native Runners validate each platform independently. Packages are unsigned and macOS is unnotarized. Official packages include anonymous usage metrics, never conversations, code, paths, screenshots or credentials; development and test builds remain disconnected.

Upstream sync ledger · Upgrade and Rollback · 5.0.0 release notes

These are isolated 5.0.0 Windows runtime captures, not macOS or Linux acceptance. Dock configuration images combine the real window and embedded WebContents captures without injecting user data.

Main window	Extension Dock plugins
Model access and bai authorization	Skills and shared discovery

4.1.0: let DeepSeek control the browser and computer

4.1.0 introduced Smart Control. Windows x64 is stable; macOS arm64 and Linux x64 are Preview builds. One GitHub Release is created only after all three platform jobs pass.

• Browser Use defaults to the official Playwright MCP in a visible, isolated system-browser session and discovers Chrome, Edge, or Chromium. Clicks, typing, uploads, and downloads remain approval-gated.
• Computer Use defaults to the bundled Cua Driver Native provider, with an external MCP fallback. Observation is separated from per-action approval, and repeated native startup failure recovers through safe mode.
• Breaking DSH 0.1.6 compatibility exact-pins @deepseek-ai/[email protected] and adapts Agent, Session, PTC, Workflow, Sandbox, and Agent Team contracts.
• Transactional 3.5/4.0 migration preserves sessions and long context, workspaces, models, credential references, Skills, plugins, themes, pet settings, and collaboration settings, with backup and rollback.
• Privacy-bounded metrics use only fixed outcome vocabularies and exclude URLs, domains, window names, screenshots, prompts, tool arguments, paths, and credentials.

Smart Control guide · 4.1.0 release record

Continuing core capabilities

• Value Mode V2: An expert controller model understands, decomposes, delegates, reviews, and synthesizes work while a subagent worker model handles bounded subtasks; first selection opens setup guidance.
• Large-Model Usage Dashboard: Balance, input/output tokens, context, cache, latency, cost, and generation speed are visible; peak speed uses a strict rolling one-second algorithm instead of treating one aggregate usage event as instantaneous throughput.
• Claude Code / Codex Project Import: Read-only discovery of projects and historical sessions, preview before import, centralized redaction, and non-executable historical tool calls.
• More reliable startup and plugins: Visible startup phases, transactional repair with rollback, and SafePluginBoundary isolation while existing DSH Home data and plugins continue to load directly.

Full Release Notes · Changelog · Upgrade and Rollback

---

Model collaboration, Skills, and model access

The screenshots below are isolated 5.0.0 Windows runtime captures, not macOS/Linux screenshots or production installation acceptance.

Model collaboration: Agent Team and Value Mode in one place

The session sidebar opens the existing Extension Dock window directly on Model Collaboration. Agent Team handles multi-role coordination, while Value Mode separates controller and worker models. They remain independent and may be enabled separately or together.

Skills: one directory model across the conversation and Skill Center

Desktop 4 scans project .dsh/skills, user DSH Skills, and user Agents Skills through one discovery contract. The composer can search and insert the same skills shown by Skill Center, including their source and scope.

bai provider: consistently promoted in model entry points

The chat picker, model settings, and collaboration controller/worker pickers share one ordering rule: user-pinned models first, then bai, followed by the existing provider order.

See Desktop architecture and capabilities, Upgrade and Rollback, and the 5.0.0 release notes for the implementation boundaries.

Why DeepSeek Harness Desktop

Ready to Use

Install the EXE and launch a complete Harness environment.

There is no need to manually prepare Node.js, Git, pnpm, or the DSH Runtime. The desktop app manages the required components and runtime environment for you.

Complete AI Coding Workspace

Use one desktop app for:

• AI conversations and code changes
• Project file browsing and editing
• Git / SCM operations
• Markdown, HTML, code, Diff, PDF, Office, and other file previews
• Model switching and reasoning-effort controls
• Skills and plugin usage
• Agent task execution
• Token and performance statistics
• Multi-project development workflows

Skills and Plugin Ecosystem

Supports multiple extension paths:

• DSH Skills
• Agents Skills
• Project Skills
• Community DSH Bundles
• Plugin Marketplace
• Desktop extensions

Search, install, and use extensions directly inside Harness to build a development workflow that fits your needs.

Task Board and Automation

The built-in Task Board organizes work as:

Planned → Todo → In Progress → Completed / Failed

Tasks can be executed through real DSH Agent Sessions and record Task Runs plus Evidence for later review and continuation.

Scheduled tasks and background execution are also supported for recurring development, maintenance, and automation workflows.

Remote Development

The desktop app can work with both local and remote environments through:

• Mobile remote control
• SSH
• Web Terminal
• SFTP
• Port forwarding
• Multi-host cluster execution
• QQ Bot integration

You can connect to your Harness workspace from a PC, phone, or chat client.

Personalized Desktop Experience

Beyond coding features, Desktop also includes:

• Multiple themes and skins
• Full-page particle themes
• Whale-girl desktop pet
• Dedicated desktop windows
• Window-state persistence
• Desktop notifications
• System tray integration
• Stable / Beta update channels

---

Harness AI Coding Workspace

The desktop app runs the DeepSeek Harness Web Surface directly while the desktop host manages the local DSH Runtime.

In one window, you can handle AI conversations, code changes, file management, Git operations, task execution, model switching, and plugin extensions.

Skills and Plugins

Search and insert installed Skills directly from the conversation input.

Extension Dock supports:

• Community DSH Bundles
• Plugin Marketplace
• Project Skills
• DSH Skills
• Agents Skills

The desktop app uses an isolated desktop profile and does not overwrite an existing DSH setup.

Plugin installation, updates, and runtime lifecycle are managed by the desktop host.

Codex Models and Reasoning Effort

3.0.9 uses the official llm-pi-ai/openai-codex authorization flow built into DSH RC.1 to complete ChatGPT OAuth and enable supported OpenAI Codex models inside Harness; it no longer loads the legacy dsh-codex-connect plugin that conflicts with native providers. The "ChatGPT Login" action in Settings starts OAuth with one click and continues in the system browser; the grant is only read or written by the official credential service and stays in the local DSH Home, so the frontend only learns whether you are signed in and never receives an access token or refresh token. It does not replace your current model by default, take over global search, or enable remote image tools.

When switching models, the desktop app shows the reasoning-effort levels supported by the active model and automatically handles valid configuration.

Task Board and Automation

Use the Task Board to manage Agent work in one place.

Board	Task details and scheduling

Tasks can be executed through DSH Agent Sessions and save Task Run and Evidence records.

In addition to manual tasks, scheduled tasks and background execution can be used for recurring development, information processing, and maintenance workflows.

Git Graph

Use the branch selector and Git graph to inspect branch relationships, commit history, repository status, and branch lanes at a glance.

Files, Preview, and SCM

Project conversations include a complete right-side workspace:

• File tree: browse and search workspace files
• File preview: Markdown, HTML, code, Diff, CSV, PDF, Office, images, and text
• Edit and save: source / preview switching and split-view workflows
• Git changes: inspect real SCM state and run Stage / Unstage / Discard
• Adjustable layout: panel width and collapsed state can persist per project

Mobile Remote Control

Scan the desktop QR code to connect a phone to the current Harness workspace.

The mobile interface can browse workspaces, create and view sessions, send and receive messages, switch models, adjust reasoning effort, and stay synchronized with the desktop app.

It works over the local network by default and can optionally use a public tunnel when needed.

Workspaces	Sessions
Mobile chat	Model and reasoning effort

SSH Remote Development

The built-in SSH panel can manage remote servers directly and share connection settings with the Agent.

Supported capabilities include:

• Web Terminal
• SFTP upload / download
• Local port forwarding
• Multi-host cluster execution
• Importing hosts from ~/.ssh/config
• Using configured remote hosts directly from Agent conversations

Harness can therefore work with remote servers and development environments as well as local projects.

QQ Bot Integration

The desktop app integrates the Tencent QQ Bot Connector.

Bind it from Extension Dock by scanning a QR code, then connect QQ direct messages and group chats to the local Harness instance.

Connection information is managed by the desktop host without requiring manual configuration-file editing.

Large-Model Usage Dashboard and Performance Statistics

The input area can display:

• Rolling one-second generation speed and per-step peak
• LLM request latency
• Context usage
• Cache hit rate
• Input Tokens
• Output Tokens

Themes and Skins

The desktop app includes multiple themes with preview-before-apply support.

Available styles include Harbor, Windows XP / Luna, Minecraft-inspired, Blue Fantasy, Whale Song, Miku, Trading Terminal, QQ nostalgia, and more.

Whale-girl Desktop Pet

The built-in whale-girl desktop pet changes animations based on Agent states such as thinking, working, waiting, and completion.

It also supports interaction, naming, dragging, and hiding.

Companion mode	Interaction panel

Full-page Particle Theme

The particle-whale theme can be applied not only to the startup page but also to the main Harness interface, automatically adjusting visual effects around input state, dialogs, background activity, and the system reduced-motion preference.

---

Download and Install

Windows

1. Open GitHub Releases.
2. Download DeepSeek-Harness-Desktop-Setup-<version>-x64.exe.
3. Run the installer.
4. Launch DeepSeek Harness Desktop.

The Windows installer already includes DSH, desktop plugins, skins, pnpm, MinGit, and the required native dependencies. Separate Node.js or Git setup is not required.

macOS unsigned preview (Apple Silicon)

arm64 only. Desktop 5.1.0 requires macOS 13 Ventura or later because of Electron 44; this floor does not establish testing on every supported OS version or rewrite historical 5.0.1 acceptance. After downloading the .dmg or .zip, move the app to /Applications and clear quarantine with xattr. macOS 15 no longer has Right-click > Open. Preview builds have no auto-update and use system Git. Full steps: macOS unsigned preview install guide.

Linux x64 preview

AppImage and DEB are available. AppImage needs execute permission; DEB can be installed through the system package manager. A graphical session, system Git and a working sandbox are required; do not disable the sandbox to work around startup failures. Preview updates are manual, and physical-desktop installation and usability remain user-acceptance work. Full steps: Linux x64 Preview install guide.

If GitHub downloads are slow in your region, you can also join the community group at the top of this page to get the synchronized installer.

Updates

DeepSeek Harness Desktop supports in-app update checks. When a new version is available, you can review the release information and choose whether to upgrade.

Two update channels are available:

• Stable: the default channel and the best choice for most users.
• Beta: opt-in access to newer features.

Upgrades are designed to preserve existing DSH_HOME, Desktop Profile, community Bundles, Skills, skin configuration, and desktop-pet state whenever possible.

More information:

• Upgrade and rollback
• Compatibility policy
• Runtime support policy
• Full release notes

Security and Privacy

DeepSeek Harness Desktop is designed to keep user data and the runtime environment local whenever possible.

Key behaviors include:

• DSH Runtime listens on loopback by default
• The main desktop surface and extension capabilities use separate permission boundaries
• External links open in the system browser
• OAuth, QQ Bot, and other credentials stay local
• Telemetry is disabled by default
• Diagnostic information is exported only when the user explicitly requests it
• Exported diagnostics redact sensitive content such as Tokens, Secrets, Cookies, paths, Prompts, Sessions, and Tool Results

Documentation

• Desktop technical guide
• Compatibility policy
• Runtime support policy
• Upgrade and rollback
• Maintainer release workflow
• Changelog

Open Source and Licensing

This project is open-sourced under the BSD-3-Clause license.

• Project source code, bundled plugins, themes, and the desktop client follow the BSD-3-Clause license.
• Imported third-party code and dependencies retain their original licenses and attribution notices.

Star History

Links

This project actively participates in and supports the LINUX DO community.

---

Make DeepSeek Harness an AI coding workspace you can use every day on Windows, macOS and Linux.

If you like this project, consider giving it a Star.