@sundusk/dsh-moodball-status
适用于 MoodBall macOS 桌面宠物的 DeepSeek Harness Agent 状态桥接：仅主机插件，支持 HTTP 兼容性和本地 Unix 套接字传输。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:sundusk/dsh-moodball#0439903ff39e194f17ca60c5b2450ec1f6df5b67Moodball Status 以 @sundusk/dsh-moodball-status 发布，当前版本为 0.5.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
正在加载相关插件…
DeepSeek Harness macOS Desktop Pet —— 让 Agent 状态飞出 Web UI，悬浮在你桌面的任意位置
菜单栏常驻 + 置顶桌宠，支持心情球与小雨两种皮肤，随 Agent 状态实时变化
macOS 14+ · SwiftUI 原生应用 · 需要 DeepSeek Harness（DSH）运行
心情球把 Agent 的状态带到你的整个桌面上。它是一颗真正「活在桌面上」的悬浮球： 按住即可拖到屏幕任意位置（位置会被记住），完全不局限于 DeepSeek Harness 的 Web UI 页面内—— 即使浏览器已最小化、甚至从头到尾都不打开 Web UI，也能随时看到任务状态。 小球颜色随 Agent 运行状态实时呼吸变化（正在思考中/工具调用/等待你的授权/做出你的抉择/搞定啦/出错了…）， 非空闲时头顶还会弹出漫画风说话气泡，空闲时自动隐藏。瞄一眼桌面，就知道任务进度。
一切配置都在 app 的设置面板里完成。
悬浮在桌面上的心情球 —— 可拖到屏幕任意位置，随时查看 Agent 状态
pnpm dshcurl -fsSL https://github.com/sundusk/dsh-moodball/raw/refs/heads/main/install.sh | bash
脚本会自动：
pnpm dsh；NPM/NPX 版执行对应的 dsh 或 npx CLIweb profile 中检测/安装状态插件MoodBall.app（本地存在 dist/MoodBall.app 时优先使用）/Applications，无权限时自动回退到 ~/Applications 并启动脚本只需要执行一次。若插件刚安装而当前 Harness 正在运行，脚本仍会继续安装并启动 MoodBall.app；请在当前任务完成后重启一次 DeepSeek Harness 让插件加载，无需再次运行安装脚本。 如果 Harness 当前没有运行，MoodBall 会先显示“未连接”，启动 Harness 后自动连接。
安装器不会自动停止或重启正在运行的 Harness，也不会把状态接口暂时不可达直接判断为“插件未安装”。 如果同时存在多个源码版 Harness 且当前都未运行，会要求选择目标；不会静默把插件装进错误的仓库。
源码版也可以显式指定：
DSH_SOURCE_ROOT="$HOME/Projects/deepseek-harness" bash install.sh
安装器会复用当前环境或已识别 Harness 的 DSH_HOME，并将最近使用的 Harness 类型、源码路径和 profile
记录在 ~/Library/Application Support/MoodBall/config.json，供下一次安装使用。
官方 Desktop 在第一阶段只做检测，不会偷偷把插件安装到 web profile；需要等待 Desktop 官方插件安装机制稳定后再支持自动安装。
git clone --depth 1 https://github.com/sundusk/dsh-moodball.git
cd dsh-moodball
bash install.sh
与方式一完全等价（方式一其实就是直接运行仓库里的 install.sh），适合想顺带查看源码/自行构建的用户。
从 最新 Release
下载 MoodBall.app.zip，解压后放入 ~/Applications（或「应用程序」），双击「MoodBall」启动。
提示：Release 安装不会自动装插件。若尚未安装，请先在终端执行 对 NPM/NPX 版执行
dsh plugin --profile web add github:sundusk/dsh-moodball； 对源码版必须在源码根目录执行pnpm dsh plugin --profile web add github:sundusk/dsh-moodball，然后重启对应 Harness。
安装并启动后，桌面上没有任何窗口——它是个纯菜单栏应用（不占 Dock、不抢焦点）： 菜单栏右侧出现状态图标，桌面右下角出现当前皮肤的悬浮桌宠。
open -a MoodBall| 菜单项 | 功能 |
|---|---|
| 状态文字 | 当前连接状态、状态名与桥接方式（如「已连接 · 工具调用 · 本地桥接」） |
| 隐藏 / 显示悬浮球 | 开关悬浮球显示 |
| 设置… | 打开设置面板 |
| 退出 | 退出 app（不影响 DSH 本体） |
宠物下方的短横条会在鼠标靠近时变成笔记按钮。点击后展开原生输入框：
设置面板 →「外观」→「桌宠」可即时切换：
两种皮肤共用 Agent 状态、显隐、大小、气泡、发光、穿透和位置记忆设置。
菜单栏 →「状态展示…」（⌘D）：查看每个状态下心情球的实时外观，可切换气泡文字的显示与隐藏， 并可将当前状态保存为 PNG 图片。
| 状态 | 心情球 | 颜色 |
|---|---|---|
| 空闲 | 空闲 | 蓝色 |
| 正在思考中 | 正在思考中 | 绿色 |
| 工具调用 | 工具调用 | 紫色 |
| 等待你的授权 | 等待你的授权 | 黄色 |
| 做出你的抉择 | 做出你的抉择 | 粉色 |
| 搞定啦 | 搞定啦 | 青色 |
| 出错了 | 出错了 | 红色 |
| 停止 / 中断 | 停止 / 中断 | 黑色 |
| 未连接 / 插件未装 | 未连接 | 灰色 |
所有颜色都可以在设置面板自定义。
插件会优先向 ~/Library/Application Support/MoodBall/moodball.sock 推送换行分隔的状态 JSON；本地桥接不可用时，app 自动回退到设置中的 HTTP 地址 /api/moodball/status。
MoodBall 的状态 Socket 只读；输入功能由独立的用户级命令 Socket 转发到官方 workspaceRegistry / sessionController。MoodBall 不会启动、停止、升级或修改 Harness，也不模拟 Web UI。
菜单栏 →「设置…」可调整：球大小、呼吸速度、8 种状态颜色、眼睛开关与颜色、 气泡文字开关、发光开关、锁定位置、API 地址、轮询间隔、点击穿透模式等，修改立即生效。
「行为」Tab 底部还有版本与更新：显示当前版本，自动/手动检查 GitHub Releases 是否有新版本，有则给出「前往下载」链接。
git clone --depth 1 https://github.com/sundusk/dsh-moodball.git
cd dsh-moodball
bash uninstall.sh
脚本会退出并删除 ~/Applications/MoodBall.app（含 /Applications 残留），
并询问是否同时移除 dsh-moodball-status 插件（移除后重启 dsh web 生效）。
dsh web 在跑，再确认插件已安装并启用。# 插件（dsh-moodball-status）：构建到 lib/
pnpm install
pnpm build
# app：构建 dist/MoodBall.app（含小雨图集）并启动
bash make-app.sh
本项目采用 MIT License 发布。