File size: 4,646 Bytes
89419ea | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 | # register.py 精简分析报告
## 概况
| 指标 | 数值 |
|------|------|
| 总行数 | 4282 |
| 方法总数 | 103 |
| 100+ 行巨型方法 | 8 个 |
| >50 行方法 | 15 个 |
| <10 行微型方法 | 12 个 |
## 功能分区与行数占比
| 区域 | 行范围 | 行数 | 占比 | 说明 |
|------|--------|------|------|------|
| 核心注册流程 | L93-L556 | 464 | 11% | 初始化、OAuth、登录、密码提交 |
| **Token 交换** | L557-L827 | **271** | **6%** | `_complete_token_exchange` 一个方法 |
| 登录重启 | L828-L881 | 54 | 1% | `_restart_login_flow` |
| **Cookie/Session 处理** | L882-L978 | 97 | 2% | 提取 session_token、Cookie 工具 |
| **chatgpt.com 会话桥接** | L979-L1591 | **613** | **14%** | 会话捕获、重定向跟踪、桥接登录、Outlook 特化 |
| 密码注册 + 邮箱标记 | L1592-L1689 | 98 | 2% | |
| OTP 验证 + 日志 | L1690-L1873 | 184 | 4% | stage 管理、验证码获取、debug 日志 |
| **日志/调试工具** | L1874-L2136 | 263 | 6% | Cookie debug、账号创建、域名黑名单 |
| **导航/载荷解析** | L2137-L2659 | **523** | **12%** | JSON 解码、文本提取、URL 分类、导航候选 |
| **Consent/Script 资产检查** | L2659-L2956 | **298** | **7%** | Script 资产解析、embedded payload 提取 |
| **Workspace 选择** | L2957-L3368 | **412** | **10%** | workspace/org 获取、选择、callback 探测 |
| **恢复/重试路径** | L3369-L3940 | **572** | **13%** | consent 恢复、重定向跟踪、Outlook 恢复、会话内重登 |
| 主入口 + 保存 | L3941-L4282 | 342 | 8% | authorize replay、run、save_to_database |
## 精简建议
### 1. 导航/载荷解析提取为独立模块（省 ~520 行）
**区域**: L2137-L2659，共 **523 行、15 个方法**
这些方法全部是纯工具函数，与 `RegistrationEngine` 状态无关：
- `_decode_auth_cookie_json_segments`、`_decode_cookie_json_payloads`
- `_collect_interesting_text_fragments_from_data`
- `_extract_app_router_push_payloads_from_text`
- `_extract_json_payload_candidates_from_fragment`
- `_sanitize_url_for_log`
- `_remember_resume_candidate`、`_remember_navigation_candidate` 等
> **操作**：提取到 `src/core/navigation_parser.py`，RegistrationEngine 调用即可。
---
### 2. Consent/Script 资产检查合并（省 ~100 行）
**区域**: L2659-L2956，共 **298 行**
包含：
- `_inspect_consent_script_assets` (74行) — 下载并解析 JS 脚本
- `_extract_embedded_payloads_from_text` (47行)
- `_extract_navigation_candidates_from_text` (37行)
- `_normalize_response_text` (17行)
- 多个小型解析方法
> **操作**：与"导航解析"合并移到同一个工具模块中。
---
### 3. chatgpt.com 会话桥接提取为独立模块（省 ~600 行）
**区域**: L879-L1591，共 **613 行**
标明 `# chatgpt.com 会话桥接方法 (从 dou-jiang/codex-console 移植)`。
包含：
- `_capture_auth_session_tokens` (125行)
- `_follow_chatgpt_auth_redirects` (77行)
- `_bootstrap_chatgpt_signin_for_session` (119行)
- `_bridge_login_for_session_token` (180行)
- `_complete_token_exchange_outlook` (103行)
> **操作**：提取到 `src/core/chatgpt_bridge.py`，作为独立类或 mixin。
---
### 4. `_complete_token_exchange` 拆分（当前 271 行）
这是最大的单个方法，包含多层嵌套的条件分支（about-you 处理、user_exists 检测、authorize replay、consent fallback 等）。
> **操作**：将 about-you 分支、user_exists 恢复逻辑各提取为子方法，可减 100+ 行。
---
### 5. 恢复/重试路径整理（省 ~200 行）
**区域**: L3369-L3940
- `_attempt_session_bound_reauth` (130行) — 已经很独立
- `_follow_redirects` (128行) — 通用重定向跟踪
- `_persist_recoverable_outlook_account` (74行) — Outlook 专用
> **操作**：`_follow_redirects` 是通用 HTTP 工具，可移到 `http_client.py`。Outlook 恢复逻辑可移到单独模块。
---
## 精简预估
| 策略 | 预估节省 | 操作复杂度 |
|------|----------|-----------|
| 导航/载荷解析 → `navigation_parser.py` | ~520 行 | 低（纯提取） |
| chatgpt 桥接 → `chatgpt_bridge.py` | ~600 行 | 中（需处理状态依赖） |
| Consent/Script → 合并到导航解析 | ~100 行 | 低 |
| `_complete_token_exchange` 拆分 | ~100 行 | 中 |
| `_follow_redirects` → `http_client.py` | ~130 行 | 低 |
**总计可精简约 1450 行**，register.py 预计从 4282 行降到 ~2800 行。
> [!IMPORTANT]
> 所有精简操作都是**代码搬迁和拆分**，不删除任何功能，只是让 register.py 更聚焦于核心注册编排逻辑。
|