dsh-whale-btn

Readme

# dsh-whale-btn 🐳 桌面悬浮鲸鱼按钮

DSH host 插件：在桌面显示一个置顶、可拖动、全桌面空间可见的 🐳 悬浮按钮。

> ⚠️ 平台限制：仅支持 **macOS + Apple Silicon（arm64）**（`bin/whale-btn` 为 arm64 原生二进制）。Intel Mac / Windows / Linux 不适用。

| 操作 | 行为 |
| --- | --- |
| 单击 | 聚焦已打开的 DeepSeek Harness 应用窗口；没开则启动它（不新开浏览器标签） |
| 拖动 | 1:1 跟手移动 |
| 右键 | 退出鲸鱼（下次启动 dsh 时自动回来） |

## 文件结构

```
dsh-whale-btn/
├── package.json          # dsh.bundle.patch 声明
├── cordis.patch.yml      # 向 Loader 插入 whale-btn 行
├── bin/whale-btn         # 编译好的原生悬浮窗程序（AppKit）
├── src/whale.m           # 源码；修改后重新编译到 bin/
└── lib/index.js          # host 半身：子进程生命周期管理
```

## 重新编译

```sh
clang -fobjc-arc -fno-modules -O2 -framework Cocoa -framework CoreServices \
  src/whale.m -o bin/whale-btn
```

## 安装 / 卸载

```sh
dsh plugin --profile web add https://github.com/hhj2714/dsh-whale-btn   # 安装
dsh plugin --profile web remove dsh-whale-btn                             # 卸载
```

安装后重启 dsh 生效。

## License

[MIT](./LICENSE)