当传统术数遇上开源：ziwei‑doushu，把紫微斗数算法还给大众
项目地址：https://github.com/Renhuai123/ziwei‑doushu
在互联网上，紫微斗数相关工具数不胜数，但绝大多数都是黑盒产品：排盘逻辑闭源、算法不透明，底层规则无从考证，想要做二次开发、学术研究，只能调用第三方付费接口。而 ziwei‑doushu 的出现，打破了这一局面：一套完整、可商用、浏览器本地运行的紫微斗数排盘开源引擎，将传统命理的计算逻辑公开给每一位开发者与爱好者TimeShinin...。
项目缘起：算法不该被锁在围墙之内
ziwei‑doushu 以倪海厦《天纪》的斗数体系作为基准，使用 TypeScript 完整复刻实现整套排盘逻辑，项目核心理念是：算法是公开的传统智慧，不应该被锁在围墙里TimeShinin...。
很多人对紫微斗数的印象停留在玄学娱乐层面，但这套数术背后，包含复杂的历法换算、安星规则、四化飞星、格局判定。过往很多网页排盘工具，底层实现参差不齐，晚子时换日、真太阳时校正、闰月处理、夏令时扣除这些历史历法细节经常处理错误，不同网站同一份出生时间，排出来的命盘却不一样，让爱好者十分困扰。
该项目希望解决这个痛点：把排盘计算逻辑完全开源，有争议的规则做成可配置开关，开发者可以对照古籍校验每一步计算，也可以按需切换不同流派的口径，不再依赖黑盒第三方服务。
核心能力：不止简单排盘
技术栈采用 Next.js + TypeScript + Tailwind CSS，底层排盘能力基于 iztro、lunar‑javascript 库，整套排盘运算全部在浏览器本地完成，不需要后端服务、不需要密钥，用户的生辰数据不会上传服务器，在隐私保护上有天然优势。
主要功能特性
- 完备排盘计算 支持真太阳时校正、夏令时扣除、晚子时换日逻辑，闰月规则可配置；完整实现十二宫安星、庙旺落陷亮度判定、四化飞星、大限小限流年流月流时运限推演，兼容主流斗数计算口径。
- 格局与知识库内置 仓库内置大量格局判定规则、星曜释义、古籍原文参考资料，不仅仅输出原始星盘 JSON 数据，同时附带结构化的领域知识库，便于做后续解读开发TimeShinin...。
- 大规模公开数据集（v4.0） 项目附带 CC‑BY‑4.0 协议的大型命盘解读数据集：67.5 万张命盘，13 个解读维度，合计 877 万段解读文本，解压后约 56.6GB。这份数据集可以直接用于 AI 大模型微调、学术统计研究，允许商用，是非常难得的中文传统术数语料库TimeShinin...。
重要提示：开源仓库本身不包含 AI 解读后端接口。界面上的 AI 解读、合盘分析接口需要开发者自行对接大模型实现，项目只提供 prompt 参考模板与知识库素材，开箱没有 AI 解读能力，不要误解为拿到仓库就可以直接 AI 算命。
协议与适用人群
- 代码主体使用 MIT 协议，数据集为 CC‑BY‑4.0，允许商业使用、二次修改、二次分发，只需要保留协议声明即可。
这个项目主要面向三类人群：
- 开发者：想要开发紫微斗数网页、小程序、工具，需要可靠的排盘底层，不想采购付费 API；
- 传统文化研究者：需要可复现的排盘逻辑，做统计、文献比对研究；
- 斗数爱好者：希望看懂排盘底层逻辑，对比不同流派规则，自己调试参数验证命盘。
它并不适合只想点开就获得 AI 算命结果的普通用户，AI 解读能力需要自行开发对接。
快速上手部署
本地运行非常简单，需要 Node.js 环境：
# 拉取代码
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei‑doushu
# 安装依赖
npm install
# 启动开发服务
npm run dev
同时内置质量校验脚本：
npm run typecheck # TypeScript类型检查
npm test # 768组命盘回归测试，校验排盘正确性
运行测试脚本可以校验修改代码之后排盘逻辑是否出现错误，保证修改后结果可靠。
理性看待：开源工具不等于 “预知命运”
ziwei‑doushu 开放的是历法与排盘计算算法，而不是所谓 “预测未来”。紫微斗数属于中国传统民俗文化，项目只是把古人的一套符号体系转化为可运行的计算机代码。
算法能精确算出星盘位置，但命盘的解读、人生的抉择，并没有标准答案。数据集只是历史整理出来的传统文本素材，不能当作现实生活的判断依据。我们可以把它当做一份数字化传统文化标本，用于学习、研究、技术实践，切勿过度迷信命理结果。
写在最后
长久以来，很多传统民俗文化在数字化的过程中被封闭在商业产品内部，底层逻辑不透明。ziwei‑doushu 的价值，在于把一份传统数术的计算逻辑还给公众：代码公开、规则可校验、数据可商用，让技术回归工具本身。
不管你是前端开发者想要研究历法算法，还是传统文化爱好者想钻研斗数底层逻辑，这个开源项目都提供了一个值得把玩与研究的范本。
注：本文仅介绍开源技术项目，不宣扬封建迷信。