reverse-skills-max/vendor-new/xbsReverseSkill/web-verify-patcher/references/solver-platform-recipes.md

打码平台与请求模板

打码平台在本技能中只作为“授权 QA 对照”路线：用来判断问题究竟在本地识别/坐标/轨迹链路，还是在厂商绑定、服务端校验、session/IP/UA 或 challenge TTL 链路。它不是默认替代所有本地方案，也不是未授权流程的自动通过工具。

平台选择

场景	常见平台
图片文字、计算题	云码/JFBYM、超级鹰、2Captcha、Anti-Captcha
坐标、点选、滑块	云码/JFBYM、超级鹰、2Captcha Coordinates、CapSolver ComplexImageTask
reCAPTCHA、hCaptcha、Turnstile	2Captcha、CapSolver、CapMonster Cloud、Anti-Captcha、YesCaptcha/NoCaptchaAI
GeeTest、FunCaptcha/Arkose	2Captcha、CapSolver、CapMonster Cloud、Anti-Captcha
AWS WAF、DataDome、复杂 WAF	平台支持不稳定，优先厂商日志和环境诊断
PoW、活体、人脸	通常不建议平台；优先官方接入、人工审核或厂商支持

使用原则

1. 先确认授权范围和目标环境。
2. 先用开源方案跑样本；通过率不足再考虑平台。
3. 当同一授权目标、同一验证码类型、同一方案连续 5 次失败且图片/坐标/轨迹/切片还原/补环境/challenge 新鲜度均无明显异常时，优先建议平台作为授权 QA 对照。
4. 平台参数只使用非秘密字段：sitekey、pageurl、action、图片 base64、题面、坐标模式等。
5. API key 由用户在运行时提供，不写入 skill 文件，不保存，不回显，不输出到报告。
6. token 类结果只用于授权测试和服务端集成诊断，不注入未授权流程。
7. 未确认授权、未选择平台或未提供 API key 时，只生成模板和字段映射，不默认发送。

平台对照触发

满足以下条件时，输出 recommended_next_route: platform-control：

• 同一授权目标、同一验证码类型、同一用户选择方案连续 5 次验证失败。
• 5 次中没有任何一次成功。
• 图片识别、坐标映射、轨迹、切片乱序还原、补环境/浏览器环境和 challenge 新鲜度均未发现明显异常。
• 当前类型适合平台对照，例如 slider、image-restore/tile-scramble、click-select、grid、rotate、token-widget。

不满足条件时不要急于切平台：

• 失败不足 5 次：继续收集样本和诊断证据。
• 已有 1 次成功：当前方案可用但需要优化稳定性。
• 仍有明确坐标、轨迹、图片、乱序还原、补环境或过期问题：先修复阻塞项。
• pow-challenge、waf-challenge、biometric-liveness：不默认推荐普通打码平台，优先官方协议、环境诊断、人工复核或厂商支持。

请求模板脚本

使用 scripts/solver_request_template.py 生成模板：

python scripts/solver_request_template.py --platform 2captcha --captcha-type token-widget --provider recaptcha --pretty
python scripts/solver_request_template.py --platform jfbym --captcha-type click-select --pretty
python scripts/solver_request_template.py --platform capsolver --captcha-type game-challenge --provider arkose-funcaptcha --pretty

脚本输出 JSON 模板。

执行边界：

• 生成模板不等于发送请求。
• 只有用户再次明确确认授权范围、选择平台、提供 API key，并要求发送时，才允许调用平台接口。
• API key 不要写入 attempts JSON、skill 文件、报告、日志或命令历史可见位置。
• 平台返回的 token、坐标、偏移或答案只用于用户确认的授权 QA 对照。

字段提示

图片文字/算术

常见字段：

• 图片：文件或 base64。
• 题型：文字、数字、算术。
• 字符约束：长度、数字/字母、大小写。

坐标/点选/九宫格

常见字段：

• 完整截图或图片 base64。
• 题面文本。
• 输出模式：单点、多点、有序坐标、格子编号。
• 坐标原点和图片尺寸。

滑块/旋转

常见字段：

• 背景图、滑块图或单张挑战图。
• 轨道宽度、显示尺寸、DPR。
• 输出模式：偏移、角度、坐标。

token widget

常见字段：

• websiteURL / pageurl。
• websiteKey / sitekey。
• action、cdata、rqdata、enterprise 标记。
• user-agent、代理和 session 是否需要绑定。

FunCaptcha/Arkose

常见字段：

• public key / pkey。
• surl。
• blob。
• pageurl。
• 题面类型和是否需要代理绑定。

平台失败排查

• 题型选错：平台返回无解或低通过。
• 图片裁剪错：坐标和页面元素不一致。
• pageurl/action/sitekey 不匹配：token 服务端校验失败。
• token 过期：TTL 太短或提交太晚。
• session/IP/UA 不一致：平台结果无法绑定当前浏览器。
• 代理质量差：风控产品直接拒绝。