跳到正文

开放代码与数据

Nhat Nguyet:紫微斗数、八字、数字命理的开源代码与开放数据

JavaScript、Python 程序库与开放数据,用于排命盘、换算农历、查黄道吉时、查节庆与祭文。面向产品开发、研究与人工智能工作者。

  • 360万份紫微、八字、数字命理命盘解读
  • 373份古籍全文,共7270万字
  • 2,669段古籍原文,收于三套知识数据集
  • 510篇知识文章
  • 33套带 DOI 的数据集
  • 456篇祭文
  • 206个越南节庆
  • 4种农历:越南、中国、韩国、日本
  • 17,291个测试用例全部通过
构建流程:从来源到使用者来源: NASA、IMCCE 天文数据; 373 份古籍全文; 510 篇知识文章; 206 个节庆; 456 篇祭文. 计算: 4 国农历; 24 节气与干支; 紫微、八字 安星、四柱; 数字命理 越南姓名; 2,669 段古籍原文(知识数据集). 核验: 17,291 个测试用例全部通过; 0.9 分钟 朔日较 NASA 平均晚; 0.27 分钟 交节与 IMCCE 相差; SHA-256、DOI 每个文件有哈希. 发布: npm、PyPI 13 个 npm 包,1 个 Python 包; GitHub MIT 源代码; 33 套数据集,Zenodo DOI; 360万 份命盘,Hugging Face. 应用: 应用程序 日历、命盘; 网站 查询工具; 人工智能 训练、引用; 研究 统计、历法比较1. 来源NASA、IMCCE天文数据373份古籍全文510篇知识文章206个节庆456篇祭文2. 计算4国农历24节气与干支紫微、八字安星、四柱数字命理越南姓名2,669段古籍原文(知识数据集)3. 核验17,291个测试用例全部通过0.9 分钟朔日较 NASA 平均晚0.27 分钟交节与 IMCCE 相差SHA-256、DOI每个文件有哈希4. 发布npm、PyPI13 个 npm 包,1 个Python 包GitHubMIT 源代码33套数据集,Zenodo DOI360万份命盘,Hugging Face5. 应用应用程序日历、命盘网站查询工具人工智能训练、引用研究统计、历法比较构建流程:从来源到使用者来源: NASA、IMCCE 天文数据; 373 份古籍全文; 510 篇知识文章; 206 个节庆; 456 篇祭文. 计算: 4 国农历; 24 节气与干支; 紫微、八字 安星、四柱; 数字命理 越南姓名; 2,669 段古籍原文(知识数据集). 核验: 17,291 个测试用例全部通过; 0.9 分钟 朔日较 NASA 平均晚; 0.27 分钟 交节与 IMCCE 相差; SHA-256、DOI 每个文件有哈希. 发布: npm、PyPI 13 个 npm 包,1 个 Python 包; GitHub MIT 源代码; 33 套数据集,Zenodo DOI; 360万 份命盘,Hugging Face. 应用: 应用程序 日历、命盘; 网站 查询工具; 人工智能 训练、引用; 研究 统计、历法比较1. 来源NASA、IMCCE天文数据373份古籍全文510篇知识文章206个节庆456篇祭文2. 计算4国农历24节气与干支紫微、八字安星、四柱数字命理越南姓名2,669段古籍原文(知识数据集)3. 核验17,291个测试用例全部通过0.9 分钟朔日较 NASA 平均晚0.27 分钟交节与 IMCCE 相差SHA-256、DOI每个文件有哈希4. 发布npm、PyPI13 个 npm 包,1 个 Python 包GitHubMIT 源代码33套数据集,Zenodo DOI360万份命盘,Hugging Face5. 应用应用程序日历、命盘网站查询工具人工智能训练、引用研究统计、历法比较
构建流程:从来源到使用者

科学依据在哪里?

在于做法,而不在于预测。

  • 历法是天文计算:朔日与 NASA 核对,二十四节气与 IMCCE(巴黎天文台)核对,范围 1900 至 2100 年。
  • 结果确定,可复核:TypeScript 与 Python 版本在全部 17,291 个测试用例中逐字段与原始计算核心一致。
  • 标明各派分歧并可切换:闰月、子时、庚干四化、火铃。程序库注明所依之书;可改用另一部书的规则,每个选项都有专门的测试用例。
  • 有一篇技术论文说明历法计算:方法、误差预算、与 NASA、IMCCE、JPL DE440 的核对,并解释越南与中国农历不同的每一天。
  • 证据等级:紫微、八字、数字命理是各流派的规则,尚未经过科学验证。
深度:从日月位置到解读紫微斗数: 1. 日月 (真实天体位置): 朔日较 NASA 平均晚 0.9 分钟; 2. 农历 (按越南时间 UTC+7): 14936 个历法测试用例; 3. 干支 (年、月、日、时): 1900 至 2100 年共 73414 天; 4. 命盘 (五行局、命宫、身宫、十四主星、辅星、庙旺利陷、四化、旬空截空): 777 张命盘逐字段一致; 5. 大限、流年 (流年流曜): 十二大限,每限十年; 6. 格局 (依《紫微斗数全书》): 可建 24 格,6 格证明不可能成立; 7. 古籍原文 (与命盘对应): ziwei-knowledge 收录 885 段; 8. 解读 (13 部分,三种语言): 360万份命盘解读. 八字: 1. 节气精确到分: 与 IMCCE 平均差 0.27 分钟; 2. 四柱: 年柱换于立春,月柱换于交节; 3. 藏干、十神: 777 张命盘逐字段一致; 4. 大运: 每运十年; 5. 古籍原文: 出自 7 部古籍.紫微斗数1日月真实天体位置朔日较 NASA 平均晚 0.9 分钟2农历按越南时间 UTC+714936 个历法测试用例3干支年、月、日、时1900 至 2100 年共 73414 天4命盘五行局、命宫、身宫、十四主星、辅星、庙旺利陷、四化、旬空截空777 张命盘逐字段一致5大限、流年流年流曜十二大限,每限十年6格局依《紫微斗数全书》可建 24 格,6 格证明不可能成立7古籍原文与命盘对应ziwei-knowledge 收录 885 段8解读13 部分,三种语言360万份命盘解读八字1节气精确到分与 IMCCE 平均差 0.27 分钟2四柱年柱换于立春,月柱换于交节3藏干、十神777 张命盘逐字段一致4大运每运十年5古籍原文出自 7 部古籍深度:从日月位置到解读紫微斗数: 1. 日月 (真实天体位置): 朔日较 NASA 平均晚 0.9 分钟; 2. 农历 (按越南时间 UTC+7): 14936 个历法测试用例; 3. 干支 (年、月、日、时): 1900 至 2100 年共 73414 天; 4. 命盘 (五行局、命宫、身宫、十四主星、辅星、庙旺利陷、四化、旬空截空): 777 张命盘逐字段一致; 5. 大限、流年 (流年流曜): 十二大限,每限十年; 6. 格局 (依《紫微斗数全书》): 可建 24 格,6 格证明不可能成立; 7. 古籍原文 (与命盘对应): ziwei-knowledge 收录 885 段; 8. 解读 (13 部分,三种语言): 360万份命盘解读. 八字: 1. 节气精确到分: 与 IMCCE 平均差 0.27 分钟; 2. 四柱: 年柱换于立春,月柱换于交节; 3. 藏干、十神: 777 张命盘逐字段一致; 4. 大运: 每运十年; 5. 古籍原文: 出自 7 部古籍.紫微斗数1日月真实天体位置朔日较 NASA 平均晚 0.9 分钟2农历按越南时间 UTC+714936 个历法测试用例3干支年、月、日、时1900 至 2100 年共 73414 天4命盘五行局、命宫、身宫、十四主星、辅星、庙旺利陷、四化、旬空截空777 张命盘逐字段一致5大限、流年流年流曜十二大限,每限十年6格局依《紫微斗数全书》可建 24 格,6 格证明不可能成立7古籍原文与命盘对应ziwei-knowledge 收录 885 段8解读13 部分,三种语言360万份命盘解读八字1节气精确到分与 IMCCE 平均差 0.27 分钟2四柱年柱换于立春,月柱换于交节3藏干、十神777 张命盘逐字段一致4大运每运十年5古籍原文出自 7 部古籍
深度:从日月位置到解读
4824 个交节时刻与 IMCCE 的误差:2026 年 11 月 19 日前后平均 0.27 分钟 (此前:4.2); 95% 以内 0.6 分钟 (此前:9.7); 最大 0.9 分钟 (此前:14.4). 自 2026 年 11 月 19 日起: -2…0: 2565; 0…2: 2259. 2026 年 11 月 19 日前: -16…-14: 8; -14…-12: 53; -12…-10: 138; -10…-8: 397; -8…-6: 603; -6…-4: 845; -4…-2: 893; -2…0: 821; 0…2: 544; 2…4: 338; 4…6: 126; 6…8: 52; 8…10: 6.平均0.27 分钟此前:4.295% 以内0.6 分钟此前:9.7最大0.9 分钟此前:14.42026 年 11 月 19 日前自 2026 年 11 月 19 日起01,0002,000−16−12−8−40481216与 IMCCE 相差分钟(负值为偏早);柱:时刻数交节日期与 IMCCE 不同:此前 10 个,现在 0 个
4824 个交节时刻与 IMCCE 的误差:2026 年 11 月 19 日前后数据来源:IMCCE(巴黎天文台),1900 至 2100 年 4824 个交节时刻,每 2 分钟一组。自 2026 年 11 月 19 日起交节时刻按 VSOP87D 理论推算,所有时刻与 IMCCE 相差均不到一分钟。

深入阅读

越南农历与中国农历不同

1900 至 2100 年间有 2,814 天按越南时间与北京时间的农历日期不同。有 10 年春节日期不同,最明显的是 1985 年:越南1月21日过年,中国2月20日。

1900 至 2100 年越南时间与北京时间春节不同的 10 年1903: VN 1月28日, CN 1月29日; 1916: VN 2月3日, CN 2月4日; 1935: VN 2月3日, CN 2月4日; 1965: VN 2月1日, CN 2月2日; 1968: VN 1月29日, CN 1月30日; 1969: VN 2月16日, CN 2月17日; 1985: VN 1月21日, CN 2月20日; 2007: VN 2月17日, CN 2月18日; 2030: VN 2月2日, CN 2月3日; 2053: VN 2月18日, CN 2月19日1903VN 1月28日CN 1月29日+1 天1916VN 2月3日CN 2月4日+1 天1935VN 2月3日CN 2月4日+1 天1965VN 2月1日CN 2月2日+1 天1968VN 1月29日CN 1月30日+1 天1969VN 2月16日CN 2月17日+1 天1985VN 1月21日CN 2月20日+30 天2007VN 2月17日CN 2月18日+1 天2030VN 2月2日CN 2月3日+1 天2053VN 2月18日CN 2月19日+1 天190019502000205021002814 天农历日期不同VN:越南时间(UTC+7);CN:北京时间(UTC+8)1900 至 2100 年越南时间与北京时间春节不同的 10 年1903: VN 1月28日, CN 1月29日; 1916: VN 2月3日, CN 2月4日; 1935: VN 2月3日, CN 2月4日; 1965: VN 2月1日, CN 2月2日; 1968: VN 1月29日, CN 1月30日; 1969: VN 2月16日, CN 2月17日; 1985: VN 1月21日, CN 2月20日; 2007: VN 2月17日, CN 2月18日; 2030: VN 2月2日, CN 2月3日; 2053: VN 2月18日, CN 2月19日1900200021001903VN 1月28日 · CN 1月29日+1 天1916VN 2月3日 · CN 2月4日+1 天1935VN 2月3日 · CN 2月4日+1 天1965VN 2月1日 · CN 2月2日+1 天1968VN 1月29日 · CN 1月30日+1 天1969VN 2月16日 · CN 2月17日+1 天1985VN 1月21日 · CN 2月20日+30 天2007VN 2月17日 · CN 2月18日+1 天2030VN 2月2日 · CN 2月3日+1 天2053VN 2月18日 · CN 2月19日+1 天2814 天农历日期不同VN:越南时间(UTC+7);CN:北京时间(UTC+8)
1900 至 2100 年越南时间与北京时间春节不同的 10 年由 @nhatnguyet/lunar 计算。

程序库可选择各国历法,默认越南历。

历法时区适用
越南默认UTC+7越南VN
中国UTC+8中国、台湾、香港、澳门;新加坡、马来西亚、印度尼西亚、菲律宾华人的春节CN, TW, HK, MO, SG, MY, ID, PH
韩国UTC+9韩国KR
日本UTC+9旧历(kyūreki),用于传统节日JP

蒙古、西藏、泰国、老挝、柬埔寨、缅甸、印度使用规则不同的历法,程序库尚未收录。

按国家代码选择历法
import { toLunar } from "@nhatnguyet/lunar";

toLunar("1985-01-21", { lang: "zh" });                   // 1985 年正月初一,乙丑
toLunar("1985-01-21", { lang: "zh", country: "CN" });  // 1984 年腊月初一,甲子

仓库里有什么?

版本 0.3.0:五个英文名的计算包,各有同一代码的越南语名版本;一个 Python 包,结果逐字段一致。

程序包功能
@nhatnguyet/lunar又名 @nhatnguyet/am-lich越南、中国、韩国、日本及另外 7 个地区的阴阳历换算;干支;精确到分钟的二十四节气;二十八宿;纳音;黄道吉时
@nhatnguyet/ziwei又名 @nhatnguyet/tu-vi紫微斗数:十二宫、庙旺利陷、四化、旬空截空、大限、流年、流曜、附古籍原文的格局、流派选项;SVG;兼容 iztro 的接口
@nhatnguyet/bazi又名 @nhatnguyet/bat-tu八字:按节气定四柱、藏干、十神、神煞、大运、小运;SVG
@nhatnguyet/numerology又名 @nhatnguyet/than-so-hoc毕达哥拉斯数字命理,支持带声调的越南姓名;SVG
@nhatnguyet/festivals又名 @nhatnguyet/le-hoi206 个越南节庆及其逐年日期、省份、民族、举办地;可导出 iCalendar(.ics)
@nhatnguyet/cli命令行:命盘以表格、JSON、SVG 或 .ics 文件输出;Python 版有同样的 nhatnguyet 命令
@nhatnguyet/mcp供 AI 助手使用的 MCP 服务器,在本机运行
@nhatnguyet/widgets5 个网页组件:今日、月历、黄道吉时、春节倒计时、日期换算
nhatnguyet (PyPI)以上全部功能合为一个 Python 包,结果逐字段一致

流派选项

各书安星不同之处,程序库选定一个默认值、注明所依之书,并可用 schools 切换。默认值永不改变;432 个测试用例专门覆盖这些选项。采用《全书》的三个选项后,与 iztro 在 610 张命盘上的差异:火铃(484)、庚干四化(126)、癸年天厨(59)都降为 0。

选项取值(默认在前)影响
fireBellvietnamese, quanshu, swap-for-female, swap-for-yin-male-yang-female火星、铃星
leapMonthwhole, split-at-15, next-month闰月出生时安星所用的月份
transformationsvietnamese, quanshu, zhongzhou庚干四化
heavenlyKitchenvietnamese, chinese癸年天厨
injuryMessengerstandard, zhongzhou天伤、天使
ziHournext-day-from-23, split-at-midnight八字:23 点至 24 点出生的日柱

数据集

CC BY 4.0 许可:可用于商业产品与 AI 训练,须注明来源。

面向 AI 与项目模板

MCP 服务器(npx -y @nhatnguyet/mcp)让 AI 助手调用计算而非猜测:历法换算、节气、黄道吉时、紫微、八字、数字命理、节庆、SVG 命盘。四个可直接使用的项目模板:

  • nextjs-lunar-calendar: Next.js 农历页面:带农历与节气的月历、春节倒计时、表单排紫微命盘
  • telegram-bot: Telegram 机器人:/today、/tet、/ziwei,三种语言回复
  • google-sheets: Google 表格函数 =LUNARDATE()、=SEXAGENARY()、=SOLARTERM()、=SOLARDATE(),一个文件即可
  • jupyter: Jupyter 笔记本:1900 至 2100 年越南与中国的春节与闰月,附图表

数据从哪里来?

  • 解读所引古籍:《紫微斗数全书》《滴天髓》《穷通宝鉴》《三命通会》《渊海子平》《皇极经世》等。原文已与刊本对照,每段注明书名与篇章。 深入阅读
  • 360万份命盘的解读:由 Nhat Nguyet 撰写,三种语言,同一格式。 深入阅读
  • 古籍全文:373 份公有领域文本(约 350 部著作),共7270万字,以文言为主。 深入阅读
  • 510 篇知识文章,与各星曜、格局、用神、生命灵数对应。
  • 节庆:206 个越南节庆,农历日期由同一历法程序库逐年换算为公历。 深入阅读
  • 祭文:456 篇,155 类仪式。均为民间流传文本,Nhat Nguyet 负责编辑与分类,不署作者之名。 深入阅读
  • 不含仍受版权保护的书籍。

可以用来做什么?

覆盖范围:已涵盖的领域四国农历 (东方): 程序库(npm、PyPI), 开放数据(33 套); 二十四节气 (东方): 程序库(npm、PyPI), 开放数据(33 套); 干支 (东方): 程序库(npm、PyPI), 开放数据(33 套); 二十八宿 (东方): 程序库(npm、PyPI); 择日 (东方): 程序库(npm、PyPI), 开放数据(33 套), 程序库即将推出; 紫微斗数 (东方): 程序库(npm、PyPI); 八字 (东方): 程序库(npm、PyPI); 易经 (东方): 开放数据(33 套), 程序库即将推出; 风水 (东方): 开放数据(33 套), 程序库即将推出; 数字命理 (西方): 程序库(npm、PyPI), 开放数据(33 套); 占星 (西方): 开放数据(33 套), 程序库即将推出; 塔罗 (西方): 开放数据(33 套), 程序库即将推出; 节庆 (东方): 程序库(npm、PyPI), 开放数据(33 套); 祭文 (东方): 开放数据(33 套), 程序库即将推出东方西方历法四国农历VN、CN、KR、JP二十四节气4824 个交节时刻干支六十甲子二十八宿每日值宿择日黄道吉时;建除十二神即将推出命理与术数紫微斗数十四主星、十二宫八字四柱、十神易经六十四卦风水八宅、鲁班尺数字命理越南姓名占星十二星座塔罗78 张牌信仰与文化节庆206 个,逐年日期祭文456 篇,155 类仪式程序库(npm、PyPI)开放数据(33 套)程序库即将推出覆盖范围:已涵盖的领域四国农历 (东方): 程序库(npm、PyPI), 开放数据(33 套); 二十四节气 (东方): 程序库(npm、PyPI), 开放数据(33 套); 干支 (东方): 程序库(npm、PyPI), 开放数据(33 套); 二十八宿 (东方): 程序库(npm、PyPI); 择日 (东方): 程序库(npm、PyPI), 开放数据(33 套), 程序库即将推出; 紫微斗数 (东方): 程序库(npm、PyPI); 八字 (东方): 程序库(npm、PyPI); 易经 (东方): 开放数据(33 套), 程序库即将推出; 风水 (东方): 开放数据(33 套), 程序库即将推出; 数字命理 (西方): 程序库(npm、PyPI), 开放数据(33 套); 占星 (西方): 开放数据(33 套), 程序库即将推出; 塔罗 (西方): 开放数据(33 套), 程序库即将推出; 节庆 (东方): 程序库(npm、PyPI), 开放数据(33 套); 祭文 (东方): 开放数据(33 套), 程序库即将推出东方西方历法四国农历VN、CN、KR、JP二十四节气4824 个交节时刻干支六十甲子二十八宿每日值宿择日黄道吉时;建除十二神即将推出命理与术数紫微斗数十四主星、十二宫八字四柱、十神易经六十四卦风水八宅、鲁班尺数字命理越南姓名占星十二星座塔罗78 张牌信仰与文化节庆206 个,逐年日期祭文456 篇,155 类仪式程序库(npm、PyPI)开放数据(33 套)程序库即将推出
覆盖范围:已涵盖的领域

三步上手

  1. 安装

    JavaScript 一条命令,Python 一条命令。无需服务器,无需密钥。

    命令行
    npm i @nhatnguyet/ziwei @nhatnguyet/lunar
    pip install nhatnguyet
    一个计算核心,三样可用之物原始计算核心运行于 nhatnguyet.org 与应用17,291 个测试用例逐字段一致TypeScriptnpmPythonpip开放数据33 套,有 DOI
  2. 调用一个函数

    以公历出生日期与钟点时间排紫微命盘。lang 选择结果的语言:中文、英文或越南文。

    TypeScript
    import { castZiWei, findPatterns } from "@nhatnguyet/ziwei";
    
    // 1990年9月19日,20点(戌时)
    const chart = castZiWei({ date: "1990-09-19", time: "20:00", gender: "male", lang: "zh" });
    const patterns = findPatterns(chart);
    Python
    from nhatnguyet import cast_zi_wei, find_patterns
    
    # 1990年9月19日,20点(戌时)
    chart = cast_zi_wei(date="1990-09-19", time="20:00", gender="male", lang="zh")
    patterns = find_patterns(chart)
    输入出生时间,得出命盘1990年9月19日, 戌时男castZiWei()五行局、命宫、身宫十二宫、十四主星、辅星四化、大限、流年《全书》格局
  3. 查看结果

    此命盘命宫在亥,土五局,识别出四个格局。

    结果
    chart.bureau.name                         // "土五局"
    chart.palaces[chart.lifePalace].branch    // "亥"
    chart.palaces[chart.lifePalace].stars[0]  // 太阴(庙,化忌)
    patterns.map((p) => p.name)
    // "机月同梁", "左右同会", "日出扶桑", "月落亥宫"
    • 机月同梁
    • 左右同会
    • 日出扶桑
    • 月落亥宫
    简化紫微命盘:十二宫与主星父母子贪狼福德丑天同化科巨门田宅寅武曲化权天相官禄卯太阳化禄天梁交友辰七杀迁移巳天机疾厄午紫微财帛未身子女申破军夫妻酉兄弟戌廉贞天府命宫亥太阴化忌庚午1990年9月19日, 戌时土五局命宫在亥

如何使用与署名?

  • 代码:MIT。 每个副本都须保留 Copyright (c) 2026 Nhat Nguyet (nhatnguyet.org)。
  • 数据与解读:CC BY 4.0。 可用于商业用途,可修改,条件是注明来源。
  • 标准署名:数据:Nhat Nguyet(nhatnguyet.org)。展示结果的应用须在用户可见处注明“据 Nhat Nguyet”;研究请引用 DOI。
  • Nhat Nguyet 名称与标志属于商标,不在许可范围内:产品命名或呈现方式不得让用户误以为是 Nhat Nguyet 的产品。
  • 隐私:程序库在本机计算,不向任何地方发送数据。

引用

使用程序库的研究请引用程序库的 DOI;使用数据集的研究请引用数据集的 DOI。两个概念 DOI 始终指向最新版本。

引用程序库
Nhat Nguyet (2026). Nhat Nguyet: open source code and data for Zi Wei Dou Shu, BaZi and numerology. Zenodo. https://doi.org/10.5281/zenodo.24358013
BibTeX
@software{nhatnguyet_2026,
  author = {{Nhat Nguyet}},
  title  = {Nhat Nguyet: open source code and data for Zi Wei Dou Shu, BaZi and numerology},
  year   = {2026},
  url    = {https://nhatnguyet.org/en/ma-nguon-mo},
  doi    = {10.5281/zenodo.24358013}
}

问答

程序库的紫微命盘包含哪些内容?

完整命盘:五行局、命宫、身宫、十四主星与辅星、庙旺利陷、四化、旬空截空、大限、流年、流曜。格局包含《紫微斗数全书》所列诸格。

有哪些程序包?

五个用于计算的 npm 包和一个 Python 包。 npm:@nhatnguyet/lunar、ziwei、bazi、numerology、festivals(与越南语名的 am-lich、tu-vi、bat-tu、than-so-hoc、le-hoi 为同一代码),另有 cli、mcp、widgets。Python:pip install nhatnguyet 包含全部五部分。

可以用这些数据训练商业 AI 吗?

可以,依据 CC BY 4.0 许可。唯一条件是注明“数据:Nhat Nguyet(nhatnguyet.org)”。

八字月柱按农历月还是按节气?

按节气,合乎四柱法:年柱于立春交换,月柱于交节之日交换,而非农历初一。

子时(23点至0点)出生算哪一天?

两门各守其法:八字自23点起换日,紫微按所输入的日期。因此两张命盘可能落在不同日期;紫微命盘附有子时说明。

数字命理如何计算带声调的越南姓名?

先去掉声调,再按毕达哥拉斯表计算,“Đ”按“D”计。包含生命灵数、使命数、灵魂数、人格数、态度数、巅峰数、挑战数,以及个人年、月、日。