Config 详解

六个开关分别改变什么、自定义四化表与亮度表怎么传、什么时候会看出差别。

适合：开发者 · 命理爱好者（前半页的流派差异不需要会写代码）

排盘中真正有分歧的地方都收在 Config 里：六个开关，外加两张可整表替换的数据表。默认值与 JS iztro 完全一致，所以不传配置就能得到与 iztro 相同的盘。

开关	取值	默认	管什么
`year_divide`	`normal` / `exact`	`normal`	排盘年干支按哪天换年
`horoscope_divide`	`normal` / `exact`	`normal`	运限干支与月柱按哪天分界
`age_divide`	`normal` / `birthday`	`normal`	虚岁什么时候加一
`day_divide`	`forward` / `current`	`forward`	晚子时算今天还是明天
`algorithm`	`default` / `zhongzhou`	`default`	算法派别
`astro_type`	`heaven` / `earth` / `human`	`heaven`	排盘视角（天盘/地盘/人盘）

另有两张覆盖表：mutagens（自定义四化表）与 brightness（自定义亮度表），见自定义四化表与亮度表。

怎么传

use x_iztro::data::types::*;

let config = Config {
    algorithm: Algorithm::Zhongzhou,
    year_divide: YearDivide::Exact,
    ..Config::default()
};
by_solar("2000-8-16", 2, Gender::Female, true, Language::ZhCN, config)?;

from x_iztro import ChartConfig
from x_iztro.enums import Algorithm, YearDivide

config = ChartConfig(
    algorithm=Algorithm.ZHONGZHOU,
    year_divide=YearDivide.EXACT,
)
astro.by_solar("2000-8-16", 2, "female", config=config)

cfg := &iztro.Config{
    Algorithm:  "zhongzhou",
    YearDivide: "exact",
}
iztro.BySolar("2000-8-16", 2, iztro.GenderFemale, true, iztro.LanguageZhCN, cfg)

Python 与 Go 都只需填要改的键，其余取默认；Rust 用 ..Config::default() 达到同样效果。

年分界点 `year_divide`

决定排盘用的年干支在哪一天换年。

取值	换年时点
`normal`（默认）	农历正月初一
`exact`	立春

年干支是一连串东西的源头：本命四化、命主与身主、十二宫宫干。所以这个开关一旦改变，整张盘可能大幅不同。

什么时候会看出差别：出生在农历正月初一与立春之间的人。这两个日期通常相差几天到半个月，落在这个窗口里的生日，两种配置排出的年干支相差一位。

什么时候该选 exact

八字体系一律以立春换年，所以要与八字盘对齐时选 exact。紫微斗数的通行做法是以正月初一换年，normal 也是 iztro 的默认。拿不准就别动 —— 改了就不再与 iztro 的默认输出一致。

年支分成三份用

x-iztro 复刻了 iztro 内部的一处细节：依赖年支的东西并非全走同一个开关。分工是固定的三条：

跟 year_divide 的年干支：生年四化、命主与身主、十二宫宫干、禄存、擎羊、陀罗、天魁、天钺、天马、红鸾、天喜、长生十二神、博士十二神
跟 horoscope_divide 的年干支：其余全部年系杂耀，以及本命盘上的岁前十二神与将前十二神
跟 horoscope_divide 的月分界：本命四柱里的月柱

两个开关可以分别设，所以「主星按一个年支、部分杂耀按另一个年支」是可能出现的。这看起来不对称，但它就是 iztro 的实际行为，为保证零差异必须原样保留。

运限分界点 `horoscope_divide`

决定运限干支、本命月柱与干支纪月在哪一天分界。

取值	年分界	月分界
`normal`（默认）	正月初一	初一，以五虎遁推月干
`exact`	立春	节气

什么时候会看出差别：查询日期落在年初（正月初一到立春之间）或每个节气交接的前后，流年与流月的干支会差一位，进而改变运限四化。

这个开关还会改本命盘的月柱——不只是运限。例如 2000-8-5 寅时：normal 下四柱是 庚辰甲申乙未戊寅， exact 下是 庚辰癸未乙未戊寅，月柱由甲申变癸未。

虚岁分界点 `age_divide`

决定虚岁什么时候加一，直接影响小限落在哪个宫。

取值	加岁时点
`normal`（默认）	跨农历年即加一岁
`birthday`	过了农历生日才加一岁

什么时候会看出差别：查询日期落在农历新年与本人农历生日之间。这段时间两种配置的虚岁相差一岁，小限也就落在相邻的两个宫。

晚子时归属 `day_divide`

决定 23:00–24:00 出生（时辰索引 12）的人，日柱按哪一天算。

取值	行为
`forward`（默认）	晚子时归次日，按次日的日柱排盘
`current`	晚子时归当天，按当日早子时排盘

什么时候会看出差别：只影响时辰索引为 12 的盘，其余时辰完全无差异。

forward 下农历日也一并进位，但展示串不变

forward 会把日柱与起紫微用的农历日一起推到次日，但星盘上的农历日期展示串仍显示出生当日。

例如 2000-8-16 晚子时：农历日期照旧显示「二〇〇〇年七月十七」，四柱却是 庚辰甲申丁未庚子 —— 日柱丁未已是 8 月 17 日的。读结果时别拿农历展示串去反推日柱。

无论选哪种，时辰索引字段都保留原始传入值 12，不会因为归到次日就变成 0 —— 这样调用方始终能知道出生的真实时辰。

算法派别 `algorithm`

取值	说明
`default`（默认）	通行的安星规则，与 JS iztro 默认一致
`zhongzhou`	中州派

中州派与默认派的差别集中在四处，四化表不在其中：

改动	`default`	`zhongzhou`
命主怎么查	按命宫地支	按生年地支（因此换命宫重排时命主不再变）
岁前十二神	大耗 `dahao`	岁破 `suipo`
杂耀	截路 `jielu`、空亡 `kongwang`	截空 `jiekong`、劫杀 `jieshaAdj`、大耗 `dahao`、龙德 `longde`
天伤天使	天伤在仆役、天使在疾厄	阴阳男女互换，两星位置对调

algorithm 不改四化表

庚干化科在两派下都是太阴 —— 要换四化取法请用下面的自定义四化表，不要指望 algorithm。

astro.by_solar("1990-11-5", 4, "male", config=ChartConfig(algorithm=Algorithm.ZHONGZHOU))

排盘视角 `astro_type`

中州派把同一组出生数据看作三张盘，差别只在用哪一宫的干支起五行局：

视角	起五行局的宫	新盘的命宫
`heaven` 天盘	命宫	命宫（即常规排盘结果）
`earth` 地盘	身宫	身宫
`human` 人盘	福德宫	福德宫

五行局一变，紫微天府的落点、十二宫名、身宫地支、长生十二神、大限小限全部跟着变；辅星、杂耀（天伤天使天才随命宫走，会重新落位）、博士十二神、岁前将前十二神沿用天盘。

earth = astro.by_solar("2000-8-16", 2, "female",
                       config=ChartConfig(astro_type=AstroType.EARTH))

earth, _ := iztro.BySolar("2000-8-16", 2, iztro.GenderFemale, true, iztro.LanguageZhCN,
    &iztro.Config{AstroType: iztro.AstroEarth})

let earth = by_solar("2000-8-16", 2, Gender::Female, true, Language::ZhCN,
    Config::default().with_astro_type(AstroType::Earth))?;

JS iztro 把 astroType 放在 withOptions 的选项对象上，因为它的 config() 是全局单例、装不下按盘变化的值。x-iztro 的配置本来就随盘传入，所以直接收进 Config，两个排盘入口都能用。

从任意干支起盘

天盘、地盘、人盘之外，也可以指定任意干支为命宫重排：

body = chart.palace(PalaceName.BODY)
earth = chart.rearranged(body.heavenly_stem_key, body.earthly_branch_key)

earth, _ := chart.Rearranged(body.HeavenlyStemKey, body.EarthlyBranchKey)

let earth = chart.rearranged(body.heavenly_stem, body.earthly_branch);

以身宫干支重排，结果与 astro_type = earth 一致。

自定义四化表与亮度表

四化与亮度是流派分歧最集中的两处。Config 允许按标识整表替换：给出某个天干的四化就只改那个天干，未给出的天干仍用默认表；亮度同理。

四化表

一个天干配四颗星，顺序固定为禄、权、科、忌，必须给满四项。

let config = Config::default().with_mutagens(
    HeavenlyStem::Geng,
    [StarKey::TaiyangMaj, StarKey::WuquMaj, StarKey::TiantongMaj, StarKey::TianfuMaj],
);
by_solar("2000-8-16", 2, Gender::Female, true, Language::ZhCN, config)?;

cfg = ChartConfig(mutagens={
    "gengHeavenly": ["taiyangMaj", "wuquMaj", "tiantongMaj", "tianfuMaj"],
})
chart = astro.by_solar("2000-8-16", 2, "female", config=cfg)

cfg := &iztro.Config{Mutagens: map[string][]string{
    "gengHeavenly": {"taiyangMaj", "wuquMaj", "tiantongMaj", "tianfuMaj"},
}}

把庚干换成「天同化科、天府化忌」之后，这张庚年盘的四化变成：

财帛 武曲 权
子女 太阳 禄
官禄 天府 忌
疾厄 天同 科

自定义四化表同时改变全部飞星判断 —— 宫干化出哪四颗星走的是同一张表。

亮度表

一颗星配十二个亮度，按盘上位置排列（第一项是寅宫），必须给满十二项；该位置无亮度时用空值（Python / Go 传空串）。

cfg = ChartConfig(brightness={
    "ziweiMaj": ["miao", "wang", "de", "li", "ping", "bu",
                 "xian", "miao", "wang", "de", "li", "ping"],
})

三条硬规则

只收标识，不收译名："ziweiMaj" 可以，"紫微" 不行。
长度严格校验：四化表必须 4 项、亮度表必须 12 项，多一项少一项都会报错。
不回显在输出里：覆盖表是排盘的输入，不属于排盘结果，星盘上回显的 config 只有六个开关，两张表读回来是空的。自己要留档就自己存那份配置。

配置会跟着星盘走

排盘用的配置存在星盘上，运限从那里取，所以运限一定与排盘用同一套配置，不会出现本命盘用中州派、运限用默认派的错配。

chart = astro.by_solar("2000-8-16", 2, "female", config=ChartConfig(age_divide="birthday"))
h = chart.horoscope("2024-10-1", 0)   # 自动沿用 age_divide=birthday

chart, _ := iztro.BySolar("2000-8-16", 2, iztro.GenderFemale, true, iztro.LanguageZhCN,
    &iztro.Config{AgeDivide: "birthday"})
h, _ := chart.Horoscope("2024-10-1", 0)   // 同上

测试覆盖

四个分界开关的非默认取值有 9,696 例专门的金标测试（含排盘层与运限层的组合），中州派盘型另有 12,488 例，覆盖立春窗口逐日、晚子时、生日前后等所有会产生分歧的边界。自定义四化表与亮度表另有一组专门的测试。见准确性保证。

Config 详解

本页目录