# Zhouyi Learning > 周易学习技能：从零开始系统学习周易，包括六十四卦查询、起卦解卦、练习测验、每日一卦和修心指南。采用白话 + 实用的教学方式，适合零基础学习者。 - Skill: `memory125/zhouyi-learning` (Agent Skill, multi-file: 26 files) - Install (CLI): `npx skillmds@latest add memory125/zhouyi-learning` - Raw SKILL.md: https://api.skillmd.com/api/skills/memory125/zhouyi-learning/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: memory125 (https://skillmd.com/u/memory125) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/memory125/zhouyi-learning --- # 📜 周易学习 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 技能调用（推荐） ```bash # 在 OpenClaw 中直接询问 "帮我查一下乾卦" "今天每日一卦是什么？" "用数字 3 起一卦并解读" "我想练习测验" "乾卦修心指南" "工作选择案例" ``` ### 方式二：使用交互式主入口 ```bash # 进入技能目录 cd ~/.openclaw/workspace/Chinese-Classics-Skills/zhouyi-learning/scripts/ # 启动交互式菜单（一键访问所有功能） python3 main.py ``` **提供功能**: - 📅 每日一卦 - 🪙 交互起卦解卦 - 🧩 练习测验系统 - 📅 农历干支查询 - 🌡️ 节气查询 - 📚 卦象数据库 - 🧘 修心指南 - 📖 案例库 ### 方式三：使用命令行工具 ```bash 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：查询特定卦象 **问题**: "帮我查一下谦卦" **回答**: ```markdown 📜 谦卦（地山谦）䷎ 【卦象】上坤下艮，山在地下，谦虚内敛 【卦辞】谦，亨。君子有终。 【白话解读】谦卑待人，通达顺利。有修养的人能够始终坚持谦德。 【修心启示】 - 保持低调，不炫耀 - 虚心学习他人长处 - 功成不居，德高不傲 【事业建议】 - 团队合作中多倾听 - 成功后归功于团队 - 用谦逊赢得尊重 【爻辞精选】 初六：谦谦君子，卑以自牧也 六二：鸣谦，贞吉 九三：劳谦君子，万民服也 ``` ### 示例 2：每日一卦 **问题**: "今天每日一卦是什么？" **回答**: ```markdown 📅 2026 年 3 月 15 日 每日一卦 🔮 得卦：火天大有䷍ 【日期信息】 - 农历：丙午年正月廿四 - 干支：丙午年 辛卯月 庚辰日 - 节气：惊蛰后第 3 天 【卦象解读】 大有卦象征光明普照、丰收富足... 【今日启示】 今日适合： ✅ 开展新计划 ✅ 与人合作 ✅ 学习新知识 需注意： ⚠️ 避免因顺利而骄傲 ⚠️ 注意细节处理 ``` ### 示例 3：数字起卦 **问题**: "用数字 88 帮我起一卦" **回答**: ```markdown 🎲 数字起卦：88 【起卦过程】 88 ÷ 8 = 11 余 0 → 上卦为坤（地） 88 ÷ 8 = 11 余 0 → 下卦为坤（地） 【得卦】坤为地䷁ 【卦象】六爻皆阴，至柔至顺 【核心含义】 厚德载物，包容万物 【应用建议】 - 以柔克刚 - 顺势而为 - 包容接纳 ``` ### 示例 4：修心指南 **问题**: "乾卦修心" **回答**: ```markdown 🧘 乾卦修心指南 【核心精神】刚健自强，持续进取 【心性修炼】 1. 培养坚韧不拔的意志 2. 在顺境中保持谦逊 3. 每日自省：是否全力以赴？ 【实践方法】 - 晨起立志：设定当日核心目标 - 日中检视：是否偏离初心 - 夜间复盘：今日有何进步 【警示】 - 警惕自满（亢龙有悔） - 避免急躁（见龙在田前需积累） - 不可孤傲（需寻求导师指点） ``` --- ## 📖 学习路径建议 ### 第一阶段：入门（1-2 周） - [ ] 阅读 `references/八卦.md` - [ ] 理解阴阳、五行基本概念 - [ ] 每天查询一卦，培养感觉 - [ ] 使用 `main.py` 交互菜单熟悉功能 ### 第二阶段：基础（2-4 周） - [ ] 熟记六十四卦卦名 - [ ] 理解 8 个经卦的组合规律 - [ ] 练习 `起卦指南.md` 中的方法 - [ ] 完成练习测验系统的基础测验 ### 第三阶段：进阶（1-3 月） - [ ] 深入研读 `六十四卦终极版_v11.md` - [ ] 结合 `案例库.md` 学习实际应用 - [ ] 每日练习起卦 + 解读 - [ ] 完成练习测验系统的全部测验 ### 第四阶段：精通（3 月+） - [ ] 研读 `修心指南_v3.md` - [ ] 将卦理融入日常生活 - [ ] 形成自己的解卦体系 - [ ] 开始记录起卦日志 --- ## 🔧 工具说明 ### main.py ⭐ 交互式主入口，带完整菜单系统 ```bash python3 main.py # 提供：每日一卦、交互起卦、练习测验、农历查询、 # 节气查询、卦象数据库、修心指南、案例库等 ``` ### daily-gua.py 生成每日卦象，结合农历、节气、干支 ```bash python3 daily-gua.py # 可选参数： python3 daily-gua.py --date 2024-03-15 python3 daily-gua.py --format json ``` ### interactive-gua.py ⭐ 交互式起卦解卦系统 ```bash python3 interactive-gua.py # 支持：硬币法、数字法、时间法 # 包含：问题梳理、自动起卦、初步解读 ``` ### exercise-system.py ⭐ 练习测验系统 ```bash python3 exercise-system.py # 包含：八卦识别、卦名记忆、爻辞理解、案例分析 # 成绩自动保存至 JSON 文件 ``` ### get-lunar-ganzhi.py 公历 ↔ 农历转换，干支计算 ```bash python3 get-lunar-ganzhi.py # 输出：日期、农历、干支、节气 # 支持 2024-2030 年 ``` ### get-solar-term.py 24 节气查询与计算 ```bash python3 get-solar-term.py # 输出：当日节气、距离下一节气天数 # 包含：节气卦象推荐 ``` ### zhouyi_database.py 六十四卦完整数据库，支持程序化查询 ```python 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*