iceleaf916/dsh-launcher

DSH启动器（dsh-launcher）

dsh（DeepSeek Harness）的系统托盘启动器：通过菜单栏控制 dsh --profile web 的启动、停止与重启，并在内置浏览器中打开 dsh 界面。

功能

- 启动 / 停止 / 重启 dsh：菜单栏一键控制 dsh web 服务
- 打开 dsh 界面：启动应用后自动在托盘内置浏览器中打开，也可从菜单重新打开
- 开机自启：勾选“开机自启 dsh”后，登录时自动启动 dsh（默认关闭）
- 崩溃自愈：dsh 进程异常退出后会自动拉起（macOS 由 launchd 托管，Linux 由 systemd user service 托管）
- 状态显示：菜单栏实时显示 dsh 运行状态（运行中 / 已停止）
- 查看日志：菜单“查看日志”直接打开 dsh 日志文件
- 退出托盘：退出托盘不影响已运行的 dsh

支持平台

| 平台 | 架构 | 安装包 |
|---|---|---|
| macOS | arm64 | .dmg |
| Linux (Debian/Ubuntu) | x86_64 | .deb |

安装

macOS

1. 从 GitHub Releases 下载 dsh-launcher__aarch64.dmg
2. 打开 dmg，将 dsh-launcher.app 拖入 /Applications
3. 由于当前发布包未进行 Apple 官方签名（未加入 Apple Developer Program），
首次打开前需要手动移除隔离属性，否则 macOS 会拦截启动：

方式一：先解除 Gatekeeper 隔离再首次启动（推荐）
xattr -dr com.apple.quarantine /Applications/dsh-launcher.app

方式二：首次启动时在“访达”中右键点击 dsh-launcher.app → 打开 → 再点“打开”

4. 首次启动时，若 dsh 未运行会自动拉起；之后可通过菜单栏控制

说明：xattr -dr 会移除整个应用的隔离标记。若系统提示“无法验证开发者”，
执行该命令后重新打开即可；如仍被拦截，可在“系统设置 → 隐私与安全性”中点击“仍要打开”。

Linux (Debian/Ubuntu)

sudo apt install ./dsh-launcher__amd64.deb

安装后可从应用菜单启动 DSH启动器，或执行 dsh-launcher。

使用

启动后会自动拉起 dsh 并弹出内置 WebView，同时菜单栏出现 DSH 鲸鱼图标；点击托盘图标可展开菜单：

| 菜单项 | 作用 |
|---|---|
| 状态行 | 显示 dsh 运行状态 |
| 打开 dsh 界面 | 在托盘内置浏览器中打开 dsh Web 界面 |
| 重启 dsh | 重启 dsh 服务 |
| 停止 dsh / 启动 dsh | 停止 / 启动 dsh 服务 |
| 开机自启 dsh | 登录时自动启动 dsh（默认关） |
| 查看日志 | 打开 dsh 日志文件 |
| 退出托盘 | 退出托盘（dsh 继续运行） |

依赖

- dsh：需已安装且可通过 shell 找到（支持 nvm / Volta / Homebrew / ~/.local/bin 等常见安装位置）
- Node.js：dsh 运行所需，与 dsh 同版本目录解析
- Linux：systemd（用户级服务），libwebkit2gtk-4.1、libgtk-3、libappindicator3（deb 已声明依赖）

服务与数据位置

macOS

| 内容 | 路径 |
|---|---|
| 窗口尺寸 | ~/Library/Application Support/dsh-launcher/window-size.json |
| 托盘日志 | ~/Library/Logs/dsh-launcher.log |
| dsh 日志 | ~/Library/Logs/dsh-web.log |
| LaunchAgent | ~/Library/LaunchAgents/com.dsh-launcher.web.plist |

Linux

| 内容 | 路径 |
|---|---|
| 窗口尺寸 | ~/.config/dsh-launcher/window-size.json |
| 托盘日志 | ~/.local/state/dsh-launcher/dsh-launcher.log |
| dsh 日志 | ~/.local/state/dsh-launcher/dsh-web.log |
| systemd unit | ~/.config/systemd/user/dsh-launcher-web.service |

遵循 XDG 规范：XDG_CONFIG_HOME / XDG_STATE_HOME 被设置时优先使用对应目录。

开发

依赖安装
pnpm install

debug 启动（需在 src-tauri 目录）
cd src-tauri && cargo run

正式打包（macOS）
pnpm tauri build --bundles app   # 仅 .app
pnpm tauri build --bundles dmg   # .app + dmg

正式打包（Linux x86_64 deb，需在 Linux 环境或 CI 中执行）
pnpm tauri build --bundles deb --target x86_64-unknown-linux-gnu

产物路径：

src-tauri/target/release/bundle/macos/dsh-launcher.app
src-tauri/target/release/bundle/dmg/dsh-launcher__aarch64.dmg
src-tauri/target/x86_64-unknown-linux-gnu/release/bundle/deb/dsh-launcher__amd64.deb

CI 构建

仓库内置 release workflow：
- 手动触发（workflow_dispatch）或在 v* tag 推送时自动触发
- Linux job：cargo check + 构建 x86_64 deb
- macOS job：构建 aarch64 dmg
- 打 tag 时自动创建 GitHub Release 并附上 deb + dmg 产物

卸载

macOS

launchctl bootout gui/$(id -u)/com.dsh-launcher.web
rm ~/Library/LaunchAgents/com.dsh-launcher.web.plist
rm -rf ~/Library/Application\ Support/dsh-launcher

Linux

systemctl --user disable --now dsh-launcher-web.service
rm ~/.config/systemd/user/dsh-launcher-web.service
systemctl --user daemon-reload
rm -rf ~/.config/dsh-launcher ~/.local/state/dsh-launcher
sudo apt remove dsh-launcher