开源项目 ziwei-doushu:6.5K Star 的紫微斗数开源排盘引擎,用 TypeScript 把倪海厦《天纪》装进代码
ziwei-doushu
传统文化 × 严谨工程 × 开源数据集:完整的紫微斗数排盘算法 + 877 万段解读的开源数据集
项目速览
项目 内容 仓库 Renhuai123/ziwei-doushu(在线体验 metisziwei.com) 定位 紫微斗数开源排盘引擎 + 解读数据集 主要语言 TypeScript(Next.js 站点) Stars / Forks 6,584 / 1,351(截至 2026-10-23) 许可证 代码 MIT / 数据集 CC BY 4.0(倪师原话 CC BY-NC-SA 4.0)
它想解决什么问题
GitHub 上从来不缺”玄学开源”,但绝大多数是玩具。ziwei-doushu 是另一个物种:它基于倪海厦《天纪》教学体系,实现了完整的紫微斗数排盘算法、四化系统、格局知识库、古籍原文数据——还顺手发布了一个 67.5 万张命盘 × 13 维 = 877 万段解读的开源数据集。6,584 Star 见证了这个项目的独特生态位:传统文化 × 严谨工程 × 开源数据集。
排盘引擎:把术数做成工程
术数类项目最容易糊弄,这个项目的较真程度却令人意外:
- 完整的排盘算法:十二宫安星、四化系统、格局判定;
- 真太阳时校正:内置中国夏令时数据库(chinaDSTSpan(year) 可查任意年份的夏令时起止),城市库补全了省直辖县级单位与新疆兵团各市的经度——出生地选到神农架、阿拉尔这些地方都能算;
- 流派可配置:星曜亮度默认《斗数全书》,与主流排盘软件一致,同时保留”现代修正 v2”可选;
- 拒绝假日期:引擎会拒绝不存在的公历日期;
- 用金标准盘验收:星曜落宫与亮度用 5 张金标准盘逐宫核对。
这些细节说明作者明白:术数可以存疑,工程不能糊弄。
v4.0 数据集:877 万段解读
2026-10-15 发布的 v4.0 解读数据集是项目的重头戏:67.5 万张命盘 × 13 维,共 877 万段解读文本,以 CC BY 4.0 发布——对研究 NLP 生成、传统文化知识工程的人来说,这是一个罕见规模的中文垂直领域数据集。
点评
亮点:工程严谨度在同类项目里断层领先——夏令时库、真太阳时、金标准盘验收,每一个都是”认真做事”的标志;MIT 代码 + CC BY 数据集的组合对研究者和产品开发者都友好;把倪海厦教学体系数字化本身就有文化保存价值。
局限:命理内容的文化与科学定位需理性看待,数据集解读文本的版权层级(CC BY 与 NC-SA 混合)使用时要区分;项目维护依赖个人作者。
适合人群:对术数数字化感兴趣的工程师、需要中文长文本垂直数据集的 AI 研究者、以及所有欣赏”把冷门领域做成认真工程”的开发者。
评论