梅花易数卜卦 ☯️
中华传统占卜术数，源于宋代邵康节。
功能
- 时间起卦 - 根据年月日时起卦（默认）
- 数字起卦 - 任意三位数字起卦
安装使用
# 解压后进入目录
cd meihuayi
# 排盘
python3 meihuayi.py [命令] [参数]
命令行
# 时间起卦（使用当前时间）
python3 meihuayi.py time [用户的问题]
# 示例
python3 meihuayi.py time 今天出行是否顺利
# 数字起卦（必须是三位数100-999）
python3 meihuayi.py num <三位数> [用户的问题]
# 示例
python3 meihuayi.py num 258 近期能否升职加薪
⚠️ 重要：AI推断规范
梅花易数是严谨的象数体系，推断必须有理有据，内外结合。
一、自动保存（必须执行）
⚠️ 每次算卦完成后，AI必须立即保存卦例，不得遗漏。
保存内容包括：
- 起卦时间（pattern.time）
- 问题、起卦方式
- 完整排盘信息（干支、五行、主卦、互卦、变卦、动爻）
- 推断过程
- 结论
保存后应确认已保存，示例：
玄安，这一卦我记录好了，等结果出来后记得告诉我。
二、完整展示排盘
程序输出的排盘结果必须完整展示，不得删减。包括：
- 时间、干支、五行旺衰
- 主卦（卦名、体用关系、卦辞）
- 互卦
- 变卦（卦名、体用关系、卦辞）
- 动爻（位置、爻辞）
二、外应询问（必做）
梅花易数以**"三要十应"**为心法，取外应是重要环节。
⚠️ AI必须询问用户起卦时的外应，因为AI不在现场。
三要：耳（听）、目（视）、心（感）
询问内容：
- 天时应 - 起卦时天气如何？（晴朗/阴雨/雷电/风云）
- 地理应 - 你在什么环境？（高处/水边/山林/市场/室内等）
- 人应 - 起卦时身边有其他人吗？（老人/儿童/男女等）
- 声音应 - 听到什么声音？（安静/嘈杂/特定声音）
- 颜色应 - 看到什么显眼颜色？（对应五行：青绿/赤红/黄褐/白金/黑蓝）
- 物应 - 附近有什么器物？（金玉/纸张/利器/圆方等）
- 动静应 - 起卦时你在做什么？（静坐/行走/言语/书写等）
询问时机：
- 排盘完成后，先询问外应，再进行推断
- 无论何种情况都应询问，因为外应可验证卦象
询问话术：
起卦已完成。在推断之前，请告诉我你起卦时的外应：
1. 天气如何？
2. 你在哪里？（室内/室外，什么环境）
3. 身边有人吗？
4. 听到什么声音？
5. 看到什么颜色？
6. 当时在做什么？
- 本卦凶但变卦有吉象，难以判断时
- 询问近期之事，需更精确判断时
不取外应：
- 体克用且用卦休囚 → 吉凶已明确
- 用克体且体卦休囚 → 凶象已明确
三、结构化推断流程
推断必须按照以下结构进行，每个部分都要有依据：
1. 外应观察（必做）
- 起卦时观察到的天时、地理、人事、声音、颜色等
- 结合三要十应解读外应对应之事
2. 取象分析（必做）
- 解读主卦上下卦的象意及其组合含义
- 解读互卦象意（过程卦）
- 解读变卦象意（结果卦）
- 解读动爻爻辞含义
3. 体用分析（必做）
- 列出体卦、用卦及其五行属性
- 列出体用关系（体克用/用克体/用生体/体生用/体用比和）
- 列出月令旺相（体卦在当月旺衰，用卦在当月旺衰）
- 判断实际影响力：体旺则克用有力，体衰则力不从心；用旺则克体有力，用衰则力不从心
4. 变卦辅助分析（必做）
- 分析变卦的体用关系
- 说明变卦对主卦的修正作用（助力/阻力/无影响）
5. 动爻分析（必做）
- 解读动爻爻辞
- 结合爻位（初/二/三/四/五/上）判断事情阶段和关键
6. 外应验证（必做）
- 将外应与卦象分析相互验证
- 外应与卦象相符 → 判断更确定
- 外应与卦象相悖 → 综合权衡
7. 综合推断（必做）
- 综合以上分析，给出明确判断
- 说明事情能否成功、程度如何
- 指出需要注意的变数或关键点
8. 结论（必做）
推断输出模板
【排盘】
[完整展示程序输出的所有内容]
【外应询问】
起卦已完成。在推断之前，请告诉我你起卦时的外应：
1. 天气如何？
2. 你在哪里？（室内/室外，什么环境）
3. 身边有人吗？
4. 听到什么声音？
5. 看到什么颜色？
6. 当时在做什么？
【推断】（用户回复外应后进行）
1. 外应解读
- 用户提供的外应信息
- 【外应解读】：XXXXX
2. 取象分析
【主卦】：上卦X / 下卦X
- X象：XXXXX
- X象：XXXXX
- 组合象意：XXXXX
【互卦】：XXXX
- 象意：XXXXX（过程变化）
【变卦】：XXXX
- 象意：XXXXX（结果指向）
【动爻】：X爻「XXXXX」
- 含义：XXXXX
3. 体用分析
【主卦体用】
- 体卦：X卦（X）
- 用卦：X卦（X）
- 关系：XXXX → XX
【月令旺相】（X月）
- 体卦X：XX
- 用卦X：XX
【状态判断】
- XXXX（具体分析旺相休囚对体用的实际影响）
4. 变卦分析
- 变卦关系：XXXX → XX
- 对主卦的修正：XXXXX
5. 动爻分析
- X爻位：XXXXX
- 关键点：XXXXX
6. 外应验证
- 外应与卦象关系：XXXXX
- 综合判断：XXXXX
7. 综合推断
- 核心判断：XXXXX
- 程度预估：XXXXX
- 变数提示：XXXXX
8. 结论
【结论】：XXXXX
【建议】：XXXXX
解卦参考
详细解卦方法请参考：
data/万物类象.md - 八卦象意data/三要十应.md - 心法要诀（必读）data/解卦技巧.md - 解卦方法论
文件说明
meihuayi/
├── meihuayi.py # 核心排盘代码
├── records.py # 卦例记录管理（SQLite版）
├── SKILL.md # 说明文档
├── _meta.json # 元信息
└── data/
├── divination_records.db # 卦例记录（SQLite）
├── 万物类象.md # 八卦象意参考
├── 三要十应.md # 心法参考（必读）
└── 解卦技巧.md # 解卦方法论
📝 卦例记录功能
卦例记录用于保存每次卜卦的原始排盘、推断过程和结论，并通过反馈和复盘不断学习提升。
自动保存
每次算卦后，排盘结果和推断会自动保存到 SQLite 数据库 data/divination_records.db。
查询卦例
| 功能 | 命令 | 说明 |
|---|
| 列出所有 | python3 records.py list | 简略查看所有卦例 |
| 关键词搜索 | python3 records.py query <关键词> | 按问题搜索（简略显示） |
| 待反馈 | python3 records.py pending | 查看未反馈的卦例（简略显示） |
| 详情查看 | python3 records.py detail <id> | 查看某条记录详情（详细显示） |
显示规范：
list / query / pending：简略表格，包含编号、时间、问题、推断结果、实际结果、是否反馈detail <id>：完整信息，包含排盘、推断过程、结论、反馈
示例：
# 搜索与"司机"相关的卦例
python3 records.py query 司机
# 查看未反馈的卦例
python3 records.py pending
# 查看ID为1的卦例详情
python3 records.py detail 1
添加反馈
当事情有结果后，可以添加反馈：
- 实际发生了什么
- 推断是否正确
- 正确/不正确的原因
- 取象是否有误
添加反馈示例：
python3 records.py feedback <id> <结果描述>
交互式输入：
# 执行后会询问：
# 1. 推断是否正确？(y/n)
# 2. 正确/不正确的原因
# 3. 取象分析
学习笔记（AI自我提升）
⚠️ 重要：每次收到反馈后，AI必须创建学习笔记。
学习笔记是AI从卦例中持续学习的关键机制：
| 字段 | 说明 |
|---|
reason_analysis | 原因分析：判断正确/错误的原因是什么 |
lesson_learned | 教训总结：从这次卦例中学到了什么 |
improvement | 改进方向：下次如何避免类似错误 |
学习笔记示例（判断失误时）：
原因分析：
1. 主卦判断有误：我以X为体，但可能应以X为体
2. 外应解读：XX应解读为XX，不应强行联想为XX
3. 取象方向：卦辞本义是XX，不是直接指向XX
教训：
1. XX卦不一定XX，可能只是XX象
2. 外应不应过度联想，应该先考虑字面意义
3. 要结合时令、卦义综合判断
改进方向：
下次遇到XX类问题，要更关注...
命令：
python3 learning_notes.py list # 列出所有笔记
python3 learning_notes.py stats # 统计信息
python3 learning_notes.py incorrect # 列出所有错误案例
AI行为规范：
- 添加反馈后，立即创建学习笔记
- 笔记应具体、实用，不说空话
- 定期回顾错误案例，避免重复犯错
- 根据积累的教训，调整后续推断逻辑
记录字段说明
每条记录包含：
| 字段 | 说明 |
|---|
id | 序号 |
date | 算卦时间 |
question | 问题 |
method | 起卦方式（数字/时间） |
params | 起卦参数 |
pattern | 原始排盘信息 |
analysis | 推断过程 |
conclusion | 结论 |
feedback | 反馈结果（事后补充） |
summary | 复盘总结（事后补充） |
显示规范
卦例显示根据命令采用不同格式：
| 命令 | 显示方式 | 说明 |
|---|
list | 简略显示 | 所有记录一览，包含：编号、时间、问题、推断结果、实际结果、是否反馈 |
detail <id> | 详细显示 | 完整展示排盘、推断、结论、反馈 |
pending | 简略显示 | 只显示未反馈的记录 |
简略显示格式：
共找到 N 条记录：
────────────────────────────────────────────────────────────
编号 时间 问题 推断结果 实际结果 反馈
────────────────────────────────────────────────────────────
#1 2026-3-25 18:10:00 陈万科能不能成功通过面试 陈万科这次面试，大概率不能成功通过 - ⏳ 待反馈
详细显示格式：
卦例 #1
问：陈万科能不能成功通过面试
时间：2026-3-25 18:10:00
方式：数字（187）
干支：丙午年 辛辰月 乙酉日 丙戌时
五行：木囚，火休，土旺，金相，水死
排盘
主卦：䷠ 天山遁（体生用） 「亨，小利贞。」
互卦：天风姤
变卦：䷴ 风山渐（用克体） 「女归吉，利贞。」
动爻：九四，好遁，君子吉，小人否。
推断过程
一、体用分析
主卦天山遁：体卦为乾金，用卦为艮土。土生金，但金被土泄 → 体生用，消耗自身能量，不利。
...
结论
陈万科这次面试，大概率不能成功通过。建议这次面试可作为练手，不必太执着。回去继续准备，积累经验和气场，下次时机对了再冲，把握更大。
状态：⏳ 待反馈
AI使用说明
作为AI使用时，可以通过以下方式查询卦例：
- "查询卦例：XXX" - 按关键词搜索
- "查看卦例" - 列出所有
- "查看待反馈的卦例" - 只看未反馈的
- "添加反馈：ID=X，结果=XXX" - 添加反馈
⚠️ 重要提醒
- 起卦需心诚，专注于所问之事
- 三要十应为梅花易数核心心法，断卦必须结合外应
- 本系统仅供参考娱乐，切勿迷信
- 重大决策仍需理性分析
📚 卦例学习方法论
卦例记录是学习梅花易数的核心方法。通过"记录→验证→复盘"的循环，不断提升推断准确率。
记录规范
每次算卦后，必须保存完整内容：
{
"id": "自增ID",
"date": "算卦时间",
"question": "问题（原文）",
"method": "起卦方式",
"params": "起卦参数",
"pattern": {
"time": "时间",
"ganzhi": "干支",
"wuxing": "五行旺衰",
"main": "主卦（含体用关系）",
"main_guaci": "主卦卦辞",
"hugua": "互卦",
"biangua": "变卦（含体用关系）",
"biangua_guaci": "变卦卦辞",
"dongyao": "动爻及爻辞"
},
"analysis": "完整推断过程",
"conclusion": "结论"
}
推断过程格式
推断过程必须包含以下部分：
一、体用分析
- 主卦：体卦X，用卦X，关系XXXX
- 变卦：体卦X，用卦X，关系XXXX
二、动爻分析
- 爻位与爻辞
- 关键点解读
三、综合推断
- 各卦象综合判断
- 时空五行影响
四、关键点
- 核心判断依据（1、2、3...）
保存时机
| 场景 | 是否保存 |
|---|
| 正式算卦（有完整推断） | ✅ 必须 |
| 练手/随便算算 | ❌ 不必 |
| 重大决策卦 | ✅ 必须 + 备注 |
反馈流程
当事情有结果后：
- 记录结果：实际发生了什么
- 判断正误：推断是否命中
- 分析原因：
- 正确：正确的原因是什么？
- 错误：哪一步出了问题？
- 体用关系判断错误？
- 旺相休囚分析有误？
- 取象方向偏差？
- 外应未充分考虑？
- 总结经验：下次如何改进
复盘要点
| 问题 | 复盘方向 |
|---|
| 结论正确 | 取象准确？判断逻辑正确？运气？ |
| 结论错误 | 体用关系？旺相判断？取象方向？外应？ |
| 部分准确 | 哪个环节对？哪个环节错？ |
| 完全偏差 | 整体思路是否有问题？起卦方式是否合适？ |
经验积累
通过大量卦例复盘，逐步形成：
- 取象库：常见问题的典型卦象组合
- 判断准则：不同体用关系的应对原则
- 准确率统计：哪些类型的问题判断准确率高
AI使用建议
作为AI使用本技能时：
- 每次算卦后主动保存卦例
- 定期提醒用户补充反馈
- 根据反馈复盘总结，持续优化推断逻辑
