# AI Chat - 智能对话助手

> **版本：v1.0.0** | **协议：AGPLv3** | **PHP 8.0 + MySQL + Nginx**

一个基于 PHP 8.0 的 AI 聊天 Web 应用，支持多种 AI 服务供应商，提供流式对话体验。

## 功能特性

- 用户认证系统（JWT）
- 多 AI 服务供应商支持（OpenAI、Claude、DeepSeek 等 12+ 供应商）
- 思考/非思考模式切换
- SSE 流式响应（打字机效果）
- 多会话管理
- 文件上传（图片 + 代码文件）
- 代码高亮和 Markdown 渲染
- 自定义提示词和可配置人格（预设 + 自定义）
- 双重历史记录存储（服务器 + 本地缓存）
- Web 安装界面（零配置部署）
- API 配置管理界面

## 技术栈

| 组件 | 技术 |
|------|------|
| 后端 | PHP 8.0（原生，无框架） |
| 数据库 | MySQL 5.7+ / 8.0（PDO 驱动） |
| 前端 | PHP 模板 + 原生 JavaScript + AJAX |
| Web 服务器 | Nginx + PHP-FPM |
| 认证 | JWT（firebase/php-jwt v7.0.5） |
| 依赖管理 | Composer（PSR-4 自动加载） |
| 代码高亮 | highlight.js（CDN） |
| Markdown 渲染 | marked.js（CDN） |

## 项目结构

```
ai-chat/
├── public/              # Web 根目录（Nginx 指向此目录）
│   ├── index.php        # 首页入口（自动路由到登录/安装页）
│   ├── api.php          # API 统一入口
│   ├── router.php       # PHP 内置开发服务器路由文件
│   ├── login.php        # 登录页面
│   ├── chat.php         # 聊天主页面
│   ├── config.php       # 配置管理页面
│   ├── install.php      # 安装向导页面
│   ├── assets/          # 前端静态资源
│   │   ├── css/         # 样式文件
│   │   ├── js/          # JavaScript 文件
│   │   └── img/         # 图片资源
│   └── uploads/         # 用户上传文件
├── app/                 # 应用代码（PSR-4 自动加载）
│   ├── Config/          # 配置管理（Database、AppConfig）
│   ├── Controllers/     # 控制器（Auth、Chat、Session 等）
│   ├── Middleware/      # 中间件（Auth、Admin）
│   ├── Models/          # 数据模型（User、Session、Message 等）
│   ├── Services/        # 服务层（AIService、Installer、Providers）
│   └── Views/           # 视图模板（login、chat、config、layout）
├── config/              # JSON 配置文件（安装后生成）
├── docs/                # 文档
├── vendor/              # Composer 依赖（安装后生成）
├── composer.json        # PHP 依赖配置
└── .gitignore
```

## 快速开始

### 环境要求

- PHP >= 8.0
- MySQL >= 5.7
- Nginx（或 Apache）
- Composer
- PHP 扩展：PDO、cURL、json、mbstring

### 安装步骤

1. **克隆项目**
   ```bash
   git clone <repository-url>
   cd ai-chat
   ```

2. **安装 PHP 依赖**
   ```bash
   composer install
   ```

3. **启动开发服务器**（本地开发）
   ```bash
   php -S localhost:8080 -t public/ public/router.php
   ```
   然后访问 `http://localhost:8080/`

4. **或配置 Nginx**（生产部署）
   - 将网站根目录指向 `public/` 目录
   - 参考 `docs/nginx.conf` 或 `docs/baota-nginx-snippet.conf` 配置 Nginx

5. **设置目录权限**（生产部署）
   ```bash
   chmod -R 755 .
   chown -R www:www .
   ```

6. **运行安装向导**
   - 访问 `http://your-domain.com/install.php`
   - 按照向导步骤完成安装

详细安装说明请查看 [INSTALL.md](INSTALL.md) 和 [DEPLOY.md](docs/DEPLOY.md)。

## 页面说明

| 页面 | 路径 | 说明 |
|------|------|------|
| 首页 | `/` | 自动重定向到登录页或安装页 |
| 登录 | `/login.php` | 用户登录 |
| 聊天 | `/chat.php` | AI 对话主界面 |
| 配置 | `/config.php` | 系统配置（需管理员权限） |
| 安装 | `/install.php` | 安装向导（安装后自动跳转） |
| API | `/api.php` | RESTful API 统一入口 |

## 文档

- [安装指南](INSTALL.md)
- [部署文档](docs/DEPLOY.md)
- [架构说明](docs/ARCHITECTURE.md)
- [API 文档](docs/API.md)
- [人格系统](docs/PERSONALITY.md)
- [Nginx 配置](docs/nginx.conf)
- [宝塔面板配置](docs/baota-nginx-snippet.conf)

## 开源协议

本项目基于 [GNU Affero General Public License v3.0 (AGPLv3)](LICENSE) 开源。

## 版本历史

| 版本 | 日期 | 说明 |
|------|------|------|
| v1.0.0 | 2026.5.5 | 初始版本，PHP 8.0 全栈实现 |