前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。在本地开发或运行智能体时,管理 dsh 服务进程通常需要打开控制台窗口或执行命令行指令。zhqowo/dsh-whale-tray(通常被称为「大肥鱼」)是一个独立的启动器插件,它为 Windows 系统提供托盘图标,为 macOS 提供菜单栏图标,实现了服务的快速启停与状态监控。
核心功能¶
该插件提供桌面级的交互入口,核心能力如下:
* 跨平台图标: Windows 在系统托盘显示,macOS 在菜单栏显示。
* 服务控制: 支持启动、停止、重启 DeepSeek Harness (dsh) 服务。
* 唤起 Web UI: 点击图标可唤起 Web 界面。
* 独立运行: 独立于 dsh 进程,不占用 dsh 的主进程资源。
* 其他操作: 支持充值/账单跳转等辅助功能。
安装与启用¶
在支持 DSH 的环境(如 Web Profile)下执行以下命令安装:
dsh plugin --profile web add github:zhqowo/dsh-whale-tray
典型用法¶
安装后,根据操作系统操作:
* Windows: 双击运行编译好的可执行文件(如 大肥鱼.exe),图标将出现在系统托盘。
* macOS: 进入源码目录执行编译脚本,生成的 .app 放入 ~/Desktop/大肥鱼.app。
* 唤起 Web: Windows 需配合浏览器扩展(用于切换后台标签),macOS 可直接通过 AppleScript 唤起,无需扩展。
注意事项¶
- macOS 权限: macOS 版本需要 TCC 权限。首次打开时,请右键选择「打开」,或在终端运行
xattr -d com.apple.quarantine 大肥鱼.app以移除隔离属性。 - Windows 扩展: 唤起 Web 界面需要安装配套的浏览器扩展,以便在后台切换标签页。
- 配置: 所有配置均为可选,默认值适用于标准 DeepSeek 环境。
该插件通过图形化界面解决了命令行管理服务的不便,适合需要在本地频繁启停 dsh 的开发者。更多细节与源码请参考:
* 插件目录:https://www.skillhub.cn/plugins/zhqowo/dsh-whale-tray
* 源码仓库:https://github.com/zhqowo/dsh-whale-tray