sundusk/mac-ballPet-DeepSeekHarness

README excerpt

waterball-mac — macOS 悬浮呼吸灯 macOS 原生悬浮呼吸灯：菜单栏常驻 + 一颗置顶的发光小球，颜色随 「DeepSeek Harness」的 agent 状态变化并呼吸（思考中=绿、调工具=紫、完成=青、 出错=红…共 7 色，颜色可在设置面板自定义）。 macOS 14+ · SwiftUI 原生应用 · 需要 DeepSeek Harness（DSH）运行 下载最新 Release · 查看 v0.1.0 项目定位 这是一个面向 DeepSeek Harness 的 macOS 配套应用（companion app），不是可以直接通过 dsh plugin add 安装的独立插件。它依赖 dsh-waterball-pet 插件提供 agent 状态接口， 再在桌面菜单栏和悬浮球中显示状态。 📦 安装（给新用户） 安装依赖 1. macOS 14+ 2. DeepSeek Harness ：安装方法见 DeepSeek Harness 官方文档，装好后终端能运行 dsh web 3. Node.js + pnpm （一键脚本自动装插件时需要）：https://nodejs.org 普通用户推荐直接下载 最新 Release 中的 Waterball.app.zip ；开发者或希望自动安装依赖的用户可以使用下面的一键安装脚本。 一键安装（推荐） 方式一：git clone（最稳定，永远是新版） 方式二：从 Release 下载脚本（按版本号寻址，无缓存问题） 注： raw.githubusercontent.com 的 CDN 对新提交有缓存滞后（可能拿到旧版脚本）， 不推荐直接用 raw 路径的 curl bash 。上面两种方式都能拿到最新脚本。 脚本会自动： 1. 检测 /api/waterball/status 接口，未装插件则自动执行 dsh plugin --profile web add github:sundusk/dsh-waterball-pet 2. 有本地 dist/ 构建产物则用本地；否则自动从 GitHub Release 下载 Waterball.app 3. 把 Waterball.app 复制到 /Applications 并启动 若脚本检测到刚安装了插件，会提示你先重启 dsh web （终端 Ctrl+C 后重新运行 dsh web ），再重新执行脚本完成 app 安装。 手动安装（备选） 🚀 启动与使用 安装并启动后， 桌面上没有任何窗口 ——它是个纯菜单栏应用（不占 Dock、不抢焦点）， 只在菜单栏右侧出现一个 彩色圆点图标 ，桌面右下角出现发光呼吸球。 退出之后怎么再打开？ - Spotlight （最快）：按 ⌘ + 空格 ，输入「Waterball」，回车 - 访达 → 应用程…

Category