前言¶
DSH 的理念是“一切皆插件”。對於使用 DeepSeek Harness Web UI 的人來說,當前 Session 是空閒、正在執行任務,還是等待交互,通常要看界面提示。dsh-deepseek-girl-pet 是一個開源 Cordis 桌寵插件,會在界面右下角加入一個動畫角色,依照當前 Session 狀態切換動畫,也會用 16 個方向跟着鼠標看。
它不修改 Session 數據、對話記錄或 DeepSeek Harness 核心源碼,適合想給 Web UI 加一個輕量狀態提示的場景。
這是什麼¶
dsh-deepseek-girl-pet 是一個面向 DeepSeek Harness Web UI 的開源桌寵插件,倉庫路徑爲 f0909172434/dsh-deepseek-girl-pet,採用 MIT License。它是社羣非官方項目,與 DeepSeek、OpenAI 或 Codex 沒有從屬、合作或背書關係。
它主要解決兩件事:
- 用動畫表達當前 Harness 狀態:空閒、執行任務、等待交互。
- 用鼠標追視提供輕量交互反饋,而不是讀取或修改對話內容。
核心功能¶
下面介紹已覈實的插件能力。
狀態動畫¶
插件會依照當前 Session 狀態切換動畫:
- 空閒時:拿着簡體“區”的板子待機,對話框文字保持“兇”。
- Harness 執行任務時:切換至工作動畫。
- Session 等待交互時:切換至等待動畫。
鼠標追視與交互¶
- 支持完整 16 方向鼠標追視,每 22.5 度一格。
- 鼠標停止 1.1 秒後,回到拿板子的待機動畫。
- 點擊桌寵可在一般尺寸與放大尺寸之間切換。
- 支持
prefers-reduced-motion。
資源與集成方式¶
- 作爲 DeepSeek Harness 原生 Cordis 插件安裝,使用
shell.overlay擴展槽。 - 使用 Codex pet v2 圖集:1536 × 2288 WebP、8 × 11、每格 192 × 208。
- 不修改 DeepSeek Harness 核心文件。
- 不讀取或寫入對話內容。
- 不依賴外部 CDN 或追蹤服務。
安裝與啓用¶
一行安裝¶
執行安裝命令:
dsh plugin --profile web add github:f0909172434/dsh-deepseek-girl-pet
安裝後需要重啓 Harness。先在原本執行 dsh web 的窗口按 Ctrl+C,確認 3080 已停止,再執行:
dsh web
如果看到:
EADDRINUSE: address already in use 127.0.0.1:3080
說明舊的 Harness 進程還在運行。先回到原本 Harness 終端按 Ctrl+C,再重新執行:
dsh web
最後到瀏覽器按 Ctrl+F5 強制重新加載。
安裝完成後打開:
http://127.0.0.1:3080/
可用下面命令確認插件已經進入 web profile:
dsh --profile web --dump-config | Select-String deepseek-girl-pet
從源碼安裝¶
也可以先打包再安裝:
git clone https://github.com/f0909172434/dsh-deepseek-girl-pet.git
cd dsh-deepseek-girl-pet
npm pack
dsh plugin --profile web add .\dsh-deepseek-girl-pet-0.2.0.tgz
源碼安裝完成後,同樣重啓 dsh web,並在瀏覽器強制刷新。
典型用法¶
經過上面的步驟後,可以這樣使用:
1、打開 DeepSeek Harness Web UI,桌寵默認出現在界面右下角。
2、移動鼠標時,它按 16 個方向追視;鼠標停止 1.1 秒後,回到拿板子的待機動畫。
3、當 Harness 執行任務時,切換至工作動畫;Session 等待交互時,切換至等待動畫。
4、點擊桌寵,可在一般尺寸與放大尺寸之間切換。
5、如果 DSH Web 內置桌寵 @linxin666/dsh-pet 也顯示在右下角,兩者可能在視覺上重疊。它們在 API 層互不衝突,可以擇一顯示或拖開內置桌寵。
兼容性¶
| 插件版本 | 需要的 DeepSeek Harness |
|---|---|
| 0.2.0 | 0.1.2-alpha.1(含)以後 |
| 0.1.1 | 0.1.0-rc.6 ~ 0.1.1-rc.2 |
適用場景與注意¶
- 適合在 DeepSeek Harness Web UI 中加入一個狀態可見、可點擊、不侵入數據的桌寵。
- 它不讀取或寫入對話內容,不修改 Session 數據、對話記錄或核心源碼。
- 它是社羣非官方項目,採用 MIT License;安裝前建議檢查源碼與許可證。
- 插件以當前
dsh進程權限運行,安裝前應確認插件來源可信。 - DSH 社區目錄是獨立站點,不等同於官方應用商店;當前資料未確認固定目錄頁 URL,建議在社區目錄中按
dsh-deepseek-girl-pet檢索。
結尾¶
dsh-deepseek-girl-pet 把 Session 狀態變成右下角的動畫提示:空閒時拿板子待機,執行任務時切換工作動畫,等待交互時切換等待動畫,還能進行 16 方向追視和點擊放大。對於想把 Web UI 反饋做得更直觀、同時不希望插件觸碰對話內容的人來說,它是一個基於 DSH 插件機制的輕量選擇。
GitHub:https://github.com/f0909172434/dsh-deepseek-girl-pet
目錄頁:DSH 社區目錄中按 dsh-deepseek-girl-pet 檢索。