前言¶
DSH 的插件機制可以把 Web 客戶端擴展成本地浮層。dsh-muyu 解決的是等待模型思考、流式輸出時缺少一個輕量本地反饋的問題：它在 Web 客戶端右下角放一個可敲擊的電子木魚，手動敲會記功德；模型忙碌時，它會自己輕敲。
這個插件不寫進對話記錄，不發起額外請求，只在本機瀏覽器裏維護一個輕交互計數。
插件定位¶
dsh-muyu 是一個 MIT 許可證的 DSH Web 插件，倉庫維護者是 liuwenji007。它的核心用途是在 Web 客戶端右下角提供一個可敲擊的電子木魚，適合本地等待模型響應時做輕交互。
核心功能¶
下面這些能力都落在 Web 客戶端界面裏：
- 在 Web 客戶端右下角顯示可敲擊的電子木魚。
- 手動點擊角色頭部可加 1 功德，被敲多了會起包。
- 當前會話忙碌時自動輕敲並記功德，默認大約每秒 1 功德。
- 功德只記錄在本機瀏覽器，不進對話記錄，也不會有額外請求。
- 計數可切換香爐或木牌，9999 以內顯示原數，再大顯示
Nk。 - 設置 → 木魚 可改開關、香爐/木牌、自動敲快慢、起包連擊數、圖源。
- 支持內置、本地製作、圖庫、URL 圖源，並可導入
zip圖包。 - 系統開啓「減少動態效果」時跳過跳動和飄 +1。
- 可導出官方文件名模板和對齊包。
安裝與啓用¶
版本要求¶
安裝前確認 DSH 版本滿足要求：
dsh ≥ 0.1.0-rc.8（建議 0.1.1-rc.2）
dsh-muyu 0.1.5+ 依賴宿主模塊表裏的 @deepseek-ai/dsh-client-store。版本搭配上需要注意：
- 新宿主配
dsh-muyu ≥ 0.1.5。 - 舊宿主先升
dsh ≥ 0.1.0-rc.8再升插件。 - 如果舊宿主暫時不升，也可以釘住
dsh-muyu@0.1.4。
從 npm 安裝¶
適合已經能正常跑 Web 客戶端的情況：
dsh plugin --profile web add dsh-muyu
安裝或更新後重啓 Web 客戶端：
dsh --profile web
從 GitHub 安裝¶
也可以直接指定 GitHub 倉庫安裝：
dsh plugin --profile web add github:liuwenji007/dsh-muyu
安裝後重啓：
dsh --profile web
如果 pnpm ≥ 10 的 git 安裝被攔截，可能需要加入構建允許項：
allowBuilds:
dsh-muyu: true
然後重新執行一次 add 命令。
本地鏈接安裝¶
調試本地源碼時可以使用本地鏈接：
dsh plugin --profile web add link:/你的路徑/dsh-muyu
啓動 Web 客戶端：
dsh --profile web
驗證安裝¶
安裝完成後，先看右下角是否出現木魚。也可以用命令確認配置裏能看到本包：
dsh --profile web --dump-config
刷新頁面不一定足夠，安裝或更新後建議重啓 Web 客戶端。
卸載¶
卸載命令：
dsh plugin --profile web remove dsh-muyu
卸載後同樣需要重啓 Web 客戶端。
典型用法¶
等待時手動敲擊¶
模型思考和流式輸出時，右下角的角色會顯示忙碌狀態。你可以手動點擊角色頭部，每點一次加 1 功德。被敲多了會起包。
會話忙碌時自動敲擊¶
當前會話忙碌時，插件會自動輕敲並記功德，默認大約每秒 1 功德。自動敲的快慢可以在設置裏調整。
查看當前會話計數¶
換會話時，可以看到當前會話的敲擊次數與自動消耗。功德只記錄當前會話相關計數，不會混到對話記錄裏。
切換計數樣式¶
設置 → 木魚 裏可以切換香爐或木牌。9999 以內顯示原數，超過後顯示 Nk。
替換圖源¶
圖源支持內置、本地製作、圖庫、URL 四類。導入 zip 圖包後，可以在圖庫裏切換圖包。
圖源目錄或 zip 裏需要這些指定文件名：
idle.png
auto-hit.png
manual-hit.png
bump.png
bump-big.png
stick.png
board.png
censer.png
add.png
layout.json 可選。
導出模板與對齊包¶
可以導出官方文件名模板，也可以導出對齊包。導入或製作完成後，在圖庫或設置裏切換圖源即可。
修改源碼後重新構建¶
如果你修改了 src/client/assets/ 或 src/config.ts，需要重新構建：
pnpm run build
適用場景與注意¶
這個插件適合希望把等待模型響應的時間變成本地輕交互的 DSH Web 用戶。它的計數只留在本機瀏覽器，不進入對話記錄，也不產生額外請求。
注意以下幾點：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼、依賴與 MIT 許可證。 - 組合包可能已有內置
ui-muyu，需要時禁用。 - 功德記在本機
localStorage，鍵名爲dsh.muyu.merit，最多記錄 100 個最近敲過的會話；刪掉的對話不會跟着清。 - 製作草稿與圖庫包記在
IndexedDB，鍵名爲dsh.muyu.art。 - 角色不能拖拽，以免擋住側欄。
- 系統開啓「減少動態效果」時，會跳過跳動和飄 +1。
資源¶
GitHub 倉庫：
https://github.com/liuwenji007/dsh-muyu
