AI占星助手 是做什么的?
构建一个占星助手,能够使用与专业工具(例如 Astro-Seek)相同的逻辑计算出生星盘。使用 Swiss Ephemeris(或 pyswisseph、swephR、swisseph-js)作为计算引擎。
何时应用此技能
- 用户要求通过出生数据计算出生星盘、本命盘或星座运势
- 构建占星API、聊天机器人或网络计算器
- 解读行星位置、宫位或相位
- 实现基于星历的占星功能
核心工作流
1. 解析出生数据(日期、时间、地点)→ 验证输入
2. 将本地时间转换为 UTC → 儒略日
3. 计算行星位置(swe_calc_ut)
4. 计算宫位、上升点、中天(swe_houses)
5. 将行星分配到宫位(swe_house_pos)
6. 计算所有行星对之间的相位
7. 可选:应用恒星黄道岁差(ayanamsha)
8. 格式化并解读结果
必需输入
| 输入项 | 是否必需 | 备注 |
|---|---|---|
| 出生日期 | 是 | 日、月、年 |
| 出生时间 | 否* | 当地时间(时、分、秒)。*宫位/上升点计算必需 |
| 出生地点 | 是 | 城市名称或经纬度 |
| 时区 | 是 | 从地点自动获取或手动输入(例如 UTC+1) |
| 夏令时 | 是 | 已实施 / 未实施 |
| 宫位系统 | 否 | 默认:普拉西德制 |
| 黄道系统 | 否 | 默认:回归黄道 |
实现检查清单
1. 时间转换
# 本地时间 → UTC(应用时区 + 夏令时)
# UTC → 儒略日
jd_ut = swe_utc_to_jd(year, month, day, hour, min, sec, SE_GREG_CAL)
# 返回:dret[0]=JD_TT, dret[1]=JD_UT
2. 行星位置
# 对每个天体:太阳(0)、月亮(1)、水星(2)……冥王星(9)、北交点(10/11)、凯龙星(12)、莉莉丝(15)
ret, xx = swe_calc_ut(jd_ut, planet_id, SEFLG_SWIEPH)
# xx[0]=黄经, xx[1]=黄纬, xx[2]=距离, xx[3]=速度(逆行时 < 0)
3. 宫位
# 需要:jd_ut, latitude, longitude, house_system
cusps, ascmc = swe_houses(jd_ut, lat, lon, hsys)
# cusps[1..12] = 宫头, ascmc[0]=上升点, ascmc[1]=中天
4. 宫位分配
house = swe_house_pos(armc, lat, obliquity, hsys, [lon, lat])
5. 相位
计算每对行星之间的角度距离。如果 |距离 - 相位角度| <= 容许度,则该相位有效。
| 相位 | 角度 | 默认容许度 |
|---|---|---|
| 合相 | 0° | 8° |
| 对分相 | 180° | 7° |
| 三分相 | 120° | 6° |
| 四分相 | 90° | 6° |
| 六分相 | 60° | 4° |
6. 恒星黄道(可选)
swe_set_sid_mode(ayanamsha_type) # 例如 SE_SIDM_LAHIRI
# 然后 swe_calc_ut 返回恒星位置
# 或:sidereal_lon = tropical_lon - swe_get_ayanamsa_ut(jd_ut)
输出格式
按以下格式呈现结果:
- 行星表格:行星 | 星座 | 度数 | 宫位 | 逆行
- 宫头:上升点(ASC)、中天(MC)以及宫位 1–12
- 相位列表:行星 A – 相位 – 行星 B(容许度)
- 特殊点:福点、顶点(Vertex)、南北交点、莉莉丝(如果启用)
关键常量
- 行星ID:太阳=0, 月亮=1, 水星=2, 金星=3, 火星=4, 木星=5, 土星=6, 天王星=7, 海王星=8, 冥王星=9, 平均北交点=10, 真北交点=11, 凯龙星=12, 平均莉莉丝=15
- 宫位系统:P=普拉西德制, K=科赫制, R=瑞吉欧蒙塔纳斯制, C=坎帕纳斯制, E=等宫制, W=整宫制
- 黄道星座:0°=白羊座, 30°=金牛座, 60°=双子座……330°=双鱼座
福点
昼生(太阳在地平线上):福点 = 上升点 + 月亮 - 太阳
夜生(太阳在地平线下):福点 = 上升点 + 太阳 - 月亮
错误处理
- 未知出生时间:计算不含宫位的星盘;使用中午或提供“仅日期星盘”选项
- 无效坐标:拒绝或使用后备值(例如首都城市)
- 极地纬度:普拉西德制失效;建议使用等宫制或整宫制
- 日期超出范围:瑞士星历涵盖约 13,000 年;为典型用途验证 1800–2100 年
依赖项
- Python:
pyswisseph+ 星历文件(从 astro.com 下载) - Node.js:
swisseph或astronomia - R:
swephR
设置星历路径:swe_set_ephe_path("/path/to/ephe")
参考与示例
- 完整 API 规范、公式、岁差: reference.md
- 用户流程、响应格式、边缘情况: examples.md