deepseek-harness-desktop
适用于 macOS（Apple Silicon）的 DeepSeek Harness Web GUI 桌面外壳——双击即可运行，无需终端。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Evan1u/deepseek-harness-desktop#e7f28f8d80d01d6c22c372b00389e27276cd4e26
Deepseek Harness Desktop 以 deepseek-harness-desktop 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A native macOS desktop shell for DeepSeek Harness — double-click, no terminal.
DeepSeek Harness is powerful, but starting it means opening a terminal and typing dsh web. This app wraps it in a thin Electron shell — double-click, and it boots dsh --profile web --no-open --port 0, waits for the local URL, and renders the exact same Web GUI in a native window. Every web feature, zero divergence, zero terminal.
| 🖥️ No terminal | 🐋 Live tray | 🎯 Busyness-aware | 🌗 Light/dark | 🔄 Auto-update |
|---|---|---|---|---|
| Double-click to run | Two switchable icon styles | The icon reacts to real workload | Adaptive icons | GitHub Releases |
The menu-bar icon is not a static glyph. It reflects what DeepSeek Harness is doing:
Right-click the icon to switch between two styles:
| Style | Idle | Working |
|---|---|---|
| 🐟 Fish Swing (default) | Still whale | Swinging whale — faster with more work |
| 🔮 Thinking Orb | Search globe | Listening orb — a rippling dot sphere |
Both styles adapt to light/dark menu bars automatically, and your choice is remembered across launches.
| Fish Swing 🐟 Fish Swing | Thinking Orb 🔮 Thinking Orb |
| Busyness | State | Frequency |
|---|---|---|
| 0 | Still | — |
| 1 | Light | Slow (~1.8 s/cycle) |
| 2 | Medium | Medium (~1.2 s/cycle) |
| 3 | Heavy | Fast (~0.8 s/cycle) |
Busyness = running sessions + running jobs, read live from the harness's own event streams.
Right-click the menu-bar icon → Swing Amplitude → pick a preset:
| Preset | Subtle | Default | Strong | Stronger | Strongest |
|---|---|---|---|---|---|
| Rotation | 6° | 9° | 12° | 15° | 18° |
double-click the .app — or drop it into Applications. If macOS warns on first launch (unsigned build), right-click → Open.
DeepSeek Harness.app
└─ Electron main process
├─ resolve dsh (DSH_BIN override → /opt/homebrew/bin/dsh → … → PATH)
├─ spawn: dsh --profile web --no-open --port 0
├─ parse stdout: "dsh web: http://127.0.0.1:<port>"
├─ BrowserWindow.loadURL(that URL)
└─ lifecycle: SIGTERM on quit · retry dialog on backend crash
The backend binds 127.0.0.1 on an OS-assigned port, so the /api loopback trust fence passes with no extra configuration and there is no fixed-port conflict.
⚠️ Do not open the same session in a separate terminal
dsh webat the same time — the session store is single-writer, so two live backends writing one session log can corrupt it (history then fails withcorrupt session log: seq gap in committed region).
npm install # installs electron + electron-builder
npm start # run from source
npm run pack # build the .app (release/mac-arm64/DeepSeek Harness.app)
npm run dist # also build .dmg and .zip
Output lands in release/. If a Developer ID Application certificate is in your Keychain, electron-builder signs automatically; otherwise the app is left unsigned for local use.
Signing + notarization require an Apple Developer Program membership and a Developer ID certificate. The toolchain and build config are already wired up — you only supply the credentials.
One-time setup
+ → Developer ID Application. Verify with security find-identity -v -p codesigning..p8 → note the Key ID and Issuer ID.Build + notarize
npm run pack # signs automatically once the cert is in Keychain
APPLE_API_KEY_PATH=~/.appstoreconnect/AuthKey_XXXXXX.p8 \
APPLE_API_KEY_ID=XXXXXXXXXX \
APPLE_API_ISSUER_ID=00000000-0000-0000-0000-000000000000 \
./scripts/notarize.sh
The app checks for updates on launch (then hourly) and offers Restart now when a newer version is out. Publish a new release with a GitHub token:
GH_TOKEN=github_pat_xxx ./scripts/publish.sh
Note: reliable macOS auto-update is best with a signed app; for an unsigned personal build it is best-effort.
| Variable | Purpose |
|---|---|
DSH_BIN | Absolute path to the dsh executable (defaults to /opt/homebrew/bin/dsh). |
DSH_HOME | Inherited from the environment; shares ~/.dsh profiles, credentials, and sessions with the CLI. |
dsh web (full web parity)dist over file:// and bridge /api over ipcRendererMade with ❤️ for the DeepSeek Harness community.