前言¶
在 DeepSeek Harness Web UI 里長時間跑 Session 時，界面往往只有任務狀態與對話區，缺少對「當前是否在跑、是否在等交互」的直觀反饋。用 DOM 掃描或自制浮層猜狀態，維護成本高，Harness 升級後也容易失效。下面介紹社區維護的 Cordis 桌寵插件 dsh-deepseek-girl-pet：掛在官方 shell.overlay 槽位，直接讀 Harness 提供的 Session 與等待交互 snapshot，在右下角用精靈圖動畫反映狀態，並支持鼠標追視。
這是什麼¶
dsh-deepseek-girl-pet（deepseek娘）是由 Chih-Kai-Wang 維護的開源 Cordis 桌寵外掛，面向 DeepSeek Harness Web UI。簡介爲：Animated deepseek girl desktop pet plugin for DeepSeek Harness。在 SkillHub 目錄中歸類爲「趣味換裝」。它是社羣非官方插件，不修改 Session 數據、對話記錄或 Harness 核心源碼，也不讀取或寫入對話內容。
核心功能¶
桌寵固定在界面右下角，行爲與 Harness 狀態綁定，主要包括：
- Cordis 原生掛載：註冊
shell.overlay擴展槽；Host 在/deepseek-girl-pet/spritesheet.webp提供固定 WebP 圖集（Codex pet v2：1536×2288，8×11 格，每格 192×208）。 - Session 狀態動畫：Idle 時持寫有簡體「區」的板子，對話框字爲「兇」；Running 時切換工作動畫；Pending interaction 時切換等待動畫。狀態來自
useSessions的 Session summary 與useSessionPendingInteraction的等待交互 snapshot，不靠掃 DOM 猜狀態。 - 鼠標追視：按 16 個方向（每 22.5° 一格）跟隨指針；停止約 1.1 秒後回到待機動畫。
- 交互與無障礙：單擊在一般與放大尺寸間切換；支持
prefers-reduced-motion。 - 資源與隱私：不依賴外部 CDN 或跟蹤服務；圖集隨包分發，運行時不下載圖集。
| Harness 狀態 | 桌寵表現 |
|---|---|
| Idle | 拿「區」板子待機，對話框「兇」 |
| Running | 工作動畫 |
| Pending interaction | 等待互動動畫 |
| Pointer movement | 16 方向追視 |
安裝與啓用¶
當前資料中的推薦版本爲 0.2.0，對應 DeepSeek Harness 來源界面 0.1.2-alpha.1（更高 Harness 版本待驗證）。插件以當前 dsh 進程權限運行，安裝前可在 GitHub 查閱源碼與 MIT License。
一行安裝（web profile）¶
在 PowerShell 中執行：
dsh plugin --profile web add github:Chih-Kai-Wang/dsh-deepseek-girl-pet#v0.2.0
安裝後需重啓 Harness：在原執行 dsh web 的窗口按 Ctrl+C，確認 3080 已停止，再執行：
dsh web
若出現 EADDRINUSE: address already in use 127.0.0.1:3080，表示舊進程仍在，並非安裝失敗；先 Ctrl+C 停掉舊進程，再 dsh web，瀏覽器中 Ctrl+F5 強制刷新。
若安裝時出現 Issues with peer dependencies found，應對照列出的套件與版本，不要默認與本插件無關。出現 Done 只表示包管理步驟完成，建議用下列命令確認配置後再看畫面：
dsh --profile web --dump-config | Select-String deepseek-girl-pet
然後打開 http://127.0.0.1:3080/。
固定版本 TGZ 與 SHA-256 見 v0.2.0 Release。
典型用法¶
安裝並重啓後，桌寵會自動出現在 Web UI 右下角，無需額外配置文件字段。使用方式即日常 Harness 操作：待機、執行任務、進入等待用戶交互時，觀察動畫是否與上表一致；移動鼠標可驗證追視，停止約 1.1 秒應回到持板待機；單擊桌寵可在大小尺寸間切換。
若同時安裝了 dsh-web 全家桶，內置桌寵 @linxin666/dsh-pet 默認也在右下角，兩隻可能重疊。兩者 API 層不衝突：可在「Web 插件 → 桌寵」中隱藏內置桌寵，或拖開其一，與本插件擇一顯示即可。維護者曾用 cordis-plugin-include 與 dsh-base、dsh-web-app、@linxin666/dsh-web-all、本插件及 dsh-plugin-verified-search 做疊層組合驗證，無重複 id 與路由衝突記錄。
適用場景與注意¶
適合希望在 Harness Web 界面獲得輕量、狀態驅動的桌寵反饋、又不願改核心或猜 DOM 的開發者。需注意：
- 版本對應：0.2.0 針對 Harness
0.1.2-alpha.1起改用dsh-client-ui-renderer/dsh-client-ui-session與獨立useSessionPendingInteraction；舊版 0.1.1 對應 Harness0.1.0-rc.6～0.1.1-rc.2。 - 與內置桌寵：同屏可能重疊，按上文擇一或隱藏即可。
- 安全與許可：非 DeepSeek / OpenAI / Codex 官方產品；安裝前自行審閱倉庫與 MIT 許可。
延伸閱讀¶
- 插件目錄：SkillHub - dsh-deepseek-girl-pet
- 源碼與說明：GitHub - Chih-Kai-Wang/dsh-deepseek-girl-pet
- 圖集上游：deepseek-girl-codex-pet
經過上面的步驟，你可以在 Web profile 下用一行命令掛上桌寵，用官方狀態源驅動動畫，而不碰 Session 內容與核心代碼。
