紫微斗数看盘（Zi Wei Dou Shu）
这个技能做什么
把用户的出生信息转成一张标准紫微斗数命盘，并给出可读的解读：命宫主星、十二宫星曜分布、生年四化（禄权科忌）落宫、五行局、大限（十年运）走势。
何时用
- "帮我排个紫微命盘" / "看看我的紫微斗数" / "我的命宫是什么星"
- 分析事业、感情、财运对应的宫位与星曜
- 看某十年（大限）或某年（流年）的运势走向
输入信息（向用户索取，缺一不可）
- 性别：男 / 女（决定大限顺逆）
- 公历生日：年 月 日（最常用，引擎自动转农历）
- 若用户只知农历，也可用lunar直接给（年干支 + 月 + 日） - 出生时辰：具体时间（如 上午9:30）或时辰（如 巳时）。优先问时辰，时辰直接决定命宫，最准确。
- （可选）出生地：用于真太阳时校正。本技能默认不校，若用户给的是"北京时间/标准时间"且出生地经度偏差大，可提示"时辰可能有±1时误差"。
> 隐私：出生信息仅用于本次排盘，不写入任何文件、不外传。
运行排盘引擎
引擎：scripts/ziwei_engine.py（纯 Python，依赖 zhdate 做公历→农历换算）。
第一次用先装依赖（已装可跳过）：
/Users/ala/.workbuddy/binaries/python/versions/3.13.12/bin/python3 -m venv /Users/ala/.workbuddy/binaries/python/envs/default
/Users/ala/.workbuddy/binaries/python/envs/default/bin/pip install zhdate
运行（公历 + 性别 + 时辰）：
/Users/ala/.workbuddy/binaries/python/envs/default/bin/python3 \
/Users/ala/.workbuddy/skills/ziwei-chart/scripts/ziwei_engine.py \
--gy 1990 5 20 9 --gender male --hour-zhi 巳
--gy Y M D H：公历年月日时（时填 0–23，若给了--hour-zhi以它为准）--gender male|female--hour-zhi：直接给时辰地支（子丑寅卯辰巳午未申酉戌亥），最准
输出是 Markdown 命盘（十二宫星曜表 + 大限表 + 简析）。
如何解读（给用户讲盘时用）
拿到引擎输出后，按这个顺序讲，别堆术语：
- 命宫主星（第一印象）：命宫是"我是谁"。看落在命宫的主星（紫微/天府/七杀等），结合
references/star_meanings.md说性格基调。若命宫无主星（空宫），借对宫星曜参看。 - 三方四正：命宫 + 财帛宫 + 官禄宫 + 迁移宫 构成一个"格局四边形"，是看一个人整体强弱的核心。看这四个宫的星曜组合。
- 生年四化落宫（一生课题与天赋）：
- 化禄：这辈子哪里"来财/得助"（福气入口）
- 化权：哪里"能做主/有掌控力"
- 化科：哪里"有名声/遇贵人"
- 化忌：不是凶，是"最在意、最要用心修炼"的功课。落夫妻=感情要用心经营；落财帛=理财宜稳；落疾厄=重调养。参考references/star_meanings.md的四化含义。 - 身宫：35 岁后加重。看身宫落在哪个宫（命/夫妻/财帛/迁移/官禄/福德），那是后半生的人生课题重心。
- 大限：从命宫起运，年龄=五行局数。顺/逆由"阳男阴女顺、阴男阳女逆"决定。指出用户当前所处大限（按年龄算）及该宫星曜吉凶，再给流年四化（流年天干起四化，同表）。
解读的四条新能力（引擎已内置，必用）
- 庙旺利陷加权：引擎内置十四主星 + 六吉星的七级庙旺利陷表（庙>旺>地>利>平>闲>陷）。排盘输出里每颗主星都带级别标注（如
武曲[庙]、文昌[陷]）。讲盘时务必先看级别：庙旺=星性充分发挥、吉者更吉；陷=星性打折、吉星也需努力，煞星陷地反而减轻。绝不要只报星名不报强弱。 - 格局自动识别：
calculate()返回patterns列表，自动判定 武贪格 / 君臣庆会（百官朝拱）/ 紫府同宫 / 杀破狼 / 日月并明 / 明珠出海 / 巨日同宫 / 府相朝垣 / 机月同梁 / 火贪铃贪 / 禄马交驰 / 三奇嘉会 / 双禄朝垣 / 马头带箭 / 日月反背 / 空宫借星 等。讲盘时优先把识别到的格局（尤其带"吉"标签的）点出来，这是"会看盘的师傅"与"报星单"的分水岭。格局释义见references/geju_meanings.md。 - 全宫飞星：
calculate()返回feixing（每宫宫干飞禄权科忌到各宫，共 48 条）。这是进阶解读骨架——任何"某宫对另一宫的影响"都从这里找。例如子女宫干丙飞廉贞忌入财帛，即"为子女花费/财务受子女牵动"。讲相关宫（财帛/子女/父母/夫妻）时直接引用feixing[宫]，不要手算。 - 合盘 / 流日 / 真太阳时：见下方独立章节。
合盘（双人对照）
用于夫妻合婚、亲子、合伙对象分析。先分别用 calculate() 排出两人命盘，再调用：
import ziwei_engine as Z
a = Z.calculate({"gregorian": (女, Y,M,D,H), "gender": "female"})
b = Z.calculate({"gregorian": (男, Y,M,D,H), "gender": "male"})
r = Z.combine(a, b, relation="夫妻") # relation: 夫妻 / 亲子 / 合伙
combine() 采用并盘法：以 A 为体盘，把 B 的命宫对齐到 A 的"对方宫"（夫妻→夫妻宫，亲子→子女宫，合伙→交友宫），平移叠加后输出：① 重点宫（命宫/对方宫/福德）的星曜共振；② 四化互涉（谁的四化飞入对方哪一宫，禄权科=助益、忌=敏感/消耗点）；③ 相性结论文案。讲合盘时优先讲"忌的互涉"（关系里的敏感点）和"禄权科互涉"（彼此助益的领域）。
流日与真太阳时
- 真太阳时校正：用户给的是"北京时间/标准时间"且出生地经度偏差大时，用
Z.true_solar_zhi(hour, minute, city=城市名)或传lon=经度校正时辰。内置 40+ 主要城市经度。西边（如成都、新疆）真太阳时比北京时晚，东边（如哈尔滨）更早；校正后若跨时辰边界需提示用户确认。杜崟（上海 17:30）经度近 120°，无需校正，仍酉时。 - 流日：
Z.liuri(data, year, month, day, city)给出某日命宫（流年命宫=太岁宫顺数日支）与日干飞四化，用于择时、看某天运势。日干支由Z.solar_day_gz(y,m,d)算出。
解读风格
- 用大白话 + 少量术语，先给结论再补原因。
- 不吓人：化忌/煞星讲成"功课/挑战"，不说"灾"。
- 给 1–3 个可执行的建议（如某宫化忌，提醒注意什么）。
- 明确说明近似：年干支以立春为界（近似 2/4），未校真太阳时；流派用通用标准四化表。
参考文件
references/star_meanings.md：十四主星 + 常用辅煞星 + 四化含义速查references/palace_meanings.md：十二宫含义与看盘要点references/geju_meanings.md：格局自动识别释义（武贪格、君臣庆会、杀破狼等）
