数据表

排盘算法的输入表与语言无关标识的枚举清单。

from x_iztro import data

四个入口返回的都是具名 dataclass（外层容器仍是 dict / list），字段用属性访问而不是下标。字段名是 snake_case，与底层 JSON 的 camelCase 键不同。

stars_info

用途　取星耀基础信息表。

签名

def stars_info() -> dict[str, StarInfo]

返回值　星耀标识 → StarInfo。只有二十颗星有记录：十四主星加文昌、文曲、火星、铃星、擎羊、陀罗。

字段	类型	说明
`brightness`	`list[str]`	十二宫亮度标识，索引 0 为寅宫；该宫无亮度则为空串
`five_elements`	`str \| None`	五行
`yin_yang`	`str \| None`	阴阳

示例

info = data.stars_info()

print(len(info))
print(info["ziweiMaj"])
print(info["taiyangMaj"].five_elements)

输出

20
StarInfo(brightness=['wang', 'wang', 'de', 'wang', 'miao', 'miao', 'wang', 'wang', 'de', 'wang', 'ping', 'miao'], five_elements='土', yin_yang='阴')
None

边界与陷阱

五行与阴阳有空缺

表中部分星耀的五行或阴阳未填：太阳与七杀两项皆为 None，贪狼、天相、天梁、破军的阴阳为 None，六颗辅星两项皆为 None。

heavenly_stems

用途　取天干信息表。

斗数含义　天干的四化表是四化系统的根：生年干决定生年四化，宫干决定该宫飞出的四化，运限干决定该层级的四化。

签名

def heavenly_stems() -> dict[str, HeavenlyStemInfo]

返回值　天干标识 → HeavenlyStemInfo：

字段	类型	说明
`yin_yang`	`str`	阴阳
`five_elements`	`str`	五行
`crash`	`str \| None`	对冲天干标识；戊、己无对冲
`mutagen`	`list[str]`	四化四星标识，顺序为禄、权、科、忌

示例

stems = data.heavenly_stems()

print(stems["jiaHeavenly"])
print(stems["wuHeavenly"].crash)

输出

HeavenlyStemInfo(yin_yang='阳', five_elements='木', crash='gengHeavenly', mutagen=['lianzhenMaj', 'pojunMaj', 'wuquMaj', 'taiyangMaj'])
None

这是内置默认表。自定义四化表（ChartConfig(mutagens=...)）不会反映在这里；要看某张盘上实际生效的四化，用 utils.get_mutagens_by_heavenly_stem(stem, config) 或宫位的 mutagen_star_keys。

earthly_branches

用途　取地支信息表。

签名

def earthly_branches() -> dict[str, EarthlyBranchInfo]

返回值　地支标识 → EarthlyBranchInfo：

字段	类型	说明
`yin_yang`	`str`	阴阳，决定大限与长生十二神的顺逆
`five_elements`	`str`	五行
`crash`	`str`	对冲地支标识
`soul`	`str`	命主星标识（按命宫地支查）
`body`	`str`	身主星标识（按生年地支查）
`inside`	`str`	对应脏腑
`outside`	`str`	对应身体部位
`health_tip`	`str`	健康提示

inside / outside / health_tip 三项只有中文一种写法，不参与国际化。

示例

zi = data.earthly_branches()["ziEarthly"]

print(zi)
print(zi.soul, zi.body, zi.crash)

输出

EarthlyBranchInfo(yin_yang='阳', five_elements='水', crash='wuEarthly', soul='tanlangMaj', body='huoxingMin', inside='胆', outside='下体', health_tip='生殖系统、膀胱、尿道之疾病，听觉障碍')
tanlangMaj huoxingMin wuEarthly

constants

用途　取顺序常量与推算规则表。

签名

def constants() -> Constants

返回值　Constants：

字段	类型	说明
`languages`	`list[str]`	支持的语言代码
`heavenly_stems`	`list[str]`	天干顺序
`earthly_branches`	`list[str]`	地支顺序
`zodiac`	`list[str]`	生肖标识，按地支顺序
`signs`	`list[str]`	星座标识，按黄道顺序
`palaces`	`list[str]`	十二宫名，从命宫起逆时针排
`gender`	`dict[str, str]`	男女各自的阴阳
`chinese_time`	`list[str]`	时辰标识，早子时起、晚子时止
`time_range`	`list[str]`	时辰对应的钟点区间
`tiger_rule`	`dict[str, str]`	五虎遁：年干推正月天干
`rat_rule`	`dict[str, str]`	五鼠遁：日干推子时天干
`mutagen`	`list[str]`	四化顺序
`five_elements_class`	`dict[str, int]`	五行局标识 → 局数（水二局 2 …… 火六局 6）

示例

c = data.constants()

print(c.languages)
print(c.zodiac[:3], c.chinese_time[12], c.time_range[2])
print(c.gender)
print("甲年正月干:", c.tiger_rule["jiaHeavenly"])
print(c.palaces)
print(c.five_elements_class)

输出

['en-US', 'ja-JP', 'ko-KR', 'zh-CN', 'zh-TW', 'vi-VN']
['rat', 'ox', 'tiger'] lateRatHour 03:00~05:00
{'female': '阴', 'male': '阳'}
甲年正月干: bingHeavenly
['soulPalace', 'parentsPalace', 'spiritPalace', 'propertyPalace', 'careerPalace', 'friendsPalace', 'surfacePalace', 'healthPalace', 'wealthPalace', 'childrenPalace', 'spousePalace', 'siblingsPalace']
{'earth5th': 5, 'fire6th': 6, 'metal4th': 4, 'water2nd': 2, 'wood3rd': 3}

边界与陷阱

palaces 是逆时针序，不是盘上位置

palaces 给的是宫名的排列顺序：命、父母、福德、田宅、官禄、仆役、迁移、疾厄、财帛、子女、夫妻、兄弟。这是十二宫从命宫起逆时针铺开的次序，不是某张盘上第 i 格叫什么。要那个用 utils.get_palace_names(soul_index)。

languages 的顺序是 iztro 词表的合并次序（en-US 起），不是 Language 枚举的声明次序。 i18n.key_of 的逐语言扫描顺序与它一致。

five_elements_class、gender、tiger_rule、rat_rule 四项是 dict 而非 list，键的次序是字典序（原生扩展转过来时排过序），不代表五行局或天干的排列顺序。局数也可以直接从枚举取：FiveElementsClass.WOOD_3.number。

枚举清单

x_iztro.enums 里的每个枚举都是 StrEnum，取值就是语言无关标识。从包根直接导入：from x_iztro import MajorStar, PalaceName。

枚举	成员数	成员
`Gender`	2	`MALE` `FEMALE`
`Language`	6	`ZH_CN` `ZH_TW` `EN_US` `JA_JP` `KO_KR` `VI_VN`
`HeavenlyStem`	10	`JIA` `YI` `BING` `DING` `WU` `JI` `GENG` `XIN` `REN` `GUI`
`EarthlyBranch`	12	`ZI` `CHOU` `YIN` `MAO` `CHEN` `SI` `WU` `WEI` `SHEN` `YOU` `XU` `HAI`
`PalaceName`	14	十二宫 `SOUL` `SIBLINGS` `SPOUSE` `CHILDREN` `WEALTH` `HEALTH` `SURFACE` `FRIENDS` `CAREER` `PROPERTY` `SPIRIT` `PARENTS`，外加两个定位标记 `BODY`（身宫）`ORIGINAL`（来因宫）
`FiveElementsClass`	5	`WATER_2` `WOOD_3` `METAL_4` `EARTH_5` `FIRE_6`
`Mutagen`	4	`LU` `QUAN` `KE` `JI`
`Brightness`	7	`MIAO` `WANG` `DE` `LI` `PING` `BU` `XIAN`
`StarType`	8	`MAJOR` `SOFT` `TOUGH` `ADJECTIVE` `FLOWER` `HELPER` `LUCUN` `TIANMA`
`Scope`	6	`ORIGIN` `DECADAL` `YEARLY` `MONTHLY` `DAILY` `HOURLY`
`MajorStar`	14	十四主星，`ZIWEI` `TIANJI` `TAIYANG` `WUQU` `TIANTONG` `LIANZHEN` `TIANFU` `TAIYIN` `TANLANG` `JUMEN` `TIANXIANG` `TIANLIANG` `QISHA` `POJUN`
`MinorStar`	14	十四辅星，`ZUOFU` `YOUBI` `WENCHANG` `WENQU` `LUCUN` `TIANMA` `QINGYANG` `TUOLUO` `HUOXING` `LINGXING` `TIANKUI` `TIANYUE` `DIKONG` `DIJIE`
`AdjectiveStar`	43	杂耀，含中州派的 `XUNZHONG`（旬中）；成员对照见星耀
`HoroscopeStar`	50	五个运限层级各十颗流耀，`YUNLU` `LIULU` `YUELU` `RILU` `SHILU` 等
`Changsheng12`	12	`CHANGSHENG` `MUYU` `GUANDAI` `LINGUAN` `DIWANG` `SHUAI` `BING` `SI` `MU` `JUE` `TAI` `YANG`
`Boshi12`	12	`BOSHI` `LISHI` `QINGLONG` `XIAOHAO` `JIANGJUN` `ZHOUSHU` `FEILIAN` `XISHEN` `BINGFU` `DAHAO` `FUBING` `GUANFU`
`Suiqian12`	13	`SUIJIAN` `HUIQI` `SANGMEN` `GUANSUO` `GWANFU` `XIAOHAO` `DAHAO` `SUIPO` `LONGDE` `BAIHU` `TIANDE` `DIAOKE` `BINGFU`（`SUIPO` 为中州派的岁破）
`Jiangqian12`	12	`JIANGXING` `PANAN` `SUIYI` `XISHEN` `HUAGAI` `JIESHA` `ZHAISHA` `TIANSHA` `ZHIBEI` `XIANCHI` `YUESHA` `WANGSHEN`
`Algorithm`	2	`DEFAULT` `ZHONGZHOU`
`AstroType`	3	`HEAVEN` `EARTH` `HUMAN`
`YearDivide` / `HoroscopeDivide`	各 2	`NORMAL` `EXACT`
`AgeDivide`	2	`NORMAL` `BIRTHDAY`
`DayDivide`	2	`FORWARD` `CURRENT`

成员名与它的取值不总是拼音对应——Boshi12.FEILIAN 的值是 faylian， Jiangqian12.XISHEN 的值是 xiishen，Suiqian12.GWANFU 的值是 gwanfu。这些拼写沿用 iztro 的词表，判断一律用枚举成员，不要手写字符串。全部标识与译名的对照见标识总表。

FiveElementsClass.number

五行局枚举多一个属性 number，给出局数——大限起运岁数与起紫微都用它：

from x_iztro import FiveElementsClass

for c in FiveElementsClass:
    print(c, c.number)

输出

water2nd 2
wood3rd 3
metal4th 4
earth5th 5
fire6th 6

示例

from x_iztro import MajorStar, PalaceName, Mutagen

soul = chart.palace(PalaceName.SOUL)

print(soul.major_stars[0].key == MajorStar.ZIWEI)
print(MajorStar.ZIWEI, Mutagen.LU, PalaceName.WEALTH)

输出

True
ziweiMaj sihuaLu wealthPalace

StrEnum 与字符串等价

chart.palace(PalaceName.SOUL) 与 chart.palace("soulPalace") 完全等价。枚举的价值在于 IDE 补全与拼写检查，而非类型约束。

名字来自外部输入时，用构造函数当校验器：PalaceName("soulPalce") 抛 ValueError: 'soulPalce' is not a valid PalaceName，比让查询方法静默返回 None 早一步暴露问题。