八字排盘与 AI 解读
根据出生年月日时生成四柱、五行、十神与大运，支持真太阳时元数据、缓存和重复记录检测；登录后可请求八字解读或完整分析，未配置真实密钥时使用 mock provider。
资源介绍
BaZi Master 是一个可自部署的开源全栈玄学应用样板，用 React 18 + Vite + Tailwind CSS 构建前端，Express 4 + Node.js 20+ 提供 API，Prisma 搭配 PostgreSQL 存储数据，Redis 作为可选缓存。它把八字排盘、塔罗抽牌、周易起卦、星座与上升星座、紫微斗数排盘、合盘分析以及 AI 解读工作流整合在同一套代码骨架中，并附带邮箱注册登录、Google / WeChat OAuth、密码重置、历史记录、收藏、多语言界面、OpenAPI 文档与健康检查等工程能力。项目定位不是托管 SaaS，而是供开发者学习、fork、自部署或二次开发的参考实现；仓库根提供 ./bazi 程序化 CLI，把环境准备、本地栈起停、数据库迁移、测试与端到端校验收敛为可脚本化调用的命令。输出仅适合娱乐、文化研究或产品原型验证。
核心能力
塔罗与周易起卦
塔罗支持单张牌、三张牌、凯尔特十字牌阵，提供公开抽牌接口和登录后的 AI 解读与历史记录；周易支持数字起卦与时间起卦，包含 64 卦数据、变爻和 AI 解读入口。
紫微斗数与合盘分析
登录后可进行紫微斗数排盘并保存历史，展示十二宫、主星、辅星和四化信息；合盘功能提供两组出生信息的基础合盘分析。
用户系统与记录管理
提供邮箱注册/登录、会话 token、cookie、Google / WeChat OAuth、密码重置和自助删除账号；八字、塔罗、周易、紫微历史记录支持客户端搜索过滤、批量操作、收藏与快照。
程序化 CLI 与运维基础
仓库根 ./bazi CLI 将环境准备、本地栈生命周期、数据库迁移、测试和端到端校验收敛为命令，全部支持 --json 和约定退出码；应用提供 /live、/health、/api/ready、Pino JSON 日志、OpenAPI / Swagger UI 与 WebSocket AI 流式输出 /ws/ai。
多语言与自部署
前端基于 react-i18next 内置 en-US、zh-CN、zh-TW、ja、ko 五套界面文案，并按浏览器语言自动匹配；同时提供 docker-compose.yml 与 docker-compose.prod.yml，支持本地 PostgreSQL + Redis 开发栈及生产容器化自部署。
使用方法
准备项目要求的 Web 服务和数据库环境并完成部署。
按需配置模型接口，然后创建用户或进入相应功能页面。
选择八字、塔罗、周易、星座、紫微或合盘功能，输入该功能要求的基础信息。
查看排盘与 AI 解读结果，并在历史记录中管理已完成内容；相关结果仅适合作为文化与娱乐参考。
使用案例
公开八字计算接口
使用场景调用后端 API 生成八字排盘
向后端发送 POST 请求到 /api/bazi/calculate，请求体传入 birthYear、birthMonth、birthDay、birthHour、gender、birthLocation 与 timezone 等字段，即可获得四柱排盘结果。
公开塔罗抽牌接口
使用场景调用后端 API 进行塔罗抽牌
向后端发送 POST 请求到 /api/tarot/draw，请求体传入 spreadType（如 ThreeCard）即可获得抽牌结果。
本地栈健康检查
使用场景验证后端服务与就绪状态
通过 curl 访问 /live、/health、/api/ready 和 /api/ai/providers，检查服务存活、依赖就绪状态与当前可用的 AI provider。
包含内容
bazi-master-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
SHA256.txt
相关资源
AI项目
Crawl4ai
面向 AI 的开源网页爬虫与抓取框架，输出适配 LLM 的 Markdown 与结构化数据
AgentMCPPDF处理
面向 AI 的开源网页爬虫与抓取框架，输出适配 LLM …
AI开发开发者工具数据分析
