chentao326/dsh-gui
macOS 原生桌面 GUI for DeepSeek Harness — 双击图标即用的 DSH 桌面客户端（Swift + WKWebView，零依赖）
安装Install
dsh plugin --profile web add github:chentao326/dsh-gui把 chentao326/dsh-gui 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
DeepSeek Harness GUI
English · 中文
Native macOS desktop client for DeepSeek Harness
Double-click the icon and start using DSH — zero dependencies, no bundled browser.
Features
- ⚡ Zero dependencies — pure Swift over the system WebKit engine; built with only Xcode Command Line Tools. No Node, no Electron, no Chromium (~180 KB binary).
- 🔍 Automatic server discovery — settings.json → port 3080 →
lsofscan of running dsh processes, each verified against thewindow.__DSH_BOOT__fingerprint. - 🚀 Self-start when needed — spawns
dsh web --port N(N = 0 lets the OS pick a port) and reads the real URL from the readiness linedsh web: http://127.0.0.1:<port>. - 🧹 Honest lifecycle — on quit it terminates only the server it started itself (SIGTERM → SIGKILL, by process group); a server that was already running is left untouched.
- 🐋 Official branding — the app icon is DeepSeek Harness's own whale, rendered from the shipped favicon.
- ⚙️ Headless config —
settings.jsoncontrols port/url, working directory (cwd), dsh path and window size. - 🔁 Resilient — 30 s startup timeout, up to 2 automatic reconnects, error page with retry, full log at
~/Library/Logs/dsh-gui.log.
Quick start
Requirements: macOS 14+, Xcode Command Line Tools (xcode-select --install), and dsh on PATH (or set dshPath).
git clone https://github.com/chentao326/dsh-gui.git
cd dsh-gui
bash build.sh # builds and installs DSH.app to ~/Desktop
Or copy the prebuilt bundle from build/DSH.app into /Applications.
Run the test suite:
bash build.sh --test # unit + spawner integration tests
Menu shortcuts: Cmd+R reload · Cmd+Shift+O open in browser · Cmd+Q quit.
Compared with other desktop shells
| This project | salathleizhang/deepseek-harness-desktop | anywhere-labs/deepseek-harness-desktop | |
|---|---|---|---|
| Stack | Swift + system WebKit | Electron (Chromium) | Electron |
| Runtime deps | none | bundled Node + Chromium (~100 MB+) | bundled Node + Chromium |
| Installer size | ~180 KB binary | multi-hundred-MB DMG | installer |
| Build | bash build.sh, ~30 s, CLT only |
pnpm / electron-builder | pnpm / electron-builder |
| Platforms | macOS (arm64; Intel cross-compilable) | macOS + Windows (signed/notarized) | macOS + Windows |
| Server startup | discovery first; spawn only if not found; --port 0 + stdout parsing |
fixed spawn, waits for readiness line | managed service + tray |
| Quit semantics | kills only self-spawned server | owns shutdown & crash-restart | integrated management (tray) |
| Config | settings.json (port/url/cwd/dshPath/window) |
— | — |
In one sentence: the Electron shells ship a Chromium to distribute installers; this project ships a few hundred kilobytes of auditable Swift for people who prefer to build from source.
Configuration
Optional ~/Library/Application Support/DSH GUI/settings.json:
{
"port": 8080,
"url": "http://127.0.0.1:8080",
"cwd": "/path/to/project",
"dshPath": "/path/to/dsh",
"windowWidth": 1280,
"windowHeight": 800
}
| Key | Effect |
|---|---|
port / url |
skip discovery and connect directly (url wins) |
cwd |
working directory of the self-started server (dsh's default filesystem location); defaults to $HOME |
dshPath |
explicit dsh CLI; default lookup: which dsh → newest ~/.npm/_npx/*/.../dsh/lib/bin.js |
windowWidth / windowHeight |
initial window size |
Logs
~/Library/Logs/dsh-gui.log — startup, connection and termination events plus the dsh child process output.
FAQ
The app says it cannot find dsh.
Install it first: npm install -g @deepseek-ai/dsh, or point dshPath at your checkout's lib/bin.js.
Port 3080 is taken by something else.
The app probes 3080 first; if the occupant is not DSH it spawns with --port 0 and discovers the OS-assigned port from stdout. No manual action needed.
My server was already running; will the app kill it on quit?
No. Only a server the app spawned itself is terminated. An external server keeps running (the log records connected to … with no termination entry).
Can it run on Intel Macs?
The shipped binary is arm64; cross-compile with swiftc -target x86_64-apple-macos13.0 (SDK supported).
Documents
- Design spec:
docs/superpowers/specs/2025-08-14-dsh-gui-design.md - Implementation plan:
docs/superpowers/plans/2025-08-14-dsh-gui.md
License & discoverability
MIT © chentao326.
Following the official DeepSeek Harness README: add the dsh-plugin topic to your plugin repository for discoverability — this repository is tagged accordingly.
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…