# navicator

**Repository Path**: MineLX/navicator

## Basic Information

- **Project Name**: navicator
- **Description**: Navicator is not navicat.
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-20
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Navicator

一个基于知识图谱的可视化管理平台，支持版本控制、分支管理、AI辅助知识共识固化等核心功能。

## ✨ 功能特性

### 📊 知识图谱可视化
- **ForceGraph 组件**：交互式力导向图谱展示
- **DetailPanel**：查看和编辑实体详情
- **GraphView**：主图谱浏览界面
- **PerspectiveView**：多视角视图切换

### 🔄 版本控制系统
- **SnapshotService**：完整的快照管理机制
- **ChangeSet**：变更集跟踪与历史记录
- **Branch**：分支创建、切换与删除
- **TimelineView**：时间线视图查看历史版本

### 🤖 AI 集成 (DeepSeek)
- **AIChatView**：AI 对话界面
- **Knowledge Consolidation**：知识共识固化流程
- **Tutorial System**：教程系统与教程编辑

### 📱 完整视图体系
- **ReviewView**：变更审查
- **ConflictResolutionView**：冲突解决
- **PromptView**：提示词管理
- **TutorialListView**：教程列表
- **TutorialManagement**：教程管理
- **TutorialView**：教程查看

### 📦 数据持久化
- **IndexedDB 支持**：浏览器端本地存储
- **MongoDB 后端**：服务器端数据持久化
- **Change Tracker**：变更追踪服务
- **Merge Engine**：合并引擎

## 🏗️ 项目结构

```
navicator/
├── backend/                    # Spring Boot 后端服务
│   ├── pom.xml                # Maven 构建配置
│   └── src/main/java/com/navicator/
│       ├── NavicatorApplication.java      # 启动类
│       ├── controller/                     # REST API 控制器
│       │   ├── AuthController.java        # 认证控制器
│       │   ├── DeepSeekController.java    # DeepSeek AI 集成
│       │   ├── VersionController.java     # 版本控制 API
│       │   └── GlobalExceptionHandler.java # 全局异常处理
│       ├── model/                         # 数据模型
│       │   ├── Branch.java               # 分支模型
│       │   ├── ChangeSet.java            # 变更集模型
│       │   └── EntityRecord.java          # 实体记录模型
│       ├── repository/                    # MongoDB 数据访问层
│       │   ├── BranchRepository.java
│       │   ├── ChangeSetRepository.java
│       │   └── EntityRecordRepository.java
│       ├── service/                       # 业务逻辑层
│       │   └── SnapshotService.java       # 快照服务
│       └── security/                      # 安全模块
│           └── JwtUtil.java              # JWT 工具类
│
├── backend/deepseek-service.js  # DeepSeek Node.js 服务
│
├── frontend/                    # Vue 3 前端应用
│   ├── package.json
│   ├── vite.config.ts
│   ├── tsconfig.json
│   └── src/
│       ├── main.ts              # 应用入口
│       ├── App.vue              # 根组件
│       ├── router/index.ts      # 路由配置
│       ├── api/index.ts         # API 封装
│       ├── types.ts             # TypeScript 类型定义
│       ├── components/          # Vue 组件
│       │   ├── DetailPanel.vue
│       │   ├── ForceGraph.vue
│       │   ├── Navbar.vue
│       │   ├── NotificationBell.vue
│       │   ├── StatusBar.vue
│       │   └── Toolbar.vue
│       ├── views/               # 页面视图
│       │   ├── AIChatView.vue
│       │   ├── ConflictResolutionView.vue
│       │   ├── GraphView.vue
│       │   ├── Login.vue
│       │   ├── PerspectiveView.vue
│       │   ├── PromptView.vue
│       │   ├── ReviewView.vue
│       │   ├── TimelineView.vue
│       │   ├── TutorialEditor.vue
│       │   ├── TutorialListView.vue
│       │   ├── TutorialManagement.vue
│       │   └── TutorialView.vue
│       ├── services/            # 业务服务
│       │   ├── database.ts      # 数据库服务
│       │   ├── changeTracker.ts # 变更追踪
│       │   ├── mergeEngine.ts   # 合并引擎
│       │   └── localDataService.ts # 本地数据服务
│       ├── composables/         # Vue 组合式函数
│       │   ├── useAIChat.ts
│       │   └── useClipboard.ts
│       ├── store/               # 状态管理
│       │   ├── graph.ts
│       │   └── version.ts
│       ├── assets/styles.css    # 全局样式
│       └── __tests__/           # 测试文件
│
└── skill/                       # 技能配置
    └── cator-consolidate/
        └── SKILL.md             # 知识共识固化流程规范

```

## 🚀 快速开始

### 环境要求

- **Node.js**: 18+
- **Java**: 17+
- **MongoDB**: 6.0+
- **Maven**: 3.8+

### 后端部署

1. 进入后端目录：
```bash
cd backend
```

2. 安装依赖：
```bash
mvn clean install
```

3. 配置 MongoDB 连接（修改 `src/main/resources/application.yml`）：
```yaml
spring:
  data:
    mongodb:
      uri: mongodb://localhost:27017/navicator
```

4. 启动服务：
```bash
mvn spring-boot:run
```

后端服务默认运行在 `http://localhost:8080`

### 前端部署

1. 进入前端目录：
```bash
cd frontend
```

2. 安装依赖：
```bash
npm install
```

3. 启动开发服务器：
```bash
npm run dev
```

4. 构建生产版本：
```bash
npm run build
```

前端服务默认运行在 `http://localhost:5173`

### DeepSeek 服务（可选）

1. 进入服务目录：
```bash
cd backend
```

2. 安装 Node.js 依赖并启动：
```bash
npm install
node deepseek-service.js
```

## 🔧 API 文档

### 认证接口

| 方法 | 路径 | 描述 |
|------|------|------|
| POST | `/api/auth/login` | 用户登录 |

### 版本控制接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/snapshot` | 获取快照 |
| GET | `/api/versions` | 获取版本列表 |
| GET | `/api/changesets` | 获取变更集 |
| POST | `/api/changesets` | 提交变更集 |
| GET | `/api/branches` | 获取分支列表 |
| POST | `/api/branch/create` | 创建分支 |
| POST | `/api/branch/switch` | 切换分支 |
| DELETE | `/api/branch` | 删除分支 |

### DeepSeek 接口

| 方法 | 路径 | 描述 |
|------|------|------|
| GET | `/api/deepseek/sessions/{sessionId}` | 获取会话信息 |
| GET | `/api/deepseek/sessions/search` | 搜索会话 |
| POST | `/api/deepseek/sessions/{sessionId}/send` | 发送消息 |

## 📖 核心概念

### 实体 (Entity)
知识图谱中的基本节点，包含：
- 唯一标识符 (entityId)
- 名称 (name)
- 标签 (tag)
- 描述 (description)
- 属性 (properties)
- 元数据 (metadata)

### 变更集 (ChangeSet)
记录知识图谱变更的单位，包含：
- 版本号 (version)
- 父版本 (parentVersion)
- 分支名称 (branch)
- 变更列表 (changes)
- 变更消息 (message)

### 分支 (Branch)
支持多版本并行开发，类似 Git 的分支概念。

### 快照 (Snapshot)
特定版本的知识图谱完整状态，可用于回溯和比对。

## 🧪 测试

### 前端单元测试
```bash
cd frontend
npm run test
```

### 前端组件测试
```bash
cd frontend
npm run test:component
```

## 📄 许可证

本项目采用 [MIT License](LICENSE) 开源协议。

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📞 联系方式

- 项目地址：https://gitee.com/MineLX/navicator
- 问题反馈：https://gitee.com/MineLX/navicator/issues