macOS 桌面壳zbin8523/dsh-whale

DSH Whale

DSH Whale 把 DeepSeek Harness（DSH） 的 Web 界面封装成一个可从 Dock 直接启动的 macOS 独立应用，不再需要先开终端、再开浏览器。

它不会复制或修改 DSH 配置。应用直接复用本机 ~/.dsh 中已有的工作区、历史任务、Provider、模型、插件和登录信息，因此网页版本能用的 DSH 功能会继续在独立窗口中使用。

功能

- 双击鲸鱼图标后自动启动本机 DSH，并在独立 Chromium 窗口中打开。
- 新电脑未安装 DSH 时自动打开设置向导，无需终端或管理员权限。
- 向导自动安装固定版本的 Node、DSH、14 个插件和郑观宇模型配置。
- 复用当前 ~/.dsh，不迁移、不上传、不内置 API Key。
- 保留 DSH Web 插件、文件上传、下载、剪贴板、弹窗和消息流能力。
- 最终回答直接显示在原消息流中。
- 原生标题栏跟随 macOS 的深色/浅色外观。
- 修复窄窗口或多栏布局中“本轮 token”按钮被挤成竖排的问题。
- 应用退出时只停止由自己启动的 DSH 服务。
- 支持 Intel 与 Apple Silicon 两种安装包。

系统要求

- macOS 12 或更高版本。
- 首次自动安装需要访问 Node.js 与 npm 软件源。
- 如本机已经安装 dsh，应用会继续优先复用兼容的现有环境。

DSH Whale 默认检查自己的托管运行环境，以及 /usr/local/bin、/opt/homebrew/bin、~/.local/bin、~/.npm-global/bin、~/.volta/bin 和当前 PATH。

安装

从 GitHub Releases 下载与你电脑对应的 DMG：

- Apple Silicon（M1/M2/M3/M4）：arm64
- Intel Mac：x64

打开 DMG，将 DSH Whale.app 拖入 Applications。当前公开构建使用临时签名、尚未经过 Apple 公证；首次打开如被 macOS 拦截，请在 Finder 中右键应用并选择“打开”，或到“系统设置 → 隐私与安全性”确认打开。

如果新电脑尚未安装 DSH，首次打开后填写 zhenguanyu API Key（DeepSeek Key 可选），点击“一键安装”。运行环境保存在：

~/Library/Application Support/DSH Whale/runtime/

Provider 配置保存在本机 ~/.dsh/；API Key 保存在 macOS 钥匙串，不进入 DSH 配置目录、应用安装包或 GitHub。“DSH Whale → 安装或修复 DSH…”可随时重新打开设置向导。

dsh-web-lan-access 会随插件一起安装，但默认不启用。只有在安装向导中主动勾选“允许局域网访问”时才会加入运行配置。

快捷键

| 默认快捷键 | 功能 |
|---|---|
| ⌘N | 新建会话并聚焦输入框 |
| ⇧⌘N | 在当前工作区新建会话 |
| ⌥Space | 从任何应用全局唤起并新建会话 |
| ⌘/ | 打开快捷键设置 |
| Enter | 直接发送消息 |
| ⇧Enter | 换行，不发送 |

DSH 页面左下角有“快捷键”入口，可查看、录制修改、保存或恢复默认设置。Dock 图标右键菜单也提供“新建会话”和“快捷键设置”。快捷键只保存在本机：

~/Library/Application Support/DSH Whale/shortcuts.json

从源码构建

npm install
npm run build:x64
npm run build:arm64
npm run release

npm run release 会生成两种架构的 ZIP、DMG 和 SHA-256 校验文件。Electron 锁定在 43.4.1，因为 Electron 44 已不再支持 macOS 12。

本机安装与启动验证：

./script/build_and_run.sh --verify
./script/install.sh
./script/acceptance_test.mjs

如需真实调用指定模型做验收：

DSH_WHALE_TEST_PROVIDER=your-provider \
DSH_WHALE_TEST_MODEL=your-model \
./script/acceptance_test.mjs --model

隐私与安全

- 仓库和安装包不包含 DSH 配置、API Key、Token、会话或工作区内容。
- DSH Whale 只连接本机 http://127.0.0.1:3080。
- 应用日志不主动记录提示词或 API Key。
- 当前发布包未使用 Apple Developer ID，无法完成公证；这是目前公开分发的主要限制。

日志位置：

- ~/Library/Logs/DSH Whale/app.log
- ~/Library/Logs/DSH Whale/dsh-service.log

License

MIT