ziwei-paipan

FateStar Ziwei

Use the bundled CLI to request deterministic Zi Wei Dou Shu chart data from FateStar. Keep free charting separate from the optional paid reading service.

Choose the operation

• Use chart for a natal chart. It is free and works anonymously.
• Use transits for decade, minor-cycle, annual, monthly, daily, and hourly transit data. It is free and works anonymously.
• Offer reading only when the user wants the hosted Zheng Da Qian interpretation. It requires an FSFSKey and may consume credits.

Never call reading, or any other paid endpoint, until the user explicitly chooses it and acknowledges that credits may be consumed. A request such as “看事业运” is not consent to spend credits: use the free chart data first, then offer the paid reading as an option.

Collect input

Require these fields and ask for any that are missing. Do not guess them:

• birth year, month, and day;
• birth hour from 0 to 23;
• gender: male or female.

Use solar as the calendar unless the user says the date is lunar. Accept birth minute, longitude, and timezone when the user wants true-solar-time correction.

Run the CLI

Treat the directory containing this file as <skill_dir>. Prefer Python, then Node.js, then the platform shell:

• Python 3.6+: python <skill_dir>/scripts/ziwei_cli.py
• Node.js 12+: node <skill_dir>/scripts/ziwei_cli.js
• Windows PowerShell 5.1+: powershell -ExecutionPolicy Bypass -File <skill_dir>/scripts/ziwei_cli.ps1
• Bash 4+ with curl: bash <skill_dir>/scripts/ziwei_cli.sh

If <skill_dir>/runtime.conf exists, follow its configured runtime and command. Run <cmd> doc for the complete offline parameter reference.

# Free natal chart
<cmd> chart --year 1990 --month 7 --day 23 --hour 8 --gender male

# Free transits for 2026
<cmd> transits --year 1990 --month 7 --day 23 --hour 8 --gender male --target-year 2026

# Optional hosted reading; confirm possible credit use first
<cmd> reading --year 1990 --month 7 --day 23 --hour 8 --gender male --question "Should I change jobs this year?"