Preface¶
Following DSH’s “everything is a plugin” philosophy, the DeepSeek Harness official WebUI already provides the primary business interface capabilities. To make it more suitable for daily desktop use, common needs include: wanting native window buttons, a system tray, and quick launchers, without separately installing an MSI, DMG, or AppImage, and without copying, forking, or reimplementing the official WebUI.
Below, we introduce @anestis271/dsh-desktop. It retains the capabilities of the official WebUI first, then adds a desktop application shell on top, making entry points and system integration closer to traditional desktop programs.
What This Is¶
@anestis271/dsh-desktop is an npm plugin for DSH, positioned as a solution to “naturally make the DeepSeek Harness official WebUI a desktop application.” It is installed via dsh plugin and does not require a separate desktop installer download.
The core problem it solves is: avoiding a separate desktop installation package while also not copying the official WebUI into another client. After installation, launching with --profile desktop provides a desktop window, system tray, and optional quick launchers.
Core Features¶
- Wraps the DeepSeek Harness official WebUI into a desktop application shell.
- Preserves the official WebUI capabilities without copying, forking, or reimplementing the interface.
- Provides a system tray, native window buttons, a cohesive title bar, and optional quick launchers.
- Supports minimizing to the system tray when closing the window.
- The tray menu supports show/hide, refresh, opening the profile directory, and quitting.
- The tray menu dynamically switches between Chinese and English settings based on dsh.
- Ensures only one window and one tray instance per profile at any time.
- Supports user-level quick launchers on Windows, macOS, and Linux.
- Clicking the shortcut again directly brings up the existing window without creating duplicate dsh and WebUI instances.
- Quick launchers only start
dsh --profile desktop, without installing another Electron instance or requiring administrator privileges. - The plugin is only responsible for window and system integration, without adding a second set of business state, account systems, or background services.
Installation and Activation¶
Check the Environment First¶
First, confirm that Node.js, pnpm, and dsh are all available. The Node.js version must satisfy:
^22.19.0 or >=24.0.0
Run the following command in the terminal:
pnpm --version
If the command returns a version normally, pnpm is executable. Also, confirm that dsh is installed and can run normally in the terminal.
Install the Plugin¶
After checking, run the following command to install the plugin into the desktop profile:
dsh plugin --profile desktop add @anestis271/dsh-desktop
After the above steps, the plugin will be added to the corresponding dsh profile.
Launch the Desktop Shell¶
Run the following command to start:
dsh --profile desktop
On the first launch, the plugin will download and extract the Electron runtime environment required for the current platform. The download size and time depend on the platform and network conditions. After the download progress reaches 100%, there may still be a short wait for extraction to complete; do not interrupt the process. Once ready, subsequent launches will directly reuse the Electron cache in the profile.
Typical Usage¶
After starting dsh Desktop, you can create desktop shortcuts and application menu entries as needed in the official WebUI under “Settings → General Settings.”
Launch at login is disabled by default and can be enabled in the same location. After creating entries, these entries will still only start:
dsh --profile desktop
That is, it does not install another Electron instance, nor does it require administrator privileges. On macOS, the system’s built-in osacompile generates a local AppleScript shortcut application. When launch-at-login is disabled, the plugin will only remove entries it created itself.
Applicable Scenarios and Notes¶
It is suitable for those who need to use the DeepSeek Harness official WebUI as a desktop entry point, especially those who want to preserve the official interface capabilities while gaining a tray, quick launchers, and the ability to bring up the existing window on repeated launches.
Notes before use:
- The plugin runs with the current dsh process permissions; check the source code and license before installation.
- The license is MIT.
- The Node.js version requirement is
^22.19.0or>=24.0.0. - pnpm must be installed and executable in the terminal.
- dsh must be installed and runnable in the terminal.
- The first launch will download and extract the Electron runtime environment; do not interrupt the process during the download.
- Quick launchers do not require administrator privileges.
- The community directory is an independent site with no official affiliation with DeepSeek / High-Flyer, and should not be interpreted as an official app store.
Conclusion¶
The value of @anestis271/dsh-desktop lies in complementing desktop shell capabilities through a dsh plugin approach, without creating a separate client or desktop installation package. The business interface remains provided by the DeepSeek Harness official WebUI, while the plugin only handles the window, tray, quick launchers, and system integration.
The verified materials did not provide the directory page URL, so here is the GitHub repository address:
https://github.com/Anestis271/dsh-desktop