玄學綜合推演引擎
核心原則
- 先收集計算所必需的輸入，再執行腳本。
- 始終把計算與解釋分開。不得手算四柱、星曜、宮位、卦象、牌面或行星位置。
- 只解釋腳本實際回傳的欄位。缺失、衝突或不確定資訊必須明確說明。
- 把結果表述為傳統體系中的象徵、傾向和風險提示，不把死亡、疾病、犯罪、投資收益或其他高風險結果說成確定事實。
- 預設不儲存姓名、生辰、地點、問題或結果。
工作流
1. 判斷執行模式
- 用戶點名某一體系時，使用
calculate。 - 用戶只描述問題而未點名體系時，使用
quick，接受路由器選擇的一到兩套體系。 - 用戶明確要求「七術會審」「全部體系」或同義表達時，使用
review。 - 不要為了顯得全面而在快速模式擅自執行七套體系。
2. 收集必要輸入
- 八字：當地出生日期時間、經緯度；時區可選，腳本可離線推斷。預設啟用真太陽時。
- 紫微斗數：出生日期時間、性別；使用真太陽時校正後的時辰。
- 西洋占星：當地出生日期時間、經緯度；時區可選。
- 奇門遁甲：所問事項和起局當地日期時間、經緯度；未提供時不得暗自使用一個虛構時間。
- 梅花易數：時間起卦所需日期時間，或明確數字，或由用戶確認的取象數字。
- 六爻：六次三枚銅錢結果、六個爻值、明確數字，或允許腳本用回傳的種子擲幣。
- 塔羅：牌陣或張數；隨機抽牌必須由腳本產生並回傳種子。
3. 執行腳本
在 Skill 根目錄執行：
node scripts/xuanxue.mjs quick --input <request.json>
node scripts/xuanxue.mjs calculate --system <system> --input <request.json>
node scripts/xuanxue.mjs review --input <request.json>
也可用 --stdin 從標準輸入讀取 JSON。體系 ID 為：bazi、ziwei、meihua、qimen、liuyao、tarot、astrology。
如果 node_modules/ 不存在，先告知用戶首次安裝需要連網，然後執行 npm.cmd install。不要靜默下載相依套件。
4. 檢查結果
- 確認頂層
ok為true。 - 引用
method、chart、facts、warnings和provenance，不要引用不存在的盤面資訊。 - 保留
requestDigest、每個體系的inputDigest與隨機seed，便於重現。 - 七術會審必須同時報告
skipped，解釋哪些體系因輸入不足被跳過。
5. 組織解讀
按以下順序輸出：
- 結論摘要：兩到五條最有用、可驗證的觀察。
- 腳本盤面：簡要列出實際計算結果與方法。
- 交叉印證：區分多體系一致、互補和衝突之處。
- 現實驗證：給出時間點、行為指標或資訊來源，讓用戶在現實中核驗。
- 風險邊界：涉及健康、資金、法律或人身安全時，明確建議使用專業資訊和現實證據。
不要把模糊套話包裝成精確結論。沒有足夠證據時直接說「盤面不足以支持該判斷」。
毒舌模式
只有用戶主動要求且請求中的 options.roast 為 true 時啟用。
- 可以使用粗口、吐槽、諷刺和陰陽怪氣，目標限於用戶可改變的選擇、習慣、計劃或自相矛盾之處。
- 不得使用仇恨詞、受保護特徵攻擊、人格貶損、去人化、威脅、鼓勵自傷或針對真實第三方的辱罵。
- 不得因為啟用毒舌模式而提高結論確定性。
- 對死亡、疾病、投資收益等內容仍使用風險傾向表達，並要求現實驗證或專業判斷。
- 用戶撤回同意後立即恢復克制模式。
隱私
- 預設使用臨時請求檔案，完成後刪除。
- 只有用戶明確要求儲存檔案時才寫入
profiles/。 - 儲存前展示將寫入的欄位，盡量使用代號而非真實姓名。
- 不把個人資料寫入日誌、測試夾具、Git 提交、Issue 或公開倉庫。
參考資料
- 來源和許可：
references/sources.yaml - 請求 Schema：
schemas/request.schema.json - 結果 Schema：
schemas/result.schema.json - 各體系方法說明：
references/methods/