前言¶
用 DeepSeek Harness（DSH）跑智能體時，界面多半是終端、日誌和工具調用列表。長時間盯着這些輸出，很難直觀感受到「代理正在想」還是「已經空閒」。一些桌面寵物類工具能在別的環境裏做陪伴，但 DSH 的 Web 界面本身並不自帶這類層。
dsh-cat-pet 是維護者 iypavlov 發佈的 DSH 插件：在 Web UI 上疊加一隻可拖動的動畫貓，並根據代理是否在思考、回合是否結束、你是否在輸入等情況切換姿態。下面介紹它做什麼、怎麼裝、裝完要注意什麼。
這是什麼¶
- 名稱：npm 包
dsh-cat-pet，倉庫 iypavlov/dsh-cat-pet。 - 定位：面向 DeepSeek Harness Web 客戶端的動畫貓伴侶（README 與
package.json描述一致）。 - 許可：MIT（見倉庫 LICENSE）。
- 當前版本（資料中的
package.json）：0.1.0。
插件通過 DSH 的客戶端擴展機制注入 Web 層（dsh.client.platform 爲 web，immediately 爲 true），不屬於 DeepSeek 或幻方官方組件；社區目錄頁在 skillhub.cn，與官方無從屬關係。
核心功能¶
資料中明確寫到的行爲如下，未列出的能力不要自行推斷。
- 浮層顯示：貓繪製在界面之上，不佔用單獨窗口（README：「живёт поверх интерфейса」）。
- 可拖動：用鼠標拖走貓，避免擋住控件。
- 記住位置：再次打開會話時仍使用上次放置的位置（README：「помнит позицию」）。
- 隨代理狀態變化：
- 一切平靜時：坐着；
- 代理在「思考」時：躺下並睡覺；
- 回合回到你這邊，或你開始打字時：醒來。
README 附帶預覽圖 assets/preview.png，可在 GitHub 倉庫首頁查看靜態效果。
安裝與啓用¶
DSH 插件生態的思路是「一切皆插件」：安裝方式以官方 README 爲準。常見有兩種；npm 不可用時再用 GitHub 地址。
從 npm 安裝（推薦）¶
包已在 npm 發佈（徽章指向 dsh-cat-pet），且爲預構建產物，不含 install 腳本，安裝時不會觸發本地編譯，也不會彈出 build 腳本權限提示。
在終端執行：
dsh plugin add dsh-cat-pet
或在 DSH 裏打開 Plugins → Add plugin，填入 dsh-cat-pet，點擊 Install。
從 GitHub 安裝¶
當 npm 不可用，或需要指定倉庫修訂時：
dsh plugin add github:iypavlov/dsh-cat-pet
同一對話框也支持其他寫法（README 表格）：
| 填入內容 | 適用情況 |
|---|---|
github:iypavlov/dsh-cat-pet |
常規 GitHub 安裝 |
https://github.com/iypavlov/dsh-cat-pet |
與上一行等價 |
git@github.com:iypavlov/dsh-cat-pet.git |
已配置 SSH 時 |
本地倉庫的絕對路徑（如 C:\path\to\dsh-cat-pet） |
使用本地副本 |
.tgz 歸檔路徑 |
安裝器同樣識別 |
安裝後必做一步¶
重啓 DSH。配置文件會從自身 node_modules 裏的插件副本加載；不重啓則界面上看不到貓（README「После установки」）。
若你要改插件源碼再本地調試，README 要求 Node ≥ 22，在倉庫內 pnpm install、pnpm build（輸出到 lib/）、再 pnpm install-local 寫入 DSH profile；每次改代碼後重復 build 與 install-local。一般使用者只需 npm 或 dsh plugin add 路徑即可。
典型用法¶
README 未提供單獨的配置文件或 CLI 子命令：安裝並重啓 DSH 後，打開 Web 界面即可。典型操作只有交互層面：
- 啓動或重啓 DSH，進入 Web UI。
- 觀察貓在「空閒 / 代理思考 / 你輸入」時的姿態切換。
- 若遮擋內容，拖動貓到空閒區域；位置會被記住。
插件客戶端依賴注入 @deepseek-ai/dsh-client-locale（見 package.json 的 dsh.client.inject），由 DSH 在加載插件時處理，無需用戶手動配置該項。
適用場景與注意¶
適合誰
- 長期在 DSH Web 界面裏調試、旁路觀察智能體回合的人，希望用輕量視覺反饋區分「代理在跑」和「等你輸入」。
- 想要桌面寵物式陪伴、又希望與 DSH 會話狀態聯動，而不是另開獨立小窗的用戶。
使用前請知悉
- 權限：插件與當前 DSH 進程相同權限運行。安裝前建議瀏覽 倉庫源碼 與 MIT 許可證，確認可接受再安裝。
- 平臺：面向 Web 客戶端；是否在非 Web 環境生效，資料未說明，不要假設。
- 網絡：優先
dsh plugin add dsh-cat-pet需要能訪問 npm；否則用 GitHub 或本地路徑。 - 維護狀態：GitHub 星標爲 0（線索與公開頁一致時），屬社區小插件，行爲以當前版本 README 爲準。
結尾¶
dsh-cat-pet 把「代理是否在思考」映射成貓睡/醒/坐，並支持拖動與位置記憶，改動面小、安裝命令明確。若你在 DSH Web 里長時間盯會話，可以把它當作狀態指示兼一點界面趣味。
