# iztro - 紫微斗数排盘 JavaScript 开源库

> 轻量级紫微斗数排盘工具包，TypeScript 编写，支持完整星盘、四化、大限流年、多语言，3.7k Star

## iztro — 紫微斗数排盘 JavaScript 库

[iztro](https://github.com/SylarLong/iztro) 是一个轻量级的紫微斗数排盘工具包，用 TypeScript 编写，支持浏览器和 Node.js 双端运行。

### 核心特性

- **完整排盘**：支持紫微斗数十二宫、主星辅星、四化、大限流年流月流日全套排盘
- **多语言**：内置中文简/繁、英文、韩文、日文、越南文等语言包
- **星曜亮度**：支持庙、旺、得、利、平、不、陷七级亮度
- **四化飞星**：天干四化、宫干四化完整计算
- **大限流年**：大限、流年、流月、流日多层时间推算
- **TypeScript**：完整类型定义，开发体验友好
- **多框架适配**：React / Vue / 小程序均有示例

### 快速上手

```bash
npm install iztro
```

```typescript
import { astro } from "iztro";

const astrolabe = astro.bySolar("2000-8-16", 2, "M", true);
// 获取命宫
console.log(astrolabe.palace(0));
// 获取所有星曜
console.log(astrolabe.stars());
```

### 为什么推荐

做玄学相关的 AI 项目（排盘、命理分析、风水应用）时，iztro 是目前开源社区里最成熟、最完整的紫微斗数 JS 库。API 设计清晰，数据结构规范，适合二次开发。配合 LLM 做智能解读也很方便——拿到星盘 JSON 直接喂给模型即可。

项目持续维护，文档完善，社区活跃。作者 SylarLong 对星曜算法做了大量考据校验，排盘精度可靠。

---

**分类**：源码
**标签**：紫微斗数 · 排盘 · iztro
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1699