dsh-pets：Codex Pets 桌面寵物集成

前言¶

在 DeepSeek Harness（DSH）的開發與調試過程中，會話的狀態變化通常隱含在文本流和終端輸出中。dsh-pets 插件旨在將 Codex Pets 的桌面寵物概念引入網頁界面，通過一個透明、可拖動的懸浮層，將當前會話的“思考”、“工作”、“完成”等狀態投影爲可視化的動畫，幫助開發者更直觀地監控智能體的運行節奏。

插件簡介¶

這是一個由 eivmosn 維護的客戶端插件，採用 MIT 開源協議。它不涉及模型推理或提示詞生成，僅作爲前端展示組件，負責渲染本地 pets 目錄中的精靈圖，並根據 DSH 的會話狀態驅動動畫播放。

核心功能¶

透明懸浮與拖動：寵物以透明背景渲染，可拖動至視口內任意位置，位置會自動持久化保存。
狀態映射：根據 Codex Pets 的標準格式（V1/V2 精靈圖），映射以下狀態：
- 思考中：顯示 waiting 動畫。
- 工作中：輪播 running、review、running-right 動畫。
- 完成狀態：揮手動畫。
- 阻塞/失敗：對應失敗動畫。
- 空閒狀態：輪播小動作。
狀態氣泡與芯片：寵物上方顯示白色氣泡（如“思考中”、“正在 {task}”），下方顯示當前會話的 agent preset 芯片。
設置分區：提供專門的設置頁面，支持從本地 pets 目錄選擇寵物形象，並覆蓋氣泡文案。

典型用法¶

獲取寵物形象：訪問 codex-pets.net 發現並下載寵物包。
安裝寵物：在終端執行命令將寵物添加到本地目錄。

    npx codex-pets add <pet-id>

重啓服務：安裝完成後需要重啓 DSH 服務，插件纔會讀取到新的寵物資源。
啓用與配置：在 DSH 網頁界面的導航欄找到“寵物”設置分區，點擊選中一隻已安裝的寵物即可生效。

技術實現與限制¶

無干擾機制：插件僅將會話快照投影爲懸浮層，不產生提示詞內容，也不寫入任何會話事件，不會影響 AI 模型的思考過程。
性能影響：無 KV Cache 影響。
資源依賴：完全兼容 codex-pets 的 V1/V2 精靈圖格式，無需額外配置即可離線渲染。

注意事項¶

本插件爲客戶端組件，運行在瀏覽器端。
使用前建議檢查源碼（GitHub）與許可證，確保符合你的使用場景。

總結¶

dsh-pets 爲 DSH 提供了可視化的狀態反饋機制。如果你需要通過直觀的動畫來觀察智能體的工作流，或希望定製專屬的桌面寵物，該插件是一個輕量且無侵入性的選擇。

項目地址：eivmosn/dsh-pets
目錄頁：dsh-pets - SkillHub