前言¶
DeepSeek Harness（DSH）是「一切皆插件」的智能體開發框架，開發者可以按需組合各類工具。對於想拓展趣味場景的插件作者，算命是一個典型的細分領域：它既需要精確的排盤計算，又需要模型做人文解讀。傳統做法要麼依賴在線 API（依賴外部服務、隱私顧慮），要麼把算命邏輯寫在 Prompt 裏（不可靠、不透明）。玄機閣（dsh-xuanji）通過本地確定性引擎解決了這兩點：排盤數據由本地計算得出，模型只負責解讀，斷語出處可追溯。
下面介紹這個插件的結構、安裝方式以及典型用法。
這是什麼¶
dsh-xuanji 是 DeepSeek Harness 的玄學算命插件，由維護者 huangziyuan-general 開發，在 SkillHub 社區目錄收錄。它內置 16 個 xuanji_* 工具，覆蓋八字、紫微斗數、梅花易數、六爻、黃曆、稱骨、擇日、風水、起名、合婚、生命數字、人生 K 線、塔羅、小六壬等。所有排盤數據由本地確定性引擎計算（干支、星曜、卦象、骨重等），模型只負責解讀，輸出包含四層：排盤事實 → 傳統解讀 → 現實行動建議 → 免責聲明。
插件還附帶右側欄 client 面板，提供八字、黃曆、人生K線、稱骨、快佔、塔羅、奇門、風水、合婚、六爻等十個只讀視圖，數據來自 /api/xuanji/* 接口，支持公曆/農曆輸入，內置夏令時與真太陽時校正。
核心能力¶
16 個 xuanji_* 工具¶
| 工具 | 用途 | 關鍵輸入 |
|---|---|---|
xuanji_bazi |
八字排盤：四柱、納音、藏幹、十神、旬空、星運十二長生、地支刑衝合會、五行旺衰、胎元命宮身宮、21 種神煞、起運與大運、流年 | 生辰（公曆/農曆）+ 時辰（可選）+ 性別（+ city/longitude 真太陽時） |
xuanji_ziwei |
紫微斗數：十二宮安星、十四主星亮度與生年四化（祿權科忌）、命主身主五行局、運限層（大限/流年/小限） | 生辰 + 時辰 + 性別 |
xuanji_meihua |
梅花易數：時間起卦 / 報數起卦，本互變卦、動爻、體用生克斷吉凶 | mode + 時刻或兩個報數 |
xuanji_almanac |
每日黃曆：農曆干支、宜忌、衝煞、喜神/財神/福神/陽貴/陰貴方位、節氣、節日、值神、星宿、彭祖百忌 + 每日一卦 | 日期（缺省今天） |
xuanji_chenggu |
袁天罡稱骨：年月日時骨重求和，分檔白話批語 | 生辰 + 時辰 |
xuanji_zeri |
擇日：事項 × 黃曆宜忌 × 建除十二神 × 衝煞排除，逐日打分排序推薦日/迴避日 | 事項 + 日期區間 + 屬相（可選） |
xuanji_fengshui |
風水：八宅命卦（東四/西四命 + 大遊年四吉四凶方位）+ 流年九宮飛星（年家紫白）；action=advise 推宅卦八星盤與門主竈廁佈局傾向 + 命宅配（24 山坐向） | 出生年月日 + 性別；advise 需坐山或向山 |
xuanji_name |
起名：評估（八字喜用神對照內置常用字五行字庫 241 字逐字打分）+ 候選生成（action=generate，按喜用與性別傾向組合候選名） | 評估：姓 + 名；生成：姓 + 生辰 + 性別 |
xuanji_star |
星座檔案 + 當日四維基調（日期哈希確定性生成，同日同星座同結果） | 日期（缺省今天） |
xuanji_trend |
人生K線：大運×流年十神確定性計分，1–100 歲逐年 OHLC + 大運分段 ASCII 迷你圖 + 順位/謹慎年份 | 生辰 + 性別（時辰可省） |
xuanji_tarot |
塔羅：每日一牌（同日同牌同正逆位）/ 三牌陣（過去現在未來），22 大阿卡納通行釋義 | mode；三牌陣需所問何事 |
xuanji_xiaoliuren |
小六壬馬前課：農曆月日時或報三數掐指落宮，六宮吉凶斷語 | mode（time/number） |
xuanji_match |
八字合婚/合盤：屬相關係 + 日主生克/天干五合 + 年命納音 + 簡化分檔（衝刑害只講摩擦點） | 雙方出生年月日（時辰可選） |
xuanji_numerology |
生命數字（西方數字學）：生命路徑數/生日數/態度數（11/22/33 主數保留）+ 白話數義 | 公曆出生年月日 |
xuanji_qimen |
奇門遁甲（時家轉盤·拆補法簡化口徑）：陽遁/陰遁、節氣局數、符頭、時干支、值符、旬空、八宮九星/八門落宮 | 日期 + 時辰（公曆/農曆） |
xuanji_liuyao |
六爻納甲（京房）：搖卦成卦 → 八宮歸屬、世應、納甲干支、六親、六神、旺相休囚死、旬空、月破/日破/暗動、動爻與變卦 | 六個爻象數（6/7/8/9）或六次三枚銅錢記錄 + 起卦日（缺省今天） |
設計原則¶
- 模型不推演數值：一切確定性事實（干支、星曜、卦象、骨重、牌面）來自本地引擎的確定性計算，模型不心算、不改盤。
- 四層輸出：排盤事實 → 傳統解讀 → 現實行動建議 → 免責聲明，由 systemPrompt 紀律段強制。
- 缺輸入先問不猜：生辰、性別、時辰缺失時必須詢問用戶，絕不允許模型代填猜測值。
- 斷語出處標註：每條斷語區分「傳統原文 / 傳統通行口徑 / 簡化判定 / 白話自撰 / 自建字庫」五級出處，工具未覆蓋的如實說明。
日期與時間處理¶
- 所有喫日期的入口支持
calendar=solar|lunar（缺省 solar），農曆側再帶isLeapMonth。 - 農曆年份以正月初一爲界，不是公曆年；閏月不是每年都有（2023 閏二月、2025 閏六月、2026 無閏月）。
- 中國夏令時（1986–1991）默認自動校正；真太陽時通過
city（內置 57 城經度表）或longitude校正；晚子時（23:00–24:00）通過宿主配置ziShi切換。 - 所有口徑調整都寫進返回值的
meta.notes。
右側欄面板¶
插件自帶右側欄「玄機閣」tab，提供十個只讀視圖：八字、黃曆、人生K線、稱骨、快佔、塔羅、奇門、風水、合婚、六爻。面板數據來自 /api/xuanji/*，缺輸入時 fail-fast，絕不代填。面板支持深淺主題自適應，無需配置。
安裝與啓用¶
安裝前確保 Node.js ≥ 20。從 npm 安裝（推薦）：
dsh plugin --profile web add npm:dsh-xuanji
從 GitHub 公開倉庫安裝（需要配置 GitHub SSH key 並將 github.com 加入 known_hosts）：
dsh plugin --profile web add github:huangziyuan-general/dsh-xuanji
本地開發時可用符號鏈接方式：
dsh plugin --profile web add link:/path/to/dsh-xuanji
安裝後可在 DSH 中使用 xuanji_* 工具或通過右側欄面板查看結果。
典型用法¶
八字排盤示例¶
使用 xuanji_bazi 工具排盤，模型會基於本地排盤結果進行解讀。典型輸入示例：
用戶：幫我算一下 1990-08-16 14:30（公曆）男命
工具會返回四柱、納音、藏幹、十神、旬空、星運十二長生、地支刑衝合會、五行旺衰、胎元命宮身宮、21 種神煞、起運與大運、流年等信息，模型隨後給出傳統解讀與現實行動建議。
起名示例¶
使用 xuanji_name 工具進行起名評估或候選生成：
用戶：幫我評估名字"張偉"，按八字喜用神打分
工具會返回喜用神對照打分結果，未收錄的字如實標註。
用戶：幫我按喜用神和性別生成幾個候選名
工具會按喜用與性別傾向從內置字庫組合候選名，並附字義與確定性排序。
快佔示例¶
使用 xuanji_meihua 或 xuanji_xiaoliuren 工具進行快速占卜：
用戶：梅花易數起卦，報兩個數 7 和 9，問什麼時候能找到合適的工作
工具返回本互變卦、動爻、體用生克斷語，模型據此給出解讀。
擇日示例¶
使用 xuanji_zeri 工具擇日：
用戶：2026 年要結婚，幫我查一下 6–8 月的宜忌日，避開屬虎的衝煞
工具返回逐日打分排序的推薦日/迴避日列表，模型結合宜忌、衝煞給出建議。
適用場景與注意¶
適合在 DSH 中搭建玄學解讀類智能體，如八字解讀、紫微斗數諮詢、擇日顧問、起名助手、風水建議、塔羅占卜等場景。插件以當前 dsh 進程權限運行，模型解讀受限於插件提供的排盤數據與設計原則，不做醫療、投資、法律斷言，恐嚇性斷語被 systemPrompt 明確禁止。
使用前建議檢查源碼與許可證（MIT），確認本地計算邏輯與輸出格式符合預期。若需定製面板樣式，可修改 src/client/ 代碼並運行 npm run build 重新生成 lib/client.js。
結語¶
玄機閣通過本地確定性引擎把算命工具鏈從在線 API 轉向本地計算，降低了外部依賴，提高了數據可控性。模型只負責解讀，斷語出處可追溯，適合需要在 DeepSeek Harness 中拓展玄學場景的開發者。插件在 SkillHub 社區目錄收錄，源碼託管在 GitHub，可通過 npm 或 GitHub 倉庫安裝使用。
- 技術介紹：https://www.skillhub.cn/plugins/huangziyuan-general/dsh-xuanji
- 源碼倉庫：https://github.com/huangziyuan-general/dsh-xuanji
