前言¶
在 DeepSeek Harness（DSH）Web UI 中，智能體通常以文本形式與用戶交互，缺乏視覺反饋。Petween 作爲一箇中間件插件，旨在解決這一問題。它允許開發者使用少量的靜態圖片資源，通過程序化算法生成豐富的動畫效果，將靜態的智能體形象轉化爲具有動態表現力和交互性的“寵物”。
它是什麼¶
Petween 是一個由 Traveritas 維護的 DSH Web UI 寵物插件，定位爲紙片動畫風格的智能體寵物動畫中間件。它不依賴龐大的預設動畫庫，而是通過 Motion Engine 處理輸入的圖片，自動生成漫畫式過渡與循環動畫，並跟隨 Agent 的真實運行狀態進行切換。
核心功能¶
該插件主要包含以下能力：
- 資源要求低：支持少量圖片即可工作。包含待機、思考、工作、等待、成功、錯誤六個狀態槽位，缺失狀態可自動 fallback。
- 動畫生成：支持漫畫式過渡動畫（如 Comic Pop、Soft、Jelly、Celebrate）與狀態循環動畫（如 Bounce、Sway、Breathing）。
- 真實對齊：提供 Anchor 真實對齊功能，確保角色換圖時腳底不瞬移，Squash & Stretch 圍繞地面錨點進行。
- 狀態跟隨：根據 Agent 狀態（空閒、活躍、等待、成功、錯誤）自動切換姿勢與動畫表現。
- 交互與持久化：支持拖動、縮放、位置持久化，並支持點擊互動與粒子特效。
- 可視化編輯：提供 Timeline Engine 與可視化時間軸編輯器，支持管理自定義動畫軌道、關鍵幀與事件。
- 生態擴展：提供動畫包（Motion Pack）和寵物包（Pet Package）功能，支持自定義動畫的導出與分享。同時提供附屬插件擴展服務，支持動畫庫註冊、舞臺快照訂閱等。
安裝與啓用¶
由於插件尚未發佈到 npm，需通過源碼安裝：
# 1. 克隆倉庫
git clone https://github.com/Traveritas/petween.git
cd petween
# 2. 安裝依賴並構建（必須在安裝前構建）
pnpm install
pnpm run build
# 3. 安裝插件
dsh plugin --profile web add link:/path/to/petween
# 4. 重啓 dsh web 生效
典型用法¶
在 DSH Web UI 中，進入設置頁面的 Petween 卡片，可以快速啓用或停用寵物，並調整整體縮放。點擊卡片上的“打開完整編輯器”會在新標籤頁打開獨立編輯器頁面。
也可以直接訪問 http://127.0.0.1:3080/petween-editor/（端口以 DSH web 配置爲準）。
若想在不觸碰真實配置的情況下測試，構建後直接雙擊 preview/index.html 即可打開獨立預覽頁。
注意事項¶
- 插件 README 目前需要更新。
- 尚未發佈到 npm，不能直接使用
dsh plugin add petween，必須從 GitHub 克隆安裝。 - 不支持 SVG，僅解碼展示圖片。
- 多瀏覽器標籤同時編輯同一配置時，默認採用 Last-Write-Wins 機制。
- 版本過期時，寫入請求會返回 409 錯誤。
總結¶
Petween 通過程序化動畫技術，降低了爲 DSH 智能體添加視覺反饋的門檻。它提供了完整的動畫編輯與分享工具鏈，適合希望增強智能體交互體驗的開發者使用。更多詳情請參考 GitHub 倉庫。
