核心用法
astro-natal-chart 是一款基于瑞士星历表(Swiss Ephemeris)的专业占星本命盘生成工具,核心流程分为三步:计算引擎 natal_chart_swe.py 通过 pyswisseph 调用 NASA JPL DE431 星历数据进行精确天文计算,输出 JSON 格式的行星位置、宫位、相位数据;渲染器 draw_wheel.py 调用该 JSON 生成 5760×2880 像素的高清星盘图,采用左中右三栏布局(本命盘轮 | 基础数据 | 解读面板);可选通过 --conclusion 参数嵌入 AI 生成的综合解读。
显著优点
- 计算权威性:使用 pyswisseph 2.10.3.2,基于 NASA JPL DE431 星历表,行星位置精度达角秒级
- 架构严谨:单一数据源设计,文本输出与图形渲染完全同源,杜绝数据不一致
- 可视化专业:4K 超高清输出,12 宫位彩色分区、逆行标记、相位连线、ASC/MC 轴线完整呈现
- 双语深度解读:内置俄/英双语解读数据库,涵盖太阳/月亮/上升星座分析、元素分布、星群格局、12 宫位全解
- 字体兼容优化:捆绑
seguisym.ttf(黄道符号)与segoeuisl.ttf(西里尔/拉丁),按字符智能切换字体
潜在局限
- 平台限制:仅支持 Windows x64,需 Python 3.14.x 及 MSVC++ 2015-2022 运行库
- 科学性质疑:占星学缺乏科学实证基础,工具明确标注为娱乐/教育用途
- 依赖 bundling:核心计算依赖 2MB 的
.pyd二进制文件,跨版本 Python 兼容性受限 - 无实时天象:仅支持本命盘计算,不包含行运、推运等动态占星功能
适合人群
占星爱好者、心理咨询师(作为辅助谈话工具)、文化研究者、个人成长探索者。不适合用于医疗诊断、财务决策或任何需要科学严谨性的场景。
常规风险
- 用户可能过度依赖占星解读进行重大人生决策
- 地理位置/时区数据库覆盖有限(约50+城市),偏远地区需手动输入经纬度
- 出生时间误差会导致宫位系统(Placidus)显著偏差, especially 近两极地区