周易 64 卦查询

周易 64 卦查询是一个旨在降低《周易》查阅门槛的开源 Web 应用。开发者针对传统易学资料分散、检索不便的痛点，将六十四卦的原文、释义、卦象及变卦关系整合在一个直观的界面中。该工具不追求玄学渲染，而是专注于提供清晰、低阻力的文本查阅体验，帮助用户快速理解卦爻辞及其相互关联。

核心功能

• 全景概览与快速检索：支持通过八卦入口快速定位重卦，或通过搜索卦名、卦象符号及简义快速找到目标卦象。
• 深度解读集成：每个卦象页面完整收录了卦辞、彖辞、象辞、白话解释及相关学术解读，无需在不同网页间跳转。
• 交互式爻位查看：点击六爻中的任意一爻，即可显示对应的爻辞。
• 变卦直观推演：点击任意爻位可查看其阴阳变化后生成的“变卦”，并提供一键跳转功能，直观展示卦象之间的动态转化关系。
• 结构化数据驱动：底层数据经过清洗和结构化处理（存储于 src/data/yijing.json），确保了展示的规范性，也为后续的功能扩展（如多版本对比、API 接入）奠定了基础。

技术实现与本地运行

该项目采用现代前端技术栈构建，强调轻量化和本地优先。

环境要求： Node.js

启动开发环境：

npm install
npm run dev

构建生产版本：

npm run build

运行测试：

npm test
npm run test:e2e

项目结构与数据来源

• 原始文本：整理自 yijing64/ 目录下的 Markdown 文件。
• 结构化数据：通过 scripts/ 目录下的脚本处理生成 src/data/yijing.json，供前端页面直接调用。
• 设计理念：保持工具的纯粹性，避免过度商业化或神秘化，适合作为个人知识库中的常备参考工具或学习辅助插件。