Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NeuralVerse — AI 驱动的知识宇宙系统

不是传统的博客,而是一个拥有神经连接的数字大脑。

NeuralVerse 将每篇文章视为一个知识节点,通过 AI 自动发现节点间的关联,构建知识图谱,形成一张动态生长的"知识神经网络"。用户可以多维度阅读(初学者/面试/深度解析/可视化/AI 对话)、跟随 AI 生成的学习路径、回顾个人知识演化的时间线。


核心概念

概念 说明
知识节点 文章不再是孤立页面,而是图谱中的节点,自动关联
AI Agent 自动标签、摘要、质量评分、内容改写、学习路径生成
多维阅读 同一篇文章支持 6 种阅读模式
时间演化 追踪并可视化用户知识结构随时间的变化
学习路径 AI 在知识图谱中规划最优学习路线
语义网络 基于 Embedding 余弦相似度自动发现知识关联

技术栈

后端

  • Spring Boot 3.5.7 + Java 17
  • MyBatis Plus + jSQL Parser — ORM
  • Spring Security + JWT (HMAC-SHA512) — 认证
  • H2 (开发) / MySQL (生产) — 关系数据库
  • LangChain4j 1.0.0-beta1 — AI 编排(Chat + Embedding + RAG)
  • Redis / Elasticsearch / Neo4j / RocketMQ / MinIO — 生产环境扩展

前端

  • React 19.2 + TypeScript + Vite 8
  • TailwindCSS 4.3 — 原子化样式
  • Three.js + @react-three/fiber + @react-three/drei — 3D 知识星图
  • Framer Motion 12 — 动画
  • Zustand 5 — 状态管理
  • @tanstack/react-query 5 — 服务端状态缓存

AI 模型

  • 对话:Qwen3-Max / GLM-4.7 / 本地 Ollama
  • 嵌入:Qwen3-Embedding-8B / 本地 ONNX AllMiniLmL6V2
  • 重排序:Qwen3-Rerank

快速开始

前提条件

  • Java 17+
  • Node.js 22+
  • Maven 3.8+

1. 配置

# 复制配置模板并填入你的密钥
cp neuralverse-backend/src/main/resources/application-example.yml \
   neuralverse-backend/src/main/resources/application.yml

编辑 application.yml,至少配置数据库账号密码和 AI API Key。

2. 启动后端

cd neuralverse-backend
mvn spring-boot:run

服务运行在 http://localhost:8080

3. 启动前端

cd neuralverse-frontend
npm install
npm run dev

前端运行在 http://localhost:5173

默认配置

  • 开发环境使用 H2 内嵌数据库,无需安装 MySQL
  • 非 AI 核心功能关闭了 Redis / Neo4j / Elasticsearch 的自动配置
  • 向量存储使用 H2 BLOB + Java 余弦相似度计算,无需外部向量数据库

项目结构

NeuralVerse/
├── neuralverse-backend/          # Spring Boot 后端
│   └── src/main/java/com/neuralverse/
│       ├── common/               # 通用工具(Result, JWT, 异常处理)
│       ├── config/               # Spring 配置(Security, AI, CORS, MyBatis)
│       ├── controller/           # REST 控制器(9 个)
│       ├── dto/                  # 请求/响应 DTO(13 个)
│       ├── entity/               # 数据库实体(11 个)
│       ├── mapper/               # MyBatis Mapper(12 个)
│       └── service/              # 业务服务层(9 个接口 + 8 个实现)
├── neuralverse-frontend/         # React + Vite 前端
│   └── src/
│       ├── components/           # 组件
│       │   ├── graph/            # 3D 力导向知识图谱
│       │   └── ui/               # 通用 UI 组件(宇宙主题)
│       ├── pages/                # 页面(9 个)
│       ├── store/                # Zustand 状态管理
│       └── utils/                # API 封装 + Axios 拦截器
└── docs/                         # 设计文档

已实现功能

  • Phase 0-1: 用户系统(注册/登录/JWT认证/个人信息)
  • Phase 2-3: 知识节点 CRUD(Markdown 编辑/渲染/标签/点赞/收藏)
  • Phase 4-5: AI 服务层(自动标签/摘要/评分/本地向量嵌入/RAG 管线)
  • Phase 6: 知识图谱系统(节点/边/PageRank/BFS 最短路径/自动关联)
  • Phase 7: 3D 知识星图可视化(Three.js 力导向布局/星空粒子/行星节点)
  • Phase 8: 多维阅读模式(6 种模式/AI 内容改写/模式切换动画)
  • Phase 9: AI 学习路径(目标解析/路径规划/进度追踪/分享)
  • Phase 10: 时间演化系统(知识快照/版本化/时间线/GrowthTrajectory)
  • Phase 12: 首页与 UI 完善(宇宙暗色主题/玻璃态/响应式布局)

架构决策

  • 开发模式零依赖:H2 替代 MySQL,内存 Token 替代 Redis,H2 表替代 Neo4j 图谱,Java 实现向量检索替代 Milvus/Pinecone
  • AI 服务降级:API Key 未配置时返回合理默认值,不阻塞业务
  • 文章即知识节点:文章创建时自动构建图谱节点,AI 自动发现嵌入相似度 >0.7 的关联
  • Mono-Repo:前后端统一管理

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages