八字排盘与分析

引擎位置：skills/bazi/scripts/bazi_engine/（Python 包，12 模块 + CLI 入口）
所有排盘计算由引擎完成，Claude 负责输入验证、确认流程、解读分析。

---

工作流（严格按序执行）

步骤 1：收集信息

向用户确认：姓名、性别（男/女）、阳历出生年月日时（24h制）。

步骤 2：验证日柱

用 WebSearch 搜索 "{年份}年{月}月{日}日 老黄历 日柱" 确认日柱干支。禁止手算。

步骤 3：处理时柱歧义

若出生时间在两时辰交界 ±30 分钟内（如 1:00, 3:00, 5:00, 7:00, 9:00, 11:00, 13:00, 15:00, 17:00, 19:00, 21:00, 23:00），列出两个候选时辰，分别跑引擎，通过 3 个校准点（性格特征、家庭关系、重大事件）与用户确认后锁定正确时辰。

步骤 4：运行引擎排盘

cd ~/.claude/skills/bazi/scripts && PYTHONIOENCODING=utf-8 python -m bazi_engine.cli \
  --name "{姓名}" --gender {性别} \
  --year {年} --month {月} --day {日} --hour {时} \
  --day-pillar {日干} {日支} \
  --liunian {起始年}-{结束年}

--day-pillar 传入步骤 2 验证的日柱。流年范围默认覆盖当前年份前后各 5 年。

步骤 5：展示排盘并请求确认

将引擎输出展示给用户（四柱、藏干、十神、格局、大运、神煞、干支关系），附一句「请确认以上排盘是否正确，确认后我继续解读。」禁止在用户确认前进入分析。

步骤 6：解读分析

用户确认后，从引擎输出的流年扫描出发，结合以下维度解读：

• 格局层次：格局清纯程度、用神忌神定位
• 当前大运：大运干支对原局的影响基调
• 流年要点：引擎已输出 7 类事件信号（桃花/升学/婚嫁/事业/财运/健康/搬迁），重点解读信号强度 ≥ ★★ 的年份，结合前后年份信号方向判读趋势
• 关键时间节点：换大运年、岁运并临、日柱天克地冲等

步骤 7：归档

分析结束后，将确认后的排盘数据整理为命例，按 references/calibration-notes.md 的准入标准判断是否可计入校准数据库。

---

引擎输出说明

引擎 CLI 输出包含以下区块，直接引用即可：

区块	内容
四柱表格	年/月/日/时柱 + 藏干 + 十神
日主 & 格局	日干五行阴阳 + 格局名 + 取格说明
大运	起运年龄、顺/逆排、每步大运干支与年龄范围
神煞	天乙贵人/文昌/红鸾/天喜/驿马/桃花/华盖/羊刃/禄
天干关系	五合
地支关系	六合/三合/半合/三会/六冲/相刑/自刑/相害
流年扫描	每年干支 + 当年大运 + 事件信号（类别+强度+触发条件+校准备注）

---

分析原则

1. 信号不孤立：单年信号需结合前后年份方向判断（如偏财年→正财年过渡）
2. 校准优先：流年输出中标注「校准 N/M」的信号优先采信，被否定过的方向不再重复错误判断
3. 性格驱动：十神组合反映性格，性格驱动选择，选择决定事件——不割裂性格与事件
4. 沉默即沉默：引擎无信号 ≠ 无事发生，只说明不在 7 类检测范围内
5. 文化参考：命理分析仅供文化参考，不对具体事件做绝对断言

---

参考文件

• references/dayun-rules.md — 大运规则、流年事件判断详细规则（已编码至引擎 dayun.py + liunian.py）
• references/wuxing-tables.md — 五行生克、天干五合、地支六合/三合/六冲表（已编码至引擎 _constants.py）
• references/calibration-notes.md — 实际命例校准记录（已编码至引擎 liunian.py 的校准规则）
• references/shichen-table.md — 时辰与地支换算表（已编码至引擎 _constants.py 的 hour_to_dizhi()）
• references/classical-texts.md — 经典文献摘录（格局/取格规则已编码至 pattern.py）