解读：ziwei-doushu——倪海厦《天纪》系开源紫微排盘引擎与解读数据集

#紫微斗数
#开源
#TypeScript
#数据集
#解读

本文是对开源项目 ziwei-doushu（在线体验 metisziwei.com）的摘要与评论。抓取时仓库约 ★8181、forks≈1643；语言 TypeScript；最新相关 Release v4.0-13d（约 2026-10-15）。插图为 GitHub 社交预览；算法与许可细节以仓库 README 为准。

阅读提示：紫微斗数属传统命理文化与趣味研究范畴，不是科学预测、医疗或人生决策依据。下文谈开源工程与数据许可，不提供「算命服务」结论。

这篇在说什么

口号：算法是公开的传统智慧，不应该被锁在围墙里。项目基于倪海厦《天纪》教学体系，开源排盘算法、四化、格局知识库、古籍原文数据，并发布大规模解读数据集；线上 AI 解读产品与完整商业 UI 不在开源包内（仓库界面是 Demo）。

对开发者而言，它首先是一个 TypeScript 排盘内核：给定出生信息，按可配置口径排出命盘结构。对研究者与产品冷启动而言，它又附带海量断语文本。两者许可不同，读仓库时要把「引擎」和「数据集」分开看。

排盘引擎亮点

内核在 lib/ziwei/，相对「只安星」的库，README 强调：真太阳时（经度 + 均时差）、中国夏令时区间；闰月 / 晚子时多种口径可配置；星曜亮度多档、流派可切换（2026-10-20 起默认改为《斗数全书》口径）；生年四化、大限/流年四化与飞星；十二神煞；1100+ 行格局规则库；合盘方法论数据、城市经纬度表、骨髓赋 / 《全书》等古籍文本模块。

本地可 npm run typecheck / npm test（含大量回归盘）；开源版不含后端 API——排盘在浏览器跑，不需 Key；AI 解读接口需自建。把「口径差异」做成配置，比写死一派更适合二次开发与对照主流软件：你可以用同一引擎切换假设，而不是 fork 出五份互不相通的代码。

解读：命理软件最容易吵的不是「有没有排盘」，而是闰月、子时、亮度、夏令时到底跟哪一派。配置化是工程上诚实的做法——争议被暴露成选项，而不是被藏进硬编码。

v4.0 解读数据集与许可分层

Release v4.0-13d：约 674,976 张命盘（1950–2026 真实日期 × 12 时辰 × 男女）× 13 维 ≈ 877 万段解读，解压约 56.6 GB（压缩包按年拆分，可按需下载）。断语按倪师原话与《全书》做过一轮校正；亮度相关句可能与 10-20 后的新默认流派不完全一致（README 已注明）。

许可拆分要看清：代码是 MIT；解读数据集是 CC BY 4.0（可商用，须署名）；倪师《天纪》原话语料是 CC BY-NC-SA 4.0（不可商用）；《紫微斗数全书》等公版表述见仓库。数据集里引用的倪师原话不在数据集商用授权范围内。做产品时最怕的就是「看见 CC BY 就整包商用」——原话语料那一层必须单独处理。

怎么看

这是「文化算法开源 + 大数据断语」组合：引擎给开发者，数据集给研究/产品冷启动，运营与深度解读留给站点。使用时尊重许可分层，并把输出当文化文本而非命运判决。六亲等维度官方也引用倪师观点提示局限。对 Vigenz 读者，更有用的切法也许是：看一个传统文化领域如何把「口径可配置 + 回归测试 + 数据许可分层」做进开源工程，而不是把仓库当成算命入口。

完整能力表、开源边界与下载见仓库。在线 Demo 可先感受排盘，再决定是否拉取数据集；数据集体积大，按年下载通常比一口气拉满更理性。

完整能力表与最新变更仍以仓库 README 为准；本文只做摘要与评论。