# Cursor自动化服务使用说明

本自动化服务实现了Cursor注册流程的完全自动化，包括API状态监控、邮箱自动获取和账号上传功能。

## 功能特点

1. **API状态监控**
   - 实时监控注册API状态，自动开启/关闭注册进程
   - 支持配置检查间隔和自定义服务器标识(hostname)

2. **邮箱账号自动管理**
   - 监控本地邮箱池，当可用邮箱不足时自动从API获取
   - 支持配置获取阈值和批次数量

3. **账号自动上传**
   - 定期上传注册成功的账号到API
   - 支持配置上传间隔和代理设置
   - 通过extracted字段跟踪已上传账号

4. **进程管理**
   - 智能管理注册子进程的启动和停止
   - 在API关闭注册时自动停止进程

5. **完善的日志记录**
   - 详细的运行日志，支持日志轮转和压缩
   - 关键操作和错误的可追溯性

## 前置条件

1. 已配置好MySQL数据库
2. Redis服务(可选，但推荐)
3. 已在config.yaml中配置好hostname参数
4. 已安装所需依赖：`pip install -r requirements.txt`

## 配置说明

在`config.yaml`中添加以下配置：

```yaml
# 服务器配置
server_config:
  hostname: "sg424"  # 服务器标识，用于API调用

# 代理配置
proxy:
  # ... 其他代理配置 ...
  api_proxy: "http://your-proxy-server:port"  # API专用代理(可选)

# 自动服务配置
auto_service:
  check_interval: 60  # 检查API状态的间隔（秒）
  upload_interval: 300  # 上传账号间隔（秒）
  email_check_threshold: 30  # 当可用邮箱少于这个数时获取新邮箱
```

## 使用方法

1. **初始化数据库**（首次使用）
   ```bash
   python init_database.py
   ```

2. **升级数据库**（现有数据库升级）
   ```bash
   python upgrade_database.py
   ```
   
   > 注意：如果您从之前版本升级，需要运行此脚本添加新的`extracted`字段

3. **启动自动化服务**
   ```bash
   python auto_cursor_service.py
   ```

4. **查看运行状态**
   - 服务会在控制台输出基本运行信息
   - 详细日志保存在`auto_cursor_service.log`文件中

5. **停止服务**
   - 按Ctrl+C安全停止服务
   - 服务会自动停止注册进程并清理资源

## 工作流程

1. 服务启动，初始化数据库连接
2. 定期检查API注册状态(`/regstates`)
3. 如果注册开启：
   - 检查本地邮箱池，如果数量不足，从API获取新邮箱
   - 启动注册进程(main.py)
4. 如果注册关闭：
   - 停止注册进程
5. 定期上传注册成功的账号，并标记为已上传(extracted=1)
6. 循环以上步骤，直到服务被手动停止

## 常见问题

1. **API连接问题**
   - 检查网络连接和代理设置
   - 确认API URL和参数正确

2. **邮箱获取失败**
   - 检查API返回的错误信息
   - 可能是服务端暂无可用邮箱

3. **子进程管理问题**
   - Windows平台可能需要管理员权限来强制终止进程
   - 检查main.py是否能正常独立运行

4. **内存占用过高**
   - 调整日志设置，减少日志详细程度
   - 检查是否有内存泄漏

5. **数据库结构问题**
   - 如遇到"Unknown column 'extracted' in 'where clause'"错误
   - 运行`python upgrade_database.py`更新数据库结构

## 进阶使用

### 设置为系统服务（Linux）

1. 创建服务文件`/etc/systemd/system/cursor-service.service`：
   ```
   [Unit]
   Description=Cursor Auto Registration Service
   After=network.target mysql.service redis.service

   [Service]
   Type=simple
   User=your_user
   WorkingDirectory=/path/to/cursor/app
   ExecStart=/usr/bin/python3 /path/to/cursor/app/auto_cursor_service.py
   Restart=on-failure
   RestartSec=10

   [Install]
   WantedBy=multi-user.target
   ```

2. 重新加载systemd：
   ```bash
   sudo systemctl daemon-reload
   ```

3. 启动服务：
   ```bash
   sudo systemctl start cursor-service
   ```

4. 设置开机自启：
   ```bash
   sudo systemctl enable cursor-service
   ```

### 使用screen或tmux（简易方法）

```bash
# 使用screen
screen -S cursor
python auto_cursor_service.py
# 按Ctrl+A然后按D分离screen

# 使用tmux
tmux new -s cursor
python auto_cursor_service.py
# 按Ctrl+B然后按D分离tmux
```