前言¶
DeepSeek Harness（DSH）主要用於智能體開發與調試。長時間面對界面可能產生視覺疲勞。dsh-desktop-pet 插件在 DSH Web 界面右下角懸浮一隻橘色小貓。這隻小貓具備眨眼、搖尾、打呼嚕等純 CSS 動畫效果，支持拖拽、點擊互動，作爲開發過程中的輕量級陪伴工具。
是什麼¶
該插件由 Ares-song-RD 維護，屬於趣味換裝類別。它不依賴任何圖片資源，僅使用內聯 SVG 和純 CSS 動畫實現。瀏覽器端依賴 React，服務端依賴 Cordis。安裝後需重啓 DSH 應用才能生效。
核心功能¶
- 拖拽與位置記憶：支持用鼠標拖拽小貓到任意位置。位置信息會自動保存到 localStorage，窗口縮放時位置會自動收斂。
- 交互行爲：
- 單擊：小貓會蹦跳，並彈出隨機語音氣泡（氣泡語言隨界面語言變化）。
- 雙擊：循環切換心情狀態（發呆 → 睡覺 → 興奮）。
- 右鍵：彈出迷你菜單，支持隱藏桌寵、換心情、查看關於信息。
- 主題與設置：支持深淺色主題。提供設置頁，可控制顯示開關、動畫開關以及直接選擇心情。
安裝與啓用¶
安裝前請確保 Node 版本 >= 20。
# 1. 克隆倉庫
git clone https://github.com/Ares-song-RD/dsh-desktop-pet.git
# 2. 安裝依賴並構建
cd dsh-desktop-pet && npm install && npm run build
# 3. 將構建產物複製到 DSH profile 的 vendor 目錄
# 示例路徑：~/.dsh/profiles/desktop/vendor/dsh-desktop-pet
cp -r . ~/.dsh/profiles/desktop/vendor/dsh-desktop-pet
# 4. 在 profile 的 package.json 中註冊依賴
# dependencies 增加: "dsh-desktop-pet": "file:./vendor/dsh-desktop-pet"
# dsh.profile.bundles 增加: "dsh-desktop-pet"
# 5. 安裝 profile 依賴並重啓 DSH
cd ~/.dsh/profiles/desktop && pnpm install
# 重啓 DeepSeek Harness 桌面應用，小貓會出現
典型用法¶
- 啓動 DSH 應用後，小貓會自動出現在右下角，開始眨眼、搖尾巴。
- 用鼠標按住小貓拖動到任意位置，下次啓動時位置保持不變。
- 單擊小貓：小貓蹦跳並顯示隨機語音氣泡（如“摸一下，能量 +1”）。
- 雙擊小貓：切換心情狀態（例如從發呆變爲睡覺）。
- 右鍵小貓：選擇隱藏、換心情或查看關於信息。
- 在 DSH 的設置頁 → 桌寵中，可開關顯示、開關動畫或手動選擇心情。
注意事項¶
- 瀏覽器端依賴 React。
- 安裝後必須重啓 DSH 應用。
- 插件使用 MIT 許可證，可自由使用與修改。
結尾¶
該插件通過極簡的代碼結構（零圖片、零額外依賴）提供了可視化的陪伴功能。更多詳情請參考 GitHub 倉庫。
