# 不写代码怎么用它 (/zh/docs/guide/guides/for-non-developers)

x-iztro 能做什么、典型用在哪、要跟工程师交代哪几件事，以及它准不准。



*适合：命理爱好者 · 产品与决策者。全页无需读代码*

## 这是什么 [#这是什么]

x-iztro 是一个**排盘引擎**：给它出生日期、时辰、性别，它算出一张完整的紫微斗数命盘，
并能把这张盘转成一段大模型读得懂的文字。

它不是一个 App，也不是一个网站 —— 它是给程序用的一段代码，
需要由工程师装进你们自己的产品里。

## 它能做什么 [#它能做什么]

* **排一张完整的本命盘**：十二宫的位置与干支、每个宫里落了哪些星、
  星的亮度与四化、四组十二神、大限与小限
* **算任意时间点的运限**：大限、小限、流年、流月、流日、流时六个层级
* **一键转成 AI 能读的文字**：不必自己描述盘面，
  生成的文本直接贴给大模型就能开始问
* **六种盘面语言**：简体中文、繁体中文、英文、日文、韩文、越南文
* **流派可切换**：年分界点、晚子时归属、中州派、天地人三盘，都是配置项

它**不做**解读。星耀落宫算得出来，「这个人事业如何」不在库的职责里 ——
那一步交给 AI 或人。

## 典型用在哪 [#典型用在哪]

### AI 解盘机器人 [#ai-解盘机器人]

最常见的一种。用户在对话里报生日，后台调 x-iztro 排盘，
把生成的盘面文字连同用户的问题一起发给大模型，模型给出解读。

盘由库算准，话由模型来说 —— 两件事分开，各自可靠。

### 命理 App 的后端 [#命理-app-的后端]

App 前端负责画盘、做交互，排盘计算放在服务端。
同一份计算逻辑可以同时服务 iOS、Android、Web 和小程序。

### 批量数据分析 [#批量数据分析]

比如「这十万条出生数据里，命宫有紫微的占多少」「某个格局与某个字段的相关性」。
x-iztro 排一张盘是毫秒级的，几十万条数据在单机上跑得完。

## 需要找工程师吗 [#需要找工程师吗]

需要。x-iztro 是一个代码库，不是可以直接打开的软件。

但工作量很小：装上它、写三行调用、把结果接到你们已有的流程里。
一个熟练的后端工程师，做出一个能跑的原型通常在半天以内。

## 要跟工程师说什么 [#要跟工程师说什么]

把下面这几条转给他们就够了：

| 事项    | 内容                                                                            |
| ----- | ----------------------------------------------------------------------------- |
| 仓库    | [github.com/x-haose/x-iztro](https://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 用法 | 调 `chart.to_text()` 拿到盘面文字，直接喂大模型                                             |
| 文档    | [快速开始](/zh/docs/guide/getting-started)、[语义化文本](/zh/docs/guide/guides/to-text) |

<Callout title="时辰索引怎么填">
  不是小时数，是 0–12 的十三个值：0 是早子时（00:00–01:00），
  1 丑时、2 寅时……11 亥时，12 是晚子时（23:00–24:00）。
  对照表见[你需要准备的输入](/zh/docs/guide/getting-started#时辰索引)。

  **23 点以后出生的要填 12，不是 0** —— 这两个值排出的盘不一样。
</Callout>

## 它准不准 [#它准不准]

「准」在这里有一个很具体的定义：**与 JS 版的
[iztro](https://github.com/SylarLong/iztro) 逐字段完全一致**。

iztro 是开源社区里最完整、维护时间最长的紫微斗数排盘实现之一，
不少前端项目在用。x-iztro 把它当作对照基准，
用 716,314 个测试用例逐字段核对 —— 任何一处不一致都当作 bug 修掉。

这句话的**边界**也要说清楚：与 iztro 一致不等于「命理界唯一正解」。
斗数流派众多，不同流派的安星与四化取法本来就不同。
x-iztro 保证的是「在同一套流派取舍下，算得和权威实现一模一样」，
而不是「这套流派取舍就是对的」。

详见[准确性保证](/zh/docs/guide/about/accuracy)。

## MIT 是什么意思 [#mit-是什么意思]

x-iztro 用 MIT 许可证开源。对使用方来说这意味着：

* **可以商用**，不需要付费，也不需要跟作者报备
* **可以闭源使用**：把它装进你们的商业产品里，产品本身不必开源
* **可以修改**
* 唯一的义务是**保留版权声明**（通常放在产品的「开源许可」页面里）
* 作者**不承担任何担保责任**：用出问题是你们自己的事

在开源许可证里，MIT 是限制最少的那一类，法务通常不会有意见。