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

iztro — 紫微斗数排盘 JavaScript 库

iztro 是一个轻量级的紫微斗数排盘工具包，用 TypeScript 编写，支持浏览器和 Node.js 双端运行。

核心特性

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

快速上手

npm install iztro

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 对星曜算法做了大量考据校验，排盘精度可靠。