Users following the install/use path could previously land in developer and maintainer content: the root README documentation table mixed both audiences, the plugin-ecosystem section named desktopProfiles/desktopPnpm inline, the user guide ended by pointing at the package README, and why-desktop carried contract details. Split the root README and docs index into user vs developer tables, add a user-level plugin intro to the user guide, remove the developer-jargon patch wording, and soften why-desktop's developer-contract detail. The plugin-ecosystem narrative and differentiation copy stay for a follow-up pass.
中文 · English
A modern desktop experience for the DeepSeek Harness ecosystem (Plugin)
Download Desktop
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 |
|---|---|
| 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
DeepSeek Harness turns models, tools, interfaces, and workflows into plugins that can be combined like building blocks. Desktop follows the same idea: it owns the window, tray, and desktop runtime while preserving the official DSH experience for agents, models, tools, sessions, and the Web UI.
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.
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.
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.



