前言¶

DeepSeek Harness 的設計理念是「一切皆插件」。當智能體需要提供命理排盤能力時，傳統做法要麼在本地維護多套邏輯，要麼接入外部 API。對於需要穩定、可控、本地計算的場景，更現實的方式是讓插件把整套規則和視圖都帶進來。

dsh-metaphysics 是一個把六套命理體系裝進 Harness 的插件：四柱八字、紫微斗數、六爻、梅花易數、大六壬、塔羅牌。它既提供 Agent 工具（通過對話調用），也提供 Web 面板（側欄顯示）。所有計算在本地完成，不收集數據，結果僅供文化娛樂參考。

功能概覽¶

插件把六種體系按「命盤」與「卦象 / 牌陣」兩類組織，每種體系都有對應的排盤面板和結構化解讀模塊。

四柱八字（bazi）¶

• 四柱、藏幹、十神、納音、空亡（逐柱）
• 十二長生：地勢（日干對各支）、自坐（各柱幹對本支）
• 神煞 42 顆，分 7 類：貴人、文星、婚姻、性情、事業、凶煞、格局；每顆星附查法依據，界面懸停可見
• 日主旺衰：月令權重 + 通根 + 天干幫扶，量化分檔並給出依據
• 格局與用神：月令取格（建祿 / 陽刃 / 月劫 / 十神格）＋ 特格（化氣 / 專旺 / 從格）＋ 十神組合，每條附判定依據；用神取扶抑爲主 + 調候提示，並列出喜忌十神
• 行運吉凶：大運、流年按喜忌五行與十神加權評分，分大吉 / 吉 / 平 / 忌 / 大忌五檔，懸停可看逐項理由
• 干支關係：五合、相沖、相剋；六合、三合半合、三會半會拱會、衝、害、破、刑
• 大運、流年（含與原局地支的關係）、真太陽時（按出生地經度修正）

紫微斗數（ziwei）¶

• 農曆（定朔 + 冬至置閏）、命宮、身宮、五行局
• 紫微 / 天府、十四主星、六吉六煞、祿存天馬、49 顆星曜
• 十四主星廟旺得利平不陷：按《紫微斗數全書》系通行表標註，廟旺標綠、得利平標灰、不陷標紅
• 四層十二神：長生、博士、將前、歲前
• 生年四化、宮幹自化、大限、小限、流年（命宮、三方四正、流祿流羊流陀）、鬥君
• 格局識別 34 條，附判定依據與吉 / 忌傾向
• 大限一覽：十二限排序列出宮位、年齡區間、宮幹四化落宮、三方主星；流年四化：逐年給出四化星落宮與命宮三方主星
• 流月 / 流日 / 流時：由流年鬥君逐級下推；每層給落宮、宮幹四化落宮與三方四正
• 宮位點擊展開詳情：點任一宮攤開該宮完整星曜、宮幹四化、四層十二神、大限 / 小限，並把三方四正同步描邊；空宮標註「借對宮 XX」

六爻（liuyao）¶

• 搖卦或手動爻值、本卦 / 變卦、納甲、六親、六神、世應
• 面板：本卦與變卦並列對照，真爻線渲染（陽整、陰斷、動描紅），世應與動爻一目瞭然
• 只需起卦時刻（取日辰定六神、月建定旺衰），與出生時間無關

梅花易數（meihua）¶

• 時間起卦（年月日時數）或數字起卦（兩數取餘，可手動指定動爻）
• 本卦 / 互卦 / 變卦 / 錯卦 / 綜卦五盤齊出；本卦上下卦分塊標「體」「用」
• 體用生克按五行判吉凶：用生體大吉、比和吉、體克用吉、體生用耗、用克體兇

大六壬（daliuren）¶

• 月將加時起天地盤（4×4 方盤：天盤大字、地盤小字、天將右下）
• 四課（幹上 / 支上遞推，標註生克與天將）、九宗門發三傳（賊克 · 元首 · 重審 · 比用 · 涉害 · 遙克 · 昴星 · 別責 · 八專 · 伏吟 · 返吟）
• 晝夜貴人（以天盤臨方定順逆）、旬空標註、格局名與斷語

塔羅（tarot）¶

• 78 張全牌、正逆位、1 / 3 / 5 張牌陣（面板可直接選牌陣，換張數自動重抽）
• 每張牌給編號、牌階級、核心義與牌陣位義；解讀 6–8 段（逐牌、大阿卡納佔比、元素分佈、宮廷牌、正逆位比例、關鍵牌、建議）
• 明確標註體系：RWS 編號、黃金黎明元素歸屬、逆位取「弱化 / 未順 / 內化」而非兇斷

解析與詳解（interpret）¶

每個體系的排盤結果下方都會跟一個「解析與詳解」模塊，把盤面翻譯成可看懂、可照着做的事。

• 結構化輸出：{ moduleType, system, title, lead, dimensions[], sections[], disclaimer }；moduleType 爲 natal（命盤）/ divination（卦象）/ card（牌陣），dimensions 固定五個維度
• 五個維度：整體運勢、工作與職業選擇、事業發展、愛情與感情、健康狀況——每項給「解讀 + 行動建議」
• 卦象（六爻 / 梅花 / 大六壬）額外給：卦名與卦辭大意、爻辭與動爻、體用關係、互卦與變卦、落到生活裏
• 塔羅額外給：整盤連貫解讀（把幾張牌串成一條線，避免各張互相矛盾）與牌面結構（大阿卡納佔比、元素分佈、正逆位）
• 文案口徑：第二人稱、溫和，只給傾向與建議，不作絕對判斷；底部保留理性參考的免責提示
• 解讀區可摺疊：內容較長（五維度 + 體系模塊），點標題欄或箭頭即可展開 / 收起；寬屏默認展開、窄屏默認收起，手動切過之後按你的選擇來

所問之事與詢問方向（六爻 / 梅花 / 大六壬 / 塔羅）¶

問事的體系要先說清問什麼，解讀纔有落點：

• 所問之事：必填，支持多行，佔位示例「用一句話描述所問之事，例如：今年是否適合換工作？」；不填就起卦會給提示，不會給一份沒有落點的解讀
• 詢問方向：下拉選擇——綜合（默認）、財運、事業、感情、健康、學業、出行。選項表 DIRECTIONS 由 engine/interpret.js 導出，界面與解析層共用一份
• 聯動方式：interpret(result, { question, direction })。所選方向對應的維度會被提到最前並標註「最貼近你的問題」，正文點明你所問的事，引語也會回顯
• 不重搖卦：改問題或方向只重出解讀，卦象本身不動
• 命盤類（八字 / 紫微）不問事，不顯示這兩項，也不會出現回顯行

安裝與啓用¶

從 npm 安裝：

dsh plugin install dsh-metaphysics

或在 Harness 的「插件」面板裏搜索 dsh-metaphysics。

從本地目錄安裝：

dsh plugin install /path/to/dsh-metaphysics

從 tgz 安裝：

dsh plugin install ./dsh-metaphysics-0.6.0.tgz

安裝後重啓 Harness，側欄會出現太極圖標，點開是排盤面板，支持以上六類體系。

對話與面板用法¶

對話裏¶

直接說：

• 「排個八字：1990-05-12 14:30，女，河北石家莊」
• 「排紫微盤：1996-01-19 07:40，男，新疆喀什」
• 「幫我起一卦，問這個項目能不能成」
• 「梅花易數，報兩個數 17 和 29」
• 「起個六壬課，問這週談判順利嗎」
• 「抽三張塔羅，問這份工作要不要接」

模型會調用 metaphysics_chart 工具，參數 system 取 bazi / ziwei / liuyao / meihua / daliuren / tarot。

注意：八字與紫微要出生時間；六爻、梅花、六壬只要起卦時刻（通常就是當下），與出生時間無關。

面板¶

重啓後側欄出現太極圖標，點開是排盤面板，支持以上四類。

深色與導出¶

• 深色主題：跟隨系統（prefers-color-scheme），盤面與頁面同時切換，只換一套 CSS 變量，元素規則一行不改
• 打印永遠是淺色：深色主題下直接打印會得到一整頁耗墨的深底 PDF，所以深色規則用 @media screen 限定
• 存爲 PDF / 打印：結果下方有按鈕，走瀏覽器原生打印（不引第三方庫）；A4 縱向、隱藏輸入區與按鈕、盤面與解讀不被撕頁、四化色塊保留顏色。摺疊着的「解析與詳解」在打印時會自動展開，不會只印出一個標題欄

精度與口徑¶

• 節氣：Meeus 低精度太陽黃經，與公開曆書相差 −3 ~ −8 分鐘；出生時刻距「節」不足 15 分鐘時會提示覆核
• 農曆：定朔（Meeus 第 49 章，誤差約 1 分鐘）＋ 冬至所在月爲十一月 ＋ 無中氣置閏
• 真太陽時：經度差 + 均時差；內置 34 個省會 ＋ 200 個地級市座標（±0.2°），地址更細時可開「聯網精確到區縣」（Nominatim）。只按經度修正，未含歷史時區與夏令時：海外出生請先把當地鐘錶時間換算成東八區標準時再輸入
• 紫微四化：中州派常用表（庚幹作太陽祿、武曲權、太陰科、天同忌）
• 日主旺衰：量化算法，非唯一流派

數據與隱私¶

• 全部計算在本地完成
• 唯一可能的網絡請求：開啓「聯網精確到區縣」時的 OpenStreetMap Nominatim 查詢；失敗即回退內置座標表
• 不收集、不上傳任何數據

生態與維護¶

dsh-metaphysics 由維護者 xuanfu-web 長期維護，開源在 GitHub。安裝前建議檢查源碼與許可證（MIT），確認權限與兼容性。

插件遵循 DSH 的「一切皆插件」理念，與 DeepSeek / 幻方無官方從屬關係，社區目錄是獨立站點。

快速鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/xuanfu-web/dsh-metaphysics
• GitHub：https://github.com/xuanfu-web/dsh-metaphysics
• 本地計算、不收集數據、僅供文化娛樂參考