讓 AI 幫你安裝
把下面這段話發給 Codex、Claude Code，或其他能執行本機指令的助手，它會自行完成安裝及連接檢查。
請幫我安裝個人命書：https://github.com/PanYX/mingshu-bazi
請閱讀項目中的 docs/agent-install.md，完成安裝及連接檢查。OPEN SOURCE · CLI + AGENT SKILL
讓 AI 幫你排八字，用神不用再猜。
個人命書面向 AI Agent 的客戶端與 Skill 已開源，MIT 授權，程式碼在 GitHub。它呼叫官網運行的排盤引擎，一次回傳命盤事實與引擎判斷：四柱與藏干十神之外，還有格局、旺衰依據、用神喜忌、調候、財庫、貴人、神煞與事業宮。判斷交給引擎，解讀留給你的 AI。
一行指令安裝
npm install -g github:PanYX/mingshu-bazi- MIT 授權
- Node.js 20+
- 支援 Codex 與 Claude Code
01 / 安裝
讓 AI 安裝、自己安裝，或先網上體驗。
CLI 直接從 GitHub 安裝，毋須註冊 npm 帳號。安裝後執行 mingshu setup，就會把排盤能力連接到你的 AI 助手。
自己安裝
需要 Node.js 20 或更新版本，以及 Git。兩行指令，第二行會請你選擇 Codex 或 Claude Code。
npm install -g github:PanYX/mingshu-bazi
mingshu setup這裡的 npm 只是安裝工具；請保留完整的 github:PanYX/mingshu-bazi 網址，不要換成尚未發布到 npm 的套件名稱 mingshu-cli。
直接網上體驗
不想安裝也可以用。先在官網排一張盤，看看同一套引擎回傳的命盤與判斷。
網上排盤網上體驗毋須安裝，也不會上載或儲存你的本機檔案。
02 / 差異
四柱大家都會算，
判斷才是分水嶺。
多數開源八字 Skill 只回傳四柱與十神。使用者接著問「我的用神是什麼」，助理只能自己編一個。個人命書把確定的判斷交給引擎，再讓 AI 負責把它講成人話。
回傳內容只給四柱的開源方案個人命書 CLI
四柱 · 藏干十神有有，附五行權重
旺衰不給依據得令 · 得地 · 得勢逐條列出
用神 · 喜神 · 忌神由助理臨場判斷由引擎直接給出結果
調候通常沒有調候天干與評級
財星 · 財庫 · 擔財通常沒有含開庫條件與擔財能力
事業宮 · 貴人 · 神煞通常沒有給出位置與依據
時間計算方式不標示真太陽時或鐘錶時間明確標示，有歧義直接報錯
語言通常只有中文五種語言，事實與摘要不變
差距不在四柱算得對不對，而在用神喜忌、旺衰依據這些判斷由誰來做。引擎給結論與依據，AI 負責解讀，兩者不會互相冒充。
03 / 真實輸出
一次呼叫，拿到可以直接解讀的命盤。
以下是虛構範例的真實回傳，未經改寫。用神、喜神、忌神與旺衰依據都在裡面，助理不需要猜。
辛 · 從強格 · 從強
用神: 金 喜神: 土 忌神: 火
調候: 丙 · 壬 · 戊 (極佳)
五行: 木 4% 火 10% 土 43% 金 38% 水 5%
十神: 比劫 38% 印綬 43% 食傷 5% 財星 4% 官殺 10%
年柱 辛未 比肩
月柱 辛丑 比肩
日柱 辛巳 日主
時柱 己亥 偏印
大運: 甲辰 2021-2030 · 乙巳 2031-2040 · 丙午 2041-2050 · 丁未 2051-2060不加參數時，終端機直接輸出可讀摘要。
{
"judgments": {
"pattern": "從強格",
"strength": {
"label": "從強",
"deLing": {
"ok": true,
"text": "月令丑土生身"
}
},
"useful": [
"金"
],
"favorable": [
"土"
],
"unfavorable": [
"火"
]
},
"chartDigest": "e733dfec6fbb98c2f17b4dd946ad19aa1f6bd76476b7cda226f12431a1eb0226"
}加上 --json 會附上判斷依據與欄位，方便助理引用；同一張盤用五種語言請求，摘要完全一致。
04 / 現場驗證
同一張盤，五種語言，摘要完全一致。
這是一次真實呼叫。轉換語言再排一次，事實、列舉值及摘要都不變，只有文字跟隨語言。
05 / 指令
指令不多，助理也看得懂。
每條指令都支援 --json，失敗時結束碼為 1，並回傳帶 code 與 message 的錯誤。
mingshu setup把 Skill 裝進你的 AI 助手，並檢查服務連接mingshu version --json查看 CLI 與 Node.js 版本mingshu capabilities --json列出能力、輸入契約與限制mingshu doctor --json檢查服務連接，不傳送出生資料mingshu example --json顯示虛構的範例出生資料mingshu validate --input birth.json --json在本機驗證輸入，不上網mingshu locations --query "Shanghai" --locale en --json查詢城市層級的地點 IDmingshu chart --input birth.json --json排盤，回傳命盤事實與引擎判斷mingshu skills輸出配套 Skill 全文mingshu website --locale en輸出官網連結，不開啟瀏覽器
服務網址預設為 https://mingshu.help，可用 --origin 或 MINGSHU_API_ORIGIN 指定。改用其他網址，出生資料就會傳到該台伺服器。
06 / 邊界
哪些開源、哪些留在伺服器，都說清楚。
開源的部分
用戶端、介面契約、Skill 及文件都在公開儲存庫裏，MIT 授權，可自由使用、修改及再發佈。
伺服器端
排盤引擎、帳號與付費報告在官網伺服器端執行，不在開源儲存庫裡。CLI 呼叫的是線上介面，你不需要自己架一套服務。
出生資料
排盤只把你填寫的資料傳到你指定的服務網址，不寫資料庫、不建立檔案。回傳的官網連結只帶來源參數，不含出生資料。用戶端不扣積分、不呼叫模型。
命理的邊界
格局、旺衰、用神、喜神、忌神與調候都來自固定表格，是本引擎的判斷，可能與其他流派結論不同；五行與十神百分比是引擎權重，不是機率。解讀屬於傳統文化範疇，不構成醫療、法律或投資建議。
FAQ
關於這個 CLI 的常見問題。
01這個 CLI 是什麼？要付費嗎？
它是官網排盤引擎的開源命令列用戶端，MIT 授權，可以免費使用與再散布。它只負責排盤與回傳引擎判斷，不產生 AI 長篇解讀，也不會產生費用。
02它和其他開源八字工具有什麼不同？
多數開源方案只回傳四柱與十神，用神喜忌要靠助手自行判斷。這裏由固定表格給出格局、旺衰依據、用神喜忌與調候，助手只負責解讀，不能改寫結論。
03安裝需要準備什麼？
需要 Node.js 20 或更新版本和 Git。安裝指令直接從 GitHub 取用套件，毋須註冊 npm 帳號，也可以交由能執行本機指令的 AI 助手自動完成。
04排盤會保存我的出生資料嗎？
不會。排盤只把資料傳到你指定的服務網址，介面不寫資料庫、不建立檔案；回傳的官網連結只帶來源參數，不含出生日期、時間及地點。
05結果可以當成確定的預測嗎？
不行。格局、旺衰與用神來自本引擎的固定表格，與其他流派可能出現不同結論。請把它當作傳統文化視角下的參考，重要決定仍需搭配現實資訊判斷。
07 / 文件
想先讀程式碼，從這裡開始。
公開儲存庫裡有完整的接入、介面與示範說明。
一行指令，把排盤引擎接到你的 AI 上。
安裝完成後，對助手說「使用個人命書，幫我排八字」，它會自行收集出生資料、呼叫 CLI，再把結果解讀給你。
npm install -g github:PanYX/mingshu-bazi用戶端直接從 GitHub 發佈，毋須註冊 npm 帳號，也不會讀取你的本機檔案。