紫微斗数 · 开源排盘引擎

紫微斗数作为中国传统命理学的瑰宝，其复杂的排盘算法与深奥的解读体系往往被封闭在商业软件或少数师承之中。紫微斗数 · 开源排盘引擎 是一个基于 倪海夏《天纪》 教学体系的开源项目，旨在通过技术手段让这门传统智慧透明化、普及化。

该项目不仅提供了完整的 TypeScript 排盘算法库（涵盖安命宫、定五行局、十四主星、四化飞星等），更重磅开源了 51.8 万条命盘样本数据集（5.5 GB），每条数据均包含结构化命盘 JSON 与基于倪师体系的详细解读文本。无论是用于 AI 大模型微调、RAG 知识库构建，还是作为学术研究的数据基础，这都是一套不可多得的顶级资源。

核心亮点：正统体系、海量数据、完整算法

1. 倪海夏《天纪》正统体系

• 纯正流派：严格遵循倪海夏老师在《天纪》中梳理的正统紫微斗数逻辑，摒弃杂乱旁支，确保排盘与解读的专业性与一致性。
• 男女命差异化：100% 实现男女命排盘差异（如大限顺逆、星曜亮度等）。
• 健康与子午流注：100% 包含基于子午流注的健康分析逻辑，女命额外包含妇科保养解读。
• 口径一致：排盘结果与线上知名平台 wdyziweidoushu666.com 完全一致，经过大规模验证。

2. 51.8 万条命盘样本数据集（开源重磅）

• 全覆盖组合：覆盖年（60）× 月（12）× 日（30）× 时（12）× 性别（2）的所有理论组合，共 518,400 条 样本。
• 结构化数据：每条样本包含：
  • 命盘 JSON：完整的十二宫位、星曜分布、四化、大限流年等结构。
  • 解读文本：基于倪师体系的 13 个主题解读（命格总览、财运、事业、感情、健康、父母、子女等）。
• AI 训练黄金语料：51.8 万组 Input-Output 配对，是微调垂直领域小模型或构建高精度 RAG 检索源的绝佳素材。
• 下载方式：通过 GitHub Releases 分三卷下载（共 5.5 GB），支持 macOS/Linux/Windows 合并解压。

3. 完整排盘算法库 (lib/ziwei/)

• 核心算法：algorithm.ts 实现完整排盘流程，包括安命身宫、定五行局、安十四主星、安辅星、排大限流年等。
• 四化系统：sihua.ts 包含完整的天干四化对照表（禄权科忌），支持飞星派逻辑。
• 格局知识库：patterns.ts 收录 1100+ 行 经典格局判定规则（如紫府同宫、日月并明、七杀朝斗等），支持自动化格局识别。
• 合盘逻辑：heming-knowledge.ts 提供倪师体系下的双盘比对方法论，支持夫妻、合作等合盘分析。
• 真太阳时校正：内置 cities.ts 中国城市经纬度数据，自动根据出生地校正真太阳时，提升排盘精度。

4. 古籍原文与知识库

• 核心典籍：收录《骨髓赋》、《紫微斗数全集》、《紫微斗数全书》等清代古本原文，支持全文搜索。
• SEO 知识图谱：结构化整理 14 主星 × 12 宫位的知识数据，便于生成 SEO 友好内容或构建外部知识库。

快速开始

1. 克隆与安装

git clone https://github.com/Renhuai123/ziwei-doushu.git
cd ziwei-doushu
npm install

2. 配置环境变量

cp .env.example .env.local
# 编辑 .env.local，如需使用 AI 解读功能，填入你的 LLM API Key

3. 启动开发服务器

npm run dev

访问 http://localhost:3000 即可体验完整的排盘工作台、合盘分析及古籍阅读器。

4. 下载样本数据（可选）

前往 GitHub Releases 页面下载 ziwei-samples-v3-part*.zip.* 文件。

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

⚠️ 注意事项

• 开源范围：本项目开源了排盘算法、前端界面、古籍数据及样本数据集。
• 未包含部分：
  • AI 解读 Prompt：需参考 patterns.ts 自行构建。
  • 后端 API：/api/interpret 等路由需自行实现。
  • 用户系统与支付：属于运营层功能，未开源。
• 免责声明：命理文化仅供参考，请勿迷信。项目理念为“玩玩可以不要当真”，旨在技术传承与文化普及。