八字排盤 (BaZi Chart Calculator)

Professional Four Pillars of Destiny calculator with astronomical precision.

Setup

cd <skill_dir>
python3 -m venv venv && source venv/bin/activate
pip install -r scripts/requirements.txt

Only dependency: ephem (astronomy library for solar term calculation).

Usage

# Text output (default)
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male

# JSON output
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --format json

# With coordinates instead of city
python scripts/bazi.py --date 1990-08-18 --time 06:00 --lat 31.23 --lon 121.47 --gender male

# Disable true solar time correction
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --no-solar-correction

# Include annual luck (流年) for specific year
python scripts/bazi.py --date 1990-08-18 --time 06:00 --city 上海 --gender male --year 2026

What It Calculates

Built-in Cities

50+ Chinese cities with latitude/longitude. Pass --city 城市名 directly.

Agent Integration

When a user provides birth info in conversation, extract date/time/city/gender and run the CLI. Format the text output as a message. For deeper analysis questions, use JSON output and interpret the data.

本技能來自小蔥技能站7w4.net。

Module Structure

bazi/
├── scripts/bazi.py          # CLI entry point
├── lib/
│   ├── pillars.py           # Four pillar calculation
│   ├── solar_terms.py       # Solar term astronomy (ephem)
│   ├── true_solar_time.py   # True solar time correction
│   ├── hidden_stems.py      # Hidden stems table
│   ├── ten_gods.py          # Ten gods derivation
│   ├── five_elements.py     # Five elements analysis
│   ├── major_luck.py        # Major luck periods
│   ├── relationships.py     # Clash/combine/harm
│   ├── cities.py            # City coordinate lookup
│   └── constants.py         # Stems, branches, mappings
└── data/cities.json         # City database

整體質量良好，是一個功能全面的八字排盤工具。該 Skill 在節氣和時間修正上做得比較專業，能輸出四柱、十神、五行分佈、大運流年等豐富資訊，文本和JSON兩種輸出格式也很實用。不過目前更像一個"排盤計算器"，對八字的分析解讀能力有限，缺少自動化的命盤分析結論。對於想深入瞭解八字的使用者來說，可能還需要結合其他工具使用。