🔮 I Ching Divination System | 周易易经占卜系统

一个基于传统周易文化的开源占卜系统 | An open-source I Ching divination system based on traditional Zhouyi culture

在线演示 | Online Demo | 快速开始 | 算法说明

---

📑 目录

• 简介
• 功能特性
• 在线演示
• 快速开始
• 项目结构
• 算法说明
• 自定义扩展
• 常见问题
• 贡献指南
• 免责声明
• 许可证

---

📖 简介

本项目是一个基于周易（易经） 传统文化的开源占卜系统，实现了六爻起卦、变卦分析、阴阳五行等核心算法。项目旨在：

• 📚 为传统文化爱好者提供学习工具
• 🔬 探索古典哲学与现代编程的结合
• 🧪 为学术研究提供可验证的算法实现

🎯 项目定位：开源研究项目，仅供学习交流和文化传播使用。

---

✨ 功能特性

模块	功能说明
🔮 六爻起卦	支持传统蓍草法、金钱卦等多种起卦方式
🔄 变卦分析	自动计算动爻、变卦及本卦、互卦、变卦关系
☯ 阴阳五行	集成天干地支、五行生克、刑冲合害分析
🌐 网页界面	纯前端实现，无需后端服务器即可运行
📱 响应式设计	支持PC端和移动端访问
🧠 AI扩展接口	预留与LLM（ChatGPT等）集成的API结构

---

🌐 在线演示

访问在线index.html演示站点或联系Tg：@fox_lovemyself，无需安装即可体验：

演示截图

📞 Contact | 联系方式 | 聯絡方式

• Telegram: @fox_lovemyself
• Email:zyue02561@gmail.com

💬 Fast response within 24h

---

---

🚀 快速开始

本地运行（5秒启动）

1. 克隆仓库

git clone https://github.com/niubideren111/I-Ching-Divination-System.git cd I-Ching-Divination-System

2. 启动本地服务器（任选一种方式）

方式一：使用 Python（推荐）

python -m http.server 8080

方式二：使用 Node.js（需安装 npx）

npx serve .

方式三：使用 VS Code Live Server 插件

3. 打开浏览器访问

http://localhost:8080

部署到 GitHub Pages（免费托管）

1. 在仓库 Settings > Pages 中

- Source 选择 "main" 分支

- 文件夹选择 "/ (root)"

- 点击 Save

2. 等待1-2分钟，访问

https://your-username.github.io/I-Ching-Divination-System/index.html

---

❓ 常见问题

Q: 占卜结果是随机的吗？ A: 是的。按传统周易理论，起卦过程模拟随机性（如掷钱币、分蓍草），本项目使用加密安全的随机数生成器。

Q: 可以用于商业产品吗？ A: 本项目采用 MIT 许可证，允许商业使用。但请您遵守各地法律法规，不得用于欺诈或虚假宣传等违法行为。

Q: 如何贡献卦辞解释内容？ A: 欢迎完善 data/interpretations.json 文件，提交 Pull Request 即可。

🤝 贡献指南

欢迎贡献代码、完善文档或报告问题！

Fork 本仓库

创建特性分支 (git checkout -b feature/amazing-feature)

提交更改 (git commit -m 'feat: add some amazing feature')

推送到分支 (git push origin feature/amazing-feature)

创建 Pull Request

详细规范请参阅 CONTRIBUTING.md

⚠️ 免责声明

本项目基于传统文化研究目的开发：

🔮 占卜结果仅供娱乐和学术参考

📚 不应作为人生决策、投资、医疗或法律行为的依据

🌐 用户自行承担使用本项目的责任

🚫 禁止用于任何形式的诈骗、迷信宣传或非法活动

📜 许可证

本项目采用 MIT License 开源许可证。

🌟 Star History

如果这个项目对您有帮助，请点击右上角 ⭐ 支持一下！