204 亿字的命盘解读开源了：67.5 万张紫微斗数盘，56.6 GB 数据可商用

摘要：紫微斗数开源排盘引擎 ziwei-doushu 发布 v4.0 解读数据集：674,976 张命盘 × 13 个维度，共 877 万段解读、约 204 亿字，按 CC BY 4.0 开放商用。今日新增 546 星。

一个传统术数项目，今天在 GitHub Trending 上拿到了单日 546 星。Renhuai123/ziwei-doushu 做的事情说起来很朴素：把紫微斗数的排盘规则写成代码，再把基于倪海厦《天纪》体系的解读文本全量生成、打包、开源。

真正让这个仓库显眼的是数据集的量级。v4.0 解读数据集于 2026 年 10 月 15 日发布：674,976 张命盘，每张盘 13 个分析维度，合计 8,774,688 段解读，正文约 204 亿字。解压后 56.6 GB，压缩后只有 161 MB——按年份切成 77 个 zstd 文件，只需要某一年的数据就下那一年，不必拖整个包。命盘覆盖公历 1950 至 2026 年的每一个真实日期，乘以 12 个时辰和男女两种性别，每张盘的解读约 3.0 万字。

不含 AI 的”生成式”内容

这份数据最有意思的地方是它的生成方式：排盘引擎加断语库，确定性生成，完全不经过大模型。同一个输入永远得到同一个输出。在一个什么都往 LLM 上靠的时间点，这种”可复现”反而成了稀缺属性——你可以拿它做基准数据、做检索、做评估，而不用担心答案每次都变。

数据以 JSON Lines 存储，一行一张盘。字段设计得很克制：k 是 YYYY-MM-DD-时辰序号-性别 形式的键，y/m/d 是公历日期（只包含真实存在的日期，不会出现 2 月 30 日这种脏数据），h 是 0 到 11 的时辰序号而非钟点，ms 记录命宫第一颗主星（命宫无主星时为 null），c 装着 13 个维度的解读全文。

13 个维度分别是：命格总览、性格、感情、事业、财运、健康、兄弟、子女、迁移、人际、田宅、福德、父母。

断语是怎么校准的

v4.0 相对上一版的核心工作不是”多生成”，而是”逐句核对”。项目按《天纪》逐字稿和《紫微斗数全书》原文过了一遍断语库：

• 标注了倪师或《全书》却查不到出处的引文，删掉或替换成逐字可查的原话，并注明出自《天纪》第几集、几分几秒；
• 不会发生的四化（比如七杀化权、紫微化忌）相关句子直接删去，只在特定条件下成立的断语补上条件；
• 原本”力量强时……落陷时……”两头都说的句子，改为按命盘只呈现成立的那一种；
• 健康维度改按倪师的思路走——取全盘杀星最集中的那一宫，按它的地支对应脏腑，不再按星曜五行推脏器；
• 网站知识库的”古籍引证”从 244 处增加到 405 处，每一处都能在《紫微斗数全书》原文里逐字找到。

10 月 20 日还有一条补充：星曜亮度默认值改成《斗数全书》口径，与主流排盘软件一致，此前默认的”现代修正 v2”仍可在流派设置里切换；补齐了天姚、天刑、天喜、大耗、解神、截空、副截、旬空的亮度。项目用 5 张金标准盘逐宫核对，星曜落宫与亮度全部吻合。也就是说，10 月 15 日那版数据集是按旧默认生成的，其中亮度字和少量随亮度变化的解读句会与新默认不同——这种把偏差写在明处的做法，比宣称”绝对正确”更可信。

引擎侧：把历法难点啃下来

排盘的正确性大量依赖历法细节，这部分的工程量藏在 src 里：真太阳时校正（经度差加均时差）、中国 1986 至 1991 年夏令时区间查表、农历与公历互转及闰月边界 clamp、十二神煞、含童限的运限上下文。10 月的这次更新还补全了省直辖县级单位与新疆兵团各市的经度，出生地选这些城市时真太阳时校正才算可用。

两年前这个仓库一行测试都没有，现在有 5 条排盘回归测试，npm test 一条命令跑完，每次 push 和 PR 都在 GitHub Actions 上自动执行。

边界写得很清楚

许可证是分层的：排盘代码 MIT，解读数据集 CC BY 4.0 可自由商用（唯一要求是保留来源标注），古籍原文属公有领域，而解读里引用的倪海厦原话单独走 CC BY-NC-SA 4.0，不随数据集授权。断语库本身不开源——开源的只有引擎、古籍数据和生成结果。

放在中文开源数据的语境里看，这类项目正在形成一种新模式：把某个垂直领域的专家知识，用确定性程序 + 全量数据的方式固化下来，然后整体开源。它不追求”AI 解读命盘”那种新鲜感，而是把可核对、可复现、可商用这三件事做到位。对做中文垂直数据集的人来说，这份 56.6 GB 的样本，比它的星数更值得研究。

仓库地址：https://github.com/Renhuai123/ziwei-doushu