前言¶
在 DeepSeek Harness（DSH）里做智能体，常见需求是「把领域能力封装成工具 + 可选界面」，而不是每次在对话里手写一套流程。梅花易数起卦涉及农历换算、八卦数学、主互变卦与体用关系，若只靠提示词，排盘容易不一致，也更难沉淀卦例与复盘记录。
MeiHuaYi 是面向 DSH 的梅花易数卜卦插件：支持聊天起卦与面板点击起卦，输出完整排盘，并把卦例、外应与学习笔记落在本机。实现为纯 JavaScript，没有 npm 运行时依赖。社区目录上归类为「趣味换装」，维护者为 Sakura7301；GitHub 仓库当前星标为 1（截至资料抓取时）。
这是什么¶
插件仓库：Sakura7301/MeiHuaYi
目录页：SkillHub 插件页
一句话定位：在 Harness 会话中调用 meihuayi_cast 起卦并排盘，通过运行时技能引导两阶段断卦（先排盘与外应，再逐节推断），并用 meihuayi_journal 管理本地卦例库与学习笔记。数据仅存储在本机 $DSH_PROFILE_DIR/.dsh-meihuayi/，不联网外传。
核心功能¶
下面按「起卦方式 → 排盘深度 → 断卦与沉淀 → 界面」说明已文档记载的能力。
四种起卦入口¶
- 时间起卦：按当前或指定时刻的农历年支、月、日、时起卦；公历自动转农历，换算表自 1900-01-31 起有效。
- 数字起卦：任意三位数 100–999，或面板「随机取数」。
- 一字占（测字法）：用户给一个字，由 Agent 按章法拆字算笔画，脚本用上下两部分的笔画数做八卦数学；聊天可说「一字占：梅，问……」，面板选「一字占」填字与问题。
- 手动起卦：直接指定上卦、下卦与动爻（上/下卦为先天八卦序 1 乾 … 8 坤，动爻 1–6 对应初二三四五上）。
排盘与进阶盘¶
完整排盘包括：干支四柱、五行旺衰、主卦 / 互卦 / 变卦、动爻爻辞、体用生克与关系。进阶项含错卦（六爻全翻）、综卦（上下颠倒，含「覆卦不动」）、空亡（日柱定旬）、神煞（天乙贵人 / 桃花 / 驿马 / 劫煞 / 灾煞）等。
断卦方法论与卦例库¶
断卦以运行时技能注入上下文：两阶段输出（先完整排盘并询问起卦时外应，再按外应解读、取象、体用、变卦、动爻、空亡、神煞、错卦/综卦、外应验证、综合、结论逐节推断）。卦例自动落盘草稿，可记录推断过程、结论、外应与取象解读；支持反馈（正确 / 错误及原因）与复盘，反馈后可沉淀学习笔记并统计准确率（基数为现存已反馈卦例）。
可视化面板¶
输入框下方有「☯ 梅花易数」入口，展开后面板分起卦、卦例、笔记、设置等页签。卦象按爻绘制（阳爻整条、阴爻断开，动爻在信息行标注），五行按传统配色着色。未填写「所问之事」时起卦不可用，接口层也会拒绝空问题。
可调项包括界面字号（小 / 标准 / 大 / 特大）、反馈后是否自动建笔记，以及明暗主题自适应。「反馈后自动建笔记」默认开启，可在设置页关闭。
安装与启用¶
图形界面：在 Plugin Manager 中粘贴仓库地址安装。
CLI（命令来自仓库 README）：
dsh plugin add github:Sakura7301/MeiHuaYi
本插件没有 npm 依赖，无需构建，也不需要 allowBuilds 授权。若安装时出现 github.com HTTPS 连接超时，README 建议通过 git URL 重写让 GitHub 走 SSH（仅影响该场景下的 git 依赖解析）。
宿主侧需要 tools、webServer、skills；客户端依赖 @deepseek-ai/dsh-client-locale，均由 Harness 提供。当前 package 版本为 1.4.3，许可证 MIT。
安装插件前，建议自行浏览仓库源码与 LICENSE；插件以当前 dsh 进程权限读写本机配置目录，属于常规 DSH 插件信任模型。
典型用法¶
聊天起卦¶
对 Agent 说「帮我起一卦，问……」。Agent 调用 meihuayi_cast，先展示排盘并询问外应；你回复后按技能流程逐节推断，并将结果写回卦例。
面板起卦¶
点「☯ 梅花易数」→ 起卦页填写所问之事 → 选择起卦方式 → 可「请 AI 解卦」把排盘送入对话，或「复制排盘」。
Agent 工具一览¶
| 工具 | 用途 |
|---|---|
meihuayi_cast |
起卦并排盘；question 必填；method 为 time / number / char / manual |
meihuayi_journal |
卦例与笔记：list、query、feedback、note 等 |
meihuayi_reference |
参考文档：sanyao、leixiang、jiegua |
手动起卦在聊天中可让 Agent 调用 meihuayi_cast，method="manual"，并传 upper / lower / moving。
一字占公式（笔画由 AI 拆分后）：上卦 = 上画数 % 8，下卦 = 下画数 % 8，动爻 = (上 + 下) % 6。
数据落盘与适用场景¶
| 项 | 位置 |
|---|---|
| 卦例与笔记 | $DSH_PROFILE_DIR/.dsh-meihuayi/journal.json |
| 装配自检 | 同目录 diagnostics.log |
存储采用加锁读改写与原子 rename；删除卦例不会连带删除学习笔记；meihuayi_journal 的 delete 在未传 confirm 时仅返回待删清单。
适合谁：想在 DSH 里把梅花易数起卦、排盘、断卦流程标准化，并本地积累卦例与学习笔记的开发者或使用者。SkillHub 将其放在「趣味换装」分类，更偏体验与兴趣向能力扩展，而非业务中间件。
注意：README 声明卜卦结果仅供参考娱乐，重大决策仍需理性分析。社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装来源以 GitHub 仓库与上述 CLI 命令为准。
结尾¶
MeiHuaYi 把梅花易数的起卦数学、完整排盘、两阶段断卦技能与本地卦例库接到 DSH 工具链上，界面与 Agent 共用 lib/operations.js，排盘结果一致。若要查看截图与自测说明，见仓库 README；安装与 Issue 亦以 GitHub 为准。
- 目录页：https://www.skillhub.cn/plugins/Sakura7301/MeiHuaYi
- GitHub：https://github.com/Sakura7301/MeiHuaYi
