让 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 setupnpm 在这里只是安装工具；请保留完整的 github:PanYX/mingshu-bazi 地址，不要把包名换成尚未发布的 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 账号，也不会读取你的本地文件。