Upload at 2026-01-01T09:09:44Z
This commit is contained in:
144
README.md
Normal file
144
README.md
Normal file
@@ -0,0 +1,144 @@
|
||||
# AI聊天助手 - Next.js版本
|
||||
|
||||
基于Next.js 16构建的现代AI聊天应用,集成了Infini AI的DeepSeek-v3.2-exp模型。
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 本地开发
|
||||
|
||||
1. **克隆项目**:
|
||||
```bash
|
||||
git clone https://github.com/EagleFandel/test.git
|
||||
cd test/ai-chat-nextjs
|
||||
```
|
||||
|
||||
2. **安装依赖**:
|
||||
```bash
|
||||
npm install
|
||||
```
|
||||
|
||||
3. **配置环境变量**:
|
||||
```bash
|
||||
cp .env.example .env.local
|
||||
# 编辑 .env.local 添加你的API密钥
|
||||
```
|
||||
|
||||
4. **启动开发服务器**:
|
||||
```bash
|
||||
npm run dev
|
||||
```
|
||||
|
||||
访问 [http://localhost:3000](http://localhost:3000) 查看应用。
|
||||
|
||||
### 部署到Vercel
|
||||
|
||||
[](https://vercel.com/new/clone?repository-url=https://github.com/EagleFandel/test&project-name=ai-chat-nextjs&repository-name=ai-chat-nextjs&root-directory=ai-chat-nextjs)
|
||||
|
||||
或者按照 [部署指南](./DEPLOYMENT_GUIDE.md) 手动部署。
|
||||
|
||||
## ✨ 功能特性
|
||||
|
||||
- 🤖 **AI智能对话**:集成DeepSeek-v3.2-exp模型
|
||||
- 🎨 **现代UI设计**:响应式设计,支持深色/浅色主题
|
||||
- 🔄 **智能降级**:API不可用时自动切换到备用响应
|
||||
- ⚡ **高性能**:基于Next.js 16和React 19
|
||||
- 📱 **移动友好**:完美适配各种设备
|
||||
- 🛡️ **类型安全**:完整的TypeScript支持
|
||||
- 🎯 **错误处理**:完善的错误捕获和用户提示
|
||||
|
||||
## 🛠️ 技术栈
|
||||
|
||||
- **框架**:Next.js 16
|
||||
- **UI库**:React 19
|
||||
- **样式**:Tailwind CSS 4
|
||||
- **动画**:Framer Motion
|
||||
- **图标**:Lucide React
|
||||
- **语言**:TypeScript
|
||||
- **部署**:Vercel
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
ai-chat-nextjs/
|
||||
├── src/
|
||||
│ ├── app/ # App Router
|
||||
│ │ ├── api/chat/ # API路由
|
||||
│ │ ├── globals.css # 全局样式
|
||||
│ │ └── page.tsx # 主页面
|
||||
│ ├── components/ # React组件
|
||||
│ ├── hooks/ # 自定义Hooks
|
||||
│ ├── types/ # TypeScript类型
|
||||
│ └── utils/ # 工具函数
|
||||
├── public/ # 静态资源
|
||||
├── .env.example # 环境变量示例
|
||||
└── vercel.json # Vercel配置
|
||||
```
|
||||
|
||||
## 🔧 环境变量
|
||||
|
||||
创建 `.env.local` 文件并配置以下变量:
|
||||
|
||||
```env
|
||||
# Infini AI配置
|
||||
INFINI_AI_API_KEY=your_api_key_here
|
||||
INFINI_AI_BASE_URL=https://cloud.infini-ai.com/maas/v1
|
||||
INFINI_AI_MODEL=deepseek-v3.2-exp
|
||||
|
||||
# 应用配置
|
||||
NEXT_PUBLIC_APP_NAME=AI聊天助手
|
||||
NEXT_PUBLIC_APP_VERSION=1.0.0
|
||||
```
|
||||
|
||||
## 🚀 部署
|
||||
|
||||
### Vercel(推荐)
|
||||
|
||||
1. Fork这个仓库
|
||||
2. 在 [Vercel](https://vercel.com) 中导入项目
|
||||
3. 设置根目录为 `ai-chat-nextjs`
|
||||
4. 配置环境变量
|
||||
5. 部署!
|
||||
|
||||
### 其他平台
|
||||
|
||||
项目支持部署到任何支持Next.js的平台:
|
||||
- Netlify
|
||||
- Railway
|
||||
- Render
|
||||
- AWS Amplify
|
||||
|
||||
## 📖 API文档
|
||||
|
||||
### POST /api/chat
|
||||
|
||||
发送消息到AI助手。
|
||||
|
||||
**请求体**:
|
||||
```json
|
||||
{
|
||||
"message": "你好,请介绍一下自己"
|
||||
}
|
||||
```
|
||||
|
||||
**响应**:
|
||||
```json
|
||||
{
|
||||
"message": "AI助手的回复内容",
|
||||
"timestamp": "2024-01-01T00:00:00.000Z"
|
||||
}
|
||||
```
|
||||
|
||||
## 🤝 贡献
|
||||
|
||||
欢迎提交Issue和Pull Request!
|
||||
|
||||
## 📄 许可证
|
||||
|
||||
MIT License
|
||||
|
||||
## 🔗 相关链接
|
||||
|
||||
- [Next.js文档](https://nextjs.org/docs)
|
||||
- [Vercel部署指南](https://vercel.com/docs)
|
||||
- [Tailwind CSS](https://tailwindcss.com)
|
||||
- [Infini AI](https://cloud.infini-ai.com)
|
||||
Reference in New Issue
Block a user