first commit: DuoPlus云手机协议注册工具 - 完整实现

QUICKSTART.md

@@ -0,0 +1,124 @@
+# DuoPlus 协议注册 - 快速开始指南
+
+## 🚀 快速上手
+
+### 1. 安装依赖
+```bash
+pip install -r requirements.txt
+```
+
+### 2. 配置 API Key
+```bash
+cp .env.example .env
+# 编辑 .env 文件，填入你的 2captcha API Key
+```
+
+### 3. 运行注册
+```bash
+python main.py
+# 或
+python duoplus_register.py
+```
+
+## 📝 重要说明
+
+### API 端点说明
+当前脚本中的 API 端点是基于常见模式推测的，实际使用时可能需要：
+
+1. **使用网络抓包工具分析实际请求**
+   ```bash
+   # 安装 mitmproxy
+   pip install mitmproxy
+   
+   # 运行分析脚本
+   mitmdump -s analyze_requests.py -p 8080
+   ```
+
+2. **需要更新的关键参数**
+   - 腾讯验证码 app_id（在 `duoplus_register.py` 第 53 行）
+   - API 端点 URL
+   - 请求头参数
+
+### 腾讯验证码处理流程
+
+1. **初始化验证码**
+   - 获取验证码配置（app_id）
+   - 调用 2captcha API 提交任务
+
+2. **等待识别结果**
+   - 2captcha 会返回 ticket 和 randstr
+   - 这两个参数用于验证
+
+3. **提交验证结果**
+   - 将 ticket 和 randstr 随注册请求一起提交
+
+## 🛠️ 调试技巧
+
+### 1. 测试 2captcha 连接
+```bash
+python test_register.py
+# 选择选项 1
+```
+
+### 2. 查看详细日志
+脚本使用彩色输出显示不同类型的信息：
+- 🟦 蓝色：信息
+- 🟨 黄色：警告/输入提示
+- 🟩 绿色：成功
+- 🟥 红色：错误
+
+### 3. 常见问题
+
+**Q: 验证码识别失败**
+- 检查 2captcha 余额
+- 确认 API Key 正确
+- 检查网络连接
+
+**Q: 注册请求失败**
+- 使用抓包工具获取最新的 API 端点
+- 检查请求头是否完整
+- 确认邮箱未被注册
+
+## 📌 注意事项
+
+1. **费用提醒**：每次验证码识别约需 $0.003
+
+2. **频率限制**：避免短时间内大量注册
+
+3. **邮箱要求**：使用真实可接收邮件的邮箱
+
+4. **合规使用**：遵守服务条款，仅用于合法用途
+
+## 💡 扩展使用
+
+### 批量注册（示例）
+```python
+from duoplus_register import DuoPlusRegister
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+registrar = DuoPlusRegister(os.getenv('CAPTCHA_API_KEY'))
+
+# 批量注册
+emails = ["test1@example.com", "test2@example.com"]
+for email in emails:
+    success = registrar.auto_register(email)
+    if success:
+        print(f"✅ {email} 注册成功")
+    else:
+        print(f"❌ {email} 注册失败")
+```
+
+## 🔧 项目文件说明
+
+- `main.py` - 主入口文件
+- `duoplus_register.py` - 核心注册逻辑
+- `captcha_solver.py` - 2captcha 集成
+- `test_register.py` - 测试工具
+- `analyze_requests.py` - 网络请求分析工具
+- `.env` - 配置文件（需自行创建）
+
+---
+
+如有问题，请查看 README.md 获取更详细的文档。