前言¶
在 DeepSeek Harness（DSH）里跑 agent，工具调用成功与失败往往只体现在日志里，缺少一种轻量、可感知的「工作量」反馈。若希望在 Web 端一边看 agent 干活，一边用趣味界面记录调用次数、失败率，并在本地起卦娱乐，dsh-cyber-muyu（赛博木鱼）把这两件事绑在同一枚悬浮木鱼上：成功调用自动敲击攒功德，报错记为渡劫，一轮对话结束有收尾连击；旁边还提供文王六十四卦金钱课，全部在本机演算，不联网。
下面介绍插件定位、能力、安装方式与典型用法。金钱卦结果仅供娱乐，工程决策请理性判断。
这是什么¶
dsh-cyber-muyu 是 DSH 的 Web 端插件，维护者为 yang101and，在 SkillHub 目录中归类为「趣味换装」。宿主端与浏览器端均为纯 JavaScript，运行时零外部依赖；功德与卦象历史通过 dsh 的 storageDomain（域名为 dsh_cyber_muyu）保存在本机。项目以 MIT 许可证发布，当前 package 版本为 0.1.0。
核心功能¶
悬浮木鱼与自动敲击¶
网页角落有一枚可拖动的赛博木鱼。手动点「敲一下」功德 +1，带动画与音效。开启自动敲击后，agent 每成功调用一次工具会自动敲一声；失败调用使用渡劫音色。一轮对话结束轻敲一声；Todo 全部完成时有收工三连击（每会话 5 分钟冷却）。深夜 23:00–05:00 若仍在干活，可触发深夜修行提醒（每晚一次）。
为避免高频工具调用把木鱼敲成机关枪，插件对成功、失败、回合结束等事件做了毫秒级合批与冷却，并有一层令牌桶限流（4 秒补满 12 声）。
功德簿¶
设置页展示今日与累计功德、工具调用次数、渡劫（报错）次数、连击与修行成就，相当于一份 agent 工作量与失败率统计。
金钱占卦¶
点木鱼旁的「籤」打开金钱卦卷轴：三枚铜钱摇六次，现场演算本卦、动爻、变卦、互卦、体用生克、解卦与工程宜忌，不是预写签文随机抽取。起卦逻辑在 src/divination.js，农历干支在 src/lunar.js（1900–2100 历表）。
模型工具¶
agent 可通过 Cordis 工具参与互动：
| 工具 | 作用 |
|---|---|
muyu_strike |
敲木鱼；可选 reason（≤60 字）、times（1–9，默认 1） |
muyu_oracle |
按金钱卦起卦；可选 question（≤200 字） |
HTTP API（可选集成）¶
路由前缀为 /dsh-cyber-muyu/api，沿用 dsh 信任栅栏。常用端点包括：GET /stream（SSE 推送 strike / achievement / oracle / night）、GET /state、POST /strike、POST /oracle、GET|POST /config、POST /reset（body 需 {"confirm":"reset"}）。
安装与启用¶
前置条件：已安装 dsh，Node.js ≥ 22.5，并使用 web profile。
在终端执行官方安装命令：
dsh plugin --profile web add github:yang101and/dsh-cyber-muyu
安装完成后重启 dsh Web，页面角落会出现悬浮木鱼。
卸载：
dsh plugin --profile web remove dsh-cyber-muyu
典型用法¶
网页端¶
- 点悬浮木鱼：手动敲击，功德 +1。
- 点「籤」：打开卷轴，完成六次摇钱后起卦，结果落在卷轴中。
- 打开设置页：查看功德簿、卦象历史，调整音量、角落位置、自动敲击与分类开关等。
配置项（设置页或 API）¶
| 键 | 默认值 | 说明 |
|---|---|---|
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 |
全开 | tool-ok / tool-fail / turn / finale |
读写配置：GET / POST /dsh-cyber-muyu/api/config。
让 agent 敲木鱼或起卦¶
模型在对话中可调用 muyu_strike（例如庆祝某步完成）或 muyu_oracle（带可选问题文案）；网页端会同步播放敲击动画或展开卦象卷轴。
适用场景与注意¶
适合已在 DSH Web profile 下开发或调试 agent、希望用轻量 UI 感知工具调用节奏与失败次数的开发者。趣味换装类插件不改变 agent 推理逻辑，主要提供反馈与本地娱乐。
安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。插件以当前 dsh 进程权限运行，功德与卦象仅存本机 storage，不上传；重置数据可用 API 或停止 dsh 后删除对应 storage 文件。DSH 社区目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。
