前言¶
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 狀態的場景。
