不写代码怎么用它
x-iztro 能做什么、典型用在哪、要跟工程师交代哪几件事，以及它准不准。
适合：命理爱好者 · 产品与决策者。全页无需读代码
这是什么
x-iztro 是一个排盘引擎：给它出生日期、时辰、性别，它算出一张完整的紫微斗数命盘， 并能把这张盘转成一段大模型读得懂的文字。
它不是一个 App，也不是一个网站 —— 它是给程序用的一段代码， 需要由工程师装进你们自己的产品里。
它能做什么
- 排一张完整的本命盘：十二宫的位置与干支、每个宫里落了哪些星、 星的亮度与四化、四组十二神、大限与小限
- 算任意时间点的运限：大限、小限、流年、流月、流日、流时六个层级
- 一键转成 AI 能读的文字：不必自己描述盘面， 生成的文本直接贴给大模型就能开始问
- 六种盘面语言：简体中文、繁体中文、英文、日文、韩文、越南文
- 流派可切换：年分界点、晚子时归属、中州派、天地人三盘，都是配置项
它不做解读。星耀落宫算得出来，「这个人事业如何」不在库的职责里 —— 那一步交给 AI 或人。
典型用在哪
AI 解盘机器人
最常见的一种。用户在对话里报生日，后台调 x-iztro 排盘， 把生成的盘面文字连同用户的问题一起发给大模型，模型给出解读。
盘由库算准，话由模型来说 —— 两件事分开，各自可靠。
命理 App 的后端
App 前端负责画盘、做交互，排盘计算放在服务端。 同一份计算逻辑可以同时服务 iOS、Android、Web 和小程序。
批量数据分析
比如「这十万条出生数据里，命宫有紫微的占多少」「某个格局与某个字段的相关性」。 x-iztro 排一张盘是毫秒级的，几十万条数据在单机上跑得完。
需要找工程师吗
需要。x-iztro 是一个代码库，不是可以直接打开的软件。
但工作量很小：装上它、写三行调用、把结果接到你们已有的流程里。 一个熟练的后端工程师，做出一个能跑的原型通常在半天以内。
要跟工程师说什么
把下面这几条转给他们就够了：
| 事项 | 内容 |
|---|---|
| 仓库 | github.com/x-haose/x-iztro |
| 编程语言 | Rust、Python、Go 三选一，结果完全一致 |
| 安装 | Python 用 pip install x-iztro；Go 用 go get；Rust 用 cargo add |
| 环境要求 | Python 3.10 及以上 / Go 1.22 及以上 / Rust edition 2024 |
| 输入 | 出生日期、时辰索引（0–12）、性别，三样 |
| AI 用法 | 调 astrolabe_to_prompt 拿到盘面文字，直接喂大模型 |
| 文档 | 快速开始、AI Prompt 生成 |
时辰索引怎么填
不是小时数，是 0–12 的十三个值：0 是早子时（00:00–01:00）， 1 丑时、2 寅时……11 亥时，12 是晚子时（23:00–24:00）。 对照表见你需要准备的输入。
23 点以后出生的要填 12，不是 0 —— 这两个值排出的盘不一样。
它准不准
「准」在这里有一个很具体的定义：与 JS 版的 iztro 逐字段完全一致。
iztro 是开源社区里最完整、维护时间最长的紫微斗数排盘实现之一， 不少前端项目在用。x-iztro 把它当作对照基准， 用约 71 万个测试用例逐字段核对 —— 任何一处不一致都当作 bug 修掉。
这句话的边界也要说清楚：与 iztro 一致不等于「命理界唯一正解」。 斗数流派众多，不同流派的安星与四化取法本来就不同。 x-iztro 保证的是「在同一套流派取舍下，算得和权威实现一模一样」， 而不是「这套流派取舍就是对的」。
详见准确性保证。
MIT 是什么意思
x-iztro 用 MIT 许可证开源。对使用方来说这意味着：
- 可以商用，不需要付费，也不需要跟作者报备
- 可以闭源使用：把它装进你们的商业产品里，产品本身不必开源
- 可以修改
- 唯一的义务是保留版权声明（通常放在产品的「开源许可」页面里）
- 作者不承担任何担保责任：用出问题是你们自己的事
在开源许可证里，MIT 是限制最少的那一类，法务通常不会有意见。