# Cursor自动化服务 - 环境设置向导

这个交互式设置向导(`setup_environment.py`)用于在新服务器上快速配置Cursor自动化服务环境，包括安装依赖、配置数据库和Redis、创建必要的表结构。

## 功能特点

1. **全自动化配置**
   - 自动检测并安装必要的Python依赖
   - 交互式配置MySQL和Redis
   - 自动创建数据库和用户
   - 创建必要的表结构
   - 更新配置文件

2. **智能默认值**
   - 使用主机名作为默认服务器标识
   - 识别现有配置并提供作为默认值
   - 为重要参数提供安全的建议值

3. **连接性测试**
   - 验证MySQL连接是否可用
   - 测试Redis连接
   - 提供详细的错误反馈

## 使用方法

### 步骤1: 准备环境

确保服务器上已安装：
- Python 3.7+
- MySQL/MariaDB
- Redis (可选)

### 步骤2: 运行设置向导

```bash
python setup_environment.py
```

### 步骤3: 按照提示完成配置

设置向导将引导您完成以下步骤：

1. **检查并安装依赖**
   - 自动安装必要的Python包

2. **配置服务器标识**
   - 设置唯一的服务器标识，用于API调用

3. **配置MySQL数据库**
   - 输入MySQL服务器信息
   - 提供MySQL root用户信息(用于创建数据库和用户)
   - 设置应用程序数据库和用户

4. **配置Redis缓存(可选)**
   - 选择是否使用Redis缓存
   - 配置Redis连接信息

5. **创建数据库和用户**
   - 自动创建数据库
   - 创建应用用户并设置权限

6. **创建表结构**
   - 创建email_accounts表
   - 创建system_settings表

7. **更新配置文件**
   - 备份现有配置
   - 写入新配置到config.yaml

## 配置选项说明

### 服务器标识
服务器标识是一个唯一的名称，用于在API调用中标识当前服务器。默认使用系统主机名。

### MySQL配置
- **主机地址**: MySQL服务器地址，默认为`localhost`
- **端口**: MySQL服务端口，默认为`3306`
- **数据库名**: 应用程序使用的数据库名，默认为`auto_cursor_reg`
- **应用用户名**: 应用程序使用的数据库用户，默认为`auto_cursor_reg`
- **应用用户密码**: 默认生成一个安全的随机密码

### Redis配置
- **是否启用**: 是否使用Redis缓存
- **主机地址**: Redis服务器地址，默认为`127.0.0.1`
- **端口**: Redis服务端口，默认为`6379`
- **密码**: Redis认证密码(如果设置了)
- **数据库索引**: Redis数据库索引，默认为`0`

## 安全注意事项

- 本脚本需要MySQL root权限来创建数据库和用户
- 数据库密码会以明文保存在配置文件中
- 脚本会自动备份现有配置文件，以`.bak`扩展名保存

## 常见问题

1. **无法连接到MySQL**
   - 确认MySQL服务已启动
   - 验证root密码是否正确
   - 检查防火墙设置

2. **无法连接到Redis**
   - 确认Redis服务已启动
   - 验证Redis密码是否正确
   - 如不需要Redis可选择禁用

3. **权限问题**
   - 确保使用的用户有创建数据库和用户的权限

4. **配置文件备份**
   - 脚本会自动备份原始配置文件为`config.yaml.bak.[时间戳]`

## 完成后的步骤

设置完成后，您可以：

1. 导入邮箱账号:
   ```bash
   python import_emails.py
   ```

2. 启动自动服务:
   ```bash
   python start.py
   ```
   
3. 或直接启动自动化服务:
   ```bash
   python auto_cursor_service.py
   ```

## 服务器系统要求

- **操作系统**: 支持Linux、Windows、macOS
- **内存**: 至少2GB RAM
- **存储**: 至少1GB可用空间
- **网络**: 稳定的互联网连接