DSH Menu Bar

简体中文

A native macOS menu bar app for starting and managing the DeepSeek Harness (DSH) web service.

🐋 Menu bar whale · one-click start/stop · managed DSH Runtime · local hostname · launch at login

Features

• One-click start / stop — a single menu action follows the service state.
• Managed DSH Runtime — on the first start, the app visibly downloads and installs DSH into Application Support. Later starts run that local copy directly, without waiting for npx to download it again.
• DSH Runtime updates — the menu shows the installed version, checks npm for an update, and installs a new DSH version independently of app releases.
• Proxy settings — use macOS system HTTP proxy, direct connections, or a custom local HTTP(S) proxy. Proxy environment variables are passed to both DSH and the runtime installer.
• Local hostname — opens http://deepseek.harness.localhost:3080.
• Trusted API host — starts DSH with --trusted-host deepseek.harness.localhost:3080 to prevent /api host-trust 403 errors.
• Browser opening — opens the local URL once the service is ready.
• Port reuse — reuses a service already listening on port 3080.
• Launch at login — install or remove a launchd login item from the menu.
• Native app updates — Sparkle checks signed GitHub Releases; updates can be checked manually from the menu.

Build

Requires macOS 13+, Xcode Command Line Tools, and Node.js/npm for the managed DSH runtime. Releases support macOS 26 and 27.

scripts/bundle-node.sh    # optional: bundle Node only as an npx compatibility fallback
scripts/build-app.sh      # build the app bundle
open DSHMenuBar.app       # open it

DSHMenuBar.app is a menu-bar-only application: it has no Dock icon or main window. Look for the whale in the right side of the menu bar.

Menu

Runtime lifecycle

On first launch, the app uses the local npm to download official @deepseek-ai/dsh into:

~/Library/Application Support/DSHMenuBar/runtime

The menu explicitly shows that download/install state. Once installed, the app launches that local DSH copy with local node, so ordinary starts do not require network access or npx package downloads. Updates are downloaded to a staging directory and become active only after the download completes successfully.

This path requires a working local Node.js/npm installation (for example, Homebrew Node). The app's bundled Node is retained only as a legacy npx compatibility fallback and is not used to execute DSH native dependencies.

Logs

• ~/Library/Logs/DSHMenuBar.log — DSH service output
• ~/Library/Logs/DSHMenuBar-diag.log — app diagnostics
• ~/Library/Logs/DSHMenuBar-crash.log — crash records
• ~/Library/Logs/DSHMenuBar-runtime-install.log — runtime download/install output

Local hostname

DSH's DNS-rebinding protection rejects untrusted API hosts. The app declares its only local hostname with the official --trusted-host deepseek.harness.localhost:3080 argument. Under RFC 6761, .localhost always resolves to the local machine.

License

MIT. The whale icon is derived from the official DeepSeek logo (DeepSeek-V2) and is used only as the menu-bar icon.