# XiaoZheAI
**Repository Path**: PhiloKun/XiaoZheAI
## Basic Information
- **Project Name**: XiaoZheAI
- **Description**: 小哲AI智能平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 小哲AI (XiaoZheAI)
**融合智慧与 AI 的智能对话平台**
[](https://golang.org)
[](https://vuejs.org)
[](https://gin-gonic.com)
[](LICENSE)
---
## 📋 项目简介
小哲AI 是一个前后端分离的 AI 对话平台，前端基于 **Vue 3 + Vite + Arco Design**，后端基于 **Golang + Gin + GORM**。
用户可以为自己的对话配置自定义 API Key 和模型，享受灵活的 AI 对话体验。
---
## 🚀 快速开始
### 前置要求
- **Go** 1.21+
- **Node.js** 18+
- **MySQL** 8.0+
- **Redis** (可选，用于会话缓存)
### 1. 克隆项目
```bash
git clone git@github.com:PhiloKun/XiaoZheAI.git
cd XiaoZheAI
```
### 2. 后端启动
```bash
# 创建配置文件
cp xiaozhe-ai-backend/config/application.example.yml xiaozhe-ai-backend/config/application.yml
# 修改 application.yml 中的数据库连接信息
# 启动后端服务
cd xiaozhe-ai-backend
go mod tidy
go run main.go
```
后端服务将启动在 `http://localhost:8088`。
### 3. 前端启动
```bash
# 启动开发服务器
cd xiaozhe-ai-frontend
npm install
npm run dev
```
前端开发服务器将启动在 `http://localhost:5173`（如端口被占用会自动递增）。
---
## 🏗️ 项目结构
```
XiaoZheAI/
├── xiaozhe-ai-backend/ # Go 后端
│ ├── cmd/ # 启动命令
│ ├── config/ # 配置管理
│ │ ├── application.example.yml # 配置模板
│ │ └── config.go # Viper 配置加载
│ ├── db/ # 数据库初始化 (GORM + MySQL)
│ ├── handler/ # HTTP 请求处理器
│ │ ├── chat.go # AI 对话 (流式/非流式)
│ │ ├── userRegister.go # 用户注册/登录/资料
│ │ ├── updateUser.go # 用户状态管理
│ │ ├── deleteUser.go # 用户删除
│ │ ├── listUser.go # 用户列表
│ │ ├── drawing.go # AI 绘图
│ │ ├── models.go # 模型列表获取
│ │ ├── response.go # 统一响应格式
│ │ └── handler.go # 健康检查
│ ├── middleware/ # Gin 中间件 (CORS, 日志)
│ ├── model/ # 数据模型
│ │ ├── user.go # 用户 (含 api_key/base_url/model)
│ │ ├── chat_session.go # 对话会话
│ │ ├── chat_message.go # 聊天消息
│ │ └── drawing.go # 绘图记录
│ ├── router/ # 路由配置
│ ├── main.go # 入口文件
│ └── go.mod # Go 模块文件
│
├── xiaozhe-ai-frontend/ # Vue 3 前端
│ ├── public/ # 静态资源
│ │ ├── xiaozhe-ai-logo.svg # 主 Logo
│ │ └── favicon.svg # 浏览器图标
│ ├── src/
│ │ ├── api/ # API 请求封装 (Axios)
│ │ ├── assets/ # 样式资源
│ │ ├── components/
│ │ │ ├── layout/
│ │ │ │ └── Sidebar.vue # 侧边栏 (会话列表/设置)
│ │ │ └── common/
│ │ │ ├── LoginModal.vue # 登录/注册弹窗
│ │ │ └── UserProfileModal.vue # 个人资料编辑
│ │ ├── views/
│ │ │ ├── HomeView.vue # 主聊天界面
│ │ │ └── DrawingView.vue # AI 绘图页面
│ │ ├── router/ # 路由配置
│ │ ├── App.vue # 根组件
│ │ └── main.js # 入口文件
│ ├── index.html
│ └── package.json
│
├── .gitignore
└── README.md
```
---
## ✨ 核心功能
### 用户系统
- 手机号注册/登录
- 个人资料编辑（昵称、头像）
- 用户级 API 配置（每个用户独立存储）
### AI 对话
- 多模型支持（小哲 1.5、小哲 K2、GPT-4o 等）
- 消息编辑 & 重新生成
- 历史会话管理
- 自定义 API Key / Base URL
### AI 绘图
- 文字生成图片
- 绘图历史管理
### 视觉设计
- 定制品牌 Logo（智网·哲 — 融合"哲"字与神经网络节点的图标设计）
- 深色紫蓝渐变主题
- Arco Design 组件库
---
## 🔧 API 路由
所有路由前缀：`/api/v1`
### 用户
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/user/register` | 注册 |
| POST | `/user/login` | 登录 |
| GET | `/user/:id` | 获取用户资料 |
| PUT | `/user/:id/profile` | 更新资料/API 配置 |
| GET | `/user/list` | 用户列表 |
| DELETE | `/user/:id` | 删除用户 |
### 聊天
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/chat/send` | 发送消息 |
| GET | `/chat/sessions` | 会话列表 |
| DELETE | `/chat/sessions` | 清空所有会话 |
| DELETE | `/chat/sessions/:id` | 删除指定会话 |
| GET | `/chat/sessions/:id/messages` | 获取会话消息 |
| PUT | `/chat/messages/:id` | 编辑消息 |
| POST | `/chat/messages/:id/regenerate` | 重新生成回复 |
### 绘图
| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/drawing/create` | 创建绘图 |
| GET | `/drawing/list` | 绘图列表 |
| DELETE | `/drawing/:id` | 删除绘图 |
---
## 🧩 技术栈
### 前端
| 技术 | 用途 |
|------|------|
| Vue 3 (Composition API) | 前端框架 |
| Vite | 构建工具 |
| Arco Design Vue | UI 组件库 |
| Axios | HTTP 请求 |
| Vue Router | 前端路由 |
### 后端
| 技术 | 用途 |
|------|------|
| Go (Gin) | Web 框架 |
| GORM | ORM 框架 |
| MySQL | 数据库 |
| Redis | 缓存 (可选) |
| Viper | 配置管理 |
---
## 📄 License
本项目基于 MIT 协议开源。详见 [LICENSE](LICENSE) 文件。
---