- ✅ 多轮对话:支持与 AI 进行多轮自然语言对话,消息实时同步。
- ✅ 会话管理:支持新建、切换、删除会话,历史消息可追溯。
- ✅ 用户系统:支持注册、登录、登出,用户信息本地持久化。
- ✅ 文件上传:支持图片、文档等多类型文件上传,自动分块与断点续传。
- ✅ 智能检索:内置消息搜索功能,支持关键词高亮与上下文定位。
- ✅ AI 角色管理:可自定义/切换 AI 角色,支持多智能体对话。
- ✅ 响应式 UI:基于 Tailwind CSS,适配多端设备,体验流畅。
- ✅ 异常处理:全局错误捕获与提示,提升用户体验。
- ✅ 权限路由:基于用户登录状态自动跳转,保护敏感页面。
- 前端框架:
React 18+TypeScript - 构建工具:
Vite - 状态管理:
Zustand - 路由管理:
React Router v6 - 样式方案:
Tailwind CSS - 网络请求:自封装
axios(支持拦截与统一错误处理) - 组件库:
Antd+Antd-x - 代码规范:
ESLint+Prettier+Husky+Commitlint - 依赖管理:
pnpm - 其他工具:
Vite热更新、环境变量配置、接口分层(api/service/store)
src/apis/—— API 请求封装components/—— 通用与业务组件pages/—— 页面级组件router/—— 路由配置services/—— 业务逻辑与数据处理stores/—— 状态管理(Zustand)types/—— TypeScript 类型定义utils/—— 工具函数assets/—— 静态资源
public/—— 公共资源tailwind.config.js—— Tailwind 配置vite.config.ts—— Vite 配置.env—— 环境变量
- 克隆项目到本地:
git clone https://github.com/你的仓库/Saturn-AI.git- 安装依赖(推荐使用 pnpm):
cd Saturn-AI-FE
pnpm install- 启动开发环境:
pnpm dev- 构建生产环境:
pnpm build- 预览生产环境:
pnpm preview