紫微斗数开源排盘引擎：以代码生成命盘并查询传统术数资料
一分钟看懂
这是一个用 TypeScript 实现的紫微斗数排盘项目，依据仓库所述的倪海厦《天纪》教学体系组织算法、四化规则、格局知识和古籍资料。项目提供可运行的网页示例，并发布按日期、时辰和性别生成的大规模解读数据集。
你可以用它做什么
- 根据出生日期、时辰和地点生成紫微斗数命盘。
- 研究十二宫、主星、四化与格局等排盘规则的代码实现。
- 在自己的应用中复用 TypeScript 排盘引擎。
- 查询项目整理的古籍原文、课程引文和知识数据。
- 下载部分年份或完整解读数据集，用于检索、研究或应用原型。
主要能力
仓库包含历法与真太阳时校正、星曜安置、四化、宫位和格局等排盘逻辑，并配有 Next.js 示例界面。官方说明的数据集覆盖 1950 至 2026 年真实日期、十二时辰和男女组合，并按多个维度输出解读。项目也整理《紫微斗数全书》等传统资料及课程引文，部分内容带出处定位。
适合哪些人
- 研究传统术数数字化与排盘算法的开发者。
- 需要紫微斗数结构化命盘或数据接口的应用制作者。
- 希望核对规则、文献出处和数据格式的研究者。
- 想学习 Next.js、TypeScript 与规则引擎组合方式的人。
怎么开始使用
可先访问在线演示了解输出形式。开发者可以克隆仓库，按 README 的快速开始安装 Node.js 依赖并运行 Next.js 应用；需要嵌入排盘能力时，应从 lib 等核心目录核对公开接口。大型数据集按年份提供下载，建议先选少量年份验证磁盘、解压和处理流程。
使用前需要知道
紫微斗数属于传统文化与占术体系，不是经科学验证的预测、医疗、法律或财务决策工具，输出应仅作文化研究或娱乐参考。仓库代码采用 MIT 许可证，但数据集、古籍与课程引文适用不同条款，其中部分内容限制商业用途，使用前必须逐项阅读许可证。完整数据解压后体积很大，处理时需要足够存储与计算资源；项目也说明部分断语库并未开源。