六爻占卜 · Liuyao Divination

面向 AI Agent 的六爻占卜技能 + 可编程排盘工具包。既能把卦排准，又能用一套完整、自洽的断卦方法去解读它。

📖 English: see README.en.md

---

✨ 这是什么

六爻（六爻卦）是以《易经》六十四卦为基础的传统占卜体系。一卦排定后，给六爻配上纳甲（天干地支）、六亲、六神、世应，再结合占卦的月建、日辰，通过旺衰、空亡、破、暗动、化进化退、三合六合、墓库等技法来判断吉凶。

本项目提供两样东西：

1. SKILL.md 智能体技能：教 LLM（如 Claude Code）按训练有素的断卦流程读卦——取用神、断旺衰、辨暗动与日破、分清"贵"与"旺"等等。
2. Python 排盘引擎 + 报告生成器：把最容易出错、最机械的部分（纳甲、六亲、空亡、暗动、化退……）交给程序确定性计算，再渲染一份古典卷宗风格的 HTML 报告。

🧭 为什么做这个

手工排盘是大多数卦断错的根源——宫位排错、漏判暗动、把墓库当破……引擎负责把卦排准，技能负责需要推理的判断。两者配合，让"机械部分"诚实可靠，"解读部分"才有扎实的根基。

📦 项目结构

liuyao-divination/
├── skill/liuyao-divination/SKILL.md   # 智能体技能（从这里开始）
├── references/                        # 11 册技法参考文档
│   ├── 01-装卦排盘.md                  #   装卦、纳甲、六亲、世应、六神
│   ├── 02-用神取用.md                  #   取用神
│   ├── 03-旺衰月日.md                  #   月建日辰定旺衰
│   ├── 04-动静暗破.md                  #   动静、暗动、月破、日破、空亡
│   ├── 05-进退神化.md                  #   化进化退、变爻
│   ├── 06-三合六合.md                  #   三合局、六合
│   ├── 07-墓库论.md                    #   入墓、库墓、空墓、出墓
│   ├── 08-断卦步骤.md                  #   完整断卦流程
│   ├── 09-四神与有力无力.md            #   用神元神忌神仇神、有力无力
│   ├── 10-卦变反伏.md                  #   卦变生克墓绝、反吟、伏吟
│   └── 11-六十四卦判辞.md              #   64 卦卦象与判曰速查
├── src/
│   ├── liuyao/                        # 排盘引擎（可 import 的包）
│   └── paipan.py                      # CLI：排盘并打印
├── tools/
│   ├── generate_report.py             # HTML 报告生成器
│   └── extract_panji.py               # 提炼 64 卦判辞
├── examples/                          # 已验证的卦例库（JSON）
├── tests/                             # 黄金用例测试（经典卦例）
├── data/zhouyi.json                   # 64 卦辞 + 385 爻辞（公有领域原文）
└── docs/易经六十四卦.md              # 完整源稿（含 64 卦象图）

🚀 快速开始

1. 排盘（命令行）

python src/paipan.py --hexagram 地泽临 --moving 2 --month 未 --day 卯

打印完整卦盘：六亲、纳甲、六神、世应、空亡、月破日破、暗动标记、化进化退、墓库状态——全部结合月建日辰判定。

2. 生成 HTML 报告

python tools/generate_report.py examples/01-是否旺己-地泽临之复.json -o outputs/report.html

3. 作为 Claude Code 技能使用

# 软链（或复制）到你的技能目录
ln -s "$(pwd)/skill/liuyao-divination" ~/.claude/skills/liuyao-divination

然后对 Claude 说："占问家人介绍的对象是否旺自己，主卦地泽临九二动变复，辛卯日"，它就会按技能流程解读。

4. 分析一个新卦（完整流程）

机械层交给程序、推理层交给 LLM，三步走：

# ① 脚手架：排盘 + 取卦辞爻辞 + 生成 JSON 骨架 + 打印推理 brief
python tools/new_case.py --hexagram 雷水解 --moving 3 --month 申 --day 甲子 \
    --question "占求职能否成" --yongshen 官鬼 -o examples/02-求职.json

# ② LLM 推理：把 brief 交给 Claude，依 SKILL.md 八步流程填充 JSON 的
#    overview 讲解 / sections 分层解析 / verdict 断语 / summary
#    （卦象推理、六爻分析、发展推演——充分发挥大模型能力）

# ③ 生成报告
python tools/generate_report.py examples/02-求职.json -o outputs/report.html

排盘、卦辞、关键判定（暗动 / 化退 / 入墓 / 三合 / 六合卦 / 元忌有力无力…）由脚手架自动算准；推理与断卦由 LLM 发挥。详见 references/08-断卦步骤.md。

🧪 正确性

引擎用一个手工精析的经典卦例（examples/01-是否旺己-地泽临之复.json，地泽临 → 地雷复，辛卯日）来验证。测试断言引擎能复现每一条手工结论：妻财亥水为用神在五爻、子孙酉为暗动（而非日破——关键区别）、世爻丁卯入未墓且化退为庚寅、空亡在午未而卦中无落空之爻，等等。

python -m pytest tests/

📚 方法论

本项目采用主流综合派（沿《增删卜易》一脉），并明确标出易被忽略的精细处：

• 暗动 vs 日破：静爻被日辰冲，旺相者为暗动（激发起用），休囚者为日破（冲散无用）。同样的"冲"，结论相反。
• 贵 ≠ 旺：爻临五爻君位是"贵"（地位尊显），不等于"旺"（力量强旺）——旺衰仍看月日。
• 墓库细节：入"空墓"（墓库落空亡）意味着困束是虚的、易脱的，不是死局。
• 进退神：卯化寅为退神，寅化卯为进神。

详见 references/ 各册与 SKILL.md。

🤝 贡献

欢迎对排盘逻辑或技法文档提出修正——准确性是本项目的全部意义。涉及实质性的方法论变更（不同流派会有分歧），请先开 issue 讨论，再慎重取舍。

⚠️ 理性声明

六爻是传统文化与占卜术，不是科学。本项目是一项工程与文化保存的努力。卦象描述的是"势、象、时机"，不是事实预测，绝不能替代现实中对感情、财务、健康及任何决策的理性判断。请理性参考、负责任地使用。

💖 支持这个项目

这是我利用业余时间开发的免费开源项目。如果你觉得它有用，可以请我喝杯咖啡——完全是自愿的。

你的支持能帮我：

• 📚 扩充更多验证卦例、校验更多卦象的断法
• 🔧 维护排盘引擎在六十四卦上的准确性
• ☯️ 对照梳理更多六爻流派（不同师承）的方法论

感谢每一位支持者 ❤️

支付宝	微信

📄 许可证

MIT © 2026 Johnson