sundusk/dsh-moodball

README 摘要

MoodBall（心情球） macOS 桌面悬浮呼吸灯 —— 让 Agent 状态飞出 Web UI，悬浮在你桌面的任意位置 菜单栏常驻 + 置顶发光小球，随 DeepSeek Harness 的 Agent 状态实时呼吸变色 macOS 14+ · SwiftUI 原生应用 · 需要 DeepSeek Harness（DSH）运行 ⬇️ 下载最新 Release 🎈 这是什么？ 心情球 把 Agent 的状态带到你的 整个桌面 上。它是一颗真正「活在桌面上」的悬浮球： 按住即可拖到屏幕 任意位置 （位置会被记住），完全不局限于 DeepSeek Harness 的 Web UI 页面内—— 即使浏览器已最小化、甚至从头到尾都不打开 Web UI，也能随时看到任务状态。 小球颜色随 Agent 运行状态实时呼吸变化（正在思考中/工具调用/等待你的授权/做出你的抉择/搞定啦/出错了…）， 非空闲时头顶还会弹出 漫画风说话气泡 ，空闲时自动隐藏。瞄一眼桌面，就知道任务进度。 项目组成 - MoodBall.app ：桌面呼吸球本体 - dsh-moodball-status ：状态插件（订阅 agent 会话事件，提供状态接口；无界面、无设置项） 一切配置都在 app 的设置面板里完成。 📸 效果展示 悬浮在桌面上的心情球 —— 可拖到屏幕任意位置，随时查看 Agent 状态 🚀 安装 安装依赖 1. macOS 14+ 2. DeepSeek Harness ：安装方法见 官方文档，装好后终端能运行 dsh web 3. Node.js + pnpm （一键安装脚本自动装插件时需要）：https://nodejs.org 方式一：一键安装（推荐） 脚本会自动： 1. 检测状态接口 /api/moodball/status ，未装插件则自动执行 dsh plugin --profile web add github:sundusk/dsh-moodball 2. 从 GitHub Release 下载 MoodBall.app （有本地构建产物时优先用本地） 3. 把 MoodBall.app 复制到 /Applications 并启动 若脚本提示刚安装了插件，请先重启 dsh web （终端 Ctrl+C 后重新运行）， 再重新执行一次脚本完成 app 安装。 方式二：仓库安装 与方式一完全等价（方式一其实就是直接运行仓库里的 install.sh），适合想顺带查看源码/自行构建的用户。 方式三：下载 Release 从 最新 Release 下载 MoodBall.app.zip ，解压后放入 /Applications （或「应用程序」），双击「MoodBall」启动。 提示：Release 安装不会自动装插件。若尚未安装，请先在终端执行 dsh p…

分类