dataelement/dsh-desktop

A local-first, cross-platform desktop app for DeepSeek Harness.

English · 简体中文 · 日本語 · Русский · Español · Português

Use official DeepSeek models or mainstream third-party providers, manage portable Agent presets, continue Harness sessions from your phone, and turn source material into editable PPTX decks.

DSH Desktop packages the local DeepSeek Harness experience as an installed desktop application. It starts Harness automatically, keeps profiles, plugins, workspaces, model settings, and sessions outside the application directory, and opens the full Harness interface as soon as the local runtime is ready.

We offer stable and preview releases: download the stable release, recommended for everyday use, from our official website. To try a preview release, choose a version marked Pre-release on GitHub Releases.

Preview releases include our newest features and closely track the latest official DeepSeek Harness versions. They may be incompatible with community plugins and are not recommended for general users. Early adopters are welcome to try them and share feedback in our community; we roll out updates to the wider community only after validation by early adopters.

Installed builds check for updates shortly after startup and every six hours. When a new version is available, DSH Desktop asks before downloading it; installation begins only after you choose Restart and install. You can also check manually from the application menu or skip one version without hiding future releases.

Scan the QR code below with WeChat to join the DSH Desktop community group.

Prefer Discord? Join the DSH Desktop Discord community.

DeepSeek Harness already provides the Agent runtime and Web UI. DSH Desktop adds the native host capabilities needed for a practical desktop product:

• Starts and stops Harness without requiring a separate CLI or browser tab
• Uses the native system directory picker to add and manage project workspaces
• Supports official DeepSeek models and mainstream third-party model providers
• Imports and exports complete custom Agent presets as portable .dshpreset packages, with conflict checks and a trust warning before installation
• Turns source material into editable PPTX decks through the built-in PPT mode
• Includes offline DOCX, PPTX and XLSX skills with bundled Python libraries on macOS and Windows
• Preserves profiles, plugins, workspaces, sessions, and model settings across app upgrades
• Detects startup and frontend plugin failures, keeps diagnostics in harness.log, and offers guided recovery actions
• Provides a non-destructive Safe Mode that temporarily blocks third-party plugins
• Lets a paired phone continue sessions over the local network or an optional temporary public tunnel
• Checks for desktop updates and keeps download and installation under user control
• Adapts native menus, titlebar behavior, window focus, theme, and application branding for macOS and Windows

Enable the PPT button, choose a template, and describe the deck you need. The built-in catalog includes 16 templates and 192 layouts with editable PPTX output. Previews use English; decks can use English or Chinese, with corresponding font settings. Preview language does not determine output language.

PPT is preinstalled, and its automatic instructions apply only to sessions where the PPT button is enabled. See the PPT runtime guide for templates, validation, and source acknowledgments.

Choose Connect Phone… from the Harness menu and scan the pairing code.

• On Wi-Fi, scanning connects immediately.
• Over the internet tunnel, the phone enters a 6-digit pairing password shown only on the computer. By default the password is temporary (5 minutes, memory only). A durable password is created only after you opt in on the Connect Phone window.

Harness itself remains on a random 127.0.0.1 port. Phone access uses a separate paired bridge. Cloudflare Quick Tunnel is the usual long-lived remote path. Free Pinggy is the fallback when Cloudflare is unavailable (for example in mainland China) and expires after about 60 minutes. Disconnecting the phone from the desktop invalidates the mobile session.

If Cloudflare fails to start, the app tries Pinggy. If a Cloudflare pairing link appears but your phone cannot open it, choose Can’t open? Try another link to switch to Pinggy.

If a third-party plugin interferes with startup or rendering, DSH Desktop can identify the implicated plugin from runtime and frontend evidence and open a guided recovery surface.

Choose Restart as Safe Mode… from the Harness menu to start an isolated profile containing only official core bundles. The Agent, sessions, model settings, and workspaces remain available while third-party plugins from the normal profile stay blocked. You can remove selected plugins or return to a normal launch from the Safe Mode banner.

Recovery screens check for compatible plugin updates. When available, you can upgrade an affected plugin; Safe Mode also offers batch upgrades. For help, hover over WeChat group to display its QR code, or click Discord to open the community.

If the normal interface cannot be reached, start DSH Desktop with --safe-mode. On macOS:

open -a "DSH Desktop" --args --safe-mode

• The Harness Web UI is served only on a random loopback port.
• The renderer has no Node.js privileges and uses context isolation and sandboxing.
• Webviews, untrusted in-app navigation, and unexpected permission requests are blocked.
• External web links open in the system browser.
• User profiles and sessions live under Electron's per-user application data directory, not inside the installed app.
• Phone access requires a short-lived pairing token. Wi-Fi connects on scan; the internet tunnel also requires the pairing password shown on the computer.

Harness includes target-native dependencies, so every release artifact is built on the matching operating system and architecture.

Contributions are welcome. Start with the public engineering documentation:

• Development guide — setup, validation, patch maintenance, and target-native packaging
• Architecture — runtime flow, persistent data, security boundaries, recovery, mobile access, and updates
• Release runbook — signing and publication controls
• Preset package format — portable Agent preset contract

Before submitting a change, run npm test, npm run typecheck, and npm run build, then exercise the affected real application flow. Never include real API keys in issues, logs, screenshots, or test data.

dsh-market is the community plugin market for DeepSeek Harness. Browse and search plugins, preview screenshots, install or update packages, enable or disable plugins, and switch themes from the Harness interface.

DSH Desktop is open source under the MIT License.

DeepSeek Harness and its dependencies remain subject to their respective upstream licenses and trademark policies. DSH Desktop is an independent community desktop application.