紫微斗数 · 开源排盘引擎

算法是公开的传统智慧，不应该被锁在围墙里

中文 · English

紫微斗数开源排盘引擎：输入公历生日即可排命盘，支持十二宫、四化、大限流年、13 维解读与古籍检索。可作为 MCP 接入百度搭子，也能在本地网页使用，适合想找开源紫微斗数排盘、命盘分析、命理占卜工具的同学。

一键部署（推荐：百度搭子）

⚠️ 需要 Node.js 22+、Git，以及能访问 GitHub 与 npm 的网络；网页默认使用 3000 端口。

1. 装客户端 打开百度搭子官网下载电脑端，安装并登录。

2. 复制这一句发给百度搭子

你好，帮我从 github 部署 JUTZUGC/ziwei-doushu 到我的电脑上，装好后启动网页，并用绝对路径把 mcp/server.ts 注册到当前工作区的 MCP。

3. 跟着对话往下走 百度搭子会克隆仓库、执行 npm install、启动服务，并询问 MCP 注册结果。建议把仓库放在固定目录（例如 C:\Users\<你的用户名>\ziwei-doushu），不要放在会话临时目录。

4. 打开网页 浏览器访问 http://127.0.0.1:3000 ，输入公历生日、时辰与性别即可排盘。

5. 调出帮助菜单 在同一个对话窗口里直接说：

紫微斗数帮助

百度搭子会调用 ziwei_help，返回排盘、解读、合盘、运限、数据集与 MCP 的用法。

注册或更新 MCP 后需要重启百度搭子客户端，工具才会进入工具列表。如果回答来自知识库而没有调用工具，直接说「调用 ziwei_help」即可强制走 MCP。

部署完成后怎么用

可选配置

npm run data:fetch -- --years 1990   # 导入 13 维解读数据
npm run data:status                  # 查看已导入年份

AI 对话需要在 .env.local 配置 OpenAI 兼容接口，详见下方「AI 解读」。完整步骤见 百度搭子部署指南。

Related MCP server: Mingli MCP Server

本仓库新增：MCP / Skill / 数据集

基于上游 Renhuai123/ziwei-doushu（MIT）复刻，新增 MCP、Skill、AI 解读接口与官方 v4.0 数据集查询层。上游代码与数据许可见 NOTICE。

快速开始

npm install
npm run dev          # http://localhost:3000

MCP（仅百度搭子）

npm run mcp

.mcp.json 已提供 stdio 配置。门禁是硬约束：initialize、ping、tools/list、tools/call 全部先校验宿主进程链，非百度搭子一律返回 HOST_NOT_ALLOWED，没有绕过开关。Skill 的 CLI 兜底走同一套门禁。

工具：ziwei_chart、ziwei_interpret、ziwei_dataset_fetch、ziwei_patterns、ziwei_classics、ziwei_heming、ziwei_yunxian、ziwei_search、ziwei_info、ziwei_help。

Skill

skills/ziwei-doushu/SKILL.md

把整个 skills/ziwei-doushu 目录放进宿主的 skills 目录即可。没有 MCP 时，Skill 会退回 CLI：

npm run ziwei -- chart --year 1990 --month 1 --day 1 --hour 0 --gender male

解读数据集

官方 v4.0 数据集不随仓库提交，按年份下载、校验并导入 SQLite：

npm run data:fetch -- --years 1990
npm run data:status

数据集许可 CC BY 4.0，来源见 NOTICE。未导入年份时：网页会在解读区给出「下载并导入」按钮，MCP 的 ziwei_interpret 会返回 offerDownload，助手询问后再调用 ziwei_dataset_fetch 下载，导入后自动可查。

AI 解读

复制 .env.example 为 .env.local，填写 OpenAI 兼容接口：

AI_API_KEY=...
AI_BASE_URL=https://api.deepseek.com/v1
AI_MODEL=deepseek-chat

不配置也能排盘、看数据集解读，只是 /api/interpret 与 /api/heming 会提示未配置。

一、项目理念：紫微斗数是中国传统命理学的瑰宝，倪海厦老师在《天纪》中系统梳理了正宗的紫微斗数体系。我们希望通过技术手段让更多人接触和学习这门学问。

开源排盘算法和知识库，是因为我们相信：算法是公开的传统智慧，不应该被锁在围墙里。真正的价值在于解读的深度、用户体验的打磨、以及持续运营的积累。

二、项目信息：基于倪海厦《天纪》教学体系的紫微斗数排盘系统，包含完整排盘算法、四化系统、格局知识库、古籍原文数据，以及一套完整开源的紫微斗数解读数据：v4.0 解读数据集——67.5 万张命盘 × 13 维 = 877 万段解读，正文约 204 亿字，解压后 56.6 GB（2026-10-15 发布）。

v3.0 每张盘解读字数按 2,160 张盘抽样估算，其余数字为全量统计；两版每张盘都是 13 维。

在线体验：metisziwei.com，排盘、AI 解读、命盘历史全部开放。

注：关于六亲判断

紫微斗数在六亲（父母、兄弟、子女等）判断上存在一定局限。倪师在《天纪》中指出：“斗数批六亲本来就比较差一点。”（2上 · 00:25:27）在传统术数中，铁板神数在核对六亲方面有其独特优势（2上 · 00:03:15）；倪师仍以紫微斗数为核心，是因为它能结合地理、环境与人事进行综合判断，形成“上知天文、下知地理、中知人事”的完整体系（2上 · 00:25:43）。因此，与六亲相关的分析仅供参考；metisziwei.com 上父母、兄弟、子女三个维度也附有同样的说明。

目录

一、本轮更新（2026-10-15）

本轮跟随网站 2026-10-15 发版（网站内容版本 ca268829f7a9）：

1. 发布 13 维解读数据集 v4.0 —— 674,976 张命盘（公历 1950–2026 年每一个真实日期 × 12 时辰 × 男女）× 13 维 = 8,774,688 段解读，正文约 204 亿字。解压后 56.6 GB（v3.0 为 33.1 GB，增加 71%），压缩后只有 161 MB，按年份分 77 个文件，可以只下需要的年份，也可以一次下全年份总包。下载见 Release v4.0-13d，规格和字段见第二·新章。发布前 77 个文件逐个解压，与原始数据逐字节比对一致。

2. 13 维断语按倪师原话与《全书》原文逐句校正（断语库仍不开源，校正结果体现在 v4.0 数据集里）：

• 标着倪师或《全书》却查不到出处的引文，删掉或换成逐字可查的原话；倪师原话注明《天纪》第几集、几分几秒

• 不会发生的四化（如七杀化权、紫微化忌）相关的句子删去；只在某种条件下才成立的断语补上条件

• 「力量强时……落陷时……」这类两头说的句子，改为按命盘只显示成立的那一种

• 健康：哪个脏腑要留意，改按倪师的看法——全盘杀星最集中的那一宫，按它的地支对应脏腑；不再按星的五行推脏器

• 网站知识库「古籍引证」由 244 处增至 405 处，每一处都能在《紫微斗数全书》原文里逐字找到

3. 排盘引擎同步（PR #39）—— dst-cn.ts 新增 chinaDSTSpan(year)，查某年中国夏令时起止；cities.ts 补全省直辖县级单位与新疆兵团各市的经度（神农架、海南各市县、阿拉尔等），出生地选这些城市时真太阳时校正可用。

4. 许可 —— DATASET-LICENSE 适用范围加上 v4.0；写明解读里引用的倪师原话不在数据授权范围内，与第五章倪师原话的 CC BY-NC-SA 4.0 一致。v3.0 样本数据集及其条款不变。

2026-10-27 补充：排盘引擎同步——true-solar-time.ts 支持海外出生地：传 utcOffsetMinutes（出生地时区的固定标准偏移），按当地时区中央经线做经度修正，国内不传时结果逐位不变；新增 clock-adjust.ts，把夏令时、或当年时区与现在不同时的钟表读数换成标准时间（跨日不改，交给用户），建议做成用户亲手点、可撤销的按钮，不要自动改。顺带更正：中国夏令时引擎只判定、从不自动扣除，此前「引擎能力」表写成「自动扣除」，有误。

2026-10-24 补充：项目理念移到页首——标题下居中一句「算法是公开的传统智慧，不应该被锁在围墙里」，紧接两段理念原文（前标「项目理念」），原有介绍段前标「项目信息」；第十章「项目理念」改为指向页首。

2026-10-20 补充：星曜亮度默认改为《斗数全书》，与主流排盘软件默认一致，此前默认的「现代修正 v2」仍可在流派设置里选；补齐天姚、天刑、天喜、大耗、解神、截空、副截、旬空的亮度，月德不再标亮度。用 5 张金标准盘逐宫核对，星曜落宫与亮度全部吻合。注意：v4.0 数据集（10-15）是按旧默认「现代修正 v2」生成的，其中亮度字和少量随亮度变化的解读句会与新默认不同。

2026-10-06 ~ 10-07 补充：README 加「注：关于六亲判断」（倪师原话 + 出处链接，中英两份）；网站链接加渠道码 ?from=；同步倪师原话语料勘误（主星南斗、北斗归属）。

上一轮更新（2026-09-21）

2026-10-03 补充：倪师《天纪·紫微斗数》原话 1848 条单独成章（第五章）；合并外部贡献 #29（时辰序号校验）；引擎拒绝不存在的公历日期，数据集补字段口径与已知问题；提交 package-lock.json；站点地址改为可配置；合盘演示改用本地引擎起盘、AI 接口缺失时明确提示；补齐贡献指南、行为准则、问题与 PR 模板；新增英文简介 README.en.md；去掉两个用不上的部署工具包（vercel CLI、@cloudflare/next-on-pages），依赖从 483 个减到 185 个；随后升级到 Next.js 16 修掉 postcss 漏洞，GitHub 安全提醒从 51 条清零。

时隔三个月，本仓库完成一次完整更新（PR #28，26 个文件、+2736 / −108 行）：

1. 排盘引擎同步到线上口径 —— algorithm.ts 从 181 行到 641 行，另更新 sihua / types / constants / patterns / cities / famous；新增 8 个模块（1367 行）：

2. 补上回归测试与 CI —— 此前本仓库没有任何测试。现在 5 条排盘回归，npm test 一条命令跑完，每次 push 与 PR 在 GitHub Actions 上自动跑。

3. 修掉样本时辰注释错位（#26）—— famous.ts 里 11 条名人样本有 7 条的时辰注释与 hour 索引不符（hour 一直是时辰地支索引 0–11，不是 0–23 的小时数）。已改正并加回归钉住。

4. 积压 issue 从 18 条清到 4 条，留下的都是还在走的。

5. 文档与许可 —— 新增 DATASET-LICENSE；README 补齐引擎能力清单、维护节奏、开源边界；修正两处不实描述（数据集「口径与线上完全一致」、界面「完整的 Next.js 15 前端」）。

二·新、13 维解读数据集 v4.0（2026-10-15）

下载位置：本仓库右侧 Releases → v4.0-13d

v4.0 用 2026-10-15 版网站断语库重新生成：13 个分析维度的断语已按倪海厦《天纪》逐字稿与《紫微斗数全书》原文逐句校正——查不到出处的引文删去或换成逐字可查的原话（倪师原话注明《天纪》集数与时间码），不会发生的四化相关句子删去，有条件的断语写明条件。

规格

每行一张盘（JSON Lines），字段：

口径说明

• 是本命盘视图的解读；网站上按读者当前年龄改写的句子、各维末尾附加的倪师法则段、AI 解读都不在数据集里。

• 按时辰序号直接排盘，未按出生地做真太阳时校正。

下载与解压

# 一次下全部：gh release download v4.0-13d --repo Renhuai123/ziwei-doushu -p "ziwei-interp-v4-all.tar"
# 只要某几年就只下那几年，例如 1990 年
zstd -d --long=27 year-1990.jsonl.zst          # 得到 year-1990.jsonl
shasum -a 256 -c SHA256SUMS.txt --ignore-missing # 校验

--long=27 必须带上（压缩时用了长窗口）。Windows 可用 zstd 官方发布包 里的 zstd.exe，参数相同。

引文说明

解读里引用的倪海厦《天纪》原话不属于本数据集的授权范围：它们是为说明断语出处而注明集数与时间码的简短引用，著作权归原权利人；要把这些原话单独成批使用，按第五章倪师原话的 CC BY-NC-SA 4.0 处理。《紫微斗数全书》原文属公有领域。

许可

与 v3.0 相同：CC BY 4.0，可自由商用，唯一要求是保留来源标注（上面「引文说明」里的倪师原话除外），完整条款见 DATASET-LICENSE。引用时请写：

本项目使用了 紫微斗数开源解读数据集 v4.0（674,976 张命盘 × 13 维） 来源：https://github.com/Renhuai123/ziwei-doushu 作者：王多鱼AI

二、51.8 万命盘样本数据集

下载位置：本仓库右侧 Releases 页面

我们开源了一套完整的紫微斗数命盘样本数据集，覆盖 51.8 万种排盘组合（年 60 × 月 12 × 日 30 × 时 12 × 性别 2），每条样本包含完整的命盘结构和基于倪海厦体系的解读文本。

2.1 数据规格

字段口径（每条样本由 birthInfo 生成，常被看错的是 hour）：

时辰序号与钟点对照：

23:00–23:59 出生（晚子时）按次日排盘、时辰取 0；00:00–00:59 出生（早子时）按当日排盘、时辰同样取 0。

已知问题：约 2,520 条样本的日期并不存在。 生成时每个月都取了 1–30 日，所以 2 月 30 日，以及非闰年的 2 月 29 日也生成了样本，共 105 个日期 × 12 时辰 × 2 性别 = 2,520 条，占 0.49%。v3 引擎遇到这类日期不报错，而是顺延成 3 月 1–2 日排盘，所以这些样本的内容与对应的 3 月 1–2 日样本重复。使用时请过滤掉：month = 2 且 day = 30，或 month = 2 且 day = 29 且该年不是闰年。引擎从 2026-10-03 起会直接拒绝不存在的日期，下一版数据集不会再有这类样本。

2.2 下载方式

前往 Releases 下载以下文件：

ziwei-samples-v3-part1.zip.001  (1.9 GB)
ziwei-samples-v3-part2.zip.002  (1.9 GB)
ziwei-samples-v3-part3.zip.003  (1.8 GB)
SHA256SUMS.txt                  (校验文件)

下载后合并解压：

# macOS / Linux
cat ziwei-samples-v3-part*.zip.* > combined.zip
unzip combined.zip

# Windows (PowerShell)
Get-Content ziwei-samples-v3-part*.zip.* -Encoding Byte -ReadCount 0 | Set-Content combined.zip -Encoding Byte
Expand-Archive combined.zip

2.3 用途

• 微调小模型的训练语料（51.8 万 input-output 配对）

• AI 对话的 RAG 检索源

• 修改 patterns.ts 后做 A/B 基线对比

• 紫微斗数研究与数据分析

2.4 数据许可与引用

📂 完全开源 · 可自由商用 —— 你可以在任何项目里使用这套数据，包括但不限于：

• 商业产品 / SaaS / 付费应用

• AI 模型微调（开源或闭源模型均可）

• 二次开发、再分发、衍生数据集

• 学术研究、技术博客、教学课程

无需付费、无需申请、无需事先告知。

唯一的要求是保留数据来源标注（attribution）：

本项目使用了 紫微斗数开源样本数据集 v3.0（518,400 条） 来源：https://github.com/Renhuai123/ziwei-doushu 作者：王多鱼AI

放在哪里都行：

• 网页 / 产品：About 页 / 关于我们 / 数据来源 / 页脚，写一行链接即可

• AI 模型：模型卡（Model Card）或数据集卡（Dataset Card）的 "Training Data" 字段

• 学术论文：参考文献或致谢章节

• 二次发布的数据集：README 或 metadata 文件里注明上游来源

仅此一条，其余都自由。完整条款见 DATASET-LICENSE。希望这套数据能帮你做出好东西 —— 做出来记得来小红书 / 抖音 / 闲鱼 @王多鱼AI 打个招呼 👋

三、快速开始

# 克隆
git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu

# 安装依赖
npm install

# 配置环境变量（只看排盘可以跳过；AI 配置仅在你自己实现了 /api/* 接口时才用得上）
cp .env.example .env.local

# 启动开发服务器
npm run dev

本地验证：

npm run typecheck   # TypeScript 全量类型检查
npm test            # 排盘引擎回归（768 盘 × 紫微铁律、夏令时、立春边界、红鸾天喜、样本时辰一致性、时辰序号边界、日期合法性、同宫双四化）

每次 push 与 PR 都会在 GitHub Actions 上跑同一套（见 .github/workflows/ci.yml）。

**注意：开源版不含后端 API 路由。**排盘、命盘展示、合盘起盘都在浏览器里用本仓库的引擎完成，不需要任何 API Key。AI 解读（/api/interpret）和合盘 AI 分析（/api/heming）需要你自己实现接口；没实现之前，这两处会直接提示「开源版不含该接口」，配置 API Key 也不会变成可用（#30 就是这个原因）。

四、排盘引擎

排盘内核全部在 lib/ziwei/。

4.1 能做到什么（与常见排盘库的差异）

4.2 文件怎么分

4.3 古籍原文（lib/classics/）

• 骨髓赋（gusuifu.ts）— 紫微斗数核心歌诀

• 紫微斗数全集（quanji.ts）— 清代古本

• 紫微斗数全书（quanshu.ts）— 陈希夷传本

4.4 SEO 知识图谱（lib/seo/）

14 主星 × 12 宫位的结构化知识数据，可用于内容生成或知识库构建。

五、倪师《天纪·紫微斗数》原话

倪海厦《天纪》紫微斗数部分的原话共 1848 条：正课 14 讲（第 2–15 讲上半）加 2 段补充，按讲分成 16 个文件，放在 docs/tianji-ziwei/。每条都带出处时间，点一下就跳回 B 站原视频的那一秒。

• 怎么读：先在上图里找到想看的主题，再点进对应那一讲，比如 5上（紫微在子）、13上（杀破狼、科权禄三会）。

• 从哪来：取自姊妹仓库 nihai-tianji-corpus，以语料库为准，会随语料库同步。

• 能不能商用：不能。这一章的内容单独采用 CC BY-NC-SA 4.0，详见九、协议。

六、界面是一份 Demo

界面代码在 app/ 与 components/。仓库里的界面是一套最小可运行示例，作用是把排盘引擎跑起来、把盘画出来，方便你在它基础上做自己的产品。线上商业版的界面不在开源范围内，两者差距很大：

Demo 能跑通的：出生信息表单、命盘方格与宫位详情、本命 / 大限 / 流年切换、古籍阅读器（全文搜索）、命理百科（14 主星 × 12 宫位）、亮暗主题、移动端适配。

Demo 里没有的：线上重做过的交互界面、AI 流式解读、合盘图谱、分享卡片，以及断语内容本身（db-analysis.ts 是占位实现）。也就是说，Demo 画得出盘，但给不出线上那套解读。

七、开源边界：什么不在里面

如果你需要 AI 解读能力，可以参考 lib/ziwei/patterns.ts 和 heming-knowledge.ts 里的知识库，结合任意 LLM 自行构建 prompt。

八、维护节奏与贡献

这个仓库是排盘引擎 + 数据集的开放快照，不是一个全职维护的开源产品，说清楚免得大家猜：

• 引擎同步：随线上发版同步 lib/ziwei/ 的引擎层并打 tag；断语库、AI 解读、商业站前端不在同步范围内。

• Issue：会看，但回复可能不及时；带复现步骤或具体盘例（年月日时 + 性别 + 哪一条不对）的问题优先处理。

• PR：欢迎，尤其是回归测试、口径修正、文档。动到排盘口径的改动请附上依据（古籍原文或可核对的对照）。

九、协议

本仓库分四部分授权。前三部分是宽松协议，商用没有限制；倪师原话目录不许商用：

一句话：代码和数据拿去用，商用也行，把来源链接带上就行；倪师原话只限非商业的学习研究（数据集解读里引用的倪师原话同样不在数据授权范围内）。

十、关于与联系

项目理念

见本页开头。想自己搭？代码都在这里，拿去用。嫌麻烦？来 metisziwei.com 直接用。

技术栈

• 框架：Next.js 16（App Router）

• 语言：TypeScript

• 样式：Tailwind CSS + CSS Variables 设计系统

• 排盘：基于 iztro + lunar-javascript

• 动画：Framer Motion

联系

• 线上平台：metisziwei.com（已完成 ICP 备案：渝ICP备2026013379号-1）

• 提问题、提修复：见 CONTRIBUTING.md；使用交流请到 讨论区

• 💕 发财的小手点一下：小红书 / 抖音 / 闲鱼 / X 关注 王多鱼AI，第一时间看上线 + 解锁更多紫微干货～