dsh-cyber-muyu

使用 / Usage

网页端

操作	效果
点悬浮木鱼	手动敲击，功德 +1，播放动画与音效。
点「籤」	打开金钱卦卷轴，摇六次铜钱实时起卦，卦象落在卷轴中。
打开设置页	查看功德簿（今日 / 累计功德、工具调用、渡劫次数、连击、修行成就）与卦象历史，并调整各项设置。

模型工具

muyu_strike —— 敲一声木鱼，为当前工作积攒功德，并在网页端播放敲击动画与声音。

参数	类型	说明
reason	string	这一声为何而敲（心愿 / 庆祝 / 安慰），≤ 60 字，显示在木鱼飘字旁。可省略。
times	integer	连击次数 1–9，默认 1。

muyu_oracle —— 按金钱卦实时起卦，返回完整卦象。

参数	类型	说明
question	string	所问之事，≤ 200 字。可省略；问题字数会记入占验背景。

自动敲击的节流规则

毫秒级合批与冷却，避免 agent 高频调用把木鱼敲成机关枪：

事件	表现	合批 / 冷却
工具调用成功	常规木鱼声	1.2 s 内合批，单次最多 8 声
工具调用失败	渡劫音色	1.6 s 内合批，单次最多 3 声
一轮对话结束	轻敲一声	1.5 s 冷却
Todo 全部完成	收工三连击	每会话 5 分钟冷却
深夜（23:00–05:00）干活	深夜修行提醒	每晚一次

此外还有一层令牌桶限流（4 秒补满 12 声），兜住子 agent 风暴。

设置项 / Configuration

设置页可直接调整，也可通过 GET / POST /dsh-cyber-muyu/api/config 读写。

键	默认值	说明
enabled	true	总开关。
volume	0.6	音量，取值 0–1。
autoStrike	true	agent 事件自动敲击。
soundAuto	true	自动事件是否发声；关闭后只播放动画。
corner	"bottom-right"	悬浮木鱼位置：bottom-right / bottom-left / top-right / top-left。
showMeritPill	true	木鱼旁显示今日功德气泡。
nightGuard	true	深夜修行提醒。
categories	全部 true	分类开关：tool-ok / tool-fail / turn / finale。