Preface¶

DeepSeek Harness (referred to as dsh for short) is an intelligent agent runtime open-sourced by DeepSeek AI, which is currently in developer preview. The official website summarizes its principle in one sentence: Everything is a plugin —— models, tools, skills, conversations, sandboxes, storage, scheduling and interfaces can all be made into replaceable plugins. The official way to launch the web interface is straightforward: first install Node.js, then run npx @deepseek-ai/dsh web, and access http://127.0.0.1:3080 via a browser.

This workflow is sufficient for users who already use the CLI. When handing Harness to colleagues on Windows who do not want to install Node.js or remember commands, they will get stuck on the environment setup: switching back and forth between terminal, npx and browser windows, and closing the windows may accidentally lose the running dsh web process.

As a result, a number of desktop wrappers have appeared in the community. This article only covers qyqy-1109/deepseek-harness-desktop. There are many repositories with the same name on GitHub, with different installation commands, built-in runtimes and platform support ranges, so do not mix them up by name.

The DeepSeek Harness Plugin Repository used in this article is a community-run site, and has no official affiliation with DeepSeek / HyperGryph. You can copy the installation commands from the directory, but you should still open the repository to verify the source code and license. The following introduction is based on cross-verified content from the directory detail page, the repository README, package.json and GitHub Releases.

What It Is¶

deepseek-harness-desktop is maintained by qyqy-1109, and its category in the directory is Themes & Appearance. The internal npm package name of the repository is dsh-codex-desktop, and the installed product name is DeepSeek Harness Desktop. The main language is JavaScript, and the current released version is v0.1.8 (2026-08-17). As of 2026-08-18, both the directory page and the GitHub repository show 9 stars; the directory inclusion date is 2026-08-15.

One-sentence positioning: This is an Electron desktop wrapper for Windows, which automatically starts (or reuses) the official dsh web after double-clicking, and wraps the web interface into an independent window; the installation package includes the dsh CLI, Node runtime and a set of community plugins. The repository also includes two web-side theme plugins: Codex Flavor (dsh-codex-flavor) and Background Gallery (dsh-background). The reason it is categorized under “Themes & Appearance” in the directory is mainly because of these two plugins.

The end of the README states that it uses the MIT license. Currently, there is no LICENSE file recognized by GitHub in the root directory of the repository, so you should still open the README and source code to verify before installation.

It is not an official DeepSeek desktop client, nor does it build a仿制 interface from scratch. The wrapper is only responsible for window management, tray icon, startup and packaging; the Harness core is still the official dsh web.

Core Features¶

The capabilities consistent between the repository README and the directory introduction can be divided into the following sections.

1. Independent window hosting the official Web GUI. No need to manually open a browser or remember dsh web. It detects http://127.0.0.1:3080 by default: if a service is already running, it will directly reuse it; if not, it will automatically resolve and start dsh web (prioritize the vendor/ copy in the installation package, then the dsh binary in PATH, and finally the globally installed npm package).
2. Minimize to tray when closing the window. Clicking the × in the top-right corner will not exit the app, it will stay in the system tray. To fully exit, right-click the tray icon and select “Quit”. The verification checklist specifies: if the service was started by the app itself, it will be shut down together when the app exits; when reusing an external existing instance, it will not accidentally kill other people’s processes.
3. Self-contained runtime. The README states that the installation package includes a complete dsh CLI and Node runtime (Electron 43 / Node 24), so end users do not need to install Node.js or dsh in advance. The extraResources field in package.json will package the @deepseek-ai/dsh in vendor/, vendor-node/node.exe, built-in plugins and pnpm into the installation package. The Release notes for v0.1.8 add that the installation package includes a self-contained pnpm, which is added to the PATH of the service process when starting, allowing the plugin marketplace to install and uninstall plugins on machines without a local Node.
4. Auto-seed plugins on first launch. The README says the installation package includes 6 plugins, which are installed into a brand new web profile: Background Gallery, Codex Flavor, dshmarket, dsh-difyctl, super-injector, mode-boost. The dependencies directly verifiable from vendor-plugins/package.json in the current repository are dshmarket, dsh-codex-flavor, dsh-background, dsh-difyctl, @dsh-external/dsh-mode-boost. The Release notes for v0.1.5 also mention @dsh-external/dsh-super-injector. The specific list shall prevail based on the installation package version you download. Starting from v0.1.7, two thinking mode presets router-standard / router-spec will also be built-in.
5. Replaceable app icon. Tray menu → “App Icon”: choose classic blue whale, black whale, or upload a custom image. After uploading, it will be cropped into a square and adapted to multiple desktop icon sizes, and the window, tray and desktop shortcut will be updated synchronously. The runtime icons are saved to %APPDATA%\dsh-codex-desktop\icons\.
6. Codex Flavor Theme. plugin/dsh-codex-flavor/ is a DSH client plugin: it retains the DSH brand blue, layout and rounded corners, only adds a near-black terminal panel (#0f1115) and thin borders to code blocks in dark mode, changes the code surface to the Cascadia Code / JetBrains Mono / ui-monospace monospace font stack, and adjusts the success/status accent color to Codex terminal green (#3fb950 series). All four configuration options can be disabled.
7. Background Image Plugin. plugin/dsh-background/ adds a “Background” row in “Settings → General”: upload local images, automatically compress and save them to the gallery (up to 3 images), adjust transparency and blur, and the selection is saved in localStorage. The background is laid out under the main content area and sidebar with semi-transparency, while inner layers such as messages remain opaque.

Installation and Activation¶

Plugin Commands Provided by the Directory Page¶

The original installation command on the community directory page is:

dsh plugin add github:qyqy-1109/deepseek-harness-desktop

Plugins run with the permissions of the current dsh process, and may execute code during installation. Before installing, you should check the source code repository and license. If you need reproducible installation, the directory page recommends pinning the commit hash. The latest commit on the current main branch is 02b681e1e0b80a23460bd5ccbb99c5c21fda941e (corresponding to the source code around v0.1.8):

dsh plugin add github:qyqy-1109/deepseek-harness-desktop#02b681e1e0b80a23460bd5ccbb99c5c21fda941e

It should be noted first: the package.json in the repository root directory is for an Electron app (main points to main/main.js), and has no DSH plugin manifest fields. The ones that actually have dsh.bundle / dsh.client declarations are the dsh-codex-flavor and dsh-background in the subdirectories. The main path written in the README for end users is to download the Windows installation package, rather than treating the entire desktop wrapper as a regular plugin added to an existing dsh. If you already have dsh web running and only want to install the theme plugins, see “Install Theme Plugins Separately” below.

End Users: Installation Package¶

The current latest installation package is v0.1.8 on GitHub Releases: DeepSeek.Harness.Desktop.Setup.0.1.8.exe, with a file size of 200070926 bytes (about 191MB). Download address:
https://github.com/qyqy-1109/deepseek-harness-desktop/releases/tag/v0.1.8

The steps in Section 1 of the README are as follows (use the version number on Releases as the standard, do not use the 0.1.5 / 176MB still written in the README):
1. Double-click the installation package. The software does not have a code signing certificate, so Windows SmartScreen may prompt “Windows has protected your computer”. Click “More info” → “Run anyway”.
2. Wait for the progress bar to complete. The README notes that the first installation may take 2 to 10 minutes (there are many files, and the antivirus software will scan them one by one); if it takes more than 15 minutes, you can add the installation package directory to the Windows Defender exclusion list and try again.
3. After installation, a “DeepSeek Harness” shortcut will appear on the desktop, and the app will open automatically.
4. The first launch will take about 10 to 20 seconds, and will initialize C:\Users\Your Username\.dsh. Starting from v0.1.4, the window will first show a loading page “Starting dsh web service…”, and switch to the main interface after the service is ready.
5. After the window opens, go to Settings (⚙️) → Models on the left, and enter your DeepSeek API Key (if you don’t have one, apply for one at platform.deepseek.com).
6. Return to the conversation page to start using.

Older versions (before README version 0.1.0) have runtime compatibility issues, and may report Failed to load plugins after opening. Please use v0.1.8. Starting from v0.1.2, the real Node 24 is built-in to avoid ABI inconsistencies between the Electron runtime and dsh native modules (directory picker koffi, sharp, node-pty, etc.).

Developers: Run from Source Code¶

The environment requirements are subject to the README: Node.js ≥ 22.19 (recommended 24 LTS), npm ≥ 10. After cloning:

git clone https://github.com/qyqy-1109/deepseek-harness-desktop.git
cd deepseek-harness-desktop
npm install
npm start

On Windows, you can also double-click 启动-桌面版.cmd (English name launch-desktop.cmd). If npm 11 blocks the electron install script:

npm approve-scripts electron
npm install

Package a self-contained installation package:

npm run dist            # dist\DeepSeek Harness Desktop Setup <version>.exe
npm run dist:portable   # Portable version (no installation required)

The packaging target in package.json only supports Windows (NSIS + portable). If electron-builder fails to pull NSIS components due to domestic network conditions, the temporary environment variable given in the README is:

set ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/
npm run dist

Daily Usage¶

The README lists daily operations in a table:

Optional environment variables (all optional, for development or troubleshooting):

Starting from v0.1.6, the startup log is at %APPDATA%\dsh-codex-desktop\startup.log, which records seeding, startup and error events.

Install Theme Plugins Separately¶

If you already have dsh web running and only want to add the Codex Flavor or background image function, you do not need to install the entire desktop wrapper. The prerequisite is that pnpm is available (corepack enable or added to PATH), and the plugins must be installed into the web profile.

Codex Flavor:

cd plugin/dsh-codex-flavor
corepack enable
dsh plugin --profile web add .
dsh --profile web --dump-config | findstr codex

Changes to the plugin set require restarting dsh web and refreshing the page. The default configuration patch:

config:
  enabled: true          # Master switch
  codexCodeBlocks: true  # Terminal panel style code blocks
  codexFont: true        # Monospace code font stack
  codexAccent: true      # Adjusted success green accent

Uninstall:

dsh plugin --profile web remove dsh-codex-flavor

Background Gallery (the README emphasizes that -w is required because the profile is the pnpm workspace root):

cd plugin/dsh-background
dsh plugin --profile web add -w <absolute path to this directory>

You also need to restart dsh web. To verify the Codex plugin, you should see /plugins/dsh-codex-flavor/client.js?rev=... return 200 in the browser’s developer tools Network tab.

Applicable Scenarios and Notes¶

It is suitable for the following groups of people: end users on Windows who want to double-click to open the official dsh web interface and do not want to install Node and CLI in advance; people who need to hand Harness to colleagues and want it to come with themes and a plugin marketplace out of the box; developers who already have dsh web running and only want to add a bit of terminal texture to dark mode code blocks or change the background image.

It currently only packages Windows. Neither the README nor the electron-builder configuration includes macOS/Linux installation packages. If you need those platforms, you should look for desktop wrappers maintained by other developers, and do not assume that this repository supports cross-platform deployment.

It is recommended to verify the following points before use:
1. Plugins run with the permissions of the current dsh process, and may execute code during installation. The desktop wrapper will also start dsh web on the local machine, with the same permissions as when you run Harness in the terminal yourself. Check the source code and license before installation, and only install sources you trust.
2. This is a community project, not an official client in the official app store. The community directory https://deepseek-harness-plugin.com has no official affiliation with DeepSeek / HyperGryph. Harness is still in developer preview, and the APIs may be incompatible.
3. The installation package is not code-signed, and the SmartScreen warning is an expected phenomenon stated in the README, and is not proof of successful installation. Please download from GitHub Releases and check if the local file size is close to 191MB (v0.1.8).
4. To call models, you still need access to the DeepSeek API and fill in the Key in the settings. The README states that configuring the API itself does not require a proxy, and the DeepSeek API can be accessed directly in China; this only covers the “fill in Key and call the official interface” part, and does not mean that all community plugin download sources are accessible without a proxy.
5. Closing the window does not equal exiting the app. If you cannot find it in the taskbar, check the tray first. Use the tray menu to fully exit.
6. There are multiple deepseek-harness-desktop / dsh-desktop repositories on GitHub. The installation commands and maintainer corresponding to this article are qyqy-1109, and the directory page slug is deepseek-harness-desktop-qyqy-1109.

Summary¶

qyqy-1109’s deepseek-harness-desktop wraps the official dsh web into a Windows independent window: automatically starts or reuses the local service, minimizes to the tray when closing the window, and the installation package includes the CLI and Node runtime. It is categorized under Themes & Appearance in the directory