QQbot/docs/PROJECT_REFACTOR.md

# 项目结构整理完成

## 整理内容

### ✅ 已完成的工作

1. **重构目录结构**
   - 创建 `src/` 源代码目录
   - 按功能模块划分：`core/`、`handlers/`、`utils/`
   - 预留 `ai/` 目录用于后续AI集成
   - 创建 `logs/` 和 `data/` 目录

2. **清理冗余文件**
   - 删除 `start.sh`（Linux启动脚本，项目在Windows环境）
   - 删除 `start_simple.bat`（简化版启动脚本）
   - 移除 `colorlog` 依赖（未使用）

3. **优化核心文件**
   - 创建统一入口 `main.py`
   - 更新 `start.bat` 启动脚本
   - 简化 `requirements.txt`（只保留必需依赖）
   - 优化日志模块（日志文件统一存放到 `logs/` 目录）

4. **完善项目文档**
   - 更新 `README.md`（包含新的项目结构说明）
   - 更新 `.gitignore`（添加日志和数据目录）
   - 为 AI 模块创建规划文档

5. **模块化改造**
   - 为所有模块添加 `__init__.py`
   - 统一导入路径
   - 保持代码整洁和可维护性

## 新的项目结构

```
QQbot/
├── src/                    # 源代码
│   ├── core/              # 核心模块（bot、config）
│   ├── handlers/          # 消息处理器
│   ├── utils/             # 工具模块（logger）
│   └── ai/                # AI模块（预留）
├── logs/                  # 日志文件
├── data/                  # 数据文件
├── main.py               # 程序入口
├── start.bat             # 启动脚本
└── requirements.txt      # 依赖列表
```

## 后续AI接入建议

在 `src/ai/` 目录下可以创建：
- `client.py` - AI客户端封装
- `prompts.py` - 提示词管理
- `context.py` - 对话上下文管理
- `models/` - 不同AI模型的配置

## 启动方式

```bash
# Windows
start.bat

# 或直接运行
python main.py
```

项目现在更加整洁、模块化，便于后续扩展和维护！