Files
workdsh/docs/faq.en.md
T
Qiuner 66862637e5 docs: improve repository discoverability
Lead with a concrete desktop-client description, supported platforms, bundled-runtime behavior, and direct downloads. Add bilingual FAQs with concise, source-linked answers for common installation, product-boundary, profile, plugin, data, and update questions.
2026-08-16 22:58:24 +08:00

3.8 KiB

DSH Desktop FAQ

中文

This page answers common questions about installation, supported platforms, the bundled runtime, and plugins in the current stable release. The latest GitHub Release and user guide define the shipped product scope.

What is DSH Desktop?

DSH Desktop is an open-source DeepSeek Harness desktop client for Windows and macOS. It packages the official Harness local Web UI, Host service, and plugin system into a native desktop application with a window, system tray, terminal, updates, and profile management.

Is this an official DeepSeek product?

No. DSH Desktop is an independent, community-maintained open-source project. It is not affiliated with or endorsed by DeepSeek. The name only describes its technical relationship with the official DeepSeek Harness.

Which operating systems are supported?

Current release installers support Windows x64 and Apple Silicon macOS. There is currently no Linux installer, and Intel Macs are not supported. Cross-platform compatibility code in the source tree does not imply that an installer has been released for that platform.

Do I need to install Node.js, pnpm, or DSH?

No. The installer includes Electron, Node.js, pnpm, and pinned DSH dependencies. Ordinary users can install and launch directly, and Desktop does not modify the global system PATH or user shell configuration.

Does the first launch download a runtime?

No separate Node.js or Harness core download is required. The installer is larger because it contains the runtime and pinned dependencies, trading download size for a more deterministic first launch and dependency set. Cloud models, update checks, and new-version downloads still require network access.

Does DSH Desktop modify official Harness?

No. The repository pins an unmodified official Harness checkout. Compatibility mode runs the upstream default Web client. Advanced mode adds Desktop-owned layout and native window presentation through plugins without editing upstream source.

Is data stored locally?

The Desktop Host, profiles, and DSH home live on the local machine. Whether content is sent to an external service depends on the model or tool providers the user configures; requests to cloud models still go to those providers.

Can I install DSH plugins?

Yes. DSH Desktop uses the official Harness plugin system. Open DSH Terminal from the tray and run dsh plugin add, dsh plugin remove, or dsh plugin update. These commands default to the active profile, and Desktop must be restarted after plugin changes.

Does the Desktop profile automatically sync with an existing web profile?

No plugins are copied automatically. Each profile has its own bundle and dependency composition. After switching profiles, default plugin commands target the active profile; --profile <name> can always select one explicitly.

How are updates installed?

Packaged applications check for stable releases in the background but never install silently. A newer version requires confirmation. macOS downloads and opens a DMG; Windows downloads and starts an NSIS installer. Network and download failures leave the current installation intact.

Where can I download the app or report a problem?

Download from the project download page or the latest GitHub Release. Check the troubleshooting section first. If the problem remains, open a GitHub Issue with the operating system, app version, reproduction steps, and error details.