📌 项目地址：Renhuai123/ziwei-doushu | ⭐ 6,793 颗星 | 🔧 TypeScript | 📜 未标注
项目地址：Renhuai123/ziwei-doushu | 6,793 星 | TypeScript | 代码 MIT / 数据 CC BY 4.0
先说最抓眼球的部分：数据
这个仓库最出圈的资产是一份数据集。v4.0 版（2026-10-15 发布）把公历 1950 到 2026 年所有真实存在的日期，乘以 12 个时辰，再乘以男女两种情况，穷举出 674,976 张命盘。每张盘附 13 个维度的解读，合计 877 万段、约 204 亿字，解压后 56.6 GB。
数字看着吓人，压缩后只有 161 MB，而且按年份拆成 77 个文件。你只需要某几年的数据就只下那几年，不用一次拖 56 GB。下载入口在 Release v4.0-13d。
发布前他们做了一件事：77 个文件逐个解压，和原始数据做逐字节比对，确认一致后才放出。发布流程做到这个程度的数据集不多见。
想先看效果的话，直接上 metisziwei.com，排盘、AI 解读、命盘历史都开放，不用自己部署。
v4.0 真正的价值：逐句校正，不是堆量
和 v3.0 比，盘数多了 30%，字数多了 44%，但我觉得这轮更新的重点在质，不在量。README 里列的几条校正，条条都指向同一个原则：每句话要能查证。
引文可溯源。 之前标着倪海厦或《紫微斗数全书》却查不到出处的引文，要么删掉，要么换成逐字可查的原话。倪师原话还注明《天纪》第几集、几分几秒。
删掉不可能发生的四化。 七杀化权、紫微化忌这类根本不会出现的四化，对应的句子全部删去。只在特定条件下才成立的断语，补上了条件。
消灭两头话。 “力量强时如何、落陷时如何”这种怎么解释都对的句子，改成按具体命盘只显示成立的那一种。这一条对文本语料的价值很大：两头话是术数文本的通病，处理过这类数据的人都知道它有多难清洗。
健康判断换了逻辑。 按倪师的看法，取全盘杀星最集中的那一宫，按它的地支对应脏腑，不再按星的五行推脏器。
古籍引证从 244 处增加到 405 处，每处都能在《紫微斗数全书》原文里逐字找到。
排盘引擎本身
代码是一个 TypeScript 写的紫微斗数排盘引擎，基于倪海厦《天纪》教学体系，包含完整排盘算法、四化系统、格局知识库和古籍原文数据。仓库自带的界面只是一份 Demo，不是线上那套，差距在 README 第六章写明了。
本轮引擎同步（PR #39）有两个实用改动：
dst-cn.ts新增chinaDSTSpan(year)，查某年中国夏令时的起止。排 1986 到 1991 年间出生的盘时，夏令时会直接影响时辰判断，这个细节很多排盘工具会漏。cities.ts补全了省直辖县级单位和新疆兵团各市的经度（神农架、海南各市县、阿拉尔等），出生地在这些城市时，真太阳时校正可以用了。
必须搞清楚的边界
许可证分三层。 代码 MIT，数据集 CC BY 4.0，古籍原文公版。但解读里引用的倪师原话是 CC BY-NC-SA 4.0，非商用，而且明确写在数据授权范围之外。想拿这份数据做商业用途，这条线必须先划清楚。
断语库不开源。 v4.0 数据集是校正后的产出，但生成断语的断语库本身不在开源范围内，README 第七章专门写了什么开、什么不开。
六亲判断的局限。 项目自己写得很坦率，直接引了倪师原话：“斗数批六亲本来就比较差一点。”（《天纪》2上 00:25:27）父母、兄弟、子女三个维度的解读仅供参考，线上站点也附了同样的说明。一个术数项目主动标注自己方法论的短板，这在同类项目里不常见，反而是可信度的加分项。
适合谁
三类人各有各的拿法。研究排盘算法实现的，读 TypeScript 源码；要做文本分析或语料研究的，56.6 GB 带出处标注的解读文本是现成材料；学《天纪》体系的人，仓库第五章收录了 14 讲加 2 段补充、共 1848 条原话，每条都标了集数和可回放的时间点。
纯粹想算个命的，用 metisziwei.com 就够了，没必要下 56 GB。