🚀 Cursor Auto

English | 简体中文

📖 项目介绍

Cursor Auto 是一个强大的自动化工具，用于自动构建和管理 Cursor 试用账号。本工具支持 Windows、macOS 和 Linux 平台，提供了直观的界面和完整的功能集。

✨ 核心功能

🔄 自动账号管理
- 自动注册新账号
- 自动验证邮箱
- 智能账号轮换
🌐 跨平台支持
- Windows 系统支持
- macOS 系统支持
- Linux 系统支持
🛠 智能构建系统
- 自动环境检测
- 依赖自动安装
- 构建过程可视化
📊 完整日志系统
- 详细的运行日志
- 错误追踪和诊断
- 性能监控

🔧 环境要求

基础环境

🐍 Python 3.7+
📦 pip (Python包管理器)
🔄 Git (可选，用于版本控制)

系统要求

💻 Windows 10/11
🍎 macOS 10.15+
🐧 Linux (主流发行版)

浏览器要求

🌐 支持以下任一浏览器：
- Google Chrome
- Microsoft Edge
- Brave Browser

注意：浏览器最好为最新版本以确保兼容性。

Python 依赖

# 核心依赖
colorama==0.4.6        # 终端颜色支持
DrissionPage==4.1.0.17 # 浏览器自动化
psutil==5.9.8         # 系统资源监控
requests==2.31.0      # HTTP 请求处理
pyinstaller==6.3.0    # 应用打包工具

# 平台特定依赖
pywin32==306          # 仅 Windows 平台需要

🚀 快速开始

📥 下载和安装

克隆仓库：

git clone https://github.com/qinye6/cursor-auto.git
cd cursor-auto

安装依赖：

pip install -r requirements.txt

💻 使用方法

Windows 平台

# 方法 1：以管理员身份运行
右键 build.bat -> 以管理员身份运行

# 方法 2：命令行运行(需要管理员权限)
以管理员身份运行命令提示符
cd /d "项目目录"
build.bat

⚠️ 注意: Windows 平台需要管理员权限才能正常运行程序，因为需要修改系统注册表。

macOS 平台

# 添加执行权限
chmod +x build.mac.command

# 运行脚本 (需要 sudo 权限)
sudo ./build.mac.command

⚠️ 注意: macOS 平台需要 sudo 权限才能正常运行程序，因为需要修改系统标识。

Linux 平台

# 添加执行权限
chmod +x build.sh

# 运行脚本
./build.sh

📁 项目结构

cursor-auto/
├── 📜 build.py           # 主构建脚本
├── 🔧 build.bat          # Windows构建脚本
├── 🔧 build.mac.command  # macOS构建脚本
├── 🔧 build.sh           # Linux构建脚本
├── 📋 build.spec         # PyInstaller配置
├── 📦 requirements.txt   # 依赖清单
├── ⚙️ config.template.json # 配置模板
├── 📊 logger.py          # 日志管理
├── 🌐 browser_utils.py   # 浏览器工具
├── 📧 email_api.py       # 邮件接口
├── 🔑 cursor_auth_manager.py # 认证管理
├── 🤖 cursor_pro_keep_alive.py # 主程序
├── 📁 logs/             # 日志目录
├── 📁 dist/             # 构建输出
└── 📁 build/            # 临时文件

⚙️ 配置说明

配置文件

项目使用 JSON 格式的配置文件：

config.template.json: 配置模板

{
    "email": {
        "domain": "xxxx.xxxx",          // 邮箱域名，用于生成邮箱地址的后缀，如 [email protected]
        "mail_domain": "xxxx.xxxx", // 临时邮箱服务的域名，用于显示邮箱服务商
        "prefix_enabled": true,           // 是否启用随机前缀
        "prefix_length": 8,              // 随机前缀的长度（当prefix_enabled为true且无custom_prefix时使用）
        "custom_prefix": "cursor",             // 自定义固定前缀，如设置为"cursor"则生成[email protected]
        "api": {
            "base_url": "https://xxxx.xxxx",  // 临时邮箱后端API地址
            "admin_password": "xxxxxxxx",                   // 管理员密码，用于API认证
            "web_url": "https://xxxx.xxxx"           // 临时邮箱Web界面地址
        }
    },
    "browser": {
        "default": "chrome",             // 默认浏览器选择（chrome/edge/brave）
        "incognito": true,              // 是否使用无痕模式
        "headless": true                // 是否使用无头模式（不显示浏览器窗口）
    },
    "account": {
        "first_name": "qin",            // 注册时使用的名字
        "last_name": "ye",              // 注册时使用的姓氏
        "password_length": 12           // 生成随机密码的长度
    },
    "cursor": {
        "auto_start": true,              // 是否在操作完成后自动启动 Cursor
        "path": "C:\\Users\\%USERNAME%\\AppData\\Local\\Programs\\cursor\\Cursor.exe"  // Cursor 的安装路径
    }
}

config.json: 本地配置（从模板复制修改）

环境变量

支持通过环境变量覆盖配置：

CURSOR_EMAIL_SERVICE
CURSOR_EMAIL_USERNAME
CURSOR_EMAIL_PASSWORD
CURSOR_BROWSER_TYPE

临时邮箱

本项目使用了[cloudflare_temp_email]临时邮箱获取注册邮箱api
可以查看相关[部署文档]来部署到cloudfalare上使用

📝 日志系统

日志级别

🔴 ERROR: 错误信息
🟡 WARNING: 警告信息
🔵 INFO: 一般信息
🟢 DEBUG: 调试信息

日志位置

构建日志：logs/build_YYYYMMDD_HHMMSS.log
运行日志：logs/runtime_YYYYMMDD_HHMMSS.log

❗ 常见问题

1. 构建相关

❓ 问题: 构建失败，提示缺少依赖
- ✅ 解决: 运行 pip install -r requirements.txt
❓ 问题: PyInstaller 打包错误
- ✅ 解决: 清理 build 和 dist 目录后重试

2. 运行相关

❓ 问题: 浏览器启动失败
- ✅ 解决: 检查 Chrome/Edge/Brave 是否正确安装，并确保为最新版本
- ✅ 解决: 确保浏览器没有被其他程序占用
- ✅ 解决: 检查浏览器驱动是否与浏览器版本匹配
❓ 问题: 浏览器自动化失败
- ✅ 解决: 关闭浏览器的开发者模式
- ✅ 解决: 清除浏览器缓存和 Cookie
- ✅ 解决: 检查是否有反自动化插件在运行
❓ 问题: 邮箱验证失败
- ✅ 解决: 检查邮箱配置和网络连接

🔨 开发指南

代码风格

遵循 PEP 8 规范
使用类型注解
添加详细注释

提交规范

feat: 新功能
fix: 修复问题
docs: 文档更新
style: 代码格式
refactor: 代码重构
test: 测试相关
chore: 构建相关

开发流程

创建功能分支
开发新功能
编写测试用例
提交代码审查
合并到主分支

🤝 贡献指南

Fork 本仓库
创建特性分支
提交更改
推送到分支
创建 Pull Request

🙏 致谢

本项目参考了以下优秀的开源项目：

cursor-auto-free - 提供了基础的自动化框架和邮箱验证逻辑
gpt-cursor-auto - 提供了 ChatGPT Access Token 获取的思路
cursor-auto-free - 提供了额外的功能特性参考

感谢这些项目的开发者为开源社区做出的贡献！

📄 许可证

本项目采用 MIT 许可证。

👥 贡献者

感谢所有贡献者的付出！

📞 联系方式

📧 Email: [email protected]

🌟 Star History

如果这个项目对您有帮助，请考虑给它一个 Star ⭐️

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.github/workflows		.github/workflows
assets		assets
turnstilePatch		turnstilePatch
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
README_EN.md		README_EN.md
anti_detection.py		anti_detection.py
auto_updater.py		auto_updater.py
browser_utils.py		browser_utils.py
build.bat		build.bat
build.mac.command		build.mac.command
build.py		build.py
build.sh		build.sh
build.spec		build.spec
config.json		config.json
config.py		config.py
config.template.json		config.template.json
cursor_auth_manager.py		cursor_auth_manager.py
cursor_pro_keep_alive.py		cursor_pro_keep_alive.py
email_api.py		email_api.py
email_generator.py		email_generator.py
error_handler.py		error_handler.py
exit_cursor.py		exit_cursor.py
get_email_code.py		get_email_code.py
human_simulator.py		human_simulator.py
icon_converter.py		icon_converter.py
logger.py		logger.py
logo.png		logo.png
logo.py		logo.py
proxy_manager.py		proxy_manager.py
requirements.txt		requirements.txt
reset_machine.py		reset_machine.py
session_manager.py		session_manager.py
version.py		version.py

License

qinye6/cursor-auto

Folders and files

Latest commit

History

Repository files navigation