MeiHuaYi

SKILL.md

---
name: MeiHuaYi
description: |
  梅花易数卜卦系统。
  支持时间起卦、数字起卦。
  自动排盘并进行分析，梅花易理进行推断。
metadata:
  author: Sakura7301
  emoji: ☯️
  version: "1.0.5"
---

# 梅花易数卜卦 ☯️

中华传统占卜术数，源于宋代邵康节。

## 功能

- **时间起卦** - 根据年月日时起卦（默认）
- **数字起卦** - 任意三位数字起卦

## 安装使用

```bash
# 解压后进入目录
cd meihuayi

# 排盘
python3 meihuayi.py [命令] [参数]
```

## 命令行

```bash
# 时间起卦（使用当前时间）
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. **物应** - 附近有什么器物？（金玉/纸张/利器/圆方等）
7. **动静应** - 起卦时你在做什么？（静坐/行走/言语/书写等）

**询问时机**：
- 排盘完成后，**先询问外应**，再进行推断
- 无论何种情况都应询问，因为外应可验证卦象

**询问话术**：
```
起卦已完成。在推断之前，请告诉我你起卦时的外应：
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>`：完整信息，包含排盘、推断过程、结论、反馈

**示例**：
```bash
# 搜索与"司机"相关的卦例
python3 records.py query 司机

# 查看未反馈的卦例
python3 records.py pending

# 查看ID为1的卦例详情
python3 records.py detail 1
```

### 添加反馈

当事情有结果后，可以添加反馈：
- 实际发生了什么
- 推断是否正确
- 正确/不正确的原因
- 取象是否有误

**添加反馈示例**：
```bash
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类问题，要更关注...
```

**命令**：
```bash
python3 learning_notes.py list              # 列出所有笔记
python3 learning_notes.py stats            # 统计信息
python3 learning_notes.py incorrect         # 列出所有错误案例
```

**AI行为规范**：
1. 添加反馈后，立即创建学习笔记
2. 笔记应具体、实用，不说空话
3. 定期回顾错误案例，避免重复犯错
4. 根据积累的教训，调整后续推断逻辑

### 记录字段说明

每条记录包含：

| 字段 | 说明 |
|------|------|
| `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"** - 添加反馈

---

## ⚠️ 重要提醒

1. 起卦需心诚，专注于所问之事
2. **三要十应为梅花易数核心心法，断卦必须结合外应**
3. 本系统仅供参考娱乐，切勿迷信
4. 重大决策仍需理性分析

---

## 📚 卦例学习方法论

卦例记录是学习梅花易数的核心方法。通过"记录→验证→复盘"的循环，不断提升推断准确率。

### 记录规范

每次算卦后，必须保存完整内容：

```json
{
  "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...）
```

### 保存时机

| 场景 | 是否保存 |
|------|----------|
| 正式算卦（有完整推断） | ✅ 必须 |
| 练手/随便算算 | ❌ 不必 |
| 重大决策卦 | ✅ 必须 + 备注 |

### 反馈流程

当事情有结果后：

1. **记录结果**：实际发生了什么
2. **判断正误**：推断是否命中
3. **分析原因**：
   - 正确：正确的原因是什么？
   - 错误：哪一步出了问题？
     - 体用关系判断错误？
     - 旺相休囚分析有误？
     - 取象方向偏差？
     - 外应未充分考虑？
4. **总结经验**：下次如何改进

### 复盘要点

| 问题 | 复盘方向 |
|------|----------|
| 结论正确 | 取象准确？判断逻辑正确？运气？ |
| 结论错误 | 体用关系？旺相判断？取象方向？外应？ |
| 部分准确 | 哪个环节对？哪个环节错？ |
| 完全偏差 | 整体思路是否有问题？起卦方式是否合适？ |

### 经验积累

通过大量卦例复盘，逐步形成：

- **取象库**：常见问题的典型卦象组合
- **判断准则**：不同体用关系的应对原则
- **准确率统计**：哪些类型的问题判断准确率高

### AI使用建议

作为AI使用本技能时：
- 每次算卦后主动保存卦例
- 定期提醒用户补充反馈
- 根据反馈复盘总结，持续优化推断逻辑