zhouyi-learning

name	zhouyi-learning
description	周易学习技能：从零开始系统学习周易，包括六十四卦查询、起卦解卦、练习测验、每日一卦和修心指南。采用白话 + 实用的教学方式，适合零基础学习者。
version	1.0

📜 周易学习 Skill v1.0

从零开始系统学习周易的实用工具

一个面向个人学习者的周易学习平台，采用"白话 + 实用"的教学方式，帮助用户从零开始系统掌握周易知识。

---

🎯 核心功能

1. 六十四卦查询 ⭐

• ✅ 完整数据: 完美 64 卦（无重复、无缺失）
• ✅ 卦象结构: 上下卦、卦德、卦象符号
• ✅ 原文 + 白话: 卦辞爻辞对照解读
• ✅ 多维启示: 修心、事业、健康、人际关系
• ✅ 场景应用: 现代生活实际案例

2. 起卦解卦系统 ⭐

支持三种传统起卦方式：

• 🪙 硬币法: 模拟传统三枚硬币抛掷
• 🔢 数字法: 输入任意数字生成卦象
• ⏰ 时间法: 基于当前时间自动起卦

功能特性:

• ✅ 引导式问题梳理
• ✅ 自动生成变爻标记
• ✅ 初步卦象解读与建议
• ✅ 保存起卦记录便于复盘

3. 练习测验系统 ⭐

• 🧩 八卦识别测验 (8 题): 卦形、元素、特性识别
• 📝 卦名记忆测验 (12 题): 卦辞、核心精神记忆
• 💬 爻辞理解测验 (5 题): 经典爻辞含义理解
• 🎯 案例分析测验 (3 题): 场景适配分析
• 🏆 综合测验 (28 题): 全量完整测试
• 💾 成绩保存: JSON 格式历史记录，支持进度追踪

4. 每日一卦 ⭐

• 📅 精准推荐: 结合农历日期 + 节气 + 干支纪日
• 🌞 节气对应: 惊蛰→震卦、春分→巽卦等
• 💡 核心启发: 根据季节特点提供指导
• 📊 日期信息: 完整显示丙午年正月廿四等信息

5. 基础知识学习

• 🔮 八卦基础: 乾、坤、震、巽、坎、离、艮、兑详解
• ⚖️ 阴阳五行: 理论体系与对应关系
• 📅 天干地支: 六十甲子纪年法
• 🌡️ 24 节气: 节气特点与卦象对应

6. 案例库 (18+ 真实案例)

涵盖六大类应用场景：

• 💼 工作决策: 是否接受 Offer、创业时机选择、职业转型风险评估
• 👥 人际关系: 团队冲突处理、同事关系化解、朋友借钱不还
• 💰 投资理财: 大额投资时机判断、股票止损决策
• ❤️ 感情婚姻: 异地恋分析、婚前犹豫、婆媳关系处理
• 🏥 健康养生: 健身计划坚持困难、手术决策建议
• 📚 学习规划: 考研深造选择、新技能学习方向

7. 修心指南 (18 个核心卦象)

• 🧘 心性修炼: 将卦象智慧转化为日常修行
• 🎯 实践指导: 具体可操作的修心方法
• 📖 18 卦覆盖: 8 个经卦 + 10 个常用卦

---

🚀 快速开始

方式一：通过 OpenClaw 技能调用（推荐）

# 在 OpenClaw 中直接询问
"帮我查一下乾卦"
"今天每日一卦是什么？"
"用数字 3 起一卦并解读"
"我想练习测验"
"乾卦修心指南"
"工作选择案例"

方式二：使用交互式主入口

# 进入技能目录
cd ~/.openclaw/workspace/Chinese-Classics-Skills/zhouyi-learning/scripts/

# 启动交互式菜单（一键访问所有功能）
python3 main.py

提供功能:

• 📅 每日一卦
• 🪙 交互起卦解卦
• 🧩 练习测验系统
• 📅 农历干支查询
• 🌡️ 节气查询
• 📚 卦象数据库
• 🧘 修心指南
• 📖 案例库

方式三：使用命令行工具

cd ~/.openclaw/workspace/Chinese-Classics-Skills/zhouyi-learning/scripts/

# 1. 每日一卦（农历 + 节气）
python3 daily-gua.py

# 2. 交互式起卦解卦
python3 interactive-gua.py

# 3. 练习测验系统
python3 exercise-system.py

# 4. 农历干支查询
python3 get-lunar-ganzhi.py

# 5. 节气查询
python3 get-solar-term.py

---

📁 目录结构

zhouyi-learning/
├── SKILL.md                              # ⭐ 技能说明文档（本文件）
├── README.md                             # ✅ 详细使用指南
├── CHANGELOG.md                          # ✅ 版本变更记录
├── VERSION                               # 版本号标识 (v1.0)
├── pyproject.toml                        # Python 项目配置
├── requirements.txt                      # 依赖列表
├── archive.tar.gz                        # 历史版本归档
│
├── references/                           # 📚 知识库 (188KB)
│   ├── 六十四卦终极版_v11.md             # ⭐ 完美 64 卦数据 (88KB)
│   ├── 六十四卦.md                       # → 符号链接至 v11
│   ├── 修心指南_v3.md                    # ⭐ 18 卦修心指南 (36KB)
│   ├── 八卦.md                           # 基础概念 (8KB)
│   ├── 案例库.md                         # 18+ 案例分析 (40KB)
│   ├── 起卦指南.md                       # 操作流程 (5KB)
│   └── 卦象关系.md                       # 卦象关联图谱 (6KB)
│
├── scripts/                              # 🛠️ 工具集 (102KB)
│   ├── main.py                           # ⭐ 交互式主入口 (9.3KB, 264 行)
│   ├── daily-gua.py                      # ✅ 每日一卦生成器 (15KB, 258 行)
│   ├── interactive-gua.py                # ✅ 交互起卦解卦 (12KB, 303 行)
│   ├── exercise-system.py                # ✅ 练习测验系统 (18KB, 468 行)
│   ├── get-lunar-ganzhi.py               # ✅ 农历干支查询 (15KB, 439 行)
│   ├── get-solar-term.py                 # ✅ 节气计算器 (9KB, 205 行)
│   ├── zhouyi_database.py                # ✅ 统一数据访问层 (14KB, 348 行)
│   └── ... (其他辅助脚本)
│
├── tests/                                # 🧪 测试套件
│   ├── run_tests.py                      # ✅ 测试运行器 (69 行)
│   ├── test_lunar_calendar.py            # ✅ 农历计算器测试 (171 行，6 个用例)
│   └── test_core_functions.py            # ✅ 核心功能测试 (139 行，5 个用例)
│
└── archive_backup_20260314/              # 📦 历史版本归档

---

💡 使用示例

示例 1：查询特定卦象

问题: "帮我查一下谦卦"

回答:

📜 谦卦（地山谦）䷎

【卦象】上坤下艮，山在地下，谦虚内敛

【卦辞】谦，亨。君子有终。

【白话解读】谦卑待人，通达顺利。有修养的人能够始终坚持谦德。

【修心启示】
- 保持低调，不炫耀
- 虚心学习他人长处
- 功成不居，德高不傲

【事业建议】
- 团队合作中多倾听
- 成功后归功于团队
- 用谦逊赢得尊重

【爻辞精选】
初六：谦谦君子，卑以自牧也
六二：鸣谦，贞吉
九三：劳谦君子，万民服也

示例 2：每日一卦

问题: "今天每日一卦是什么？"

回答:

📅 2026 年 3 月 15 日 每日一卦

🔮 得卦：火天大有䷍

【日期信息】
- 农历：丙午年正月廿四
- 干支：丙午年 辛卯月 庚辰日
- 节气：惊蛰后第 3 天

【卦象解读】
大有卦象征光明普照、丰收富足...

【今日启示】
今日适合：
✅ 开展新计划
✅ 与人合作
✅ 学习新知识

需注意：
⚠️ 避免因顺利而骄傲
⚠️ 注意细节处理

示例 3：数字起卦

问题: "用数字 88 帮我起一卦"

回答:

🎲 数字起卦：88

【起卦过程】
88 ÷ 8 = 11 余 0 → 上卦为坤（地）
88 ÷ 8 = 11 余 0 → 下卦为坤（地）

【得卦】坤为地䷁

【卦象】六爻皆阴，至柔至顺

【核心含义】
厚德载物，包容万物

【应用建议】
- 以柔克刚
- 顺势而为
- 包容接纳

示例 4：修心指南

问题: "乾卦修心"

回答:

🧘 乾卦修心指南

【核心精神】刚健自强，持续进取

【心性修炼】
1. 培养坚韧不拔的意志
2. 在顺境中保持谦逊
3. 每日自省：是否全力以赴？

【实践方法】
- 晨起立志：设定当日核心目标
- 日中检视：是否偏离初心
- 夜间复盘：今日有何进步

【警示】
- 警惕自满（亢龙有悔）
- 避免急躁（见龙在田前需积累）
- 不可孤傲（需寻求导师指点）

---

📖 学习路径建议

第一阶段：入门（1-2 周）

• 阅读 references/八卦.md
• 理解阴阳、五行基本概念
• 每天查询一卦，培养感觉
• 使用 main.py 交互菜单熟悉功能

第二阶段：基础（2-4 周）

• 熟记六十四卦卦名
• 理解 8 个经卦的组合规律
• 练习 起卦指南.md 中的方法
• 完成练习测验系统的基础测验

第三阶段：进阶（1-3 月）

• 深入研读 六十四卦终极版_v11.md
• 结合 案例库.md 学习实际应用
• 每日练习起卦 + 解读
• 完成练习测验系统的全部测验

第四阶段：精通（3 月+）

• 研读 修心指南_v3.md
• 将卦理融入日常生活
• 形成自己的解卦体系
• 开始记录起卦日志

---

🔧 工具说明

main.py ⭐

交互式主入口，带完整菜单系统

python3 main.py
# 提供：每日一卦、交互起卦、练习测验、农历查询、
#      节气查询、卦象数据库、修心指南、案例库等

daily-gua.py

生成每日卦象，结合农历、节气、干支

python3 daily-gua.py
# 可选参数：
python3 daily-gua.py --date 2024-03-15
python3 daily-gua.py --format json

interactive-gua.py ⭐

交互式起卦解卦系统

python3 interactive-gua.py
# 支持：硬币法、数字法、时间法
# 包含：问题梳理、自动起卦、初步解读

exercise-system.py ⭐

练习测验系统

python3 exercise-system.py
# 包含：八卦识别、卦名记忆、爻辞理解、案例分析
# 成绩自动保存至 JSON 文件

get-lunar-ganzhi.py

公历 ↔ 农历转换，干支计算

python3 get-lunar-ganzhi.py
# 输出：日期、农历、干支、节气
# 支持 2024-2030 年

get-solar-term.py

24 节气查询与计算

python3 get-solar-term.py
# 输出：当日节气、距离下一节气天数
# 包含：节气卦象推荐

zhouyi_database.py

六十四卦完整数据库，支持程序化查询

from zhouyi_database import get_gua_by_name, get_random_gua

# 查询乾卦
qian = get_gua_by_name("乾")
print(qian['interpretation'])

# 随机获取一卦
random_gua = get_random_gua()

---

❓ 常见问题

Q: 这个技能适合什么样的人？

A: 适合对传统文化感兴趣、想了解周易但不想啃古文的初学者。零基础友好，所有解读都是白话 + 实用建议。

Q: 需要背诵所有内容吗？

A: 不需要。重点是理解逻辑 + 日常使用。数据都在 references/ 里，随时可查。

Q: 每日一卦准确吗？

A: 卦象是算法生成的，"准确"在于你如何理解和应用。重点是通过卦象反思当日状态，不是预测未来。

Q: 可以自定义起卦方式吗？

A: 可以。scripts/ 目录下的脚本都是开源的，你可以修改或扩展。

Q: 如何更新卦象数据？

A: 数据文件在 references/六十四卦终极版_v11.md，如需更新请修改后重新加载技能。

Q: 练习测验的成绩会保存吗？

A: 会。成绩自动保存为 JSON 格式，可以查看历史进度。

---

🤝 贡献与反馈

如果你发现错误或有改进建议：

1. 查看 SKILL.md 了解技能设计逻辑
2. 检查 references/ 中的数据源
3. 提出具体修改建议

---

📊 质量指标

维度	评分	说明
卦象数据完整性	⭐⭐⭐⭐⭐ (5/5)	完美 64 卦，无重复无缺失
测试覆盖率	⭐⭐⭐⭐☆ (4/5)	11 个测试用例，100% 通过
文档完整性	⭐⭐⭐⭐⭐ (5/5)	SKILL.md + README.md + CHANGELOG.md
用户体验	⭐⭐⭐⭐⭐ (5/5)	交互式菜单 + 白话解读 + 实用建议

---

📝 版本历史

• v1.0 (2026-03-25):

  • ✅ 完美 64 卦数据（无重复、无缺失）
  • ✅ 交互式主入口 main.py
  • ✅ 练习测验系统完整上线
  • ✅ 修心指南 v3（18 个核心卦象）
  • ✅ 测试套件 100% 通过

• v0.9 (2026-03-14):

  • ⚠️ 六十四卦数据存在重复和错误
  • ❌ 缺少练习测验系统
  • ❌ 无交互式主入口

---

📄 许可证

本技能仅供个人学习与研究使用。

---

🌟 记住：周易不是占卜工具，而是修心智慧。

用第一性原理思考，用卦象反思人生。

---

最后更新：2026-03-25
版本：v1.0
维护者：memory125
仓库地址：https://github.com/memory125/Chinese-Classics-Skills