前言¶
DeepSeek Harness（dsh）把模型適配、工具、會話、沙箱和界面都做成可替換插件，官方倉庫的口號就是「Everything is a Plugin」。日常用它跑智能體時，真正容易漏掉的往往不是能力，而是狀態：會話已經在跑、卡在審批、剛做完等你看結果，人卻切到了瀏覽器、IDE 或文檔裏。頁面內的桌寵只能在你打開 DSH 網頁時起作用；一旦窗口被蓋住，狀態就從視野裏消失。
社區目錄裏有一款名爲 dsh-pet 的趣味插件，維護者是 FlytoMAYDAY80。它不是網頁右下角的動畫，而是一隻獨立的桌面小鯨魚：不打開 DSH 頁面，也能用表情、氣泡和音效告訴你當前會話處於「需要確認 / 工作中 / 完成 / 空閒 / 離線」中的哪一種。本文依據插件目錄頁、GitHub 倉庫 README、產品說明.md、CHANGELOG.md 與 package.json 交叉覈實後寫成。社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。
當前公開源倉庫爲 FlytoMAYDAY80/dsh-pet，許可證 MIT，主要語言 JavaScript。目錄頁與 GitHub 在撰寫時均顯示 13 顆星；最新發布標籤是 v0.1.1（2026-08-17）。倉庫聲明：本工具是獨立的第三方桌面伴侶，與 DeepSeek / DeepSeek AI 官方無關；鯨魚形象與「DeepSeek」名稱用於指代所對接的官方產品，版權歸各自所有者。
這是什麼¶
dsh-pet 的產品名是「DSH 桌寵」。按 README 的定位，它是一隻懸浮在桌面上的 DeepSeek 小鯨魚：你在別的軟件裏工作時，它始終待在桌面一角，把「任務狀態」從需要主動打開的頁面，變成餘光就能讀到的即時信號。
倉庫說明它隨 DeepSeek Harness 發佈而開源，原先託管在 dsh-external 組織倉庫，現在以個人賬號倉庫作爲公開源。形態上它是獨立的 Electron 桌面應用，通過只讀 HTTP / WebSocket 接口讀取本機 DSH GUI，不寫入會話數據、不改 DSH 配置。package.json 裏的版本號是 0.1.1，productName 爲「DSH 桌寵」，構建目標是 macOS 的 dmg 與 zip。
它要解決的問題很具體：人離開 DSH 頁面之後，審批、提問和任務完成最容易被漏掉。桌寵把這幾類狀態提到桌面層，並用專屬音效提醒「需要確認」和「任務完成」。
核心功能¶
README 把能力概括成下面幾條，產品說明和 Changelog 可以互相印證。
1、離屏狀態感知。 獨立置頂懸浮窗，跨全屏應用可見。不打開 DSH 網頁，也能看見會話是否在跑、是否在等你、是否剛做完。
2、五種狀態，按緊迫度呈現。 README 給出的用戶可見優先級是：需要確認 > 工作中 > 完成待查看 > 空閒 > 離線。對應表現如下：
| 狀態 | 鯨魚表現 | 含義 |
|---|---|---|
| 需要確認 | 瞪眼 + 眉毛 + o 嘴 + 提示音 | 有審批或提問等你處理 |
| 工作中 | 專注眼 + 噴水動畫 | 有會話正在運行 |
| 完成待查看 | 開心眯眼 + 星星 | 任務剛完成，去看結果 |
| 空閒 | 睡覺 + zzz | 無任務 |
| 離線 | 灰度 + X 眼 | 連不上 DSH，會自動重試 |
產品說明補充了觸發條件：任一會話出現權限審批（approval/requested）或提問（question/requested）時進入「需要確認」；任一會話 running 時進入「工作中」；會話由運行轉空閒後有 120 秒 窗口顯示「完成待查看」；DSH GUI 不可達時顯示離線。多會話並行時，氣泡按會話粒度逐行列出標題，數量多了可以在氣泡內滾動。
3、雙通道即時推送，輪詢兜底。 v0.1.1 起，狀態引擎使用：
- 每 2 秒輪詢
POST /api/session.list，拿會話標題、running 與 todos 基線； - WebSocket
/api/events.mux，收審批 / 提問 / 隊列推送，斷線自動重連； - WebSocket
/api/events.host，收 running 狀態翻轉的即時推送。
Changelog 寫得很清楚：DeepSeek Harness 0.1.0-rc.6 起，這兩條事件通道只接受 WebSocket 升級，普通 GET 會返回 426。v0.1.0 仍走舊 SSE 客戶端，在 rc.6 下收不到審批 / 提問，桌寵會一直離線。要用當前 DSH，應安裝 v0.1.1。
4、低打擾，只在狀態變化時發聲。 同一狀態下的輪詢刷新保持靜默。「需要確認」和「任務完成」各有專屬音效；已經處於「需要確認」時若再來新的審批或提問，v0.1.1 會再次響鈴。
5、對 DSH 零侵入。 只讀本地接口，不寫入任何數據。卸載桌寵進程即消失。README 明確說：桌寵不會把數據傳到雲端。
6、零代碼定製。 把文件放進 custom/ 目錄，重啓後覆蓋內置素材：sprites.json 改像素圖案和配色，attention.m4a / done.m4a 改兩種提示音。也可以用倉庫自帶腳本從參考圖生成圖案。
安裝與啓用¶
目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行：
dsh plugin add github:FlytoMAYDAY80/dsh-pet
如需可復現安裝，目錄頁建議固定 commit 哈希：
dsh plugin add github:FlytoMAYDAY80/dsh-pet#commit
把 commit 換成實際哈希即可。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼；安裝前應檢查源代碼倉庫和許可證。
需要把形態說清楚。倉庫根目錄是 Electron 應用（main.js、preload.js、package.json），沒有典型的 Harness apply(ctx) 插件入口。產品說明寫明：桌寵通過 HTTP/WebSocket 只讀接口與 DSH 通信，不依賴 DSH 插件體系，以獨立桌面伴侶分發。想讓小鯨魚出現在桌面上，應使用倉庫 README 推薦的安裝包，或從源碼啓動，而不是隻依賴上面這條目錄收錄命令。
方式一：下載安裝包（README 推薦）
從 GitHub Releases 下載當前 v0.1.1 產物。撰寫時最新資源是：
| 平臺 | 安裝包 | 說明 |
|---|---|---|
| macOS Apple Silicon | dsh-pet-0.1.1-arm64.dmg |
雙擊打開，把鯨魚拖入 Applications |
| macOS Apple Silicon | dsh-pet-0.1.1-arm64-mac.zip |
便攜版，解壓即用；刪文件夾即卸載 |
產品說明寫的是「平臺：macOS（當前驗證）」。Windows / Linux 的透明窗口、托盤和音效仍列爲待適配，不要默認它們已經可用。
方式二：從源碼運行
需要 Node.js 18+ 與 pnpm：
pnpm install # 安裝依賴（Electron）
pnpm start # 啓動桌寵（默認右下角）
可選環境變量指定 DSH GUI 地址，默認是本機 3080 端口：
DSH_PET_URL=http://127.0.0.1:3080 pnpm start
啓動前先確認 DSH GUI 已經在該地址運行。桌寵連不上時會進入離線態（灰度 X 眼），並自動重試。
典型用法¶
啓動後，鯨魚默認停在屏幕右下角。對照五種狀態讀表情即可；氣泡裏會寫明是哪些會話、需要什麼操作。
README 給出的交互如下：
| 操作 | 行爲 |
|---|---|
| 單擊鯨魚或氣泡 | 打開 DSH GUI（系統瀏覽器；也可改成桌寵窗口並直達會話） |
| 按住拖拽 | 移動位置 |
| 右鍵鯨魚 / 氣泡或托盤圖標 | 菜單：氣泡開關、音效開關、大小調節、打開方式 |
| 滾輪（氣泡內） | 滾動查看多會話列表 |
產品說明裏大小範圍是 50%–110%，默認 67%。音效可在右鍵菜單裏開關；聽不到提示音時，先打開「音效」，再確認系統音量。
看到「需要確認」就回到 GUI 處理審批或提問；聽到完成音或看到完成表情，就回去看結果；鯨魚睡覺則表示當前沒有任務。
如果要換形象或換音效，把文件放進 custom/ 後重啓：
custom/
├── sprites.json ← 像素圖案 + 配色
├── attention.m4a ← 「需要確認」音效
└── done.m4a ← 「任務完成」音效
只改配色時，sprites.json 裏寫 palette 即可，例如把身體主色 "b" 換成自己的主題色。從參考圖生成圖案：
python3 scripts/ref_to_sprites.py <你的參考圖.png>
腳本需要 Python 3 和 PIL。詳細字段見倉庫 custom/README.md。刪除 custom/ 下不需要的文件，就會回到內置素材。
開發自檢命令也在 README 裏：
pnpm smoke # 狀態引擎冒煙測試
pnpm shot # 兩種皮膚 × 5 狀態截圖
適用場景與注意事項¶
適合已經在本機跑 DeepSeek Harness GUI、又經常切到其他軟件幹活的人：編碼、寫文檔、看網頁時，用餘光確認智能體有沒有卡住、有沒有做完。也適合同時開多個會話、需要在氣泡裏掃一眼各會話標題的人。分類在社區目錄裏是「趣味」，但狀態通道和音效是按真實會話事件來的，不是純裝飾動畫。
使用前注意這幾件事：
- 先升級到 v0.1.1。 Changelog 寫明：v0.1.0 安裝包基於舊 SSE 協議，在 DSH 0.1.0-rc.6 下無法收到審批 / 提問事件。
- 當前驗證平臺是 macOS。 官方安裝包只提供 Apple Silicon 的 dmg / zip。從源碼跑仍然依賴 Electron；產品說明把跨平臺適配和約 100MB+ 的安裝體積都列爲待優化項。
- 桌寵只讀本地 DSH 接口。 默認連
http://127.0.0.1:3080。它不處理審批本身：點擊目前只打開 GUI，氣泡內還沒有「允許 / 拒絕」按鈕。產品說明把「氣泡內直達處理」列爲後續項。 - 權限與來源。 目錄頁的通用安全提示仍然適用：安裝命令可能執行代碼，插件以當前 dsh 進程權限運行。獨立安裝包則是另一個 Electron 進程，會讀取本機 DSH 的 HTTP/WebSocket。安裝前應查看 源碼倉庫 和 MIT 許可證。
- 同名插件不要混。 社區目錄裏還有其他名爲
dsh-pet的項目（例如網頁內桌寵）。本文對應的是維護者 FlytoMAYDAY80、目錄頁 slug 爲dsh-pet-flytomayday80的這一份獨立桌面應用。
小結¶
dsh-pet 把 DeepSeek Harness 的會話狀態從網頁裏拿到桌面上：小鯨魚用五種表情加兩種音效，覆蓋審批、運行、完成、空閒和離線。它由 FlytoMAYDAY80 維護，MIT 開源，當前推薦版本是 v0.1.1，面向本機已啓動的 DSH GUI，安裝包目前驗證在 macOS Apple Silicon。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-pet-flytomayday80/
GitHub：https://github.com/FlytoMAYDAY80/dsh-pet
