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 格式，可以查看历史进度。 🤝 贡献与反馈 如果你发现错误或有改进建议： 查看 SKILL.md 了解技能设计逻辑 检查 references/ 中的数据源 提出具体修改建议 📊 质量指标 维度 评分 说明 卦象数据完整性 ⭐⭐⭐⭐⭐ (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