前言¶
DeepSeek Harness（DSH）采用插件化架构。在开发或调试智能体时，常需最小化 Web UI 或让浏览器处于后台，此时难以直观感知 Agent 的运行状态（如是否正在思考、等待授权或已完成）。MoodBall 旨在解决这一问题，将 Agent 状态从 Web UI 中“解放”出来，悬浮在桌面的任意位置。
这是什么¶
这是一个 macOS 桌面宠物插件，由 sundusk 维护。它让 Agent 状态飞出 Web UI，悬浮在桌面的任意位置，提供菜单栏常驻与置顶桌宠功能。
核心功能¶
插件包含以下核心能力：
1. 菜单栏常驻：在菜单栏显示当前连接状态、状态名与桥接方式。
2. 置顶桌宠：小球悬浮在屏幕最上层，支持拖拽到任意位置（位置会自动保存）。
3. 多皮肤支持：提供心情球与小雨两种皮肤，随 Agent 状态实时变化。
4. 状态气泡：非空闲时显示漫画风气泡，空闲时自动隐藏。
5. 实时状态桥接：通过 HTTP/状态 Socket 接口兼容，提供用户级命令 Socket，实现状态与输入的桥接。
安装与启用¶
安装前需确保环境满足以下条件：
* 系统：macOS 14+
* 依赖：DeepSeek Harness（DSH）运行中
* 运行方式：NPM/NPX 版需 Node.js；源码版需在源码根目录运行 pnpm dsh
安装命令如下：
curl -fsSL https://github.com/sundusk/dsh-moodball/raw/refs/heads/main/install.sh | bash
注意：若通过 Release 下载安装，不会自动安装插件。此时需在 DSH 中手动添加插件。
典型用法¶
- 移动位置：按住小球任意位置可拖动，位置会自动记忆。
- 交互反馈：双击小球左右摇动约 2 秒表示兴奋；鼠标靠近宠物下方的短横条会变成笔记按钮。
- 快捷键：默认快捷键为
Option+Space。 - 输入与截图：在输入框内直接粘贴剪贴板图片，或点击回形针菜单选择框选截图。
适用场景与注意¶
- 运行环境：插件以当前 DSH 进程权限运行。若使用源码版，必须在源码根目录运行
pnpm dsh。 - 配置位置：所有配置均在 MoodBall.app 的设置面板完成，插件本身无设置项（因此不显示配置卡片）。
- 接口限制：MoodBall 的状态 Socket 只读，输入功能由独立的用户级命令 Socket 提供。
短结尾¶
MoodBall 将 Agent 状态实时投射到桌面，通过拖拽、双击等交互与状态气泡，让开发者无需打开浏览器即可掌控任务进度。配置集中，维护简单，适合需要后台监控 Agent 状态的场景。
