# ChatHub

**Repository Path**: deepseek-r1/chathub

## Basic Information

- **Project Name**: ChatHub
- **Description**: 开源 DeepSeek 对话界面 | PHP + JavaScript 实现 | 流式响应支持
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 3
- **Created**: 2025-01-26
- **Last Updated**: 2025-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ChatHub 🚀

[![GitHub license](https://img.shields.io/github/license/deepseek-r1/chathub)](LICENSE)
[![Gitee Stars](https://gitee.com/deepseek-r1/chathub/badge/star.svg?theme=white)](https://gitee.com/deepseek-r1/chathub)

**基于 DeepSeek API 的开源对话界面 | PHP + JavaScript 实现**

👉 [在线体验 Demo](#) | 📚 [部署文档](docs/DEPLOY_CN.md)

[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![DeepSeek](https://img.shields.io/badge/Powered_by-DeepSeek-blue)](https://www.deepseek.com/)

开箱即用的 DeepSeek 对话界面实现，基于 PHP + JavaScript 构建，支持流式响应与多轮对话。

## 功能特性

- ✅ 流式响应（逐字输出效果）
- ✅ 多轮对话历史管理
- ✅ 极简部署（PHP 环境即用）
- ✅ Markdown 渲染支持
- 🔜 代码高亮（规划中）

## 快速开始

### 前置条件
- PHP ≥7.4 （需启用 `curl` 扩展）
- DeepSeek API Key

### 一键部署
```bash
# 克隆仓库
git clone https://gitee.com/deepseek-r1/chathub.git

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件填写你的 API Key

# 启动服务（PHP 内置服务器）
php -S 0.0.0.0:8000 -t frontend


#### 3. 开源协议
```markdown
## 开源协议

本项目采用 [MIT 协议](LICENSE)，欢迎自由使用、修改与二次分发！


---

### **四、首次代码提交**
```bash
# 添加所有文件
git add .

# 提交初始版本
git commit -m "init: 项目初始版本 by deepseek-r1"

# 推送到 Gitee
git push origin master

### **五、PHP 服务器测试**
#### 1. 配置环境
```bash
# 复制环境文件并填写真实 API Key
cp .env.example .env
nano .env  # 编辑 API Key
```

#### 2. 启动服务
```bash
# 进入项目目录
cd chathub

# 启动 PHP 内置服务器（前端目录作为根目录）
php -S 0.0.0.0:8000 -t frontend
```

#### 3. 访问测试
打开浏览器访问：`http://你的服务器IP:8000`

---

### **六、下一步建议**
1. **添加错误处理**  
   在 `api.php` 中增加 API 调用失败的提示：
   ```php
   if (curl_errno($ch)) {
       echo json_encode(['error' => curl_error($ch)]);
       exit;
   }
   ```

2. **性能优化**  
   添加缓存机制（如 Redis 缓存常见问答）

3. **安全增强**  
   在 `api.php` 中增加请求频率限制：
   ```php
   // 简单 IP 频率限制示例
   $ip = $_SERVER['REMOTE_ADDR'];
   $cacheKey = "rate_limit_$ip";
   if ($cache->get($cacheKey) > 10) { // 示例阈值
       http_response_code(429);
       exit('请求过于频繁');
   }
   $cache->increment($cacheKey);
   ```

需要我帮你优化任何具体功能模块，随时告诉我！现在就去创建仓库吧，期待你的第一个 commit！ 🎉