dsh-cyber-muyu

dsh-cyber-muyu

赛博木鱼 / Cyber Wooden Fish —— 电子木鱼赛博修仙，agent 干活即修行。

dsh-cyber-muyu 是 DeepSeek Harness (dsh) 的赛博木鱼插件：agent 每成功调用一次工具就敲一声木鱼、攒一分功德，报错算「渡劫」，一轮对话收工有连击；木鱼旁边还挂着一支金钱卦，摇六次铜钱当场起卦。功德簿同时是一份 agent 工作量与失败率统计。

A cyber wooden-fish (muyu) plugin for DeepSeek Harness. Every tool call the agent makes strikes the fish and earns merit, failed calls count as tribulations, and a finished turn rings a closing combo. Alongside it sits a real-time I-Ching coin divination (金钱卦) cast with three coins and six tosses. The merit ledger doubles as a lightweight workload and failure-rate report for your agent.

金钱卦是中国传统文化的趣味演绎，结果仅供娱乐，工程决策请理性判断。 Coin divination here is a cultural toy, not a prediction service. Important decisions still deserve real analysis.

目录 / Contents

• 特性 / Features
• 截图 / Screenshots
• 安装 / Installation
• 使用 / Usage
• 金钱卦怎么算 / How the divination works
• 设置项 / Configuration
• HTTP API
• 隐私 / Privacy
• 本地开发 / Development
• 致谢与许可 / Credits and License

特性 / Features

截图 / Screenshots

安装 / Installation

前置要求：dsh（DeepSeek Harness）+ 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

使用 / Usage

网页端

模型工具

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

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

自动敲击的节流规则

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

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

金钱卦怎么算 / How the divination works

插件实现的是民间通行的文王六十四卦金钱课（六爻金钱卦），全部计算在 src/divination.js，可单测复现：

1. 摇钱：三枚铜钱，字面（阴）记 2、背面（阳）记 3，每掷三枚求和，共摇六次，自初爻（最下）向上爻（最上）排列。
   • 和为 6：老阴 ⚋×（阴爻，动）；7：少阳 ⚊（阳爻，静）；8：少阴 ⚋（阴爻，静）；9：老阳 ⚊○（阳爻，动）。
2. 成卦：六爻组成本卦（查 8×8 卦宫表得周易卦序与卦名）；老阴变老阳、老阳变老阴后得变卦；二至四爻、三至五爻互得互卦。
3. 体用：动爻所在的经卦为「用」，不动之经卦为「体」；上下俱动或六爻安静时，内卦（下卦）为体、外卦（上卦）为用。
4. 吉凶：以体卦、用卦的五行生克定本卦基调（用生体 / 体用比和 / 体克用为吉，体生用为平，用克体为凶），再以变卦的体用关系定终应（生体、比和上调，克体下调），映射为上上 / 上吉 / 中吉 / 中平 / 小凶 / 下下六级。
5. 工程宜忌：八卦各配一条「工程卦德」（如离主发布与文档、艮主冻结守成、坎主排障加固、坤主测试配合），结合体卦与变用卦实时组合出本次的「宜 / 忌」。
6. 起卦依据：占问时刻会换算为农历年月日与时辰干支（src/lunar.js，1900–2100 历表），连同问题字数、六掷钱数记入卷轴底部的占验背景。

设置项 / Configuration

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

HTTP API

所有路由挂在 /dsh-cyber-muyu/api 之下，并沿用 dsh 的信任栅栏：connection.requestRejection 的 Host / Origin 校验加浏览器认证。

隐私 / Privacy

• 功德、成就、卦象历史通过 dsh storageDomain 保存在本机（storage 域 dsh_cyber_muyu），不上传。
• 起卦为纯本地计算，无网络请求、无外部 API、无遥测。
• 重置数据：POST /dsh-cyber-muyu/api/reset（body {"confirm":"reset"}），或停止 dsh 后删除对应 storage 文件。

本地开发 / Development

npm install            # 无运行时依赖，仅为构建与测试
npm run check          # 语法检查（host + client 全部源文件）
npm test               # 单元测试（禅修内核 / 农历 / 起卦引擎，41 用例）
npm run build:client   # 零依赖拼接构建 client/bundle.js

client/bundle.js 由 scripts/build-client.mjs 生成，请勿手动修改。

用 --patch 把工作树叠加进本地 dsh（不写入 profile，不影响已安装插件）：

cp cordis.dev.example.yml cordis.dev.yml
# 编辑 cordis.dev.yml，把 name 改成本仓库 src/index.js 的绝对路径
dsh --profile web --patch ./cordis.dev.yml --port 3180 --no-open

cordis.dev.yml 含本机绝对路径，已在 .gitignore 中，不会发布。

致谢与许可 / Credits and License

本项目以 MIT 许可证 发布。

黑白极简木鱼的造型语言受以下项目启发，木鱼图形为本项目自绘 SVG：

• Ares-Chang/wooden-fish（MIT，© Chang）
• zengsanxiang/mp-muyu（MIT，© caidukai）

农历换算表（src/lunar.js）数据源自 jjonline/calendar.js，原始数据为香港天文台公开历表。

第三方声明详见 NOTICE。