DSH Launcher — DeepSeek Harness 菜单栏 App

English | 中文

macOS 菜单栏小应用：把 dsh web 服务交给 launchd 托管，不再需要开着终端。
App 在 → 服务就在：启动 App 自动拉起服务，退出 App 自动停止服务。
点击菜单栏鲸鱼图标（🐋 绿=运行中 / 橙=端口被外部占用 / 红=启动失败 / 灰=未运行，图标为官方 dsh 鲸鱼 logo 按状态着色）弹出控制菜单，可打开 Web UI、重启服务、设置登录自启、打开数据目录或退出。

绿色 = launchd 托管进程在运行 且 HTTP 3080 实际可访问，双条件缺一不亮绿。
服务进程继承你终端的 zsh 环境（PATH 等），agent 的 shell 工具直接可用 node/npm/pnpm/bun 等工具链。

需要先手动执行 npx @deepseek-ai/dsh web 吗？

不需要。 前提只是"机器上装有 Node.js"：

• 本 App 负责启动并托管 dsh web --port 3080（App 启动自动拉起，也可点"重启服务"手动拉起）；已有 dsh（全局安装或 npx 缓存）直接复用。
• 首次使用（本地无 dsh）时，App 不会自动下载，菜单栏显示"服务：dsh 未安装"并出现「安装 dsh」按钮。点击后弹出安装面板（实时显示下载日志），安装完成自动拉起服务，全程无需重启 App。
• 如果你之前在终端手动跑过 dsh web，那个进程占着 3080 端口，App 会显示橙色"外部实例"——先在终端按 Ctrl+C 停掉，再让 App 接管（步骤见下文）。

安装（DMG 发行版）

从 Releases 下载 DSH-Launcher-*.dmg：

1. 打开 DMG，把 DSH Launcher.app 拖进 Applications
2. 首次打开（未签名/未公证，Gatekeeper 会拦截）：Finder 里右键 DSH Launcher.app → 打开；或执行

   xattr -dr com.apple.quarantine /Applications/DSH\ Launcher.app

要求：Apple Silicon Mac（M1/M2/M3/M4）· macOS 13 或更高 · 装有 Node.js（fnm / nvm / Homebrew 均可）。

构建

./build.sh        # 产出 dist/DSH Launcher.app（ad-hoc 签名，无需开发者账号）

产物为可直接运行的 dist/DSH Launcher.app，拷贝到任意位置（如 ~/Applications/）即可使用。

菜单功能

从终端实例切换（第一次使用）

现在端口 3080 可能还被终端里的 dsh web 占着（App 会显示橙色"外部实例"）。
切换步骤：

1. 在终端按 Ctrl+C 停掉旧的 dsh web（本次会话会离线，但历史记录都在 ~/.dsh/sessions/）
2. 退出再打开 DSH Launcher（或点 重启服务），服务自动拉起
3. 状态变绿后点 打开 Web UI，历史会话完整可续

技术要点

• 环境继承：launchd 本身没有你的 shell 配置，所以每次启动服务前，App 会用
  zsh -lic 抓取你的完整环境写入 plist 的 EnvironmentVariables（PATH 剔除易失的
  fnm multishell 临时目录、node 目录置顶）。服务进程与 agent 的 shell 工具因此
  直接可用终端同款工具链（node/npm/pnpm/bun 等），改 .zshrc 后重启服务即生效。
  注意：含 token/secret/password/api key/凭据等关键字的环境变量（如
  DASHSCOPE_API_KEY、AWS_SECRET_ACCESS_KEY）会被主动剔除，不会写入 plist
  明文落盘——请把 API key 配置在 ~/.dsh 的 dsh 配置里（dsh 原生做法），
  不要依赖 .zshrc 环境变量传给服务内的 agent。
• 升级 dsh 无需改配置：每次启动服务都会重新解析 node 与最新 dsh 包路径并
  重写 ~/Library/LaunchAgents/com.dsh.web.plist。
• 自动更新检测：App 启动 10 秒后及每 6 小时查询一次 npm registry
  （@deepseek-ai/dsh 的 latest + next 两个 dist-tag，取版本更高者），与本地
  已装版本按 SemVer 2.0 比较（正确识别 rc/alpha/beta 预发布号）。发现新版本时菜单栏
  出现「更新 dsh → vX」，来自 next 预发布通道的目标版本会标注「（预发布）」；
  点击一键执行 npm install -g @deepseek-ai/dsh@<目标版本>（装确切版本，不写死
  @latest），完成后自动重启服务加载新版。更新日志：
  ~/Library/Logs/DSHLauncher/dsh-update.log。
• 日志轮转：dsh-web.log 超过 20MB 时在下次重启服务前自动轮转为 .1，
  防止无限增长占满磁盘。

卸载

launchctl bootout gui/$(id -u)/com.dsh.web 2>/dev/null
launchctl bootout gui/$(id -u)/com.dsh.menubar 2>/dev/null
rm -f ~/Library/LaunchAgents/com.dsh.web.plist ~/Library/LaunchAgents/com.dsh.menubar.plist
rm -rf ~/Applications/DSH\ Launcher.app