菜单栏启动器 DESTINYwang0428/dsh-menubar

dsh-menubar

DSH（DeepSeek Harness）的 macOS 菜单栏启动器 —— 不用开终端，点一下菜单栏图标就能启动 / 关闭 DSH Web。

编译产物是一个 22×22 的原生菜单栏 App（Swift + AppKit，无任何第三方依赖），常驻在菜单栏右上角，运行中 / 未运行两种图标一眼可见，由 launchd 托管，开机自启、崩溃自动拉起。

交互

| 操作 | 行为 |
| 左键（DSH 未运行） | 直接后台启动 DSH Web，图标变「运行中」 |
| 左键（DSH 运行中） | 弹出菜单 |
| 右键 | 总是弹出菜单 |
| 菜单「启动 DSH / 重启 DSH」 | 启动；已在跑则先杀掉再重启 |
| 菜单「退出（关闭 DSH 网页端）」 | 关掉 DSH Web 服务，图标变回「未运行」（图标本身不退出） |
| 菜单「打开 Web 界面」 | 浏览器打开 http://127.0.0.1:3080 |
| 菜单「打开日志」 | 打开 /tmp/dsh-web.log |
| 菜单「刷新状态」 | 立即重新探测一次 |
| 菜单「退出菜单栏图标」 | 从 launchd 卸载并退出图标，不会被自动拉起 |

状态每 3 秒自动探测一次（HTTP 请求本地端口，不依赖 ps），所以你在别处用
dsh web 起的服务，图标也会自动亮起来。

菜单栏 ● ← 运行中图标 ○ ← 未运行图标

环境要求

- macOS 11 或更高（Apple Silicon / Intel 均可）
- Xcode Command Line Tools：xcode-select --install（只为拿 swiftc）
- 已安装 DSH：npm install -g @deepseek-ai/dsh，dsh --version 正常
- 默认探测端口 3080，与 dsh web 的默认值一致

安装

git clone https://github.com/DESTINYwang0428/dsh-menubar.git
cd dsh-menubar
./install.sh

install.sh 做三件事：

1. 编译源码 → DSHStatus.app
2. 拷到 ~/Applications/DSHStatus.app
3. 写 ~/Library/LaunchAgents/com.dsh.status.plist 并注册到 launchd

装完菜单栏立刻出现图标。想装到别处：./install.sh /Applications。

只想先试试（不装开机自启）

./build.sh
open DSHStatus.app

手动编译（不用脚本）

swiftc -O -framework AppKit -framework Foundation \
-o DSHStatus.app/Contents/MacOS/DSHStatusApp Sources/DSHStatusApp.swift

配置

通过 LaunchAgent plist 的 EnvironmentVariables 覆盖（改完 launchctl bootout + bootstrap 重载）：

| 变量 | 说明 | 缺省 |
| DSH_BIN | dsh 可执行文件绝对路径 | 自动探测：/opt/homebrew/bin/dsh → /usr/local/bin/dsh → ~/.local/bin/dsh → 登录 shell 的 command -v dsh |
| DSH_PORT | DSH Web 监听端口 | 3080 |

例：dsh 装在自定义位置、端口用 8080

EnvironmentVariables

DSH_BIN/Users/you/tools/dsh
DSH_PORT8080

自定义图标

仓库自带两张像素风图标作为默认外观（icons/run.jpeg 运行中 / icons/stop.jpg 未运行），构建时自动打进 bundle。想换成自己的图，放 icons/run.png 与 icons/stop.png 再 ./install.sh 即可（同名时扩展名按 png → jpeg → jpg → tiff 优先）；一个图标都不放会退回 macOS 内置 SF Symbols（运行中 bolt.circle.fill / 未运行 bolt.circle）。详见 icons/README.md。

自带图标只是占位美术，自行确认授权后再分发或商用。

卸载

./uninstall.sh

会注销 LaunchAgent、结束进程、删除 ~/Applications/DSHStatus.app 与 plist。
DSH 本身和 ~/.dsh 里的会话数据不受影响。

原理

- 不弹终端：启动走 /bin/zsh -lc 'nohup dsh web > /tmp/dsh-web.log 2>&1 &'， DSH 完全脱离终端在后台跑，关掉任何窗口都不影响它。
- 状态探测：后台队列每 3 秒对 127.0.0.1: 发一次 1.5 秒超时的 HTTP 请求， HTTP 状态码

图标是灰色的闪电 / 默认图标，不是我自己放的图？
说明这份 App 编译时 icons/ 里没有图（build.sh 会打印「未提供 icons/run.*」）。
把图放好重新 ./install.sh 即可。

图标一直是「未运行」，但 DSH 明明开着？
说明端口不一致。确认 DSH_PORT 与 dsh web --port 用的是同一个值。

点了启动但 Web 打不开？
看 /tmp/dsh-web.log（菜单里可以直接打开）。最常见原因是 dsh 不在 PATH 里的常见位置，用 DSH_BIN 显式指定即可。

改了源码怎么生效？
重新 ./install.sh（会自动 bootout 旧实例再装新的）。

已知限制

- 仅 macOS（AppKit + launchd），Linux / Windows 不适用
- 只管理本机默认端口的 DSH Web，不做多实例 / 多端口管理
- 状态判定基于 HTTP 探测，端口被别的 HTTP 服务占用时会误判为「运行中」

许可证

MIT © 2026 DESTINYwang0428