现代化的 Neo4j 图数据库可视化管理工具
A Modern Neo4j Graph Database Visualization & Management Tool
- 支持多种连接协议 (bolt://, bolt+s://, neo4j://, neo4j+s://)
- 多数据库管理与切换
- 连接状态实时监控
- 演示模式（无需真实数据库）
- D3.js 力导向图：流畅的交互式图形渲染
- 视口裁剪优化：仅渲染可见区域，支持大规模图数据
- LOD 渲染：基于缩放级别的细节层次渲染
- 实时性能监控：FPS、内存占用、渲染时间追踪
- 完整的 Cypher 查询执行
- 语法自动补全：关键字、函数、标签、属性智能提示
- EXPLAIN/PROFILE 分析：可视化执行计划
- 查询历史与收藏：本地持久化存储
- 节点 CRUD：创建、读取、更新、删除节点
- 关系 CRUD：完整的关系生命周期管理
- 批量操作：事务性批量创建/删除/更新
- 约束管理：唯一性约束、存在性约束、节点键约束
- 全文搜索：支持模糊搜索、通配符、短语、布尔查询
- 路径查找：最短路径、所有路径、K最短路径、加权路径
- 图算法 (GDS)：PageRank、Louvain、中心性算法等
- 导出为 Cypher / JSON / CSV
- 从 JSON / CSV 导入数据
- 导出当前图视图
- 暗色/亮色主题：护眼暗色主题 + 亮色主题切换
- 响应式设计：适配不同屏幕尺寸
- 键盘快捷键：高效操作
- 赛博朋克风格 UI：现代霓虹美学设计
 |
 |
| 连接管理 | 图可视化 |
 |
 |
| Cypher 查询 | Schema 浏览 |
 |
 |
| 查询历史（记录） | 查询历史（收藏） |
Web 开发模式：
- Node.js 18+
- pnpm (推荐) / npm / yarn
- Neo4j 数据库 4.x / 5.x（可选，支持演示模式）
桌面客户端打包（额外要求）：
- Rust (通过 rustup 安装)
- Microsoft C++ Build Tools (Windows)
- Windows SDK (Windows，包含 kernel32.lib 等系统库)
- WebView2 Runtime (Windows 10/11 通常已预装)
# 克隆仓库
git clone https://github.com/YOUR_USERNAME/graphscope-neo.git
cd graphscope-neo
# 安装依赖
pnpm install
# 启动 Web 开发服务器
pnpm devpnpm build
pnpm preview本项目已集成 Tauri 2.0，可以打包为轻量级桌面应用。
桌面客户端开发模式支持热重载，前端代码修改后会实时更新：
# 方式一：直接运行（需要 MSVC 工具链在 PATH 中）
pnpm tauri:dev
# 方式二：通过 VS 环境脚本运行（推荐 Windows 用户，自动设置编译环境）
pnpm tauri:dev-win# 方式一：直接构建
pnpm tauri:build
# 方式二：通过 VS 环境脚本构建（推荐 Windows 用户）
pnpm tauri:build-win构建产物位于 src-tauri/target/release/bundle/：
| 文件 | 说明 | 参考体积 |
|---|---|---|
GraphScope Neo_x.x.x_x64-setup.exe |
NSIS 安装包 | ~2 MB |
GraphScope Neo_x.x.x_x64_en-US.msi |
MSI 安装包 | ~3 MB |
graphscope-neo.exe |
可执行文件 | ~8 MB |
# 准备一张 1024x1024 以上的 PNG 源图，自动生成所有尺寸
pnpm tauri icon <path-to-icon.png>生成的图标文件会保存在 src-tauri/icons/ 目录下。
如果你的系统 PATH 中存在 Cygwin/MSYS2 的 link.exe，直接运行 pnpm tauri:build 可能会遇到链接器冲突。解决方案：
- 推荐：使用
pnpm tauri:build-win，它会自动通过vcvars64.bat设置正确的 VS 编译环境 - 或在 Visual Studio Developer Command Prompt 中运行
pnpm tauri:build - 或调整系统 PATH，确保 MSVC 的
link.exe优先级高于 Cygwin
graphscope-neo/
├── components/ # React 组件
│ ├── OptimizedWorkspace.tsx # 主工作区
│ ├── OptimizedGraphCanvas.tsx # 优化图画布
│ ├── ConnectionManager.tsx # 连接管理
│ ├── SchemaBrowser.tsx # Schema 浏览器
│ ├── ExecutionPlanView.tsx # 执行计划视图
│ ├── QueryResultTable.tsx # 查询结果表格
│ ├── QueryHistory.tsx # 查询历史
│ ├── ConstraintManager.tsx # 约束管理
│ ├── FulltextSearch.tsx # 全文搜索
│ ├── PathFinder.tsx # 路径查找
│ ├── DatabaseManager.tsx # 数据库管理
│ ├── AlgorithmRunner.tsx # 图算法
│ ├── ImportExport.tsx # 导入导出
│ └── PerformanceMonitor.tsx # 性能监控
│
├── services/ # 服务层
│ ├── neo4j.ts # Neo4j 核心服务
│ ├── neo4j/ # Neo4j 扩展服务
│ │ ├── transaction.ts # 事务管理
│ │ ├── constraints.ts # 约束管理
│ │ ├── fulltext.ts # 全文搜索
│ │ ├── paths.ts # 路径查询
│ │ ├── databases.ts # 多数据库管理
│ │ ├── algorithms.ts # 图算法 (GDS)
│ │ └── import-export.ts # 数据导入导出
│ └── performance/ # 性能优化服务
│ ├── queryOptimizer.ts # 查询优化器
│ ├── incrementalLoader.ts # 增量加载
│ └── loaderManager.ts # 加载管理
│
├── core/ # 核心架构
│ └── services/
│ └── ServiceRegistry.ts # 服务注册中心
│
├── utils/ # 工具函数
│ ├── cypherAutocomplete.ts # Cypher 自动补全
│ ├── dataValidation.ts # 数据验证
│ └── performance/ # 性能工具
│ ├── lodRenderer.ts # LOD 渲染器
│ └── viewportCulling.ts # 视口裁剪
│
├── src-tauri/ # Tauri 桌面客户端 (Rust)
│ ├── tauri.conf.json # Tauri 配置（窗口、打包、图标等）
│ ├── Cargo.toml # Rust 依赖
│ ├── capabilities/ # Tauri 权限配置
│ ├── icons/ # 应用图标（多种尺寸）
│ └── src/
│ ├── main.rs # Rust 入口
│ └── lib.rs # 应用逻辑
│
├── scripts/ # 构建辅助脚本
│ └── tauri-build.bat # Windows VS 环境构建脚本
│
├── types/ # TypeScript 类型定义
├── e2e/ # E2E 测试
└── docs/ # 文档
| 类别 | 技术 | 版本 |
|---|---|---|
| 前端框架 | React | 19.2.4 |
| 类型系统 | TypeScript | 5.8.2 |
| 构建工具 | Vite | 6.2.0 |
| 桌面客户端 | Tauri | 2.10 |
| 图形渲染 | D3.js | 7.9.0 |
| Neo4j 驱动 | neo4j-driver | 5.20.0 |
| 图标库 | lucide-react | 0.563.0 |
| 样式 | Tailwind CSS | 4.1 |
| 单元测试 | Jest | 30.2.0 |
| E2E 测试 | Playwright | 1.58.0 |
-
启动应用后，在连接页面输入数据库信息：
- 协议：选择 bolt:// 或其他协议
- 主机：数据库地址（如 localhost）
- 端口：默认 7687
- 用户名/密码：数据库凭据
-
点击"初始化连接"建立连接
-
或点击"演示模式"体验功能（无需真实数据库）
// 查询所有节点和关系
MATCH (n)-[r]->(m) RETURN n, r, m LIMIT 100
// 查找特定标签的节点
MATCH (p:Person) RETURN p
// 路径查询
MATCH path = shortestPath((a:Person)-[*]-(b:Person))
WHERE a.name = 'Alice' AND b.name = 'Bob'
RETURN path// 运行 PageRank
CALL gds.pageRank.stream('myGraph')
YIELD nodeId, score
RETURN gds.util.asNode(nodeId).name AS name, score
ORDER BY score DESC| 命令 | 说明 |
|---|---|
pnpm dev |
启动 Web 开发服务器 (localhost:3000) |
pnpm build |
构建 Web 生产版本 |
pnpm preview |
预览 Web 生产构建 |
pnpm tauri:dev |
启动桌面客户端开发模式（热重载） |
pnpm tauri:build |
构建桌面客户端安装包 |
pnpm tauri:dev-win |
通过 VS 环境启动桌面客户端开发模式 (Windows) |
pnpm tauri:build-win |
通过 VS 环境构建桌面客户端 (Windows) |
pnpm tauri icon <img> |
从源图生成所有尺寸的应用图标 |
pnpm test |
运行单元测试 |
pnpm test:watch |
监听模式运行测试 |
pnpm test:coverage |
生成测试覆盖率报告 |
# 运行单元测试
pnpm test
# 监听模式
pnpm test:watch
# 生成覆盖率报告
pnpm test:coverage欢迎贡献代码！请遵循以下步骤：
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
本项目采用 MIT License 开源许可证。
如有问题或建议，欢迎通过以下方式联系：
| 平台 | 联系方式 |
|---|---|
| 微信 (WeChat) | li_freeLife |
771603162 |
|
| 邮箱 (Email) | cwu981221@gmail.com |
- Neo4j - 强大的图数据库
- D3.js - 数据可视化库
- React - 用户界面库
- Vite - 下一代前端构建工具
- Tauri - 轻量级跨平台桌面应用框架
- Tailwind CSS - 实用优先的 CSS 框架
- Lucide - 精美的图标库
Made with ❤️ by the GraphScope Neo Team