【1.1 痛点分析】
中国传统命理学(八字、玄空飞星、六壬、梅花易数等)在数字化过程中
普遍存在三类问题:
1) 在线工具不严谨
年柱以公历元旦为界、时辰按北京时间计算,与古法《子平真诠》
《滴天髓》规定不符
2) 在线工具涉及隐私
出生日期、性别、姓名等敏感信息需上传至第三方服务器
3) 算法与解读混杂
计算结果与 AI 生成文本边界模糊,用户难以识别"学理定论"与"模型生成"
【1.2 项目定位】
本项目以"确定性计算 + AI 解读"双轨分离为核心架构:
- 计算层:所有排盘、推演、干支计算 100% 本地执行,不依赖网络,
不上传数据
- 解读层:AI 解读为可选增值模块,仅发送脱敏后的排盘摘要至 API
- 知识库:内置五经(《子平真诠》《滴天髓》《穷通宝鉴》《三命通会》
《渊海子平》)摘要检索
【1.3 商业价值】
文化价值:将传统排盘算法代码化,为数字人文研究提供可验证样本
技术价值:Python 桌面应用 + RAG 知识库的落地范式,可供同类文化项目参考
用户价值:提供隐私安全的离线排盘工具,降低传统文化学习门槛
可扩展性:模块化架构支持二次开发、SaaS 化改造、教学课件制作
【2.1 技术栈总览】
组件 | 选型 | 版本
-------------|--------------------------|-------------------
编程语言 | Python | 3.13
GUI 框架 | PySide6 (Qt6) | 最新稳定
数据存储 | SQLite(嵌入式) | Python 内置
数据校验 | Pydantic v2 | 最新稳定
农历转换 | lunardate | 最新稳定
数据处理 | pandas + numpy | 最新稳定
向量库 | ChromaDB(本地部署) | 最新稳定
嵌入模型 | bge-small-zh | 中文优化
检索算法 | BM25 + 向量混合 | 自研封装
AI 框架 | LangChain | 最新稳定
打包工具 | PyInstaller | 最新稳定
测试框架 | pytest + hypothesis | 最新稳定
导出库 | openpyxl / reportlab | 最新稳定