dsh-codex-compatible-pet：DeepSeek Harness 的 Codex 風格桌面寵物

前言¶

DeepSeek Harness (DSH) 的核心架構基於插件化設計。在調試或運行智能體時，僅通過日誌和界面文本觀察 Agent 的狀態往往不夠直觀。dsh-codex-compatible-pet 插件旨在解決這一問題，它引入了 Codex 風格的桌面寵物，通過可視化的動畫反饋 Agent 的運行狀態。這是一個雙端客戶端插件：Node 端負責託管寵物資源文件，Browser 端負責渲染精靈圖和提供交互頁面。

核心功能¶

1. Agent 狀態驅動動畫
   寵物會根據 Agent 的運行狀態實時改變動作。支持的狀態包括 running（運行中）、waiting（等待確認）、review（審查中）、idle（空閒）以及 failed（失敗）。狀態切換時，寵物會自動播放相應的幀動畫。

2. Codex 兼容模型
   寵物模型移植自 Codex 的源碼，支持標準的精靈圖格式。兼容 8x9 或 8x11 的網格精靈圖。只要 Manifest 文件符合 pet.json 格式（包含 id、spritesheetPath、animations 等字段），即可直接使用。

3. 多源資源管理
   插件內置了來自 Codex CDN 的寵物資源，同時也支持在本地 $DSH_HOME/pets 目錄下放置自定義寵物。

4. 交互與詳情展示
   - 交互：點擊寵物可觸發交互軌道（如 wave、bounce）；支持鼠標拖拽改變位置。
   - 詳情：懸停在寵物上會顯示一個 Codex 風格的詳情卡片，展示當前會話的最新用戶提示、工具調用及助手輸出摘要。

5. 持久化設置
   寵物的選擇、尺寸選項以及拖拽偏移量會保存在瀏覽器的 localStorage 中，刷新頁面後狀態依然保留。

安裝與啓用¶

通過官方 CLI 安裝插件。

dsh plugin add github:youzhoujiMrLiu/dsh-codex-compatible-pet

安裝完成後，刷新 DeepSeek Harness 的 Web GUI 頁面。寵物會默認出現在屏幕右下角。此時在設置頁面中會出現“Pet”選項，用於管理寵物目錄和導入自定義寵物。

典型用法¶

1. 觀察狀態：在 Agent 運行或等待確認時，觀察寵物對應的動作變化（如運行時奔跑、等待時站立）。
2. 觸發交互：點擊寵物可播放揮手、彈跳等互動動畫。
3. 移動位置：按住鼠標左鍵拖拽寵物，可將其放置在屏幕任意位置。
4. 導入寵物：在設置頁面的寵物目錄中，導入 .codex-pet 格式的目錄文件。

注意事項¶

1. 純展示插件：該插件不註冊 Prompt、工具或 Schema，也不影響 KV Cache 的生成或向 Provider 發送請求，僅提供視覺展示。
2. 狀態來源：寵物的狀態完全來源於 DSH 的會話列表。目前失敗回合會回退到 idle 或 review 動畫，沒有專門的失敗動畫。
3. 內置資源下載：內置的 Codex 寵物在首次選擇時需要從 CDN 下載資源，下載完成前不會顯示。
4. 卸載方式：卸載插件需要使用 dsh plugin remove 命令，這會移除插件所在的層。

結語¶

dsh-codex-compatible-pet 爲 DeepSeek Harness 提供了直觀的 Agent 狀態反饋。對於需要長時間觀察智能體行爲的開發者，它是一個實用的視覺輔助工具。

GitHub 倉庫 | 社區目錄