Skip to main content

How to use deepseek-harness-desktop

Package DSH into an Electron desktop app with native window, system tray, profile switching, standalone terminal, and update checking—no need to open the web version in a browser.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

deepseek-harness-desktop

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add dsh-plugin-desktop

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 本地服务的启动、停止与恢复
  • 桌面窗口和系统托盘集成
  • macOS、Windows 安装包构建与发布
  • 更适合桌面使用的界面体验

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Can I directly double-click to open the desktop app after installing this plugin?

Not necessarily. It requires electron to launch; installing via npm globally will automatically include electron, but when installing in a profile you need to manually install it separately. Without electron, the command will only print an installation prompt.

Is the interface I see in the desktop version the same as the web version?

The default compatibility mode loads the official web interface, just wrapped in a native window with system borders. After switching to advanced mode, macOS and Windows will switch to native appearance with blur/Mica effects.

How do I switch interface modes?

Select from the tray menu, or manually edit the dsh-desktop.mode field in DSH home's settings.yaml (compatibility or advanced). Switching will definitely restart the application.

Can it be used on Linux?

It can be used, but only supports compatibility mode; advanced mode will be directly rejected; the "Open Terminal" command in the tray won't appear on Linux, and update downloads are also not provided.

Will switching profiles lose chat history?

No. The official profile shares the same DSH home session, settings, and storage by default. Switching only restarts the application to use a different set of plugins; it doesn't copy or migrate data.

Why don't newly added plugins take effect after installation?

The launcher doesn't listen for profile list changes; you need to restart the desktop app after adding or removing plugins; switching a profile from the tray will also trigger this restart.

Are updates automatically installed?

No. The packaged version checks once after 60 seconds of startup, then every 6 hours after that. When a new version is found, it prompts for download; on macOS you need to manually replace the app from the DMG, and on Windows you need to confirm and run the installer.

Does closing the window mean I've quit the application?

No. Closing the window only hides the interface; it continues running in the background and can be reopened from the tray; to truly exit, you need to select Exit from the tray.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 0.1.0-rc.6
  • Node: ^22.19.0 || >=24.0.0

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule

How to use deepseek-harness-desktop