鲸鱼菜单栏 reg4916/dsh-bar

DSH Bar

macOS 菜单栏里一只会动的鲸鱼，为 DeepSeek Harness 而生——不用切换窗口，就能看到并操控智能体。

DSH Bar 弹出面板

它能做什么

| 状态 | 菜单栏 |
| 空闲 | 静止的鲸鱼 |
| 思考中 / 工具运行中 | 游动的鲸鱼 + 喷水 |
| 等待批准 | 红点（若同时有提问在等待，还会显示数量） |
| 完成 | 短暂闪现「done」，然后回到空闲 |
| 出错 | 一直保留，直到下一轮开始 |
| DSH 未运行 | 鲸鱼变暗，弹出面板说明原因 |

左键点开弹出面板：会话标题、当前步骤/工具、模型、token、被挂起的工具批准可 批准/拒绝（带 1/N 队列）、直接 回答问题（单选 / 复选 / 自由文本）、会话列表、停止、打开 DSH、退出。右键菜单：打开 DSH、停止、设置、检查更新、登录时启动、退出。

鲸鱼

这个图标是代码画出来的，不是素材：WhaleIcon.swift 把身体椭圆、摆动的尾鳍、胸鳍、三滴水花和一个透明的眼睛孔画进 22 pt 的模板图，macOS 会自动为浅色和深色菜单栏着色。12 帧、12 fps，只在智能体思考或运行工具时播放；其他状态静止。

鲸鱼动画

鲸鱼动画帧

鲸鱼状态

0.2 新增：

- 在弹出面板里回答 ask_user_question 提示词——单选、多选、自定义文本，一个提示词可含多个问题；
- 批准队列：显示「1 of N」，配上一页/下一页，不再悄悄藏起其余项；
- 从 status.rows 读取会话列表：点会话即可聚焦；
- 设置窗口：通知、鲸鱼动画、会话列表、登录时启动；
- 对照 GitHub Releases 检查更新；
- en / ru / zh-Hans（跟随系统语言）；
- CI 里跑原生测试（解码、批量回答、版本比较）。

0.3 新增：

- 长问题和长会话列表在弹出面板内 滚动，不再撑出屏幕（上限 640 pt）；
- 选择器最多显示 8 个会话；
- 状态点模式——用一个小色点代替鲸鱼（设置里开）；
- 显示器变化后恢复更顺滑：弹出面板会重新跑一遍尺寸计算。

0.4 新增：

- 通过 Server-Sent Events（GET /dsh-bar/events）即时更新；0.8 秒轮询保留作兜底和重连用；
- 全局快捷键 ⌥⌘D，在任何应用里都能开关弹出面板（设置里可禁用）；
- 0.4.1：重画鲸鱼——大头、嘴线、宽大上扬的尾鳍和胸鳍，不再是像鱼的椭圆。

下载与安装（免费）

Homebrew（推荐）

brew tap reg4916/dsh-bar
brew trust reg4916/dsh-bar
brew install --cask dsh-bar

手动安装

从 latest release 下载 DSHBar-0.4.1-macos-universal.zip，解压到 /Applications，首次启动时右键 → Open（或执行 xattr -dr com.apple.quarantine /Applications/DSHBar.app）。这个包是 ad-hoc 签名——没有付费的 Apple Developer ID，所以也没有公证。

宿主插件

cd ~/.dsh/profiles/desktop
npx pnpm add dsh-bar

把 "dsh-bar" 加到该配置档 package.json 的 dsh.profile.bundles 里，然后重新加载 DSH。

关于通知

macOS 只给带 Apple 签发签名的应用注册通知中心，所以 ad-hoc 构建会收到 Notifications are not allowed for this application。DSH Bar 会检测到这种情况，改为在菜单栏附近显示一张 浮动卡片：审批标题、工具和原因，带 Open DSH / Deny / Dismiss。批准操作故意留在弹出面板里——横幅里看不到工具参数。
如果你在本地构建，并用自己的 Apple Development 证书签名，真实通知（包括 Deny 操作）会自动生效。

审批卡片

架构

- plugin/ —— dsh-bar 宿主插件（npm）。写入 $DSH_HOME/dsh-bar/runtime.json（0700/0600），在 Host web 服务器上挂载 /dsh-bar，把会话事件折叠成状态文档，持有 approval/request 和 user-questions/request 瀑布，让菜单栏应用能应答这些请求，并提供一个浏览器端，通过 ctx.uiWorkspace.openSession 打开会话。
- app/ —— 原生菜单栏应用（Swift，AppKit + UserNotifications）。读取 runtime.json，带 Bearer token 轮询 GET /dsh-bar/status，提交审批/回答/停止/聚焦。

安全：仅限回环地址，每个原生路由都要求 Bearer token，页面路由改用同源/桥接信任，不把 token 放进页面 JS。只有标题、工具名、问题文本和用量计数会过桥——消息正文永远不过桥。

审批说明： 随附的 danger-full-access 预设使用 approval: never，所以审批永远不会到达菜单栏。想看到 Approve/Deny，请使用 read-only 或 workspace-write 预设。

端点

| 方法 + 路径 | 认证 | 用途 |
| GET /dsh-bar/status | Bearer | 状态文档（会话、审批、问题） |
| GET /dsh-bar/health | Bearer | 存活检查 |
| POST /dsh-bar/approve | Bearer | {id, outcome: "allowed-once" \\| "rejected"} |
| POST /dsh-bar/answer | Bearer | {id, answers: [{id, selected, custom?}]} |
| POST /dsh-bar/stop | Bearer | {sessionId} |
| POST /dsh-bar/focus | Bearer | {sessionId} |
| GET /dsh-bar/pending-focus | 页面信任 | 页面端想要的聚焦请求 |

开发

cd plugin && npm test # 13 host tests
cd .. && ./scripts/test-native.sh # 20 native checks
./scripts/build.sh # current-arch app
./scripts/build.sh --universal # arm64 + x86_64
./scripts/package.sh # zip + plugin tgz + SHA256SUMS
不用菜单栏也能调试：DSHBar --dump-status、--notification-status、--alert-test。
环境变量覆盖：DSH_BAR_RUNTIME_FILE、DSH_BAR_DEMO=1、DSH_BAR_AUTOANSWER=1 （测试钩子：打开浮层，点第一个选项 + Send —— 用于端到端问题测试）。

路线图

- 0.1 — 原生外壳、动画鲸鱼、实时状态 ✅
- 0.2 — 问题、审批队列、会话、设置、多语言、更新检查、测试 ✅
- 0.3 — 可滚动浮层、8 个会话、状态点模式 ✅
- 0.4 — SSE 推送、全局快捷键 ✅
- 0.5 — 会话搜索、更丰富的通知卡片

许可证

MIT