天衍奇门开放数据:节气对照、局数表与整盘对照(CC0,可下载)

发布于

天衍奇门的排盘规则和验证结果,都写在排盘规则页里。这一页把背后的数据整理成可以直接下载的文件,方便研究者、开发者和其他软件作者核对、引用,或者拿来测试自己的排盘程序。

所有文件以 CC0 1.0(公有领域) 公开:不需要注册、不留邮箱,可以复制、修改和商用,也不需要署名。

三份数据

文件内容行数
solar-terms-vs-hko-2026-2028.csv2026–2028 年 72 个节气:香港天文台公布的时刻、天衍奇门引擎算出的时刻、相差分钟数72
ju-number-table.csv拆补法局数表:24 节气 × 上中下三元,注明阳遁或阴遁24
board-comparison-china95.csv56 个北京时间时刻与元亨利贞网(转盘 + 拆补无闰法)的整盘对照:四柱、局数、值符值使、九宫每格的干星门神56
qimen-open-data.json以上三份合在一起,附来源说明152

CSV 为 UTF-8(带 BOM,Excel 可直接打开中文)。

每份数据怎么读

节气对照。 hko_time_hkt 与 qimena_time_hkt 都是香港时间(UTC+8,和北京时间相同);diff_minutes_qimena_minus_hko 为正,表示我们的引擎比天文台晚。三年 72 个节气全部在 1 分钟以内(天文台只公布到分钟)。注意 qimena_time_hkt 来自我们引擎使用的预先算好的节气时刻表(由 tyme4ts 生成),所以与天文台吻合是预期的;独立的核对是用另一个天文库 astronomy-engine 比对表中 1900–2100 年 4,824 个节气,最大偏差 1.0 分钟,平均 0.2 分钟。香港天文台的时刻来自英国航海历局和美国海军天文台的数据,读取日期为 2026-09-29。

局数表。 第一行冬至,之后依次到大雪;冬至至芒种为阳遁,夏至至大雪为阴遁。三元由当日符头的地支决定:子午卯酉为上元,寅申巳亥为中元,辰戌丑未为下元。

整盘对照。 result 列为 identical 表示四柱、局数、值符值使以及八个外宫每一宫的天盘干、地盘干、九星、八门、八神都与对方完全一致;different 的行附有 first_differences(我们和对方各是什么)和 note(原因)。56 个时刻中 16 个是节气交界与特殊时刻,40 个是随机奇数整点。结果:49 个完全一致,7 个不同,7 个差异的原因都在对方的节气时刻或月柱规则(详见排盘规则页)。

使用时请注意

  • 整盘对照用的是北京时间的钟表时刻,不做真太阳时校正。 这和天衍奇门网页上默认的排盘方式(按起局地经度校正)不同,对照时请按文件里写明的方式起局。
  • 只对照了一个网站。 不同流派的软件(置闰法、飞盘法等)盘面不同,这不一定是谁算错,见流派的选择。
  • 读取时间是 2026 年 10 月。 对方网站今后可能更新规则,本表记录的是当时的输出。

想引用或复现

引用可以写:天衍奇门开放数据(qimena.com/wiki/qimen-open-data/),2026-10-13,版本 1.0。想自己复现整盘对照的做法,把表里任意一个时刻同时输入你的程序和元亨利贞网的转盘奇门(拆补无闰法)比较即可,一个时刻一个盘面,几分钟就能核对完。

如果你发现数据有误,或者你用其他软件得到了不同的结果,欢迎把软件名称、时间和差异发到 [email protected]。想看这些数据怎么用在排盘上,可以试试免费 AI 排盘。

常见问题

这些数据可以随便用吗?

可以。三份数据都以 CC0 1.0 公开,等同放弃著作权,可以复制、修改、商用,不需要署名,也不需要联系我们。如果愿意注明来源,写“天衍奇门开放数据”即可。

怎么用这份数据测试自己的排盘程序?

把你的程序在同样的 56 个北京时间时刻起局,与整盘对照表里的四柱和局数比较;节气表可以用来检验你的节气算法,局数表可以核对拆补法的查表。注意对照时用北京时间的钟表时刻,不做真太阳时校正。

数据是怎么得来的?有没有可能错?

节气时刻对照的是香港天文台公布的时刻,局数表是传统口诀表,整盘对照是在元亨利贞网同一时刻起局后逐项比对。对照网站的结果是我们读取的,不代表它始终如此。发现问题请发邮件到 [email protected],我们核对后更正并记入更正记录。