前言¶
DeepSeek Harness (DSH) 採用插件化架構。在 Agent 運行過程中，開發者往往需要更直觀的狀態反饋。現有的瀏覽器內 UI 雖然功能豐富，但在後臺運行時往往難以捕捉或被遮擋。
dsh-ronaldo-pet 插件提供了一種解決方案：它不僅存在於 Web 界面右下角，更通過原生 Windows 窗口常駐桌面，實時感知 Agent 的運行狀態。通過精靈動畫和交互反饋，將 Agent 的工作流（工作、思考、等待、出錯、完成）具象化。
基本信息¶
- 插件名稱：dsh-ronaldo-pet
- 維護者：Stellum-Waq
- 分類：趣味換裝
- 許可證：MIT
- Star 數：5
核心功能¶
原生桌面窗口¶
插件使用 WPF 技術構建，生成一個無邊框、背景透明且永遠置頂的桌面窗口。
* 獨立性：不依賴瀏覽器內核，終端關閉或瀏覽器最小化時窗口依然存在（只要終端進程在運行）。
* 生命週期：插件加載時自動拉起，當宿主進程無響應超過 15 秒或進程結束時自動退出。
* 交互方式：
* 懸停：顯示當前工作區、對話標題及 Agent 狀態。
* 單擊：冒出對話氣泡並播放點擊音效。
* 快速連點三下：觸發摔倒動畫。
* 雙擊：用 Microsoft Edge 打開 Harness 網頁。
* 拖動/滾輪：改變位置和窗口大小（32～1024 DIP）。
* 右鍵菜單：提供切換寵物、調整大小、隱藏、設爲默認、系統音開關等選項。
Agent 狀態感知¶
插件通過輪詢 agents 服務，監聽 tools/execute、approval/request 等接口，實時推導並切換 Agent 的狀態，對應不同的動畫幀：
* 工作：專注狀態。
* 思考：回合中思考。
* 等待：等待審批。
* 出錯：戲劇性摔倒。
* 空閒：待機。
* 完成：SIU 慶祝跳躍 + 全機播放提示音。
精靈動畫與分辨率¶
- 動畫規格：支持 8 列 × 11 行的精靈圖集。
- 分辨率：不限單格尺寸。無論是像素風、精細立繪還是寫實素材，插件均支持，顯示時會等比縮放。
一句話生成寵物¶
配合 dsh-pet-forge 技能，可以通過自然語言描述生成新寵物。該流程整合了生圖模型、Blender 3D 建模、動作/音效設計。
* 生成流程：環境自檢 -> 生成 -> 校驗 -> 安裝。
* 註冊：生成並安裝後，寵物會立即出現在界面右下角。
從視頻生成（v2.2 新增）¶
支持將視頻素材（尤其是綠幕或純色幕布拍攝）轉化爲桌寵動作。
* 流程：抽幀 -> 摳幕布 -> 按時間段/運動切分動作 -> 合成圖集。
* 參數：支持調整摳像參數（key, similarity, blend, spill, erode）。
* 解碼引擎：優先使用 ffmpeg，其次 OpenCV，最後支持直接導入抽好的 PNG 幀。
寵物社區（v2.1 新增）¶
基於 DPSL-1.0 開放共享協議，支持將生成的寵物發佈到 GitHub 並收錄進插件內置的「寵物社區」。
* 共享流程：生成完寵物後，插件會詢問是否按 DPSL-1.0 發佈。選擇同意後，插件會生成分享包，但不會自動上傳（需要用戶手動執行腳本或操作），也不執行倉庫內的腳本。
* 權限：插件僅被授權收錄、展示、下載和本機安裝，不得商業銷售或用於訓練模型。
安裝與啓用¶
安裝插件¶
通過 DSH CLI 安裝：
# 從 GitHub 安裝
dsh plugin --profile web add github:Stellum-Waq/dsh-pet-ronaldo
# 本地開發安裝
dsh plugin --profile web add D:\代碼\桌寵\dsh-ronaldo-pet
安裝配套技能¶
安裝用於生成新寵物的 dsh-pet-forge 技能：
Copy-Item -Recurse -Force .\skill\dsh-pet-forge $env:USERPROFILE\.agents\skills\
卸載¶
dsh plugin --profile web remove dsh-ronaldo-pet
注意事項¶
- 權限範圍：插件以當前 DSH 進程權限運行，安裝前請檢查源碼與許可證。
- 默認行爲：默認只開啓一隻寵物（默認爲內置 C羅）。新生成的寵物會自動接管默認位，其他寵物自動收起。如需多寵物並排，需在設置中手動打開。
- 隱私與安全：插件不會替你上傳任何東西，也不執行倉庫裏的腳本，不會讀取你的 GitHub 憑據。
總結¶
dsh-ronaldo-pet 通過原生窗口和狀態感知，解決了 Agent 運行過程中的視覺反饋問題。配合視頻生成和社區分享功能，它爲開發者提供了一個可擴展的桌寵生態，既提升了使用體驗，也豐富了 Agent 的表現形式。
