dsh-desktop

English | 中文

A desktop client for DeepSeek Harness — start dsh as easily as using Claude Code or Codex. Double-click and go, no commands needed.

This project is not affiliated with or endorsed by DeepSeek Harness. It is an independent effort to fill the gap of an official Harness desktop client and make it easier to use.

Screenshots

Features

• 🚀 One-Click Launch — Double-click to run, automatically detects and remembers dsh path
• 🔄 Smart Management — Auto-scans PATH candidates, port reuse, graceful exit prompts
• 🎨 Theme Sync — Real-time follow of dsh light/dark/system theme
• 🌐 Multilingual — English & Chinese, instantly switches with dsh settings
• 📋 Help Menu — Current dsh info, check for updates, refresh page, quick links
• 🖥️ View Controls — Fullscreen, refresh page...
• 🔔 Task Notifications — Get notified when dsh completes answering, even when window is minimized
• 🔒 Security Assurance — Loads only verified dsh pages, external links open in browser

Requirements

• dsh installed: Run dsh -V in a terminal; it should print a version number

Installation

Note: Currently only supports Windows x64.

Download from GitHub Releases:

Usage

1. First Launch: The app will scan for dsh installations and prompt you to select one
2. Subsequent Launches: Starts automatically using your saved dsh path
3. Close: Click the window close button — if dsh was running before the app, you'll be asked whether to close it

Keyboard Shortcuts

Building from Source

# Clone the repository
git clone https://github.com/zhenghaoyang24/dsh-desktop.git
cd dsh-desktop

# Install dependencies
pnpm install

# Run in development mode
npx electron .

# Run tests
pnpm test

# Build for Windows
pnpm run build

Build Mirrors (for China network)

If GitHub downloads time out, set these mirrors before building:

$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:ELECTRON_BUILDER_BINARIES_MIRROR="https://npmmirror.com/mirrors/electron-builder-binaries/"
pnpm run build

Project Structure

dsh-desktop/
├── main.js                  # App entry: lifecycle management
├── preload.js               # Context bridge for IPC
├── src/                     # Main process modules
│   ├── constants.js         # Port, URLs, timeouts
│   ├── dsh.js               # dsh process management
│   ├── startup.js           # Boot state machine
│   ├── view.js              # dsh WebContentsView
│   ├── window.js            # Window creation and management
│   ├── ipc.js               # IPC handlers
│   ├── theme.js             # Theme synchronization
│   ├── i18n.js              # Language support
│   ├── task-events.js       # Completion notification (dsh official event streams)
│   └── injected/            # Scripts injected into dsh page
│       ├── chrome.js        # Custom title bar
│       ├── dropdown.js      # Help/View menus
│       └── about.js         # About overlay
├── renderer/                # Startup page UI
│   ├── status.html          # Main HTML
│   ├── status.js            # UI logic
│   └── status-core.js       # i18n strings
├── test/                    # Automated tests
└── buildResources/          # Icons and logos

FAQ

Q: Port 3080 is occupied by another program? A: The app will show an error. Free the port or close the other program, then click Retry.

Q: dsh not found in PATH? A: Install dsh globally (npm install -g @deepseek-ai/dsh) or manually enter the path when prompted.

Q: How to change dsh path after initial setup? A: Delete settings.json in %APPDATA%\github.zhenghaoyang24.dsh-desktop\ and restart the application.

Q: I didn't get a notification when the task finished? A: Notifications only appear when the window is minimized at the exact moment a task ends (whether it succeeds or fails); no toast is shown while the window is visible. If you still get nothing while minimized, check Windows notification settings: Settings → System → Notifications, make sure the top-level "Notifications" toggle is on and dsh-desktop is allowed under "Notifications from these senders", and don't enable Focus Assist / Do Not Disturb.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License — see the LICENSE file for details.

Acknowledgments

• DeepSeek Harness — The AI coding assistant this app wraps
• Electron — Cross-platform desktop framework
• electron-builder — Packaging and distribution