AI-Cloud-Frontend

AI-Cloud 的前端项目，基于 React + TypeScript + Vite，提供文件管理、知识库管理、模型管理、Agent 配置与对话界面。

技术栈

• React 18
• TypeScript
• Vite
• Ant Design
• Tailwind CSS
• Redux Toolkit

快速开始

环境要求

• Node.js >= 16
• npm >= 8

安装依赖

npm install

本地开发

npm run dev

默认开发代理会将 /api 转发到 http://localhost:8080，如需修改请查看 vite.config.ts。

生产构建

npm run build

部署

单独部署

适用于后端已经独立部署完成的场景。

1. 构建前端：

npm install
npm run build

2. 根据你的部署环境调整 nginx.conf 中 /api 的上游地址。

3. 如果使用 Docker：

docker build -t ai-cloud-frontend .
docker run -d -p 80:80 --name ai-cloud-frontend ai-cloud-frontend

也可以直接把 dist/ 部署到任意静态资源服务器。

联合部署

适用于前后端一起部署的场景。

mkdir ai-cloud
cd ai-cloud
git clone https://github.com/RaspberryCola/AI-Cloud-Frontend.git frontend
git clone https://github.com/RaspberryCola/AI-Cloud-Go.git backend
cd backend/deploy
cp .env.example .env
make up

联合部署由后端仓库的部署目录统一编排。详细说明见后端仓库中的 deploy/README.md。

目录结构

• src/main.tsx: 应用入口
• src/App.tsx: 路由入口
• src/pages/: 页面
• src/components/: 组件
• src/services/: API 请求
• vite.config.ts: 开发代理配置
• nginx.conf: 生产反向代理配置