Add ephemeris download script and update README

- Add download_ephemeris.sh script for automated JPL ephemeris file downloads
- Support de421, de422, and de440s ephemeris files
- Update README.md with download script usage instructions
- All text in Traditional Chinese

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-09 14:15:25 +08:00
parent 5b78b3c6d9
commit 3407170b8c
2 changed files with 165 additions and 6 deletions

View File

@@ -21,7 +21,8 @@ lunar-converter/
├── api.py # FastAPI REST API 伺服器
├── age_calculator.py # 年齡計算器
├── generate_lunar_calendar_json.py # 批量生成農曆資料
├── de421.bsp / de422.bsp # JPL 星曆檔案(需另行下載)
├── download_ephemeris.sh # JPL 星曆檔案下載腳本
├── de421.bsp / de422.bsp # JPL 星曆檔案
└── lunar_json/ # 生成的農曆資料 JSON 檔案
```
@@ -46,13 +47,24 @@ pip install skyfield jplephem numpy fastapi uvicorn loguru
### 3. 下載 JPL 星曆檔案
從 [JPL 星曆官網](https://naif.jpl.nasa.gov/pub/naif/generic_kernels/spk/planets/) 下載其中一個
使用提供的下載腳本自動下載
- `de421.bsp` (預設,涵蓋 1900-2050)
- `de422.bsp` (較新,涵蓋更長時間範圍)
- `de440s.bsp` (精簡版,適合 1900-2150)
```bash
# 下載預設的 de421 (推薦,涵蓋 1900-2050約 15MB)
./download_ephemeris.sh
將檔案放在專案根目錄。
# 或下載其他版本
./download_ephemeris.sh de422 # 涵蓋更長時間範圍,約 500MB
./download_ephemeris.sh de440s # 精簡版1900-2150約 30MB
./download_ephemeris.sh all # 下載全部版本
```
或從 [JPL 星曆官網](https://naif.jpl.nasa.gov/pub/naif/generic_kernels/spk/planets/) 手動下載,將檔案放在專案根目錄。
**各版本說明:**
- `de421.bsp` - 預設推薦,涵蓋 1900-2050約 15MB
- `de422.bsp` - 涵蓋更長時間範圍(-13000+17000約 500MB
- `de440s.bsp` - 精簡版,涵蓋 1900-2150約 30MB
### 4. 生成農曆資料