格局

适合：所有人。64 条格局总表在页尾

什么是格局

一张盘上，某几颗星按特定方式凑在一起，传统上会给这个组合起一个名字—— 「紫府同宫」「杀破狼」「阳梁昌禄」都是这样的名字。这类有名字的星耀组合就是格局。

格局不是另一套算法，它只是在已经排好的盘上做模式识别： 看某几颗星是不是落在了某几个宫，亮度够不够，带没带四化。 盘一旦排完，格局就已经确定了。

x-iztro 怎么判

格局这件事在古籍与各家资料里口径并不统一，同一个名字常有宽严两种说法。 这套引擎的取舍原则是：

1. 只做事实判定。输出是「这个组合成立，证据是这几颗星落在这几个宫」， 不含吉凶、强弱、评分。
2. 每条规则注明来源。规则实现里逐条写了古籍引文与所采口径， 以及为什么在两种说法之间选了这一种。
3. 多口径不设开关，用 variant 报出。同一个格局有几种成立形式时， 引擎把命中的那一种记在 variant 字段上，由你决定认不认。 比如「机巨同临」在酉宫成立的那种，variant 是 "you"， 因为另有资料称酉宫不算此格——引擎照报，标注清楚。
4. 「破格」只标记不否决。资料里说的「加杀平常」「破格」这类条件触发时， 格局照样报出来，只把 broken 置为真。成立与否是事实，好坏是解读。
5. 「身命」类格局命中哪宫记哪宫。古籍常写「身命居子午」， 意思是命宫或身宫任一成立即可。这类格局命宫、身宫各判一次， palace_index 记的是实际成格的那一宫，两宫都成立就报两次。
6. 空宫借对宫。宫内没有主星时，按传统借对宫主星参与判定。 证据里记的仍是那颗星真正待的宫，不是借到的宫。
7. 没有金标，自己造证据。iztro 本身没有格局 API， 所以这部分不像排盘那样有逐字段对照的金标数据。代之以四层测试： 每条规则的正反例单测（约 80 个）、来源页 32 张示例盘的真实盘复现、 tier1 那 1,560 张盘上的批量合理性与不变量检查（含每个格局的命中盘数统计）， 以及 4 张盘 × 6 种语言的输出快照——快照由 Rust 写基线，Python 与 Go 读同一批文件比对， 三侧结果必须逐字节一致。

一次命中长什么样

一次命中就是一个 PatternHit，字段在三种编程语言里同名（大小写随语言习惯； 唯 Rust 结构体把 palace_index 叫 palace，序列化 DTO 的键统一是 palaceIndex）：

拿一张盘列出它的全部格局：

let zh = Language::ZhCN;
let chart = by_solar("1985-5-3", 9, Gender::Male, true, zh, Config::default())?;

for hit in chart.patterns() {
    println!("{} {}",
        translate_pattern(hit.key, zh),
        translate_palace(chart.palaces[hit.palace].name, zh));
}

输出

武贪同行 迁移
府相朝垣 命宫
杀破狼 迁移
禄马交驰 命宫
左右夹命 命宫
文贵文华 迁移
文星朝命 命宫
文星暗拱 命宫
文星暗拱 命宫

这张盘的身宫落在迁移宫，所以三条「身命」类格局（武贪同行、杀破狼、文贵文华） 记的是迁移宫而不是命宫。

variant 与 broken 也在同一批命中里：

for hit in chart.patterns():
    if hit.variant or hit.broken:
        print(f"{hit.name}: variant={hit.variant} broken={hit.broken}")

府相朝垣: variant=soul_empty broken=False
禄马交驰: variant=surround broken=False
文星朝命: variant=None broken=True
文星暗拱: variant=opposite broken=False
文星暗拱: variant=surround broken=False

府相朝垣的 soul_empty 表示这张盘的命宫确为空宫（古书「命无主星」那一支， x-iztro 不把它当成格条件，只标注）；文星朝命的 broken 表示命宫三方四正见了煞忌； 禄马交驰的 surround 与文星暗拱的 opposite / surround 各是那条格局的一种成立口径， 逐条含义见页尾总表。

本命与运限是同一套规则

引擎内部把「本命十二宫」和「某个运限层的合成十二宫」抽象成同一种视图， 规则只面对视图。所谓运限视角，就是把这三件事换掉之后再跑一遍全部规则：

• 命宫换成该层的命宫。大限走到哪一宫，那一宫就是这一层的命宫， 十二宫名以它为起点重排。
• 合并该层的流曜。运禄、流禄、运昌、流昌这些流曜，在判定时等同于对应的本命辅星： 运限盘上见到流禄，规则就当见到禄存。
• 四化换成该层的四化。本命视角读生年四化，大限视角读大限干引发的四化，以此类推。

因此资料里说的「本命有此组合，大限又走到即享其益」自然成立—— 在大限视角下重跑本命规则即可。运限视角没有身宫， 「身命」类格局在运限层只判该层命宫。

let h = chart.horoscope("2025-6-1", 0)?;
for hit in h.patterns(Scope::Decadal) {
    println!("{} {:?}", translate_pattern(hit.key, zh), hit.variant);
}

用 2000-8-16 寅时的女命盘，大限视角（Python 版）：

杀破狼 decadal None
风云际会 decadal None
风云际会 decadal yearly

同一张盘的本命视角只有一条「府相朝垣」——大限走到之后， 命宫换了位置，杀破狼才在这一层成立。

两条只在运限出现的格局

64 条里有两条是行运格：只在运限视角判定，本命盘上永远不报。

风云际会的 variant 同时记二限组合与「逢」的松紧：无 variant 或 same_palace 取「大限 + 小限」，yearly 或 yearly_same_palace 取「大限 + 流年」（另有流派取这一种）； 带 same_palace 的是两限命宫皆本宫坐禄马的严口径，不带的是三方四正会照。 两种组合各报一条，最多两条，上面那张盘正是两种组合都成立。

日月的明暗按哪张表

「日月并明」「日月反背」「丹墀桂墀」这几条要看太阳、太阴的明暗， 而明暗的判法有两种传统，结论会不一样：

from x_iztro import Astro, PatternConfig, BrightnessSource

chart = Astro().by_solar("1985-1-5", 11, "female")

print([h.name for h in chart.patterns()])
print([h.name for h in chart.patterns(
    PatternConfig(brightness_source=BrightnessSource.POSITIONAL))])

['禄马交驰', '左右夹命', '坐贵向贵']
['日月并明', '禄马交驰', '左右夹命', '坐贵向贵']

三个口径开关

PatternConfig 只有三个字段。凡是「多口径」的格局一律走 variant， 不在这里加开关；这里只放会改变事实判定本身的数据口径。

关掉 borrow，空宫就是空宫，靠借宫成立的格局不再报； 关掉 flow_stars，运限视角只认本命辅星，流禄流马不参与。 两者都只影响格局判定，不影响排盘结果。

64 条格局总表

按来源页的条目顺序。「类别」一列里，行运表示只在运限视角判定， 其余在本命与运限两种视角下都会判。

判定条件一列写的是形式化条件的要点；每条规则的完整口径、古籍引文 与在两种说法间取舍的理由，写在实现的文档注释里（src/pattern/rules/）。

几处容易误解的地方

API 参考

• Rust — patterns
• Python — patterns
• Go — Patterns

格局释义在知识包里

这一页与三个 API 参考页讲的是判定：哪几颗星怎么凑在一起才算成格。 成格之后「这条格局意味着什么」是解读，属于门派观点， 放在知识包里—— 内嵌的默认包给了 64 条格局各自的古籍引文、成立条件的文字描述与解读正文。

命中的 key 就是知识包 patterns 段的键，直接对上：

pack = KnowledgePack.builtin()

for hit in chart.patterns():
    print(hit.name, "|", pack.pattern(hit.key).quotes[0])

不认同其中的说法，写一份覆盖包换掉那几条，判定结果不变。

来源与署名

格局规则的条目、示例盘与古籍引文取自 iztro-docs《格局》页（MIT License，作者 Sylar Long）， 引文本身出自《紫微斗数全书》。格局判定引擎、六语言格局名、 以及在多种说法之间的取舍与形式化，是 x-iztro 的实现—— iztro 本身没有对应的 API。