🐳 大肥鱼 · DeepSeek Harness 启动器

Name: zhqowo/dsh-whale-tray
Author: zhqowo

DSH(DeepSeek Harness)的一键开关 —— Windows 是右下角托盘,macOS 是右上角菜单栏。 独立于 dsh 进程,类似 Steam 的启动器。

🦞 找 OpenClaw 龙虾? 那个已经拆到独立仓库了: zhqowo/openclaw-menubar —— 两者受众不同, 分开之后各自能被搜到、各自独立发版。

我该用哪个

平台	程序	形态	源码
Windows	`大肥鱼.exe`	右下角托盘	`WhaleTray.cs`
macOS	`大肥鱼.app`	右上角菜单栏	`macos/`

功能对照

操作	Windows	macOS
开关服务	右键 → 开启/关闭	同
唤起 Web	左键 / 双击鲸鱼	左键
切到已开的标签	9335 端口 + 配套浏览器扩展	AppleScript 直连,不需要扩展
重启服务	右键 → 重启	同
充值	右键 → 充值	同
退出	先关 dsh 再退出	同
状态刷新	每 2 秒	每 3 秒(TCP 探测)
形态	托盘 + 隐藏控制台	菜单栏,天然静默

macOS 版不需要浏览器扩展 —— Chromium 系浏览器把标签页暴露给 AppleScript, 直接选标签就行。Windows 才需要那套端口轮询 + 扩展。

⚠️ macOS 版有一个 Windows 没有的大坑:TCC 权限。 改代码 / 换机器 / 重新编译之前,务必先读 macos/README.md 的 TCC 章节 —— 那三条铁律是踩坑换来的,违反任何一条都会让整套授权静默失效。

🐳 大肥鱼

Windows 版

操作	行为
双击 exe	托盘出现鲸鱼;dsh 没开自动启动(隐藏运行,日志写 `dsh-tray.log`)
左键 / 双击鲸鱼	唤起 DSH Web(通过配套浏览器扩展切换后台标签,不新开页)
右键 → 开启/关闭大肥鱼	动态切换,状态每 2 秒自动刷新
右键 → 重启服务	仅运行时显示;停旧服务 → 等端口释放 → 隐藏重启
右键 → 充值	在 Edge 中打开 `https://platform.deepseek.com/usage`
右键 → 退出	先关 dsh 服务,再退出程序

技术要点(Windows)

独立进程:不依赖 dsh;强杀鲸鱼不影响 dsh,反之亦然
唤起 Web 三层方案:① 窗口标题匹配(前台标签)② 浏览器扩展唤醒后台标签(推荐)③ 兜底新开
扩展通信:本地端口 9335(鲸鱼发信号 → 扩展轮询 → chrome.tabs.update + windows.update(state:'normal'))
DPI:PerMonitorV2 感知 + 系统菜单字体(app.manifest)
句柄安全:监听 socket 标记不可继承(防止 dsh 子进程占用端口),端口被占时 20s 自愈重试
单实例:互斥锁防止重复运行

构建(Windows)

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /nologo /target:winexe /out:大肥鱼.exe /win32icon:whale.ico /win32manifest:app.manifest /codepage:65001 /r:System.dll /r:System.Drawing.dll /r:System.Windows.Forms.dll /r:System.Web.Extensions.dll /r:UIAutomationClient.dll /r:UIAutomationTypes.dll WhaleTray.cs

扩展安装(一次性)

edge://extensions → 打开「开发人员模式」
「加载解压缩的扩展」→ 选择 extension/ 目录
以后点鲸鱼即可静默切换 DSH 标签

macOS 版

Swift + Cocoa 的 NSStatusItem 应用。菜单栏右侧一只鲸鱼,左键切标签、右键弹菜单 (状态 · 开启/关闭 · 重启 · 打开网页 · 充值 · 退出),运行中彩色 / 停止时半透明。

cd macos && zsh build.sh     # 编译并安装到 ~/Desktop/大肥鱼.app

细节(图标合成、左右键分离原理、AppleScript 的坑、以及必读的 TCC 权限章节) 见 macos/README.md。

⚙️ 配置(可选,两个平台都支持)

不配置也能用 —— 默认值就是给标准 DeepSeek + dsh 环境准备的。

「充值」写死指向 DeepSeek?我怎么改成别的?

菜单里的充值默认打开 https://platform.deepseek.com/usage。但本启动器只管开关 dsh 服务,跟模型供应商无关 —— 你完全可以用别家的模型。

放一个 JSON 配置文件就能改,不用重新编译:

平台	路径
macOS	`~/.config/dsh-whale-tray/config.json`
Windows	`%APPDATA%\dsh-whale-tray\config.json`

也可以用环境变量 DSH_WHALE_TRAY_CONFIG 指定任意路径(两平台通用)。

{
  // 充值/账单要打开的页面
  "billingUrl":   "https://your-provider.example/billing",
  // 菜单里那一项显示什么字(默认「充值」)
  "billingLabel": "账单",

  // 仅 Windows:你的 dsh 装在哪儿
  // 留空则自动探测 D:\DeepSeekHarness,再退回 %USERPROFILE%\DeepSeekHarness
  "dshHome":      "C:\\DeepSeekHarness"
}

键	默认值	作用
`billingUrl`	`https://platform.deepseek.com/usage`	充值项打开的网址
`billingLabel`	`充值`	充值项的显示文字
`dshHome`	自动探测	仅 Windows:dsh 安装根目录

所有键都是可选的,给几个生效几个
文件不存在 / JSON 写错 / 类型不对 → 静默回退默认值,绝不让托盘或菜单栏起不来
命令行 macos/dsh-ctl.sh billing 读同一个文件
不支持 JSON 注释 —— 上面只是为了标注才写成 jsonc

🦞 OpenClaw 龙虾 → 已拆分为独立仓库

OpenClaw 网关的菜单栏开关曾经和本仓库放在一起,现已迁到:

👉 zhqowo/openclaw-menubar

它跟大肥鱼是两个受众:大肥鱼伺候 DSH 用户,龙虾伺候 OpenClaw 用户。合在一起会让两边都搜不到对方的关键词,所以拆了。

源码、构建脚本、图标素材、Release 全在新仓库
原 openclaw/ 目录已从本仓库移除(内容与 Git 记录完整保留在新仓库)

作为 DSH 插件安装

本仓库声明了 dsh.bundle manifest,所以可以直接当插件装(用于让 agent 自己拉起/管理 DSH):

dsh plugin --profile web add github:zhqowo/dsh-whale-tray

装的只是清单,真正干活的是 WhaleTray.cs / macos/ 里编译出来的菜单栏应用 —— 桌面应用没法通过 npm 分发。这个入口的意义是让 DSH 能发现并管理它。

下载

dist/ 里是打包好的 macOS 应用(解压即用):

文件	说明
`dist/大肥鱼.app.zip`	macOS 菜单栏版大肥鱼

🦞 OpenClaw 龙虾的下载在新仓库: openclaw-menubar/releases

因为是 ad-hoc 签名,首次打开会被 Gatekeeper 拦一下:右键 →「打开」,或 xattr -d com.apple.quarantine 大肥鱼.app。 ⚠️ 别再自己重新编译 大肥鱼.app —— 会换 cdhash,让 TCC 授权全部失效。

WhaleTray.cs      # Windows 主程序(C#, WinForms, .NET Framework 4.x)
app.manifest      # Windows DPI 感知清单
extension/        # Windows 配套浏览器扩展(唤醒后台 DSH 标签)
whale*.*          # Windows 图标(裁剪 + 缩放 + 白色提亮修复版)
macos/            # macOS 版大肥鱼(Swift)+ dsh-ctl.sh
tools/            # 配套小工具(check-perms.sh 权限体检 / uictl 界面操作)
dist/             # 打包好的 macOS .app
package.json      # dsh 插件清单(声明 dsh.bundle,供 dsh plugin add 安装)
cordis.patch.yml  # 上面那个 manifest 指向的 patch 文件

🦞 OpenClaw 龙虾已拆到 zhqowo/openclaw-menubar。

🖼️ 图标出处

鲸鱼娘立绘不是我画的,出处如下,两个平台的图标都从这张原图加工而来。

原始作者:月匠(B站) —— 鲸鱼娘立绘由 B 站画师月匠绘制 (原图见仓库内 whale-source.png,来自其 B 站动态)
收录渠道:dsh-whale-widget(DeepSeek 余额小鲸鱼挂件)插件 —— MeteorNOX/DeepSeek-Balance-Whale-Widget (MIT License, Copyright © 2026 MeteorNOX)
若月匠老师希望调整署名、更换或删除素材,请提 issue,我们立即处理

本仓库对原图没有做美术改动,只做了机械处理:

文件	平台	怎么来的
`whale.ico`	Windows	原图裁剪 → 缩放到 16/32/48/256 → 打包 ico
`whale16/32/48/256.png`	Windows	同上,各尺寸单独文件
`macos/whale256.png`	macOS	原图缩小到 256(构建素材的起点)
菜单栏 `whale.png` / `whale@2x.png`	macOS	上者 `sips -z` 缩成 22px / 44px
app 图标 `AppIcon.icns`	macOS	上者叠在渐变卡片上(`icon_compose.swift`)后转 icns

小尺寸做了白色提亮修复 —— 原图缩到 16px 后线条会糊成一团暗色,提亮后才看得清。

macOS 那 22px 图标还有个坑:NSImage(contentsOfFile:) 不会自动加载 @2x 兄弟文件, 只塞一个在 Retina 上会发虚,所以构建脚本两个尺寸都塞。

完整第三方素材声明见 NOTICE。

依赖

DeepSeek Harness(dsh)
Windows:系统已装 Edge / Chrome(唤起用)
macOS:系统已装 Edge / Chrome(切标签用);dsh 侧见 macos/README.md

许可

⚠️ 图标/素材除外:鲸鱼素材版权属原画师月匠(B站),收录链路与署名要求见上面「图标出处」一节。二次分发请一并保留这个署名。

🐳 大肥鱼 · DeepSeek Harness 启动器

English | 中文

DSH(DeepSeek Harness)的一键开关 —— Windows 是右下角托盘,macOS 是右上角菜单栏。 独立于 dsh 进程,类似 Steam 的启动器。

🦞 找 OpenClaw 龙虾? 那个已经拆到独立仓库了: zhqowo/openclaw-menubar —— 两者受众不同, 分开之后各自能被搜到、各自独立发版。

我该用哪个

平台	程序	形态	源码
Windows	`大肥鱼.exe`	右下角托盘	`WhaleTray.cs`
macOS	`大肥鱼.app`	右上角菜单栏	`macos/`

功能对照

操作	Windows	macOS
开关服务	右键 → 开启/关闭	同
唤起 Web	左键 / 双击鲸鱼	左键
切到已开的标签	9335 端口 + 配套浏览器扩展	AppleScript 直连,不需要扩展
重启服务	右键 → 重启	同
充值	右键 → 充值	同
退出	先关 dsh 再退出	同
状态刷新	每 2 秒	每 3 秒(TCP 探测)
形态	托盘 + 隐藏控制台	菜单栏,天然静默

macOS 版不需要浏览器扩展 —— Chromium 系浏览器把标签页暴露给 AppleScript, 直接选标签就行。Windows 才需要那套端口轮询 + 扩展。

🐳 大肥鱼

Windows 版

操作	行为
双击 exe	托盘出现鲸鱼;dsh 没开自动启动(隐藏运行,日志写 `dsh-tray.log`)
左键 / 双击鲸鱼	唤起 DSH Web(通过配套浏览器扩展切换后台标签,不新开页)
右键 → 开启/关闭大肥鱼	动态切换,状态每 2 秒自动刷新
右键 → 重启服务	仅运行时显示;停旧服务 → 等端口释放 → 隐藏重启
右键 → 充值	在 Edge 中打开 `https://platform.deepseek.com/usage`
右键 → 退出	先关 dsh 服务,再退出程序

技术要点(Windows)

独立进程:不依赖 dsh;强杀鲸鱼不影响 dsh,反之亦然
唤起 Web 三层方案:① 窗口标题匹配(前台标签)② 浏览器扩展唤醒后台标签(推荐)③ 兜底新开
扩展通信:本地端口 9335(鲸鱼发信号 → 扩展轮询 → chrome.tabs.update + windows.update(state:'normal'))
DPI:PerMonitorV2 感知 + 系统菜单字体(app.manifest)
句柄安全:监听 socket 标记不可继承(防止 dsh 子进程占用端口),端口被占时 20s 自愈重试
单实例:互斥锁防止重复运行

构建(Windows)

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /nologo /target:winexe /out:大肥鱼.exe /win32icon:whale.ico /win32manifest:app.manifest /codepage:65001 /r:System.dll /r:System.Drawing.dll /r:System.Windows.Forms.dll /r:System.Web.Extensions.dll /r:UIAutomationClient.dll /r:UIAutomationTypes.dll WhaleTray.cs

扩展安装(一次性)

edge://extensions → 打开「开发人员模式」
「加载解压缩的扩展」→ 选择 extension/ 目录
以后点鲸鱼即可静默切换 DSH 标签

macOS 版

cd macos && zsh build.sh     # 编译并安装到 ~/Desktop/大肥鱼.app

细节(图标合成、左右键分离原理、AppleScript 的坑、以及必读的 TCC 权限章节) 见 macos/README.md。

⚙️ 配置(可选,两个平台都支持)

不配置也能用 —— 默认值就是给标准 DeepSeek + dsh 环境准备的。

「充值」写死指向 DeepSeek?我怎么改成别的?

菜单里的充值默认打开 https://platform.deepseek.com/usage。但本启动器只管开关 dsh 服务,跟模型供应商无关 —— 你完全可以用别家的模型。

放一个 JSON 配置文件就能改,不用重新编译:

平台	路径
macOS	`~/.config/dsh-whale-tray/config.json`
Windows	`%APPDATA%\dsh-whale-tray\config.json`

也可以用环境变量 DSH_WHALE_TRAY_CONFIG 指定任意路径(两平台通用)。

{
  // 充值/账单要打开的页面
  "billingUrl":   "https://your-provider.example/billing",
  // 菜单里那一项显示什么字(默认「充值」)
  "billingLabel": "账单",

  // 仅 Windows:你的 dsh 装在哪儿
  // 留空则自动探测 D:\DeepSeekHarness,再退回 %USERPROFILE%\DeepSeekHarness
  "dshHome":      "C:\\DeepSeekHarness"
}

键	默认值	作用
`billingUrl`	`https://platform.deepseek.com/usage`	充值项打开的网址
`billingLabel`	`充值`	充值项的显示文字
`dshHome`	自动探测	仅 Windows:dsh 安装根目录

所有键都是可选的,给几个生效几个
文件不存在 / JSON 写错 / 类型不对 → 静默回退默认值,绝不让托盘或菜单栏起不来
命令行 macos/dsh-ctl.sh billing 读同一个文件
不支持 JSON 注释 —— 上面只是为了标注才写成 jsonc

🦞 OpenClaw 龙虾 → 已拆分为独立仓库

OpenClaw 网关的菜单栏开关曾经和本仓库放在一起,现已迁到:

👉 zhqowo/openclaw-menubar

它跟大肥鱼是两个受众:大肥鱼伺候 DSH 用户,龙虾伺候 OpenClaw 用户。合在一起会让两边都搜不到对方的关键词,所以拆了。

源码、构建脚本、图标素材、Release 全在新仓库
原 openclaw/ 目录已从本仓库移除(内容与 Git 记录完整保留在新仓库)

作为 DSH 插件安装

本仓库声明了 dsh.bundle manifest,所以可以直接当插件装(用于让 agent 自己拉起/管理 DSH):

dsh plugin --profile web add github:zhqowo/dsh-whale-tray

装的只是清单,真正干活的是 WhaleTray.cs / macos/ 里编译出来的菜单栏应用 —— 桌面应用没法通过 npm 分发。这个入口的意义是让 DSH 能发现并管理它。

下载

dist/ 里是打包好的 macOS 应用(解压即用):

文件	说明
`dist/大肥鱼.app.zip`	macOS 菜单栏版大肥鱼

🦞 OpenClaw 龙虾的下载在新仓库: openclaw-menubar/releases

因为是 ad-hoc 签名,首次打开会被 Gatekeeper 拦一下:右键 →「打开」,或 xattr -d com.apple.quarantine 大肥鱼.app。 ⚠️ 别再自己重新编译 大肥鱼.app —— 会换 cdhash,让 TCC 授权全部失效。

WhaleTray.cs      # Windows 主程序(C#, WinForms, .NET Framework 4.x)
app.manifest      # Windows DPI 感知清单
extension/        # Windows 配套浏览器扩展(唤醒后台 DSH 标签)
whale*.*          # Windows 图标(裁剪 + 缩放 + 白色提亮修复版)
macos/            # macOS 版大肥鱼(Swift)+ dsh-ctl.sh
tools/            # 配套小工具(check-perms.sh 权限体检 / uictl 界面操作)
dist/             # 打包好的 macOS .app
package.json      # dsh 插件清单(声明 dsh.bundle,供 dsh plugin add 安装)
cordis.patch.yml  # 上面那个 manifest 指向的 patch 文件

🦞 OpenClaw 龙虾已拆到 zhqowo/openclaw-menubar。

🖼️ 图标出处

鲸鱼娘立绘不是我画的,出处如下,两个平台的图标都从这张原图加工而来。

原始作者:月匠(B站) —— 鲸鱼娘立绘由 B 站画师月匠绘制 (原图见仓库内 whale-source.png,来自其 B 站动态)
若月匠老师希望调整署名、更换或删除素材,请提 issue,我们立即处理

本仓库对原图没有做美术改动,只做了机械处理:

文件	平台	怎么来的
`whale.ico`	Windows	原图裁剪 → 缩放到 16/32/48/256 → 打包 ico
`whale16/32/48/256.png`	Windows	同上,各尺寸单独文件
`macos/whale256.png`	macOS	原图缩小到 256(构建素材的起点)
菜单栏 `whale.png` / `whale@2x.png`	macOS	上者 `sips -z` 缩成 22px / 44px
app 图标 `AppIcon.icns`	macOS	上者叠在渐变卡片上(`icon_compose.swift`)后转 icns

小尺寸做了白色提亮修复 —— 原图缩到 16px 后线条会糊成一团暗色,提亮后才看得清。

macOS 那 22px 图标还有个坑:NSImage(contentsOfFile:) 不会自动加载 @2x 兄弟文件, 只塞一个在 Retina 上会发虚,所以构建脚本两个尺寸都塞。

完整第三方素材声明见 NOTICE。

依赖

DeepSeek Harness(dsh)
Windows:系统已装 Edge / Chrome(唤起用)
macOS:系统已装 Edge / Chrome(切标签用);dsh 侧见 macos/README.md

许可

⚠️ 图标/素材除外:鲸鱼素材版权属原画师月匠(B站),收录链路与署名要求见上面「图标出处」一节。二次分发请一并保留这个署名。

zhqowo/dsh-whale-tray

🐳 大肥鱼 · DeepSeek Harness 启动器

我该用哪个

功能对照

🐳 大肥鱼

Windows 版

技术要点(Windows)

构建(Windows)

扩展安装(一次性)

macOS 版

⚙️ 配置(可选,两个平台都支持)

🦞 OpenClaw 龙虾 → 已拆分为独立仓库

👉 zhqowo/openclaw-menubar

作为 DSH 插件安装

下载

目录

🖼️ 图标出处

依赖

许可

Community comments

zhqowo/dsh-whale-tray

🐳 大肥鱼 · DeepSeek Harness 启动器

我该用哪个

功能对照

🐳 大肥鱼

Windows 版

技术要点(Windows)

构建(Windows)

扩展安装(一次性)

macOS 版

⚙️ 配置(可选,两个平台都支持)

🦞 OpenClaw 龙虾 → 已拆分为独立仓库

👉 zhqowo/openclaw-menubar

作为 DSH 插件安装

下载

目录

🖼️ 图标出处

依赖

许可

Community comments