_{中文 · English}

A token-free desktop client for the DeepSeek Harness (DSH) ecosystem

_{Current v2.2.3 · All releases · macOS is unsigned/unnotarized — right-click Open}

DeepSeek Harness desktop demo

> **Public repository notice**: Download desktop builds from [Releases](https://github.com/hyqibot/DeepSeek-Harness-Token-Free/releases). **Zero-Token (free-token) mode requires the Release installer** — it ships the private gateway; you cannot build the full Zero-Token stack from this public source tree. ## Features

Desktop

Bring the official DeepSeek Harness local Web UI to a native desktop application. The app starts and manages the local Harness service, integrates the system tray and desktop window, and requires no Node.js installation or command-line setup.

Mobile Remote Control

Telegram, Discord, Feishu, WeChat, and a LAN PWA share one pairing code. Send tasks from a phone bot or add the PWA to the home screen. The Web UI stays on 127.0.0.1.

Plugin Marketplace

The tray Marketplace installs catalog plugins through official dsh plugin add. Unaudited dshmarket is not bundled. Service management, system integration, and the marketplace are Cordis Host rows composed with the profile.

Channels

Paired IM identities remote-control the in-process Agent. The Zero Token gateway also listens on localhost in the same process: official API keys need no activation code; optional Zero Token web models that avoid token fees share the same activation code as the built-in HYQi chat model (community quota, no extra key).

## Plugin Ecosystem DeepSeek Harness is built on [Cordis](https://github.com/cordiverse/cordis) and follows an “everything is a plugin” architecture. Core capabilities such as model adapters, the tool registry, the session log, and the Agent Loop participate in the runtime as plugins, so they can be composed or replaced through configuration. External plugins can also join a runtime through profiles and bundles. See the official [architecture overview](https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md) and [plugin management documentation](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md#plugin-management). Desktop is already composed as official Cordis plugins: the window and tray (`desktop-shell`), services and pnpm (`desktop-pnpm` / `desktop-profiles`), system integration (`desktop-terminal` / `desktop-updates`), IM remote control (`desktop-channels`), the LAN phone shell (`desktop-mobile`), the Zero Token gateway (`desktop-zero-token`), the HYQi community model (`desktop-hyqi`), and the marketplace (`desktop-marketplace`) all mount as Host rows and follow the same `dsh plugin add` composition model. ## Statement This project is built on [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness). It is an implementation based on DeepSeek Harness and the Cordis plugin model. The goal is a DeepSeek Harness desktop that is easy to get started with, plus an optional token-free path to major models, so more people can try AI apps without a high cost. ## Community Choose whichever platform you prefer to discuss usage, plugin development, and project updates.

WeChat Group	DingTalk Group

## Run from source This public tree can run the **desktop app** (`yarn dev`) with **official / API-key models**. > **Limit**: The Zero-Token gateway sources and sidecars are **not** in this repository. Use the [Release installer](https://github.com/hyqibot/DeepSeek-Harness-Token-Free/releases) for free-token web mode. **Requirements** - Node.js 22.19+ or 24+ (with Corepack) - [Git](https://git-scm.com) **1. Clone and install** ```bash git clone --recurse-submodules https://github.com/hyqibot/DeepSeek-Harness-Token-Free.git cd DeepSeek-Harness-Token-Free corepack enable yarn install ``` **2. Start the desktop app** ```bash yarn dev ``` Configure an official API key in Settings. Web Zero-Token **only works in the Release installer**. **Notes** - This tree does **not** include `dsh-plugin-desktop/vendor/copaw-zero-token/python/`. Local `yarn dist:win` / `yarn dist:mac` will **not** produce a Zero-Token installer. ## License This project is licensed under the [MIT License](LICENSE). > This is a community desktop edition built on DeepSeek Harness. It is not an official DeepSeek product.