@sundusk/dsh-moodball-status

✨ 使用

安装并启动后，桌面上没有任何窗口——它是个纯菜单栏应用（不占 Dock、不抢焦点）： 菜单栏右侧出现状态图标，桌面右下角出现当前皮肤的悬浮桌宠。

以后怎么打开？

• 访达 → 应用程序（或 ~/Applications）：找到「MoodBall」，双击
• 终端：open -a MoodBall

菜单栏图标功能

菜单项	功能
状态文字	当前连接状态、状态名与桥接方式（如「已连接 · 工具调用 · 本地桥接」）
隐藏 / 显示悬浮球	开关悬浮球显示
设置…	打开设置面板
退出	退出 app（不影响 DSH 本体）

小球交互

• 拖动：按住小球任意位置拖动，可把它移到任何地方（位置会记住）
• 双击：小球左右摇动约 2 秒，表示兴奋
• 锁定位置（设置面板 → 行为）开启后不可拖拽，仍可双击

向 Harness 发送消息

宠物下方的短横条会在鼠标靠近时变成笔记按钮。点击后展开原生输入框：

• 首次发送前选择 Harness 已注册的工作区，MoodBall 会记住目标。
• Enter 发送，Shift+Enter 换行；中文输入法选字时 Enter 只确认候选文字。
• 第一条消息创建 MoodBall 专用会话，后续消息沿用同一会话；执行中、等待授权或等待回答时暂时不能继续发送。
• “新建会话”只解除当前绑定，不会删除或停止旧 Harness 任务；“打开 Harness”进入现有 Harness 首页。
• 命令插件不可用时仍可显示旧版状态，但输入功能会明确禁用；草稿不会被静默丢弃。

桌宠皮肤

设置面板 →「外观」→「桌宠」可即时切换：

• 心情球：保留原有呼吸、眨眼、气泡和状态颜色。
• 小雨：使用迁移自 Harness Desktop 的像素图集，支持待机、思考、授权、提问、完成、失败、挥手，以及左右拖拽奔跑。

两种皮肤共用 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 未运行（显示「DSH 未运行」）或状态插件未装（显示「插件已关闭」）。 先确认终端里 dsh web 在跑，再确认插件已安装并启用。
• 「设置 → 插件」里怎么没有心情球插件卡片？ 这是正常的——心情球插件没有任何设置项 （所有配置都在 app 的设置面板里），所以不显示配置卡片。可在「设置 → 插件 → 插件列表」 中查看它（状态为「已挂载」）。