前言¶

在 DeepSeek Harness（DSH）裏跑 Agent，界面往往只有日誌和狀態文本。長時間盯屏時，「當前是在跑任務、等確認還是已經告一段落」需要你自己從文案裏推斷。若你希望在 Web GUI 裏有一個不聯網、不佔後端資源的輕量反饋層，社區插件 mufanlee/dsh-pikachu-pet 提供了一種做法：在頁面右下角常駐一隻非官方粉絲向皮卡丘桌寵，動作與當前會話 Agent 狀態對齊，並在適當時機播放叫聲。

這是什麼¶

dsh-pikachu-pet 是由維護者 mufanlee 發佈的 DSH 桌寵插件（社區目錄分類：趣味換裝）。定位爲「Unofficial fan-made Pikachu desktop pet plugin for the DeepSeek Harness Web GUI」——僅在瀏覽器端注入 UI，跟隨會話狀態切換姿勢與音效，不替代 DSH 核心能力。

插件以 bundle 形式接入 Cordis 宿主：package.json 中 dsh.client 指向 Web 平臺，並注入 @deepseek-ai/dsh-client-ui-layout 與 @deepseek-ai/dsh-client-ui-session。代碼採用 MIT License；assets/ 與 icon.png 中的皮卡丘素材來自網絡免費資源，僅供粉絲非官方用途，詳見倉庫 NOTICE。

核心功能¶

下面行爲均來自倉庫 README 中的狀態表與說明。

與 Agent 狀態聯動¶

任務完成時會播放「皮卡皮卡」類叫聲。插件共 8 張姿勢、3 段叫聲，從候選裏隨機選取，避免連續重複同一資源。

交互與聲音¶

• 點擊皮卡丘會叫一聲。
• 懸停桌寵右上角可靜音；設置 → 通用 中也有聲音開關，與喇叭按鈕同步。
• 聲音偏好寫在瀏覽器 localStorage，不跨設備同步。
• 瀏覽器通常要求用戶先與頁面有一次點擊交互後才允許出聲。

隱私與運行方式¶

README 寫明：僅使用 localStorage 與 Web Audio，不聯網、無遙測。桌寵邏輯在已構建的 client.js 中執行，屬當前 DSH Web 會話的前端能力，不單獨請求遠端服務。

安裝與啓用¶

官方 README 的安裝起點是克隆倉庫（安裝命令須與資料一致，勿自行拼接 dsh plugin add github:...）：

git clone https://github.com/mufanlee/dsh-pikachu-pet.git

克隆完成後，任選其一裝入當前 profile：

1. 在 DSH 會話中讓 Agent 將克隆目錄作爲 bundle 安裝（plugin_manager 的 install_bundle）。
2. 打開 設置 → Plugins 添加該 bundle，然後刷新頁面。

成功時返回 application: applied。

卸載：設置 → Plugins 停用，或調用 plugin_manager 的 remove_bundle。

安裝前建議自行閱讀倉庫源碼與 LICENSE、NOTICE。插件隨當前 DSH 進程與 Web 環境運行，權限邊界與宿主一致。

典型用法¶

1. 在 DSH 0.2.1-rc.5（Web GUI） 上完成安裝並刷新（README 標明該版本；其他版本未驗證）。
2. 正常發起 Agent 任務，觀察右下角桌寵隨「運行中 / 等待確認 / 完成 / 長時間空閒」變化。
3. 若不需要聲音：在桌寵懸停區關喇叭，或到 設置 → 通用 → 皮卡丘桌寵 · 聲音 關閉。

版本與包名以 package.json 爲準：當前文檔抓取時爲 @local/dsh-pikachu-pet 1.0.0。

適用場景與注意¶

適合誰： 經常在 DSH Web GUI 里長時間跑 Agent、希望用視覺與輕量音效感知會話節奏，且能接受非官方粉絲素材合規邊界的開發者。

需要注意：

• 素材與商標歸屬見 NOTICE，非 MIT 範圍內容勿當作可任意再分發商用素材。
• 星標、社區目錄展示信息可能滯後；以 GitHub 倉庫 爲準。
• 社區插件目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文介紹的是社區貢獻之一。

若你參與二次開發：修改 src/client.template.js 或 assets/ 後需重建 client.js（勿手改生成產物）：

npm run build
npm run verify

或：

node src/build-client.cjs
node src/verify-client.cjs

結尾¶

mufanlee/dsh-pikachu-pet 把會話狀態映射到右下角桌寵動作與本地音效，安裝路徑清晰、依賴瀏覽器本地能力。若你需要在不改後端的前提下給 Web GUI 加一點狀態反饋，可按 README 克隆倉庫並通過 Plugins 或 install_bundle 啓用。

• 社區目錄：https://www.skillhub.cn/plugins/mufanlee/dsh-pikachu-pet
• 源碼與說明：https://github.com/mufanlee/dsh-pikachu-pet