Create docs/plugin-ecosystem(.en).md as the ecosystem manifesto: an open, composable, sustainable vision with composition-first, declare-clearly, and compatibility-first principles, the desktop shell as the first example, living-document community governance, and the marketplace as the trust signal. The root README intro now ends with the co-progress vision and links the manifesto; the docs index and root README tables list it; the plugin-development ecosystem-vision section points to it as the full statement.
中文 · English
A modern desktop experience for the DeepSeek Harness ecosystem (Plugin)
Download Desktop
DSH Desktop brings DeepSeek Harness to native macOS and Windows applications. Official Harness runs unchanged at a pinned version; the desktop shell itself — the window, tray, terminal, updates, and work profiles — is a legitimate DSH plugin on the same composition path as official and third-party plugins. Models, tools, interfaces, and workflows can all be extended through plugins; together with every plugin author, we want to build an open, composable, and sustainable DSH plugin ecosystem where plugins grow alongside each other. Read the DSH plugin ecosystem manifesto.
Documentation
Ordinary users can start with the user guide; the developer documentation is only needed when extending or maintaining the application.
User documentation
| Goal | Entry point |
|---|---|
| Install and use the application | User guide |
| Understand why the project exists | Why DSH Desktop |
| See the full documentation and README map | Documentation index |
Developer and maintainer documentation
| Goal | Entry point |
|---|---|
| Read the plugin ecosystem manifesto | Plugin ecosystem manifesto |
| Build ordinary or Desktop plugins | Plugin development |
| See what Desktop plugins can use | Desktop plugin API |
| Understand how the desktop works | Architecture |
| Read package-level build and release details | dsh-plugin-desktop/README.md |
Features
Plugin Ecosystem
Plugins are extensions that add capabilities to DSH — models, tools, interfaces, and workflows can all be plugins, combined like building blocks.
DSH Desktop does not fork or modify upstream source, and it is not a fixed, hardcoded shell. Official DeepSeek Harness runs unchanged at a pinned version; the desktop shell itself — the window, tray, terminal, updates, and work profiles — is a legitimate DSH plugin, composed into the same runtime through the official plugin mechanism. From the core agent to the desktop shell, the whole product follows the same "everything is a plugin" rule: plugins from the official ecosystem work directly, and desktop capabilities are combined, replaced, and evolve the same way.
We want the plugin ecosystem to work like a phone app store: every plugin is built against the same set of rules, so plugins can be installed together and work together without interfering with each other.
Compatibility mode stays close to the official default experience; advanced mode adds a fuller desktop layout and system effects. The plugin marketplace, mobile remote control, and Channels remain future plans and are not part of the current installer.
For developers
Desktop plugin capabilities are now available. Developers can extend the app through two public interfaces: desktopProfiles to view and switch work profiles, and desktopPnpm to install, update, and remove plugins in the active profile. See the Desktop plugin API for complete usage details. See Why DSH Desktop and Plugin development for the reasoning and the third-party boundary.
Relationship to the Official Project
This project is built on deepseek-ai/deepseek-harness.
This project is an implementation built on DeepSeek Harness and the Cordis plugin model, intended to provide the foundation for the DSH desktop experience.
The official project provides the core agent capabilities, plugin system, and Web UI. This project primarily provides:
- Desktop application packaging
- Starting, stopping, and recovering the local service
- Desktop window and system tray integration
- macOS and Windows installer builds and releases
- An interface designed for desktop use
If you prefer to run Harness from the command line or contribute to its core functionality, refer to the official repository first.
Special Thanks
Special thanks to the original DeepSeek Harness repository and the DeepSeek AI team. DSH Desktop is built from a pinned upstream checkout, and its core agents, models, tools, sessions, Web UI, and plugin ecosystem come from that project.
We also thank Cordis for the plugin foundation that makes this composition possible. DSH Desktop would not exist without these open-source projects.
We are also grateful to the Koishi.js project and community for their long-standing work on plugin practices, tooling, and shared knowledge, and to everyone who contributes discussions, testing, feedback, and plugins.
Also, and you.
Development
Desktop source lives in dsh-plugin-desktop/. The outer repository uses Yarn, while the pinned deepseek-harness/ submodule keeps its own pnpm workspace. From the repository root:
git submodule update --init --recursive
corepack yarn install --immutable
corepack yarn dev
Use corepack yarn check for the headless gate. The architecture and package README describe the full build, test, and release boundaries.
Community
Choose whichever platform you prefer to discuss usage, plugin development, and project updates.
| WeChat Group | QQ Group |
|---|---|
![]() |
![]() |
Discord: Join the DeepSeek Harness Desktop community
If you would like to join our technical team, contact us at [email protected].
License
This project is licensed under the MIT License.
This is a community desktop edition built on DeepSeek Harness. It is not an official DeepSeek product.



