前言¶
DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。開發者可以通過插件擴展 Web UI 的功能邊界。在開發與調試智能體的過程中，聊天界面往往僅作爲信息交互的容器。dsh-pet-sprite 插件通過在聊天流中嵌入一個可交互的像素角色，將聊天界面轉化爲一個兼具娛樂性與養成屬性的平臺。
插件介紹¶
dsh-pet-sprite 是一個由 BlackBearCC 維護的 DeepSeek Harness (DSH) Web UI 可玩像素伴侶插件。它不屬於靜態的壁紙貼圖，而是直接運行在聊天區域的角色實體。插件集成了平臺跳躍玩法、角色養成系統，並利用 DSH 已配置的 LLM 實時 Token 資源驅動其行爲與成長。
核心功能¶
1. 孵化與自定義伴侶¶
插件啓動後，聊天角落會出現一個斑駁的蛋。點擊即可孵化，並在 Poka（白髮少女）、Mikan（斑紋貓）、Puff（深藍幼鯨）三者中選擇一隻作爲初始夥伴。夥伴可在護理面板隨時切換。
支持自定義生成伴侶：輸入一句話描述（如“戴圓眼鏡的綠色恐龍”），消耗 100 星幣由模型繪製像素圖並自動動畫化。生成的寵物可導出爲 .dsh-pet.json 文件，供他人免費導入。
2. 對話與互動¶
左鍵點擊寵物可打開側邊的小型聊天框。回覆內容直接調用 DSH 中已配置的模型（Provider 和 Model 可在護理面板設置中切換），無需額外 API Key。對話保持本地 30 輪歷史記錄。
3. 平臺跳躍玩法¶
寵物會將聊天消息氣泡視爲物理平臺。在空閒狀態下，它會自動漫遊、爬升氣泡邊緣。玩家可以通過點擊聊天區域空白處接管控制權。
4. 玩家控制¶
採用 WASD 操作體系：
* A / D：左右移動。
* Space：跳躍（空中雙擊可觸發技能跳）。
* W：向上攀爬。
* S：穿下平臺。
接管操作後，寵物會在 10 秒空閒時自動迴歸自主漫遊模式。
5. 狀態反應與養成¶
狀態反應：模型流式輸出時，寵物會坐在旁邊打字；空閒時則會眨眼、散步或睡覺。每種伴侶都有獨特的環境音。
養成系統：包含心情、能量、健康三個屬性，具有衰減與聯動機制。角色等級 1-100，擁有稱號、金幣與庫存。
Token 綁定經濟：輸入 Token 消耗寵物能量；回覆 Token 轉化爲經驗值；每日首次打開獎勵登錄金幣。等級提升可減緩屬性衰減。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:BlackBearCC/dsh-pet-sprite
安裝完成後，重啓 DSH (dsh web) 並打開任意對話，寵物會出現在聊天流底部。
典型用法¶
- 聊天：左鍵點擊寵物，使用 DSH 已配置的模型與其對話。
- 接管控制：點擊聊天空白處，使用鍵盤 WASD 控制寵物跳躍。
- 管理：右鍵點擊寵物，打開護理面板，查看狀態、互動、物品欄、商店及設置。
注意事項¶
- 兼容性：當前基於 DSH 開發者預覽版測試（版本 0.1.0-rc.7）。DSH 迭代較快，存在破壞性更新風險，如需穩定環境建議固定插件 Commit。
- 依賴環境：需要 Node.js 版本 >= 22.19.0。
- 隱私與網絡：插件無遙測，不發起任何外部網絡請求，所有狀態數據存儲於
localStorage。其lib/目錄已包含編譯輸出，通過 Git 安裝無需授權構建腳本。 - 許可證：遵循 MIT 許可證。
結語¶
dsh-pet-sprite 將 DSH 的聊天體驗從單純的文本交互拓展到了實體互動與資源管理的維度。如果你希望增強對話界面的趣味性，或者需要通過 Token 使用量驅動一個輕量級的養成系統，這是一個可直接集成的方案。
插件目錄：https://www.skillhub.cn/plugins/BlackBearCC/dsh-pet-sprite
GitHub 倉庫：https://github.com/BlackBearCC/dsh-pet-sprite
