Web 可视化面板
IGraph 内置了一个 Web GUI，让你可以在浏览器中管理项目、浏览图谱、模拟查询和编辑配置，无需记忆 CLI 命令。
启动
bash
igraph gui| 选项 | 说明 | 默认值 |
|---|---|---|
-p, --port <port> | HTTP 端口号 | 3210 |
--host <host> | 监听地址 | 127.0.0.1 |
--open | 自动打开浏览器 | - |
启动后访问 http://127.0.0.1:3210。
功能概览
项目看板（首页）
首页为全屏项目看板，无侧边栏：
- 项目卡片网格 — 展示所有已导入项目的名称、路径、文件/节点/边数量、向量化和摘要状态
- 导入项目 — 点击「导入项目」按钮，通过系统文件夹选择器或手动输入路径导入本地仓库
- 构建进度 — 导入或重建时实时显示 SSE 推送的进度条和日志
- 重新构建 — 每张项目卡片提供「重新构建」按钮
- 全局配置 — 右上角齿轮按钮弹出全局配置编辑面板
点击已构建的项目卡片进入项目详情页。
项目详情（二级页面）
选中项目后进入带侧边栏的二级页面，侧边栏包含「返回看板」链接和三个导航项：
图谱结构
- 力导向图（Force-directed graph）可视化节点与边的关系
- 点击节点查看详情（类型、文件路径、源码片段、调用关系）
- 统计卡片展示文件数、节点数、边数
查询模拟
- 输入自然语言查询，调整 TopK 和跳数参数
- 实时展示检索管线的每个步骤：向量化 → Dense/FTS5 检索 → RRF 融合 → 图谱展开
- 每个步骤以 Swagger 风格的彩色卡片呈现，支持展开查看详细数据
项目配置
三个 Tab 页：
| Tab | 说明 |
|---|---|
| 项目配置 | 编辑 .igraph/config.json，支持表单模式和 JSON 编辑模式 |
| 全局配置 | 编辑 ~/.igraph/config.json，支持表单模式和 JSON 编辑模式 |
| 合并配置 | 只读展示最终合并后的运行时配置 |
JSON 编辑模式：点击「JSON 模式」按钮切换到 JSON 编辑器，直接修改完整配置 JSON，带实时语法校验，修改后点击「保存」即可生效。
技术架构
- 前端：Vue 3 + Vite + Tailwind CSS v4 单页应用
- 后端：Node.js
http模块，SSE 流式推送构建进度 - 数据：复用 CLI 的 SQLite 数据库（
.igraph/igraph.db），项目注册表持久化在~/.igraph/projects.json