前言¶

DSH 的理念是「一切皆插件」。在 Web GUI 場景中，除了命令執行和對話界面，也可以加入輕量交互組件。yuhao-pet 是一個 DSH Web 插件，由 dlpufan 維護，許可證爲 MIT。它把一隻叫「宇昊」的桌面寵物放進 DSH Web 桌面右下角，支持拖拽、投餵、洗澡、學習、打工等動作，並把 token 消耗轉化爲積分，用於購買道具。下面介紹它的核心功能、安裝命令和典型用法。

這裏寫的是社區插件目錄中的插件；社區目錄是獨立站點，與 DeepSeek 或幻方無官方從屬關係，不是官方應用商店。

這是什麼¶

一句話定位：DSH Web GUI 桌面寵物插件。

它主要解決三件事：

• 在 DSH Web 桌面裏提供一個常駐、可拖拽、可隱藏的互動角色。
• 用五項狀態、動作、道具和商店，把日常交互做成一個輕量養成流程。
• 把 token 消耗轉化爲積分，並允許積分購買食物、玩具、藥品、學習、傢俱、特殊類道具。

立繪與角色設定來自 FurryBar 角色百科（畫師 香瓜）。

核心功能¶

常駐、移動與隱藏¶

• 常駐 DSH Web 桌面右下角。
• 可拖拽，可隱藏。
• 隱藏時，如果裝了賽博朋克主題插件，可收進右上角 HUD；否則收在右下角。

狀態與動作¶

• 可執行投餵、玩耍、洗澡、喫藥、學習、打工、睡覺等動作。
• 飽食、清潔、心情、健康、精力五項狀態會隨時間衰減。
• 狀態變化會影響寵物表現，寵物會生病、會睡覺。
• 提供等級與經驗，以及積分商店。

積分與揹包¶

• 消耗 token 會自動攢積分。
• 積分商店包含食物、玩具、藥品、學習、傢俱、特殊。
• 購買後的道具會進入揹包，並在對應動作中使用。

AI 對話¶

• 可以主動搭話，並和 DeepSeek AI 對話。
• 對話歷史記錄本地持久化，並標註每條回覆的觸發來源。
• 配合賽博朋克主題插件時，切歌會評論新歌；在對話裏說「切歌」可幫助切歌。

需要填寫的配置項爲：

DeepSeek API Key

立繪、表情與換裝¶

• Spine 逐幀呼吸動態立繪，耳朵、頭、尾巴、身體自然擺動。
• 7 種表情會隨狀態自動切換，也可被對話中的情緒詞臨時觸發。
• 可切換舊版 Q 版立繪。
• 立繪大小支持大、中、小三檔。
• 換裝：穿衣、脫衣一鍵切換，立繪即時變化。
• 隨機小動作：打噴嚏、左右張望眨眼、偷一些小東西。

互動工具¶

• 提供羽毛、手指、手掌、番茄四種互動工具。
• 點擊身體不同部位會觸發不同反應。

安裝與啓用¶

先在插件源碼目錄中切換到 yuhao-pet，再添加插件：

cd yuhao-pet
dsh plugin --profile web add .

安裝完成後，重啓並刷新：

dsh web

如果需要卸載：

dsh plugin --profile web remove yuhao-pet

寵物狀態保留在以下路徑：

<dshHome>/data/yuhao-pet/state.json

重裝可繼續；想徹底清除，需要手動刪除該目錄。

典型用法¶

1、左鍵點擊寵物：打開屬性面板。

2、右鍵點擊寵物：打開菜單，可進入對話、商店、設置或執行各動作。

3、按住拖動：移動寵物位置。

4、互動：在菜單「互動」中選擇羽毛、手指、手掌或番茄，再點擊寵物身體部位。

5、AI 對話：在菜單「設置」中填寫 DeepSeek API Key，然後在「對話」裏聊，或點氣泡下「回覆」。

適用場景與注意¶

適合：

• 已經在用 DSH Web GUI，希望桌面裏多一點輕量互動。
• 想用一個積分/道具機制感知 token 消耗。
• 想給對話、切歌、隱藏等場景加一層寵物交互。

注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼、行爲與許可證。
• AI 對話需要配置 DeepSeek API Key。
• 切歌評論、說「切歌」切歌、隱藏時收進右上角 HUD 等功能，依賴賽博朋克主題插件。
• 本文只寫已覈實能力，不引用未覈實的數據或字段。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/dlpufan/yuhao-pet
• GitHub：https://github.com/dlpufan/yuhao-pet