auto_cursor/SETUP_README.md

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

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

功能特点

1. 全自动化配置

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

2. 智能默认值

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

3. 连接性测试

   • 验证MySQL连接是否可用
   • 测试Redis连接
   • 提供详细的错误反馈

使用方法

步骤1: 准备环境

确保服务器上已安装：

• Python 3.7+
• MySQL/MariaDB
• Redis (可选)

步骤2: 运行设置向导

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. 导入邮箱账号:

   python import_emails.py
   

2. 启动自动服务:

   python start.py
   

3. 或直接启动自动化服务:

   python auto_cursor_service.py
   

服务器系统要求

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