ZhouYiLab · 周易实验室（Fork）

本仓库 fork 自 https://github.com/banderzhm/ZhouYiLab ，在此基础上完成了前后端打通与多模块展示优化。

---

本仓库新增与修复（摘要）

全栈接入

• 新增 FastAPI 服务层（server.py），将 C++ 核心能力统一包装为 HTTP API
• 前端页面（web/index.html）完整对接后端 API，支持一键排盘
• 统一 JSON 输出格式，便于组件化渲染与扩展

八字（BaZi）

• 输出：四柱、纳音、旬空、十神、十二长生、自坐长生、藏干
• 神煞：按年/月/日/时柱分组展示 + 全量汇总
• 五行强度统计、起运方向、起运年龄、大运/流年（含按大运分组的流年列表）
• 性别参数影响排盘逻辑

六爻（LiuYao）

• 起卦支持：手动 / 数字 / 时间 / 爻辞
• 统一通过 yao_ci_to_hexagram_code 计算动爻与变卦
• 修正部分卦内外卦对应错误（如地水师、天雷无妄、风水涣、天火同人、雷泽归妹）
• 伏神逻辑修正：只展示缺失六亲，不再“六爻全伏”

梅花易数（Meihua）

• 采用农历年/月/日/时起卦
• 输出上卦/下卦/动爻，并联动生成互卦/错卦/综卦

奇门遁甲（QiMen）

• 对齐“转盘时家”排盘规则
• 地盘按局数“几局戊落几宫”，值符/值使随时干时支旋转
• 天盘/人盘/神盘联动旋转，中宫保持空门

紫微斗数（ZiWei）

• 南派 / 北派可切换（北派输出全量星系）
• 宫位布局固定，星曜显示与宫位信息整合

大六壬（DaLiuRen）

• 修正月将顺序与节气换将规则
• 修正伏吟 / 返吟取三传逻辑

功能模块

• 八字排盘（BaZi）
• 六爻排盘（LiuYao）
• 梅花易数（Meihua）
• 奇门遁甲（QiMen）
• 紫微斗数（ZiWei）
• 大六壬（DaLiuRen）

快速开始（Windows 推荐）

1) 构建 C++ 核心

cmake -B build -G "Visual Studio 17 2022" cmake --build build --config Release

2) 启动后端

conda run -n fabu python server.py

3) 打开前端

浏览器访问：http://127.0.0.1:8000

API 一览（本仓库新增）

• POST /api/bazi
• POST /api/liuyao
• POST /api/meihua
• POST /api/qimen
• POST /api/ziwei
• POST /api/daliuren

说明

• 本仓库与上游 fork 存在功能差异，若需提交上游请通过 PR 方式合并。
• 如需重新对齐上游，请使用 GitHub 的 Sync fork 功能。

许可

MIT License