前言¶

DeepSeek Harness (DSH) 的 Web UI 提供了 Agent 運行的上下文，但有時需要更直觀的反饋。DSH Agent Pet 插件在 Web UI 角落放置了一個寵物，它的動作會跟隨 Agent 的狀態變化。這隻寵物由 Noah-wang 維護，解決了在長時間運行或調試過程中，通過視覺反饋確認 Agent 當前行爲的需求。

核心功能¶

插件的核心能力是生成和展示逐幀動畫精靈表。它將 Agent 的生命週期狀態映射爲具體的動作：待命時的呼吸起伏、思考時的抬頭、執行工具時的奔跑、等待確認時的歪頭、完成時的跳躍、出錯時的低頭等。精靈表大小爲 6x8 格，包含 8 種狀態。內置的默認寵物 Momo 是一張手寫的 SVG，不依賴網絡。

安裝¶

插件需要 Node.js >= 22.19.0。

dsh plugin --profile web add dsh-agent-pet

安裝後重啓 DSH Web UI。

使用¶

插件提供三種擁有寵物的方式：

1. 使用默認形象：安裝後即可使用內置的 SVG 寵物 Momo，無需任何配置。
2. 通過工作室生成：在設置頁的「寵物」分區，填寫名字、外觀描述和畫風（預設包括 auto, pixel, sticker 等），點擊「開始繪製」。這會消耗 API Key 生成新的 6x8 精靈表。
3. 導入外部精靈表：從其他生圖 AI（如 Midjourney）導出提示詞，生成精靈表後上傳。插件會自動識別圖片中的透明間隔，無需手動指定行列。

本地調試時，可以通過接口切換狀態：

curl -X POST http://127.0.0.1:3080/api/agent-pet \
  -H 'content-type: application/json' \
  -d '{"state":"running_tool"}'

配置¶

插件支持通過 profile 的 patch 層進行配置，全部可選：

• apiKeyEnv：圖片服務的憑據引用名（默認 OPENAI_API_KEY）。
• model：圖片生成模型（默認 gpt-image-2）。
• baseURL：圖片服務地址（默認 https://api.openai.com/v1）。
• quality：生成質量（low/medium/high）。
• dataDir：生成結果存放目錄。
• petFile：自定義寵物定義文件路徑。
• idleAfterMs：完成或出錯後回到待命的毫秒數。

隱私與依賴¶

插件不讀取對話正文、工具參數、工具結果、API Key 或任何憑據。它只觀察 Agent 生命週期事件和工具名稱。

依賴方面，插件僅有 React peer dependency，無其他運行時依賴。它只接受合法的 PNG 格式圖片，拒絕執行腳本或 HTML。

結尾¶

當前版本爲 0.5.0。這隻寵物適合需要在 DSH Web UI 中獲取 Agent 狀態視覺反饋的開發者。源碼與文檔可在 GitHub 查看。