# 本地AI聊天助手

**Repository Path**: Chancy599/local-ai-chat-assistant

## Basic Information

- **Project Name**: 本地AI聊天助手
- **Description**: 本项目是一个本地AI聊天应用，结合了简洁优雅的前端界面与Flask后端服务，能够与Deepseek的API进行交互，实现智能对话功能。尽管目前响应时间稍长，但整体体验流畅，旨在为用户提供一个直观、高效的AI聊天工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-02-21
- **Last Updated**: 2025-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: HTML, Python

## README

# 本地AI聊天助手

本项目是一个本地AI聊天应用，结合了简洁优雅的前端界面与Flask后端服务，能够与Deepseek的API进行交互，实现智能对话功能。尽管目前响应时间稍长，但整体体验流畅，旨在为用户提供一个直观、高效的AI聊天工具。

## 功能特点

- 🎨 简洁现代的用户界面
- 💬 实时AI对话能力
- 🔄 完整的前后端分离架构
- 📱 响应式设计，适配各种设备
- 🖥️ 纯HTML/CSS/JS前端，无需框架
- 🔌 基于Flask的轻量级后端服务
- ⌨️ 支持键盘快捷键操作

## 文件结构

```
ai-chat-assistant/
├── chat.html         # 前端界面
├── app.py            # Flask后端服务
└── requirements.txt  # 项目依赖
```

## 安装步骤

1. **克隆或下载项目**

2. **安装Python依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **配置API密钥**
   
   在`app.py`中，替换OpenAI客户端配置中的API密钥:
   ```python
   client = OpenAI(
       base_url='https://api.deepseek.com',  # 自定义API端点
       api_key='your-api-key-here'             # 替换为您的API密钥
   )
   ```

## 使用方法

1. **启动后端服务**
   ```bash
   python app.py
   ```
   服务将在 http://localhost:5000 上运行。

2. **打开前端界面**
   - 直接在浏览器中打开`chat.html`文件
   - 或者通过本地服务器访问此文件

3. **开始对话**
   - 在文本框中输入您的问题
   - 按Enter键或点击发送按钮
   - AI助手将生成回复

4. **退出程序**
   - 按Esc键退出前端
   - 在终端中按Ctrl+C停止后端服务

## 键盘快捷键

- `Enter` - 发送消息
- `Shift+Enter` - 在输入框中换行
- `Esc` - 退出应用程序

## 自定义选项

### 更改模型

在`app.py`中修改使用的AI模型:
```python
completion = client.chat.completions.create(
    model="your-preferred-model",  # 修改为您想使用的模型
    messages=messages
)
```

### 自定义界面

您可以通过编辑`chat.html`中的CSS样式来自定义用户界面。主要样式定义在`<style>`标签内。

## 技术栈

- **前端**: HTML5, CSS3, JavaScript (ES6+)
- **后端**: Python, Flask
- **API**: OpenAI兼容接口

## 注意事项

- 此应用仅用于本地使用，未实现用户认证或其他安全措施
- API密钥直接嵌入代码中，生产环境中应使用环境变量或更安全的方式
- 消息未保存到数据库，关闭应用后对话历史将丢失

## 排错指南

**问题**: 无法连接到API端点
**解决方案**: 检查API密钥和基础URL是否正确

**问题**: 前端无法连接到后端
**解决方案**: 确保Flask服务正在运行，检查CORS设置

**问题**: 依赖项安装失败
**解决方案**: 确保使用Python 3.7+，尝试逐个安装依赖项

## 扩展建议

- 添加会话持久化功能
- 实现用户认证系统
- 添加消息历史导出功能
- 支持多种AI模型切换
- 增加语音输入/输出功能