一个基于 Vue 3 + TypeScript 的周易六爻八宫变化查询系统，提供64卦的完整查询、变化关系图谱和智能字词联想功能。
- 64卦完整查询: 包含全部64卦的卦辞、彖传、象传、爻辞、小象传
- 八宫变化计算: 自动计算本卦的七种变化（一世变至归魂变）
- 智能搜索: 支持卦名模糊搜索、卦宫筛选、搜索历史
- 矩阵图谱: 64×64 热力图，直观展示卦象间变化距离
- 网络图谱: 力导向图，可视化卦象关系网络
- 路径查找: 查找两卦间的最短变化路径（支持多条路径）
- 11种联想类型: 字形、本义、引申义、音韵、成语、诗词、卦象、五行、八卦、反义、历史典故
- AI驱动: 基于 DeepSeek API 的智能联想
npm installnpm run devnpm run build主界面分为四个区域：
┌─────────────────────────────────────────────────────────┐
│ [搜索栏] [卦宫选择] │
├──────────┬─────────────────────────────┬────────────────┤
│ │ │ │
│ 本卦区 │ 八宫变化区 │ 归魂变区 │
│ │ (一世~五世变 + 游魂变) │ │
│ │ │ │
└──────────┴─────────────────────────────┴────────────────┘
字词联想区
操作说明:
- 在搜索栏输入卦名（如"乾为天"）进行搜索
- 点击卦宫选择器，按宫浏览卦象
- 点击任意卦象卡片查看详细内容
- 双击卦象卡片将其设为本卦
点击顶部导航栏切换到关系图谱视图：
- 64×64 热力图展示所有卦象间的变化距离
- 颜色越深表示变化步数越多
- 鼠标悬停查看具体卦象信息
- 物理模拟的力导向图
- 节点代表卦象，边代表变化关系
- 可拖拽节点调整布局
- 支持缩放和平移
- 在"起始卦"和"目标卦"输入框中输入卦名
- 或点击快速测试按钮直接测试示例路径
- 点击"查找路径"按钮
- 查看最短变化路径列表
- 点击路径中的卦名可跳转查看详情
在主界面右侧的字词联想区：
- 点击"设置 API Key"配置 DeepSeek API Key
- 在输入框中输入一个汉字
- 按 Enter 键或点击搜索按钮
- 查看11种类型的联想结果
API Key 获取:
- 访问 https://platform.deepseek.com/
- 注册账号并获取 API Key
- 成本约 0.001 元 / 千 token
| 卦宫 | 本宫卦 | 一世 | 二世 | 三世 | 四世 | 五世 | 游魂 | 归魂 |
|---|---|---|---|---|---|---|---|---|
| 乾宫 | 乾为天 | 天风姤 | 天山遁 | 天地否 | 风地观 | 山地剥 | 火地晋 | 火天大有 |
| 坎宫 | 坎为水 | 水泽节 | 水雷屯 | 水火既济 | 泽火革 | 雷火丰 | 地火明夷 | 地水师 |
| 艮宫 | 艮为山 | 山火贲 | 山天大畜 | 山泽损 | 火泽睽 | 天泽履 | 风泽中孚 | 风山渐 |
| 震宫 | 震为雷 | 雷地豫 | 雷水解 | 雷风恒 | 地风升 | 水风井 | 泽风大过 | 泽雷随 |
| 巽宫 | 巽为风 | 风天小畜 | 风火家人 | 风雷益 | 天雷无妄 | 火雷噬嗑 | 山雷颐 | 山风蛊 |
| 离宫 | 离为火 | 火山旅 | 火风鼎 | 火水未济 | 山水蒙 | 风水涣 | 天水讼 | 天火同人 |
| 坤宫 | 坤为地 | 地雷复 | 地泽临 | 地天泰 | 雷天大壮 | 泽天夬 | 水天需 | 水地比 |
| 兑宫 | 兑为泽 | 泽水困 | 泽地萃 | 泽山咸 | 水山蹇 | 地山谦 | 雷山小过 | 雷泽归妹 |
- Vue 3: 渐进式 JavaScript 框架
- TypeScript: JavaScript 的超集，提供类型安全
- Vite: 新一代前端构建工具
- Vue Router: Vue.js 官方路由管理器
liuyaobagong/
├── src/
│ ├── components/ # 组件
│ │ ├── common/ # 通用组件
│ │ ├── gua/ # 卦象相关组件
│ │ ├── graph/ # 图谱组件
│ │ ├── settings/ # 设置组件
│ │ └── association/ # 联想组件
│ ├── composables/ # 组合式函数
│ ├── services/ # API 服务
│ ├── types/ # TypeScript 类型定义
│ ├── utils/ # 工具函数
│ ├── data/ # 数据文件
│ ├── views/ # 页面视图
│ └── assets/ # 静态资源
├── public/ # 公共资源
├── docs/ # 文档
│ ├── PHASES.md # 开发阶段记录
│ ├── BUGS.md # Bug 修复记录
│ └── GUIDE.md # 项目指南
├── CLAUDE.md # 开发规范
├── devlog.md # 开发日志索引
└── README.md # 项目说明
| 命令 | 说明 |
|---|---|
npm run dev |
启动开发服务器 |
npm run build |
构建生产版本 |
npm run preview |
预览生产构建 |
npm run type-check |
TypeScript 类型检查 |
npm run format |
格式化代码 |
A: 有三种方式：
- 直接在搜索框输入卦名（支持模糊搜索）
- 先选择卦宫，再从列表中选择
- 点击搜索历史记录快速选择
A: 八宫变化是周易中的一种变化系统，每个卦通过改变爻位可以衍化出7个新卦，共8卦，称为八宫变化。
A: 进入"关系图谱"页面，切换到"路径查找"标签，输入起始卦和目标卦，点击"查找路径"即可看到最短变化路径。
A: 字词联想功能使用 DeepSeek API，需要注册账号并配置 API Key。按使用量计费，成本约 0.001 元 / 千 token。
本系统的周易数据来源于《周易通行本》，包含：
- 卦辞
- 彖传
- 象传（大象传）
- 爻辞（六爻）
- 小象传
- 文言传（乾坤两卦）
MIT
- ✅ 完成64卦完整数据
- ✅ 实现八宫变化计算
- ✅ 实现三种关系图谱视图
- ✅ 集成字词联想功能
- ✅ 添加全局导航栏
- ✅ 添加卦宫筛选功能
- ✅ 优化八宫变化矩阵显示逻辑
- ✅ 修复矩阵卦名标签重叠问题
- ✅ 添加图谱缩放功能
- ✅ 文档模块化重构
- ✅ 修复矩阵标签精确对齐问题
- ✅ 添加矩阵拖动功能
项目状态: 首页可用八宫变化稳定版 ✅
最后更新: 2026-03-09