前言¶
用 DeepSeek Harness（DSH）跑智能體時，任務進度和審批請求多半隻在終端或 Web 界面裏出現。窗口切走之後，很難一眼判斷「還在跑」還是「等你點同意」。下面介紹 dsh-desktop-pet，它把基於 vlln/whale-girl 的鯨魚娘桌寵，適配到 Linux 與 Windows 桌面，讓 DSH 的執行狀態留在屏幕一角。
這是什麼¶
dsh-desktop-pet 由 xiaoshihou514 維護，在 SkillHub 社區目錄中歸類爲「趣味換裝」。項目自述爲「DeepSeek Harness：鯨魚娘桌寵」，當前版本 v0.1.0（MIT 許可）。
它包含兩部分協作關係，README 寫得很清楚：
- DSH 插件側：通過
whale-girl插件與 Harness 通信。 - 桌面應用側：獨立安裝的「大肥魚」客戶端（
productName: dafeiyu），負責在桌面上展示角色與狀態。
維護者在 README 中註明：這是對 @vlln 作品的 Linux / Windows 桌面版適配。
核心功能¶
根據 README 與 package.json，目前可覈實的能力如下：
- 桌面桌寵展示：角色可在桌面常駐，README 配圖展示了多套外觀。
- 任務狀態可視化：運行時可顯示「幹活進度」。
- 審批提醒：可反映當前是否需要用戶審批。
- 跨平臺桌面包：發行版提供 Linux AppImage、RPM，以及 Windows 安裝包與便攜版。
桌面端基於 Electron 構建（npm run start 爲 electron .），打包腳本同時保留 Tauri 相關命令；日常安裝以 Releases 預編譯包爲主。
安裝與啓用¶
下面按 README 給出的順序操作。插件以當前 dsh 進程權限運行，安裝前建議瀏覽倉庫源碼並確認 MIT 許可證。
1. 安裝 DSH CLI¶
npm i -g @deepseek-ai/dsh
全局安裝 @deepseek-ai/dsh，後續用 dsh plugin 管理插件。
2. 添加 whale-girl 插件¶
dsh plugin --profile web add "github:vlln/whale-girl#main"
README 使用 --profile web，插件源爲 vlln/whale-girl 的 main 分支。這是桌面伴侶與 Harness 通信的插件入口，不要自行改成其他倉庫名。
3. 安裝桌面客戶端¶
在發行版頁面下載對應平臺的安裝包：
https://github.com/xiaoshihou514/dsh-desktop-pet/releases
Linux 可選 AppImage 或 RPM；Windows 可選 NSIS 安裝包或 portable 便攜版。裝好後啓動「大肥魚」即可與已配置的 DSH 環境配合。
典型用法¶
完整鏈路可以概括爲三步：
- 全局安裝
dsh，並用上面的命令添加whale-girl插件。 - 按常用方式啓動 DSH 會話（Web profile 與安裝命令中的
--profile web對應）。 - 打開桌面端「大肥魚」，觀察角色旁的任務進度與審批狀態變化。
README 未給出更細的 CLI 子命令示例；狀態展示依賴 DSH 與 whale-girl 插件的正常通信，桌面端負責渲染。
適用場景與注意¶
適合誰
- 長時間開着 DSH 跑任務，希望桌面一角持續反饋進度的人。
- 需要醒目感知「等待審批」、又不想反覆切回終端或瀏覽器的人。
- 喜歡桌寵交互、並接受「趣味換裝」類 UI 的開發者。
使用前注意
- 插件與 DSH 以當前用戶權限運行；
add之前請檢查vlln/whale-girl與xiaoshihou514/dsh-desktop-pet的源碼與許可證。 - 桌面端是獨立應用，需從 Releases 單獨下載，不能只裝 CLI 插件就期望出現桌寵窗口。
- 項目版本爲 0.1.0，API 與打包形態可能隨版本調整，以 GitHub 倉庫爲準。
- SkillHub（目錄頁）是社區插件目錄，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，本倉庫是其中一例。
