跳到正文
春节 −50%团圆仅 99,500 越南盾 首年团圆首年仅 99,500 越南盾, 每年赠 1 份个人解读查看优惠

Blog

Nhat Nguyet 用哪些方法检验数据与计算?

各科测试用例数:农历 14,936、八字 777、紫微 777、生命灵数 600、节日 201

Nhat Nguyet 的每一个数字都出自单一的事实来源,即原始计算核心,再经过五层检验:外部对照、不变量、变异测试、通用于各编程语言的测试用例,以及带散列的发布。 测试用例目前共 17,291 个;2026 年 11 月 19 日,TypeScript 与 Python 两版全部通过。这里所说的“科学基础”,是指任何人都能复核的做法,而不是保证术数会算准。

单一事实来源,多层检验
单一事实来源,多层检验

“单一事实来源”是什么意思?

  • 以 Go 编写的计算核心每天运行于 nhatnguyet.org 与 App,它就是来源。TypeScript 与 Python 库是移植版本,不自行设定答案。
  • 文章中的查询表由计算核心生成,从不手打,所以文章里的表与工具的结果是同一份。
  • 测试用例由计算核心机器生成,不手改。 某个用例不一致而怀疑原答案有误时,不改用例去迁就,而是记录并报告。

测试用例包括什么?

科目用例数内容
农历、节气14,936公历转农历 11,039、农历转公历 3,696、201 年的二十四节气时刻;含 UTC+8、UTC+9 用例
八字777四柱、藏干、十神、十二长生、神煞、大运、2026 年流年
紫微777局、命宫、身宫、所有星曜、四化、旬截、大限、2026 年流年、格局
生命灵数600按姓名与生日的档案,流年 2026
节日201每个农历与公历节日的公历日期,1900 至 2100 年每年一例
合计17,291

比较方法:逐字段深度比较,跳过说明文字字段;浮点误差不超过 1e-9;数组按顺序比较;原版有的字段移植版必须有,反之亦然。

为什么必须是确定性的?

同样的输入必须得到同样的字节,否则无从比较。 代码不读系统时间,流年固定为 2026,抽样用固定种子。因此约 360 万张命盘的论断重跑逐字节一致,任何下载者都能复核。

不变量测试能抓到测试用例抓不到的什么?

测试用例只说明两个版本一致;不变量说明原版与某个独立事实一致。 期望值由规则或古籍推出,而不是照抄被测的表:

  • 六十四卦:八卦按朱熹的口诀;六十四卦的序号、汉名、上下卦与八宫依《周易本义》中的两首歌诀;错、综、互、变卦以位运算求出;文王三十二对卦。
  • 历法:只用 NASA 与 IMCCE 数据重建农历,再与计算核心比较,2,461 个月中 2,459 个一致(见农历与二十四节气)。
  • 干支:1900 至 2100 年每一天六十甲子都不断;二十八宿与星期锁定(见干支与循环)。
  • 紫微:以扫描命盘守住《全书》六格“不可能出现”的结论(见《全书》的格局)。

变异测试用来做什么?

用来确认数据错了测试一定会失败。 从未失败过的测试,可能什么都没测。对六十四卦的各张表,我们逐一故意改坏,确认测试都能抓到;生命灵数的测试会放入错误答案,确保比较不会悄悄放过不一致。

带散列的发布与 DOI 是什么?

  • 每次开放数据发布都有一个发布码:日期加清单 sha256 散列的前八位,如 2026.10.27-cd6fca71。内容相同则发布码相同,不论哪天构建。
  • 每个文件在清单中都有自己的 sha256。 已发布的版本不会被覆盖;数据变动即为新版本。
  • 33 个数据集有概念 DOI 10.5281/zenodo.23009396,已登记于 Wikidata(Q141589952),可在开放数据页面下载。
  • 模型档案随每次发布附上:公式、对照文件及其 sha256、实测误差。

为什么“行数数得到”不等于“正确”?

因为一项检查只能抓到作者想到过的错误。 三次失足,均已修正,让我们明白了这一点:

  • 有竖线的行不一定是表格。 2026 年 9 月的一次审查把读者只看到一块文字的文章算作“有表格”:缺分隔行的表、被格内换行切成两半的表、紧挨着被合并成一张的两张表。共 22 篇文章,三种语言皆有;最初的检查只量“有没有分隔行”,报告干净,而 12 篇仍然表格错乱。
  • 表格对了,文句却错了。 “表格由计算核心生成”的规则守住了表格,但像“大泽土是乙未与庚子的纳音”这样的句子不是表格;同月的审查在 30 篇中的 18 篇正文里找到 40 处纳音错误。现在正文也与计算核心对照。
  • 表里有那一栏,不等于那一栏被用上。 有五处彼此独立的地方,译文就在表里,读表的函数却从未返回;只有量输出才看得出来。

所以我们量输出、在真实页面上量,并从预想之外的另一个方向再量一次,而不是相信源代码。已修正与仍在处理的问题列在更正页面。

您如何自行复核?

开放数据农历、干支、节庆数据集,CC BY 4.0 许可。立即试用

转用本文数字请注明:数据:Nhat Nguyet(nhatnguyet.org)。

博客中的更多文章

全部博客文章