前言¶
DeepSeek Harness (DSH) 的插件生態強調「一切皆插件」。除了功能性工具外，開發者在長時間編碼時往往需要一些視覺陪伴或反饋。mypet 插件爲 DSH 桌面端提供了一個 Tamagotchi 風格的電子寵物。它不僅是屏幕上的一個圖標，更具備呼吸浮動、自動眨眼、尾巴搖擺等活體動畫，並能根據時段、天氣和寵物狀態改變環境氛圍。
插件信息¶
- 名稱：mypet
- 作者：qiqikuaidianpao
- 分類：趣味換裝
- 許可證：MIT
核心功能¶
活體動畫¶
寵物具備呼吸浮動、自動眨眼、尾巴搖擺等動畫。點擊寵物會有回彈效果，懸停時會做出笑臉。閒時寵物會閒逛踱步，睡着時會做夢。時段氛圍光和天氣粒子會隨時間變化，例如清晨橙、白天藍、夜晚藍以及雨滴或雪花效果。
面板系統¶
插件提供四標籤頁面板：
- 狀態：顯示心情、體力、飽腹、牽絆四維進度條，包含趨勢走勢線、撫摸/餵食/小憩/玩耍按鈕及每日任務。
- 衣櫥：提供皮膚更換，包含 24 種皮膚（6 普通 / 9 稀有 / 9 傳說）及稀有度篩選。
- 成就：展示 26 個里程碑、進度條、事件日誌及近 7 天週報。
- 更多：包含接球小遊戲、單抽/十連抽、改名、分享、換性格、轉生及存檔導入導出。
經濟與牽絆¶
- 經濟系統：通過工作發薪、連擊遞增獎金（5~25/輪）、每日簽到、每週津貼、隨機寶箱、每日任務和轉生永久加成積累金幣。
- 牽絆系統：互動累積好感度。好感度達到閾值可解鎖暴擊效果和主動冒險帶回金幣的能力。
音效與慶祝¶
內置 12 種 Web Audio 合成音效。在升級、稀有掉落或完成里程碑時，會觸發 Canvas 粒子綵帶雨、環形衝擊波、emoji 粒子或金色儀式橫幅。
其他特性¶
- 離線歸來結算：斷開連接後返回時會結算離線進度和報告。
- 快捷鍵：支持 1-4 / P / F / N / L / D / Esc 等快捷鍵操作。
- 持久化：面板位置可持久化保存，支持分享狀態卡片。
- 性格與節律：包含 6 種性格和晝夜節律。
安裝與啓用¶
使用官方插件管理命令進行安裝。
dsh plugin --profile web add mypet
安裝後重啓 DSH Web，屏幕上會出現懸浮寵物，可拖拽。
更新與卸載¶
dsh plugin --profile web update mypet
dsh plugin --profile web remove mypet
自定義與開發¶
插件採用模塊化開發。修改源碼前需注意：
npm run build
修改 src/client.js 後運行上述命令進行打包。lib/client.js 是構建產物，不可手動修改。
自定義配置項¶
在源碼中可調整：
- SKINS：皮膚目錄（名稱 + emoji + 稀有度）
- TRAITS：性格（6 種）
- DRAW_COST / SALARY_PER_TICK / PITY_CAP：經濟參數
- ACH：成就定義
- QUESTS：每日任務
- tick()：衰減速度
- MOUNT：面板掛載方式（"overlay" 懸浮 或 "sidebar" 側邊欄）
數據與注意事項¶
- 存檔位置：寵物狀態存儲在瀏覽器的
localStorage中，key 爲mypet，舊版兼容 key 爲dsh-pet:v1。 - 導出碼：面板內的「更多」標籤支持導出/導入存檔碼，導出碼僅包含遊戲數據（金幣/皮膚/成就/性格等），不含歷史走勢和事件日誌。
- 依賴項：項目依賴
react和@deepseek-ai/dsh-client-runtime。
適用場景¶
適合希望在編碼過程中獲得視覺陪伴、喜歡電子寵物養成或希望爲 DSH 體驗增加趣味性的開發者。
