人工智慧占星助手
建立一個占星助手,使用與專業工具(例如 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) |
| 日光節約時間 | 是 | 有觀測 / 未觀測 |
| 宮位系統 | 否 | 預設:Placidus |
| 黃道系統 | 否 | 預設:回歸黃道 |
實作檢查清單
1. 時間轉換
# 當地時間 → UTC(套用時區 + DST)
# 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(容許度)
- 特殊點:福點、頂點、月亮交點、莉莉絲(若啟用)
主要常數
- 行星 ID:太陽=0, 月亮=1, 水星=2, 金星=3, 火星=4, 木星=5, 土星=6, 天王星=7, 海王星=8, 冥王星=9, 平均交點=10, 真實交點=11, 凱龍星=12, 平均莉莉絲=15
- 宮位系統:P=Placidus, K=Koch, R=Regiomontanus, C=Campanus, E=Equal, W=Whole Sign
- 黃道星座:0°=牡羊座, 30°=金牛座, 60°=雙子座... 330°=雙魚座
福點
日生盤(太陽在地平線上):福點 = ASC + 月亮 - 太陽
夜生盤(太陽在地平線下):福點 = ASC + 太陽 - 月亮
錯誤處理
- 未知出生時間:計算不含宮位的星盤;使用中午或提供「僅日期星盤」
- 無效座標:拒絕或使用備用值(例如首都)
- 極地緯度:Placidus 會失敗;建議 Equal 或 Whole Sign
- 日期超出範圍:Swiss Ephemeris 涵蓋約 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