# relation

**Repository Path**: lliaoliao/relation

## Basic Information

- **Project Name**: relation
- **Description**: 关系分析器是一款面向图数据建模与可视化的桌面应用，支持实体、关系的创建与管理，以及多种图分析功能。适用于人物关系、企业关系、资金流向、社交网络等场景的可视化分析与探索。

本软件基于 Wails 构建，结合 Go 后端与 React 前端，采用 AntV G6/Graphin 作为图渲染引擎，提供跨平台（macOS / Windows）的本地运行体验。
- **Primary Language**: Go
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://gitee.com/lliaoliao/relation
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-23
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 关系分析器 (Relationship Analyzer)

**让复杂关系一目了然** —— 面向图数据建模与可视化的桌面应用，支持实体关系管理、多种图布局与图分析能力。

---

## 产品简介

关系分析器是一款**本地优先**的图数据可视化工具，适用于人物关系、企业关系、资金流向、社交网络等场景的建模与探索。软件基于 **Wails** 构建，结合 Go 后端与 React 前端，采用 **AntV G6 / Graphin** 作为图渲染引擎，支持 macOS 与 Windows 跨平台运行。
![输入图片说明](build/6294ffb3-2782-430b-87aa-14083f593aef.png)
![输入图片说明](build/image.png)
![输入图片说明](image.png)
---

## 核心功能

### 图数据管理

| 功能 | 说明 |
|------|------|
| **实体类型** | 人物、组织、事件、地点、电话、账户、车辆、文档，支持自定义扩展 |
| **关系类型** | 关联、亲属、同事、交易、通讯、所有权、成员、出行等，支持自定义 |
| **属性扩展** | 实体与关系均可添加键值对属性，灵活扩展业务字段 |

### 可视化与交互

- **多种布局**：力导向、同心圆、环形、网格、层次、辐射、鱼骨、生态树、活动图等
- **画布操作**：拖拽画布、缩放、节点拖拽、适配视图、小地图
- **节点折叠**：支持将子节点折叠到父节点，便于聚焦关键信息
- **主题切换**：暗黑模式与明亮模式

### 图分析

- **链接分析**：基于 BFS 的 N 度人脉分析（1–3 度扩展）
- **路径分析**：两实体间最短路径查询
- **群集分析**：基于标签传播算法的社区发现
- **社会网络分析 (SNA)**：度中心性、介数中心性、紧密中心性

### 数据导入导出

- **JSON**：完整导入导出图数据（含类型定义）
- **CSV**：实体、关系批量导入

### NeuroDB 图数据库

- 内置 NeuroDB 实例，数据自动同步
- 可连接外部 NeuroDB 服务（127.0.0.1:18839）
- 数据持久化至本地 JSON 文件（`~/.relationship-analyzer/graph_data.json`）

### 历史记录

- 记录增删改、导入、同步等操作
- 支持查看近期历史与清空记录

---

## 应用场景

| 场景 | 用途 |
|------|------|
| 人物关系分析 | 家庭、社交圈、人脉网络可视化与多度分析 |
| 企业关系分析 | 股权、交易、合作、供应链等企业图谱 |
| 资金流向分析 | 账户、交易、转账等资金链路追踪 |
| 反洗钱/反欺诈 | 多跳路径、异常模式识别 |
| 知识图谱 | 实体关系建模、存储与图分析 |

---

## 预构建版本

`build/bin/` 目录下提供已构建好的可执行文件，可直接下载使用：

| 文件 | 平台 | 说明 |
|------|------|------|
| `relationship-amd64.exe` | Windows x64 | 绿色可执行文件，解压/复制即可运行 |
| `relationship-amd64-installer.exe` | Windows x64 | NSIS 安装包，推荐首次安装使用 |
| `relationship.app` | macOS | 应用程序包，拖入「应用程序」即可使用 |

---

## 从源码构建

在已搭建好 [Wails](https://wails.io/) 环境的前提下，可在项目根目录执行：

```bash
wails build -nsis -upx
```

构建产物将输出到 `build/bin/` 目录。

---

## 系统要求

- **操作系统**：macOS / Windows
- **架构**：x64
- **内存**：建议 4GB 及以上
- **存储**：约 100MB

---

## 特色亮点

- **本地优先**：数据存于本地，无需联网即可使用
- **一键示例**：内置示例数据，快速体验分析流程
- **快捷键支持**：常用操作支持快捷键，提升效率
- **中文界面**：完整中文界面与提示

---

*关系分析器 — 让关系一目了然*