前言¶
在 Windows 上使用 DeepSeek Harness（DSH）Desktop 跑 Agent 時，進程往往在後臺長時間工作：等待審批、執行工具、失敗重試。界面以日誌和會話爲主，缺少一種輕量、常駐桌面、又能反映當前任務狀態的反饋方式。社區裏已有桌寵類插件思路；dsh-kurowhale-pet（KuroWhale）把角色視覺對齊 DSH 官方圖標裏的鯨魚娘意象，做成透明懸浮窗，並根據 Agent 活動切換動畫。下面介紹它是什麼、能做什麼，以及如何在 Desktop 裏安裝啓用。
這是什麼¶
dsh-kurowhale-pet 是維護者 lemonxiny55 發佈的非官方社區插件，npm 包名與插件 ID 均爲 dsh-kurowhale-pet，當前資料中的版本爲 0.1.4。簡介爲：參考 DeepSeek Harness 官方圖標設計的鯨魚娘桌寵，在 Windows 桌面上陪伴用戶，並響應 DSH Agent 的工作狀態。
在 SkillHub 等社區目錄中，該插件歸類爲 趣味換裝。倉庫說明明確：免費、非官方，與 DeepSeek 官方及相關創作者無關聯，也未獲得背書。
- 目錄頁：https://www.skillhub.cn/plugins/lemonxiny55/dsh-kurowhale-pet
- GitHub：https://github.com/lemonxiny55/dsh-kurowhale-pet
核心功能¶
以下能力均來自倉庫 README 與 package 元數據，未在資料中出現的配置項不寫進正文。
動畫與 Agent 狀態¶
插件提供 九種動畫，對應待機、左右移動、揮手、跳躍、失敗、等待審批、工作中和完成回顧等狀態，隨 DSH Agent 活動切換。動畫幀來自既有 pet.json 所指向的 spritesheet.webp 的提取與排版，資料說明未重繪角色或修改動畫邏輯。
桌面展示與交互¶
- 桌面懸浮：透明窗口，支持拖動、縮放、隱藏、置頂，並記憶位置。
- 菜單與托盤：右鍵管理桌寵；通過系統托盤可恢復顯示。
運行環境¶
package.json 中聲明：
- DSH：
0.2.1-rc.3或0.2.1-rc.5 - Node（包構建/引擎約束）：
>=22.18.0 - 安裝說明要求：Windows x64、WebView2，以及 DSH Desktop 0.2.1-rc.3 或 rc.5。
首次啓動會優先使用包內素材；缺失的素材和官方 Neutralino 6.9.0 運行時會從固定來源聯網獲取並校驗 SHA-256。已有自定義路徑、顯示偏好和位置會保留。下載或校驗失敗會記錄錯誤，DSH 仍可使用。
安裝與啓用¶
推薦在 DSH Desktop 中通過 npm 官方源 安裝固定版本，不要憑倉庫名自行拼接未在資料中出現的 CLI 命令。
- 打開 DSH Desktop 的 插件管理 → 添加插件。
- 輸入下面包標識，選擇 npm 官方源，點擊 安裝。
- 安裝完成後點擊 立即啓用，再 重啓 DSH。
dsh-kurowhale-pet@0.1.4
注意： 同名插件已安裝時，Desktop 要求先卸載再安裝，請先備份配置。資料另列 GitHub 倉庫 URL 作爲添加插件入口的歷史方式；0.1.4 推薦入口爲上述 npm 版本。DSH Market 搜索 KuroWhale 的索引同步在發佈說明中仍待上游確認，當前請以 npm 固定版本爲準。
典型用法¶
安裝並重啓後，桌寵以懸浮窗形式出現在桌面，無需額外配置文件即可隨 Agent 狀態播放對應動畫。日常操作包括：
- 拖動窗口調整位置（位置會被記憶）。
- 右鍵打開管理菜單，或使用系統托盤恢復被隱藏的桌寵。
- 在 DSH 中觸發 Agent 工作流（等待審批、執行、失敗、完成等），觀察桌寵是否切換到 README 所列九種狀態之一。
具體動畫與靜態幀說明見倉庫 docs/images/ 及 README 中的「九種狀態」摺疊說明。
適用場景與注意¶
適合誰： 在 Windows 上使用 DSH Desktop 0.2.1-rc.3 或 rc.5、希望桌面有輕量視覺反饋的開發者或長期跑 Agent 的用戶。
驗證範圍（資料原文）： 已在 Windows x64 的 DSH Desktop 0.2.1-rc.3 驗證安裝及桌寵交互，並在 rc.5 驗證安裝和針對性穩定性迴歸。其他 DSH 版本、混合 DPI 和長期運行尚未充分驗證。
權限與信任： 插件隨當前 DSH 進程權限運行。安裝前應閱讀倉庫源碼與許可證，自行判斷是否滿足環境與安全要求。
許可： 代碼採用 MIT；項目有權授權的新增美術貢獻採用 CC BY-NC-SA 4.0（署名、註明修改、非商業、相同方式共享）。角色來源涉及 AI 輔助創作及社區桌寵 lineage，詳細署名見倉庫 NOTICE-ARTWORK.md。
結尾¶
dsh-kurowhale-pet 把 DSH 官方圖標語境下的鯨魚娘做成 Windows 桌寵，用九種動畫對接 Agent 生命週期，並提供透明懸浮與托盤管理。若你已在 Desktop 滿足 WebView2 與 rc.3/rc.5 要求，可按 dsh-kurowhale-pet@0.1.4 安裝啓用。
- SkillHub 目錄：https://www.skillhub.cn/plugins/lemonxiny55/dsh-kurowhale-pet
- GitHub：https://github.com/lemonxiny55/dsh-kurowhale-pet
- npm 0.1.4：https://www.npmjs.com/package/dsh-kurowhale-pet/v/0.1.4
