# DevHub

**Repository Path**: maowangan/dev-hub

## Basic Information

- **Project Name**: DevHub
- **Description**: 一站式开发者工作台，集成工具集、网址导航、知识库、AI 对话和 Agent。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-30
- **Last Updated**: 2026-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Java, AI

## README

# DevHub — 新时代综合个人网站

一站式开发者工作台，集成工具集、网址导航、知识库、AI 对话和 Agent。

## 功能模块

| 模块 | 说明 |
|------|------|
| **Dashboard** | 工作台首页，快捷入口卡片 |
| **工具集** | JSON 格式化、Base64 编解码、正则测试、时间戳转换、MD5/SHA、JWT 解析、UUID 生成、AES 加解密 |
| **网址导航** | 常用站点快速跳转，支持浏览器书签导入和批量管理 |
| **知识库** | Markdown 笔记，分类+标签，实时预览编辑 |
| **AI 对话** | 多模型支持（OpenAI / DeepSeek / Claude / Ollama），SSE 流式输出，会话管理，自定义系统提示词 |
| **Agent** | 工具调用（搜索知识库 / 计算器 / 时间查询），AI 对话页内切换 |
| **个人简历** | 公开展示页：技术栈、工作经历、项目、教育背景 |
| **配置中心** | 个人信息编辑、API Key 管理（多模型）、主题设置、数据导入导出 |

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | React 18 + TypeScript + Vite + Ant Design 5 + Zustand + React Router v6 |
| 后端 | Java 21 + SpringBoot 3.2 + MybatisPlus 3.5 + sa-token + Knife4j |
| AI | Spring AI 1.0.0-M6（OpenAI / Anthropic / Ollama） |
| 数据库 | MySQL 8 + Redis 7 |
| 容器化 | Docker Compose |

## 快速开始

### 环境要求

- Node.js 18+
- Java 21
- Maven 3.8+
- Docker Desktop

### 1. 启动基础服务

```bash
docker compose up -d
```

启动 MySQL 8 和 Redis 7，并自动执行数据库初始化脚本。

### 2. 启动后端

```bash
cd backend
mvn spring-boot:run
```

后端运行在 `http://localhost:8080`，Knife4j 接口文档：`http://localhost:8080/doc.html`

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

前端运行在 `http://localhost:3000`，自动代理 `/api` 到后端。

### 4. 使用

1. 浏览器打开 `http://localhost:3000`
2. 注册账号 → 登录
3. 配置 AI API Key（设置 → API Key 管理）
4. 开始使用各项功能

## 项目结构

```
├── backend/                 # SpringBoot 后端
│   └── src/main/java/com/devhub/
│       ├── common/          # 通用组件（Result、异常处理）
│       ├── config/          # 配置（CORS、MybatisPlus、sa-token）
│       ├── controller/      # REST 控制器
│       ├── dto/             # 请求/响应 DTO
│       ├── entity/          # 数据库实体
│       ├── mapper/          # MybatisPlus Mapper
│       └── service/         # 业务服务
├── frontend/                # React 前端
│   └── src/
│       ├── api/             # API 层
│       ├── components/      # 通用组件
│       ├── layouts/         # 布局组件
│       ├── pages/           # 页面组件
│       ├── routes/          # 路由配置
│       ├── stores/          # Zustand 状态管理
│       └── tools/           # 工具组件（8个核心工具）
├── docs/                    # 文档
│   ├── requirements/        # 需求分析
│   ├── plans/               # 开发计划
│   ├── design/              # 功能设计
│   └── superpowers/plans/   # 详细实现计划
├── prototype/               # UI 原型
├── docker-compose.yml       # Docker 编排
└── README.md
```

## 数据库

| 表 | 说明 |
|----|------|
| `sys_user` | 用户表 |
| `sys_tool` | 工具配置表 |
| `sys_nav` | 网址导航表 |
| `user_config` | 用户配置表（JSON 存储） |
| `ai_session` | AI 会话表 |
| `ai_message` | AI 消息表 |
| `user_model_config` | 用户模型配置（API Key 加密存储） |
| `kb_note` | 知识库笔记表 |