Astro Natal Chart

核心用法

astro-natal-chart 是一款专业级占星本命盘生成工具，采用NASA JPL DE431星历数据（Swiss Ephemeris）进行精确天文计算，输出5760×2880像素的高分辨率合成图。核心工作流为：natal_chart_swe.py 计算引擎 → JSON数据 → draw_wheel.py 渲染器生成PNG图像。

主要功能

• 精准天文计算：行星位置（含逆行检测）、十二宫位（Placidus分宫制）、主要相位（8种，含容许度）
• 双语解读面板：俄/英切换（--lang ru/en），含太阳/月亮/上升星座分析、宫位详解、元素分布、格局提示
• 专业可视化：左侧本命盘轮+右侧扩展解读面板，含黄道符号、行星标记、相位线、ASC/MC轴线、图例
• CLI灵活输入：支持任意出生日期、时间、地点，输出文件名自动包含人名

显著优点

1. 计算权威性高：Swiss Ephemeris为天文学界标准工具，误差<0.001角秒
2. 架构清晰：单一计算源保证文本与图形输出严格一致，无数据漂移
3. 本地化完善：内置50+城市坐标/时区数据库，俄英双语完整覆盖
4. 零依赖安装：捆绑.pyd二进制，无需系统级pip安装swisseph

潜在局限与风险

• 平台锁定：仅Windows x64，需Python 3.14.x + MSVC++ Redist 2015-2022
• 娱乐性质明确：文档免责声明强调"非科学方法"，不可用于医疗/财务决策
• 领域局限：西方占星体系，不含印度/中国占星流派
• 字体硬编码：依赖捆绑的Segoe系列字体，自定义字体需修改源码

适合人群

• 占星爱好者、占星师（需本命盘可视化）
• 灵性/自我探索领域的内容创作者
• 对NASA星历数据有好奇心的技术用户

常规风险提示

• 输出内容属主观解读框架，无实证科学支撑
• 行星位置数据虽天文精确，但"宫位意义""相位解读"为文化建构
• 避免将输出用于重大人生决策的单一依据

核心用法

Astro Natal Chart 是一款专业级占星术出生星盘计算与可视化工具。用户只需提供出生日期、时间和地点，即可生成包含完整天文数据的星盘分析报告。

计算引擎：采用 Swiss Ephemeris（pyswisseph 2.10.3.2），基于 NASA JPL DE431 星历表进行精密天文计算，支持行星位置、宫位划分、相位分析等核心功能。通过 --json 标志可导出结构化数据供二次开发。

图形渲染：使用 Pillow 库生成 5760×2880 像素的高清星盘图，采用双轮布局设计——左侧为带宫位的本命盘，右侧为纯黄道行星圈，中间嵌入关键数据面板。支持英俄双语界面，输出文件名自动包含人名与语言标识。

双语解读：v4.0.0 版本新增扩展解读面板，涵盖太阳/月亮/上升星座分析、主导元素判断、群星格局检测、逆行行星解读，以及全部 12 宫位的详细释义。

显著优点

1. 天文级精度：告别简化算法，采用与专业天文软件同源的 Swiss Ephemeris 计算引擎，行星位置精度达角秒级。

2. 视觉专业化：4K 分辨率输出、元素配色系统（火/土/风/水）、智能字体切换（西文/俄文/占星符号），成品可直接用于印刷或展示。

3. 架构可靠性：单一数据源设计——natal_chart_swe.py 作为唯一计算引擎，draw_wheel.py 仅负责渲染，确保文本与图形输出完全一致。

4. 本地化完善：内置完整俄英双语词库，涵盖行星含义、星座关键词、宫位解读、相位释义等全部文本内容。

5. 零依赖安装：核心计算所需的 .pyd 二进制文件与字体资源已捆绑打包，无需系统级 Python 库安装。

潜在缺点与局限性

• 平台受限：仅支持 Windows x64 系统，且需要 Python 3.14.x 与 Microsoft Visual C++ Redistributable 2015–2022 运行环境。

• 硬编码路径：输出目录默认为 C:\Users\alter\.openclaw\workspace，需手动修改源码适配不同环境。

• 自动安装行为：Pillow 缺失时会自动执行 pip install，在受限网络环境中可能失败。

• 二进制恢复机制：.pyd.dat 与 .ttf.dat 文件在运行时恢复为可执行格式，可能触发安全软件警报。

• 娱乐性声明：工具本身明确标注为"娱乐/教育用途"，非科学预测手段。

适合的目标群体

• 占星爱好者：需要快速生成专业视觉星盘用于学习或社交分享的个人用户
• 占星从业者：寻求标准化、可批量生成解读报告的专业咨询人士
• 内容创作者：制作占星主题图文、视频、印刷品的自媒体运营者
• 俄语区用户：原生支持俄语界面与解读文本，填补该语言区工具空白
• 技术开发者：JSON 数据导出功能便于集成至更大型的应用系统

使用风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 原生代码执行 | 包含 Windows 原生扩展 (.pyd)，存在平台绑定与潜在安全扫描误报 | 在受控环境运行，验证文件哈希 |

| 依赖自动安装 | 自动 pip install 可能引入非预期版本或网络失败 | 预先手动安装 Pillow 12.x |

| 输出路径固定 | 硬编码路径可能导致权限错误或数据写入非预期位置 | 执行前修改源码中的 `_out` 变量 |

| 输入数据隐私 | 出生信息属于个人敏感数据 | 本地处理，无网络传输；使用者自行保管输出文件 |