fortune-telling-bazi 八字算命

核心流程

首次启用

1. 用户说「开始算命」→ 调用 python3 scripts/main.py status
2. 无用户 → 询问生日（姓名/年份/月份/日期/时间/性别）
3. 调用 python3 scripts/main.py add <name> <年> <月> <日> <时> <性别>（分可省略）
4. 本地计算八字（scripts/calc.py）→ 保存到 data/users.json → 显示摘要
5. 调用 python3 scripts/main.py active <name> 激活
6. 标记 is_active = true，此后每条回复注入八字摘要

非首次启用

1. 用户说「开始算命」→ python3 scripts/main.py status
2. 有记录 → 显示所有已保存用户列表，询问「用哪个/哪几个」
3. 用户选一个或多个人 → python3 scripts/main.py active <name1,name2,...>
4. 标记 is_active = true，注入对应八字摘要

退出

• 用户说「停止算命」→ is_active = false

---

数据文件

data/
├── users.json     # 所有用户的生日+八字（JSON格式）
└── active.json    # 当前激活的用户列表

---

命令一览

命令	功能
python3 scripts/main.py add <name> <year> <month> <day> <time> <gender>	添加新用户（time格式：16 / 16:30 / 下午4 / 晚8）
python3 scripts/main.py update <name> <year> <month> <day> <time> <gender>	更新已有用户
python3 scripts/main.py list	列出所有已保存用户
python3 scripts/main.py view [name]	查看某人八字详情（默认当前激活）
python3 scripts/main.py remove <name>	删除某人八字
python3 scripts/main.py active [name1,name2,...]	设置激活用户，多人用逗号分隔
python3 scripts/main.py status	检查激活状态
python3 scripts/main.py joint [name1,name2]	联合分析（默认当前激活用户）

---

八字摘要格式（单人被注入到 context）

━━━ 八字信息 ━━━
姓名：{name} | {gender} | 农历{lunar_str}
八字：{year_ganzhi} {month_ganzhi} {day_ganzhi} {hour_ganzhi}
生肖：{shengxiao} | 日主：{me}（{yinyang}）
五行：{wuxing} | {mingge} | 旺衰：{wangshuai}
喜用：{xiyong}
神煞：{shensha}
大运：{current_dayun}（{start_age}-{end_age}岁）
━━━ 八字信息 ━━━

---

联合分析格式（多人被注入到 context）

━━━ 联合分析 ━━━
【{name1}】{gender} | {bazi_str} | {mingge}
【{name2}】{gender} | {bazi_str} | {mingge}
━━━ 合冲刑害 ━━━
年支关系：{analysis}
日支关系：{analysis}（夫妻/伴侣位）
月支关系：{analysis}
━━━ 五行契合 ━━━
{analysis}
━━━ 婚配分析 ━━━
{analysis}（仅两人时）
━━━ 八字信息 ━━━

---

触发关键词

关键词	动作
开始算命、算命、看看八字、我的八字	激活算命流程
停止算命、不算了、退出算命	退出算命模式
联合分析、合盘、双人八字	触发联合分析
添加八字、加个人、录入八字	添加新用户
查看用户、都有谁、八字体检	列出所有已保存用户

---

联合分析内容

地支关系分析：

• 年支 vs 年支（双方祖辈/原生家庭/根基是否相合）
• 日支 vs 日支（夫妻/伴侣位合冲刑害）
• 月支 vs 月支（父母/环境/外环境关系）

五行契合分析：

• 喜用五行是否相生（你生我或我生你为吉）
• 五行是否互补

婚配分析（仅两人时）：

• 日支合冲刑害婚姻判断
• 桃花重叠警告
• 天乙贵人重叠吉兆

---

技术实现

• 八字计算：完全本地，不依赖任何远程API

• 依赖库：scripts/lunar_core.py 自包含单文件，提供本地农历换算和四柱计算。

  • 计算范围覆盖 1899-2060 年。
  • 无远程 API、无第三方运行时依赖。

• lunar_core.py 调试经验（2026-04-26 已修复）：

  • jd_greg() 反算公历年时曾少减 4800，导致 Solar.toYmd() 出现 67870114 这类错误年份；现已修正 JD → Gregorian 转换。
  • _from_solar() 现在按月首 JD 反推真实农历年，避免 11/12 月重复数据和立春年混用；立春年柱判断放在 _compute() 中按 solar year 查询 LICHUN_JD/LICHUN_YMD。
  • 日期比较统一使用 int(s.toYmd()) / int(LICHUN_YMD[year])，exact 年柱用含时分秒的 Julian Day 比较。
  • 三个测试案例：1987/3/14 16:30→丁卯/癸卯/壬戌/戊申；1998/1/19 16:00→丁丑/癸丑/丙寅/丙申；2000/2/1 00:30→己卯/丁丑/己丑/甲子

• 农历计算：完全自包含的 lunar_core.py，基于 LY_DATA V6B 天文表，覆盖 1899-2060 年。

• 命格算法（已验证 12/12 测试全过）：直接用 TEN_GOD[日干][月干] → 格局映射，一行代码：

  def calc_mingge(day_stem, month_stem):
      return TEN_GOD_TO_GE[TEN_GOD[day_stem][month_stem]]
  

  • 9个普通格：正官→正官格，偏官→偏官格，七杀→七杀格，正印→正印格，偏印→偏印格，食神→食神格，伤官→伤官格，正财→正财格，偏财→偏财格
  • 特殊格：比肩→比肩格，劫财→阳刃格
  • 不需要藏干强度表，不需要透干逻辑
  • "财才格" = "正财格" 的别名（2024/2/10 案例验证）

• 喜用神算法：

  • 天干强度表（10天干 × 12月令地支）
  • 地支藏干强度表（12地支藏干 × 12月令地支）
  • 同类总分（日主五行 + 生我五行）vs 异类总分（克我 + 我克 + 泄我）
  • 身强 → 宜泄（取异类）；身弱 → 宜扶（取同类）

• calc.py TEN_GOD table bug（2026-04-26 已修复）：

  • 100 个条目全部写错 — 用的是缩写（比/劫/食/伤）而非全称（比肩/劫财/食神/伤官）
  • 修复：替换为完整的十神表（全称版本），重新验证 12 个案例

• 代码位置：所有 Python 文件统一放在 scripts/ 下，数据文件放在 data/ 下。

• 代码架构（6个文件）：

  scripts/
  ├── main.py    # CLI 入口，命令路由，时间解析
  ├── calc.py    # 八字计算核心（常量和计算逻辑）
  ├── report.py  # 输出格式化（单人详情 / 联合分析）
  ├── store.py   # 数据存储（users.json / active.json）
  ├── lunar_core.py # 自包含农历/八字底层换算
  └── test_lunar_core.py # 单元测试（12 个固定样例 + 128 个随机日期）
  

• 测试命令：python3 -m unittest scripts/test_lunar_core.py

• 已实现功能：

  • 四柱天干地支（含藏干）
  • 五行纳音
  • 十神（以日干为中心）
  • 地支阴阳
  • 旬空
  • 胎元、胎息、命宫、身宫
  • 大运排盘（10步大运）
  • 神煞：桃花、天乙贵人、驿马、将星、劫煞
  • 旺衰判断（量化算法：月令强度 × 天干 + 藏干权重）
  • 喜用判断
  • 联合分析：合冲刑害、五行相生、婚配

---

注意事项

• python3 scripts/main.py joint 支持2-N人联合分析，默认用当前激活用户
• 激活多个用户时，所有人的摘要都注入 context
• 若只激活一人，格式同单人摘要
• 注入摘要时放在回复最前面，然后回答问题
• 大运排盘需要性别参数（第7个参数：男=1，女=0）

架构可复用性

本 skill 的多人+联合分析架构可复用到其他领域：

• 任何「alias + 结构化数据 + 联合分析」场景都适用
• 核心数据结构：users.json（key=alias）、active.json（当前激活列表）
• scripts/main.py（入口）+ scripts/calc.py（计算）+ scripts/report.py（展示）+ scripts/store.py（存储）+ scripts/lunar_core.py（农历换算）
• 联合分析的维度（合冲刑害/五行/喜用等）可根据不同领域替换