星盘对象

chart = Astro().by_solar("2000-8-16", 2, "female")

def palace(self, index_or_name: int | PalaceName | str) -> Palace | None

soul = chart.palace("soulPalace")
print(soul.name, soul.heavenly_stem + soul.earthly_branch)

print("身宫落在", chart.palace("bodyPalace").name)
print("来因宫是", chart.palace("originalPalace").name)
print("寅宫是", chart.palace(0).name)

命宫 壬午
身宫落在 官禄
来因宫是 夫妻
寅宫是 财帛

def star(self, star: str) -> Star | None
def star_in_palace(self, star: str) -> tuple[Star, Palace] | None

ziwei = chart.star("ziweiMaj")

print(ziwei.name, "在", ziwei.palace().name)
print("对宫是", ziwei.opposite_palace().name)
print("亮度", ziwei.brightness, "四化", ziwei.mutagen)

star, palace = chart.star_in_palace("ziweiMaj")
print(star.key, palace.name_key)

紫微 在 命宫
对宫是 迁移
亮度 庙 四化 None
ziweiMaj soulPalace

def surrounded_palaces(self, index_or_name: int | PalaceName | str) -> SurroundedPalaces | None

sp = chart.surrounded_palaces("soulPalace")

print(sp.target.name, sp.opposite.name, sp.wealth.name, sp.career.name)
print("三方四正见紫微:", sp.have(["ziweiMaj"]))

命宫 迁移 财帛 官禄
三方四正见紫微: True

def is_surrounded(self, index_or_name: int | PalaceName | str, stars: list[str]) -> bool
def is_surrounded_one_of(self, index_or_name: int | PalaceName | str, stars: list[str]) -> bool
def not_surrounded(self, index_or_name: int | PalaceName | str, stars: list[str]) -> bool

print(chart.is_surrounded("soulPalace", ["ziweiMaj", "tianxiangMaj"]))
print(chart.is_surrounded_one_of("soulPalace", ["qishaMaj", "pojunMaj"]))
print(chart.not_surrounded("soulPalace", ["huoxingMin"]))

True
False
True

def flanking_palaces(self, index_or_name: int | PalaceName | str) -> FlankingPalaces | None

f = chart.flanking_palaces("soulPalace")

print(f.previous.name, "/", f.next.name)
print(f.have(["tianjiMaj", "tuoluoMin"]))
print(f.have_one_of(["huoxingMin"]))

w = chart.flanking_palaces("wealthPalace")
print(w.previous.name, "/", w.next.name)
print(w.have_mutagen("sihuaLu"), w.have_mutagen("sihuaJi"))

兄弟 / 父母
True
False
疾厄 / 子女
True True

def horoscope(
    self,
    target_date: str | None = None,
    target_time_index: int | None = None,
) -> Horoscope

h = chart.horoscope("2025-6-1", 0)

print("大限", h.decadal.heavenly_stem + h.decadal.earthly_branch)
print("流年", h.yearly.heavenly_stem + h.yearly.earthly_branch)

# 两个参数都可省略，取当下
now = chart.horoscope()

大限 庚辰
流年 乙巳

def to_text(
    self,
    *,
    knowledge: bool | KnowledgePack | None = None,
    config: PatternConfig | None = None,
) -> str

print(chart.to_text().splitlines()[0])

text = chart.to_text(knowledge=True)
print(len(chart.to_text()), len(text))
print(" ".join(l for l in text.splitlines() if l.startswith("## ")))

# 命盘 2000-8-16 寅时 女
3389 20767
## 基本信息 ## 十二宫总览 ## 格局 ## 十二宫 ## 四化释义

def to_dict(self) -> dict[str, Any]
def to_json(self, **kwargs: Any) -> str

d = chart.to_dict()
print(d["solarDate"], d["palaces"][4]["nameKey"])
print(d["config"]["yearDivide"], d["genderKey"], d["timeIndex"])

import json
print(json.dumps({k: d[k] for k in ("gender", "solarDate", "lunarDate")},
                 ensure_ascii=False))
print(len(chart.to_json()) > 10000, chart.to_json()[:1])

2000-8-16 soulPalace
normal female 2
{"gender": "女", "solarDate": "2000-8-16", "lunarDate": "二〇〇〇年七月十七"}
True {