# SmartMindGraph

**Repository Path**: snowwolf_lj/smart-mind-graph

## Basic Information

- **Project Name**: SmartMindGraph
- **Description**: SmartMindGraph 是企业级智能知识图谱，是面向企业全域 AI Agent 的知识资产基础设施。它的使命是把分散在个人、项目、会话、代码、文档、方案、招投标、客户服务和交付中的隐性经验，持续沉淀为可追溯、可复用、可运营的组织资产，让知识主动找人、经验自动复用、体系自主进化。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-18
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SmartMindGraph

## 介绍

SmartMindGraph 是企业级智能知识图谱，是面向企业全域 AI Agent 的知识资产基础设施。它的使命是把分散在个人、项目、会话、代码、文档、方案、招投标、客户服务和交付中的隐性经验，持续沉淀为可追溯、可复用、可运营的组织资产，让知识主动找人、经验自动复用、体系自主进化。

## 核心特性

- **本地优先的知识图谱记忆系统**：为 Claude Code 等 AI 编程工具及企业业务智能体提供持久化的长期记忆与可信上下文服务
- **混合检索能力**：支持 BM25 向量搜索、图检索和时序查询
- **MCP 协议支持**：通过 Streamable HTTP / stdio 对外暴露标准工具接口
- **企业级安全架构**：RBAC + ABAC 混合访问控制，支持数据分级与隔离
- **可扩展领域知识包**：业务部门可通过声明式 schema 文件自定义扩展

## 技术栈

| 类别 | 技术选型 |
|------|---------|
| 运行环境 | Java 21+ |
| 应用框架 | Spring Boot 4.0, Spring AI 2.0 |
| 图数据库 | Neo4j Community Edition |
| AST 解析 | tree-sitter + java-tree-sitter |
| 向量嵌入 | all-MiniLM-L6-v2, ONNX Runtime |
| 全文检索 | Apache Lucene |
| 前端 | Vue 3 + Vite + sigma.js |

## 快速开始

### 环境要求

- Java 21+
- Docker (用于 Neo4j)
- 至少 4GB 可用内存

### 启动步骤

1. 启动 Neo4j 容器：
```bash
docker run -d \
  --name neo4j \
  -p 7474:7474 -p 7687:7687 \
  -e NEO4J_AUTH=neo4j/password \
  neo4j:community
```

2. 编译并启动 SmartMindGraph Server：
```bash
./mvnw spring-boot:run
```

3. 配置 MCP 客户端连接：
```bash
# 配置 Claude Code 或其他 MCP 客户端
mcp server: http://localhost:8080/mcp
```

## 主要工具接口

| 工具 | 用途 |
|------|------|
| `impact` | 影响分析 |
| `context` | 符号 360° 上下文 |
| `query` | 混合搜索 |
| `detect_changes` | Git 差异影响 |
| `memory_context` | 新会话自动注入 |
| `memory_add_episode` | 添加记忆单元 |
| `memory_temporal_query` | 时间旅行快照 |
| `claim_trace` | 声明溯源 |

## 部署形态

- **L0 个人本地版**：所有组件运行在单个开发者机器上
- **L1 团队共享版**：团队图谱实例 + 团队领域包
- **L2 企业私有化版**：企业知识平台 + 多租户/多部门

## 许可证

本项目基于 LICENSE 文件中指定的许可证开源。

## 相关资源

- [架构详细说明](./README.md)
- [English Documentation](./README.en.md)