前言¶

DSH 的擴展方式是“一切皆插件”。社區目錄裏會出現這類掛在 DSH 網頁界面上的小型插件：不替代 Agent 工作流，只把狀態、審批、通知等信息轉成可見交互。whale-on-desk 就是其中一個對象：給 DeepSeek Harness 提供一隻像素鯨魚桌寵。下面介紹它的定位、安裝方式、典型用法和注意邊界。

這是什麼¶

whale-on-desk 是 cookiesheep 維護的 DSH 插件，定位是“給 DeepSeek Harness 的像素鯨魚桌寵”。它適用於 DSH 網頁界面，也可用於 DSH Desktop。README 狀態徽章標註爲“早期預覽”，許可證爲 MIT。

宿主端爲 Cordis 插件，監聽 session/event，並在 DSH web 服務器暴露 /whale/state、/whale/poke、/whale/assets/*。資料聲明插件只讀，不碰會話和文件。

核心能力¶

1. 即時反映 Agent 狀態：任務運行中、模型輸出中、調用工具、請求批准、任務完成、任務失敗。
2. 請求批准時，鯨魚貼住屏幕邊緣敲玻璃，並顯示琥珀色脈衝；瀏覽器標籤標題出現通知提示。
3. 任務完成時空翻慶祝，並彙報耗時、工具數、文件數；任務失敗時下沉，眼睛變橫線。
4. 可拖到任何位置，位置自動記住。
5. 音效爲即時合成，零音頻文件。
6. 成長系統：完成任務、開啓會話、陪伴時長累積經驗，可解鎖 8 個稱號。
7. 提供 whale_say 工具，讓 Agent 使鯨魚說話和表演，作爲通知通道。
8. 水族館模式：全屏水族箱，包含隨工具調用生長的進度珊瑚、計數本回合工具數的小魚羣；等批准時鯨魚衝向缸邊敲玻璃。
9. AI 寵物工坊：註冊 pet-forge 技能，可生成並熱切換自定義桌寵，需要 PATH 裏有 ffmpeg。
10. 自定義桌寵：把狀態映射到 GIF 的 manifest.json 和 GIF 放入指定目錄，右鍵切換立即生效。

安裝與啓用¶

先做網頁版安裝：

dsh plugin --profile web add whale-on-desk

打開或重啓 DSH 網頁界面即可。無需 API Key，無需額外配置即可使用網頁界面。

如果使用 DSH Desktop，社區資料說明 DSH Desktop 是 Electron 桌面版，且跑的是官方 Web 客戶端。先通過應用托盤打開 Open DSH Terminal：

dsh plugin add whale-on-desk

然後重啓 DSH Desktop。

當前 package.json 版本爲 3.0.0。peerDependencies 包含：

• @deepseek-ai/cordis
• @deepseek-ai/dsh-client-runtime
• @deepseek-ai/dsh-client-ui-slots
• @deepseek-ai/dsh-host-webserver
• react

卸載：

dsh plugin --profile web remove whale-on-desk

典型用法¶

先驗證基礎交互：

1. 懸停鯨魚，查看當前任務統計牌，信息包括耗時和工具數。
2. 點擊、單擊或雙擊鯨魚，觸發驚嚇、吱吱叫或驚醒反應。
3. 右鍵點鯨魚，打開小菜單：靜音、回到默認位置、換桌寵、隱藏。
4. 隱藏後，雙擊右下角恢復按鈕恢復顯示。

自定義桌寵：

1. 創建目錄：

~/.dsh/whale-on-desk/pets/<名字>/

2. 放入一套精靈：一個把狀態映射到 GIF 的 manifest.json，以及對應 GIF 文件。
3. 右鍵桌寵切換，立即生效。

AI 寵物工坊：

直接對 Agent 說“給我做一隻粉色章魚桌寵”。它會設計精靈圖、生成 GIF、裝成寵物包並熱切換，需要 PATH 裏有 ffmpeg。

水族館模式：

右鍵鯨魚選擇水族館，進入全屏水族箱；按 Esc 或關閉按鈕回到桌面夥伴模式。

審批與演示：

• 請求批准時，鯨魚貼住屏幕邊緣敲玻璃，並顯示琥珀色脈衝；瀏覽器標籤標題出現通知提示。
• 如需錄演示或截圖，配置 allowPreview: true 會額外開啓 POST /whale/preview。
• 觸發狀態：{"state":"glass-tap"}。
• 恢復：{"state":null}。
• allowPreview 默認關閉。

睡眠超時：

在 cordis.patch.yml 配置 sleepAfterMinutes，默認 10。

適用場景與注意事項¶

適合：

• 在 DSH 網頁界面使用 Agent，希望審批等待、任務完成/失敗有可見提醒。
• 在 DSH Desktop 中把 Agent 狀態放到桌寵裏。
• 希望用 whale_say 給 Agent 增加一條輕量通知通道。
• 想用自定義 GIF 或 AI 生成桌寵替換默認鯨魚。

注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼、許可證和依賴。
• 當前許可證爲 MIT。
• 該插件與 DeepSeek 無官方關聯；DSH 社區目錄是獨立站點，不等同於官方應用商店。
• AI 寵物工坊需要 PATH 裏有 ffmpeg。
• allowPreview 默認關閉，配置後纔開啓 preview endpoint。
• DSH Desktop 的具體兼容版本/運行方式未給出，建議以實際運行環境爲準。
• 動畫語法與像素規範致敬 clawd-on-desk，未共享素材或代碼；clawd 美術歸 Anthropic 所有。

鏈接¶

GitHub：https://github.com/cookiesheep/whale-on-desk

插件目錄頁（來自插件線索，README/package.json 未列出）：https://www.skillhub.cn/plugins/cookiesheep/whale-on-desk