AI 聊天助手

基于 DeepSeek V4 API 的全栈聊天机器人应用，支持流式输出（打字机效果）。

技术栈

• 前端: React 18 + TypeScript + TailwindCSS + Vite
• 后端: Node.js + Express + TypeScript
• 部署: Docker + Docker Compose (nginx)

快速开始

1. 配置环境变量

cp .env.example .env
# 编辑 .env 填入你的 DeepSeek API Key

2. 开发模式运行

bash scripts/dev.sh

前端: http://localhost:5173 后端: http://localhost:3001

3. 生产模式运行（Docker）

bash scripts/start.sh

访问 http://localhost

4. 手动运行后端

cd backend
npm run dev

5. 手动运行前端

cd frontend
npm run dev

项目结构

my-chat-app/
├── frontend/          # React 前端
│   ├── src/
│   │   ├── components/   # UI 组件
│   │   ├── hooks/        # 自定义 hooks
│   │   ├── types/        # TypeScript 类型
│   │   └── utils/        # 工具函数
│   ├── Dockerfile
│   └── nginx.conf
├── backend/           # Express 后端
│   ├── src/
│   │   ├── routes/       # API 路由
│   │   └── services/     # 外部服务封装
│   └── Dockerfile
├── scripts/           # 启动脚本
├── docker-compose.yml
└── .env.example

环境变量

变量	说明	默认值
DEEPSEEK_API_KEY	DeepSeek API 密钥	(必填)
DEEPSEEK_MODEL	模型名称	deepseek-v4-flash
PORT	后端端口	3001