前言¶
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
