技能介绍

它解决什么问题

紫微斗数排盘的规则链不短：公历转农历、由生年天干起四化、按时辰定命宫、由五行局数起大限、再判断顺逆。手工排盘容易在时辰换算与大限方向这类环节出错，解读时也常只报星名、不提星曜强弱与格局。这个技能把整条链路封装进一个 Python 排盘引擎，输入结构化参数，直接产出标准命盘与可读解读，省去查表和手算的成本。

核心能力与工作方式

入口是 scripts/ziwei_engine.py，纯 Python 实现，依赖 zhdate 完成公历到农历的换算。

输入字段：性别（决定大限顺逆）、公历生日（或直接给 lunar 的年干支+月+日）、出生时辰。其中时辰最关键，直接决定命宫，因此优先索取；出生地为可选项，仅用于真太阳时校正。
输出：Markdown 格式的十二宫星曜表、大限表与简析。
庙旺利陷加权：内置十四主星与六吉星的七级表（庙>旺>地>利>平>闲>陷），每颗主星带级别标注，如 武曲[庙]、文昌[陷]，解读时先看级别再看星性。
格局自动识别：calculate() 返回 patterns 列表，覆盖武贪格、君臣庆会、杀破狼、禄马交驰、日月反背、空宫借星等常见格局，释义见 references/geju_meanings.md。
全宫飞星：返回每宫宫干飞禄权科忌共 48 条，是"某宫对另一宫影响"类解读的骨架，例如子女宫干飞廉贞忌入财帛，即解读为为子女花费。
合盘与流日：combine() 用并盘法做双人对照，将 B 的命宫对齐到 A 的对方宫，输出星曜共振、四化互涉与相性结论；Z.liuri() 计算某日命宫与日干四化，Z.true_solar_zhi() 按城市经度做真太阳时校正，内置 40 多个城市经度。

解读顺序

拿到引擎输出后按此推进：先看命宫主星（空宫借对宫），再看命宫、财帛、官禄、迁移组成的三方四正格局，然后按生年四化落宫说明天赋与课题（化忌讲成"要用心修炼的功课"而非凶），接着点出身宫（35 岁后加重），最后按年龄定位当前大限并附流年四化。

适用边界

默认不做真太阳时校正；用户给的是"北京时间"且出生地经度偏差大时，应提示存在约 ±1 小时的时辰误差，跨时辰边界需向用户确认。
年干支以立春为界（近似 2/4），四化用通用标准表，未覆盖流派差异。
出生信息仅用于当次排盘，不写文件、不外传。
星曜与格局释义依赖 references/star_meanings.md、palace_meanings.md、geju_meanings.md 三个参考文件，换用其他流派结论时需自行核对。