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