前言¶
DSH 的插件生態強調「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。dsh-BFF-pet 是其中一個桌面寵物插件：用透明懸浮窗和 WebM 動畫顯示真實 Agent 狀態。它由 DSH 自動拉起，複用 DSH 自身的 127.0.0.1:3080，沒有獨立應用入口，也不需要額外端口。
這是什麼¶
dsh-BFF-pet 由 anyuinlara-bit 維護，項目許可證爲 MIT。它解決的是一個具體問題：DSH 的 Agent 在後臺執行任務時，開發者希望在桌面上有一個低干擾的狀態提示，而不是反覆切窗口查看。
一句話定位：DSH 桌面寵物插件，透明懸浮窗 + WebM 動畫，由真實 Agent 狀態驅動。
核心能力¶
下面介紹已覈實的幾類能力。
透明懸浮桌寵¶
桌面只顯示寵物本身，沒有背景塊。窗口置頂，可任意拖拽。
Agent 狀態驅動¶
插件會根據 DSH 的 Agent 狀態即時切換動畫與氣泡，覆蓋以下狀態：
- 空閒
- 思考中
- 工作中（區分搜索、編輯、測試、命令）
- 等待確認
- 完成
- 錯誤
狀態氣泡與彩蛋¶
狀態氣泡在寵物上方顯示當前狀態文字。
彩蛋調度包括：
- 空閒隨機彩蛋
- 早/中/晚餐時間彩蛋
- 長時間工作喫 Token
互動與托盤控制¶
點擊可觸發互動動畫，拖拽會反饋懸空動畫。
系統托盤和右鍵菜單支持：
- 觸發彩蛋
- 顯示隱藏
- 氣泡開關
- 透明度
- 大小縮放
- 復位位置
- 退出
健壯性¶
已覈實能力包括：
- 斷連檢測
- 錯誤可視化
- 狀態回落
運行環境¶
Node¶
Node 要求爲：
>=22.19
Electron¶
運行需要 Electron 運行時。程序不打包，也不強制安裝方式。
運行模式¶
支持：
- 純 Windows
- WSL2
安裝與啓用¶
資料未給出官方安裝命令，本文不拼接具體命令。啓用前可以先確認環境：
1、Node 版本滿足 >=22.19。
2、本機有可運行的 Electron。
3、按運行模式準備 Electron 路徑。
啓用後，插件由 DSH 自動拉起，無需額外端口，複用 DSH 的 127.0.0.1:3080。
典型用法¶
純 Windows¶
純 Windows 使用者可先執行：
npm install electron
這一步會在本地得到 Windows 可用的 Electron。程序啓動時按以下順序定位 Electron：
ELECTRON_PATH
node_modules/electron/dist/electron.exe
bin/win32-x64/electron.exe
程序只負責找到並配對路徑，不打包，不強制安裝方式。
注意：在 WSL 下執行 npm install electron 得到的是 Linux 版，無法驅動 Windows 桌寵。
WSL2¶
WSL2 場景下，需要將 Windows 版 Electron 放入：
bin/win32-x64/
helper 會把 runtime 與 bin/ 同步到：
C:\Users\<user>\AppData\Local\dsh-BFF-pet\
然後啓動桌寵。
托盤菜單¶
通過系統托盤或右鍵菜單可以執行：
- 觸發彩蛋
- 顯示隱藏
- 氣泡開關
- 透明度
- 大小縮放
- 復位位置
- 退出
測試¶
可使用以下命令：
npm test
npm test:helper
npm run smoke
素材與許可¶
動畫素材來自 dsh-pet，項目參考了 dsh-dafeiyu。
資料說明：
- 本項目的架構與代碼爲獨立實現
- 動畫素材複用自
dsh-pet dsh-pet與dsh-dafeiyu均爲 MIT License- 使用時需遵循各自的許可條款，並保留版權聲明
適用場景與注意¶
適合希望在 Windows 桌面觀察 DSH Agent 狀態、並且希望界面儘量不佔用的開發者。
需要注意：
- 該插件需要 Electron 運行時，程序本身不打包。
- WSL2 下不能使用 Linux 版 Electron 驅動 Windows 桌寵。
- 插件由 DSH 拉起，以當前 DSH 進程權限運行，並複用 DSH 的本地端口；安裝前應檢查源碼與許可證。
- 資料未確認 DSH 兼容版本、星標數、分類和目錄頁地址，本文不寫這些信息。
結尾¶
dsh-BFF-pet 的價值在於把 DSH 的 Agent 狀態映射到桌面，用透明懸浮窗和低干擾動畫提示當前進展，同時不引入額外端口。
資料未確認目錄頁地址；已覈實的 GitHub 倉庫地址如下：
- https://github.com/anyuinlara-bit/dsh-BFF-pet
