前言¶

DSH 的理念是「一切皆插件」。對使用 DSH Web 的開發者來說，頁面裏已經有模型對話和工具調用，但缺少一個輕量、可見的交互反饋對象。dsh-deepseek-pet 把 DeepSeek 藍色小鯨魚桌寵放進 DSH Web 頁面，讓桌寵浮動在頁面右下角，並允許 Agent 通過 pet_say 工具觸發臺詞；對話開始和結束時，桌寵也會做思考與慶祝狀態。

下面介紹它的功能、安裝和典型用法。

這是什麼¶

dsh-deepseek-pet 是一個浮動在 DSH Web 頁面上的擬人化寵物插件，倉庫路徑爲 txlznbzsdj-collab/dsh-deepseek-pet，許可證爲 MIT。

它解決的核心問題是：在 DSH Web 頁面中提供一個可拖動、可點擊、可由模型觸發說話的藍色小鯨魚反饋對象，讓開發者在 Web 端觀察 Agent 與頁面插件的聯動。

核心功能¶

模型聯動¶

• Agent 可調用 pet_say 工具讓桌寵說話。
• 模型可以調用 pet_say {text, mood?} 命令小鯨魚在頁面上說話。
• 對話開始（思考）與結束（慶祝）會同步到桌寵狀態。

桌面互動¶

• 右下角浮動，帶呼吸 + 搖擺動畫，可拖拽；位置記憶，鬆手回彈，甩遠吐槽。
• 單擊說人設臺詞，臺詞包括主人 / 大肥魚 / 喫白飯 / 摸魚。
• 雙擊觸發開心慶祝和撒花粒子；長按觸發撒嬌。
• 懸停揮手問候；打字時偷看；隨機冒泡（45~90s）；貼邊擠壓吐槽；失焦打盹（Zzz）。
• 右鍵菜單有 8 項：回到右下角 / 換姿勢 / 講個冷笑話 / 今日運勢 / 摸摸頭 / 自我介紹 / 說點什麼 / 躲起來。
• 隱藏後，右下角小鯨魚按鈕可以喚回。

安裝與啓用¶

先確認環境：已安裝 DSH（dsh web）與 pnpm。

下面步驟會克隆倉庫、構建瀏覽器端 client.js，再把插件安裝到 web profile。

git clone https://github.com/txlznbzsdj-collab/dsh-deepseek-pet.git
cd dsh-deepseek-pet
powershell -ExecutionPolicy Bypass -File ./build.ps1

build.ps1 會把 assets/small/*.png base64 嵌入生成 client.js；client.js 是構建產物，已 gitignore。

dsh plugin --profile web add <本目錄絕對路徑>

這裏的 <本目錄絕對路徑> 填你本地克隆後的 dsh-deepseek-pet 目錄絕對路徑。

dsh web --port 3173

經過上面的步驟，重啓 DSH Web 並刷新頁面後，右下角出現小鯨魚即可。

典型用法¶

啓用後，可以直接在頁面上與桌寵互動：單擊、雙擊、長按、懸停、右鍵菜單都可用。

如果要觸發模型聯動，可以對模型說：

讓小鯨魚說句話

模型側的調用形式是：

pet_say {text, mood?}

適用場景與注意¶

適合以下情況：

• 希望 DSH Web 頁面裏有一個輕量反饋對象。
• 希望 Agent 通過 pet_say 觸發桌寵臺詞。
• 希望在對話開始與結束時看到桌寵的狀態變化。

安裝前需要特別注意：

• 插件以當前 dsh 進程權限運行；安裝前應檢查源碼、構建腳本和許可證。
• 插件許可證爲 MIT。
• 角色美術來自 YunYueSama/codex-deepseek-pet 的 DeepSeek 擬人化桌寵素材；該倉庫的角色圖片不在其 MIT 許可範圍內，但已獲原作者授權複用，詳見 ASSET_LICENSE.md。
• client.js 爲構建產物，已 gitignore；修改素材或模板後需要重新運行 build.ps1 生成。
• 需要已安裝 DSH（dsh web）與 pnpm。

結尾¶

dsh-deepseek-pet 的價值很具體：給 DSH Web 頁面加一個可互動、可被模型觸發的 DeepSeek 藍色小鯨魚，並把對話開始與結束狀態同步到桌寵。

相關鏈接：

• GitHub：https://github.com/txlznbzsdj-collab/dsh-deepseek-pet
• 社區目錄頁（插件線索）：https://www.skillhub.cn/plugins/txlznbzsdj-collab/dsh-deepseek-pet