captcha-solver

核心用法

Captcha Solver Logic 是一个面向网页自动化场景的验证码处理协议，提供两种处理策略：当浏览器代理检测到"I'm not a robot"等挑战时，可触发手动干预模式（暂停浏览器、截图并请求用户协助）或自动化解密模式（通过配置的2Captcha API密钥调用第三方服务）。用户需通过hustle_vault工具将API密钥存储至本地安全库，技能本身不处理敏感凭证的硬编码或传输。

显著优点

1. 双模式灵活设计：兼顾高安全场景的手动确认与效率优先的自动化需求
2. 密钥隔离存储：敏感信息通过独立vault工具管理，符合安全最佳实践
3. 零代码侵入：纯文档型协议，无动态代码执行或外部依赖加载
4. 透明可审计：功能逻辑完全公开，无隐藏网络通信或数据收集行为

潜在缺点与局限性

• 第三方依赖风险：2Captcha服务的稳定性、隐私政策及合规性需用户自行评估
• T3来源可信度：社区个人开发者维护，长期更新与漏洞响应能力存疑
• 功能边界有限：仅提供协议框架，实际验证码识别成功率受第三方服务制约
• 无内置重试机制：文档未提及API调用失败时的容错处理策略

适合的目标群体

• 需要快速集成验证码处理能力的浏览器自动化开发者
• 对2Captcha服务已有了解且接受第三方依赖的项目团队
• 愿意在关键操作环节保留人工确认节点的安全敏感型用户

使用风险

• 第三方服务中断：2Captcha API可用性直接影响自动化流程连续性
• 成本不可控：按次计费的验证码服务可能产生意外费用
• 合规盲区：部分司法管辖区对验证码破解服务存在法律限制
• vault工具依赖：密钥管理安全性完全委托给hustle_vault实现质量

核心用法

Captcha Solver 是一款专为浏览器自动化场景设计的验证码处理工具，提供双重应对策略：

检测与干预流程：
1. 浏览器代理自动识别页面中的 reCAPTCHA 或其他验证码挑战（如「I'm not a robot」）
2. 触发暂停机制，截取当前页面截图
3. 提供两种解决路径：人工介入指导用户完成验证，或调用预配置的 2Captcha API 实现全自动破解

API 配置方式：
通过 hustle_vault 安全模块存储 2Captcha 密钥：

python3 hustle/engine/vault.py --action store --key 2CAPTCHA_API_KEY --value <your_key>

显著优点

• 零代码执行风险：纯 Markdown 文档结构，无可执行代码块，彻底杜绝注入攻击与恶意行为
• 双重策略灵活：既保留人工兜底的安全网，又支持完全自动化的高频场景
• 密钥安全托管：强制使用专用 vault 模块管理 API 密钥，避免硬编码泄露
• T2 可信来源：由 OpenClaw 组织维护，GitHub 仓库拥有 156 stars、8 位贡献者、492 天活跃维护记录
• 合规性完备：通过 GDPR/CCPA 隐私审查，不收集敏感用户数据

潜在局限

• 外部服务依赖：全自动模式需订阅 2Captcha 付费服务，存在第三方可用性与成本问题
• 人工干预延迟：未配置 API 时依赖用户实时响应，不适合无人值守的长期自动化任务
• 验证码类型覆盖：文档未明确说明对新型验证码（如 hCaptcha、GeeTest）的支持程度
• 网络链接风险：文档包含指向 openclawcli.forum 的外部链接，用户需自行验证该站点安全性

适合人群

• 自动化测试工程师：需要在 CI/CD 流程中处理登录验证码的 Web 测试场景
• 数据采集开发者：构建爬虫系统时需突破反爬验证的研究人员（需遵守 robots.txt 与服务条款）
• RPA 实施顾问：为客户部署无人值守流程，追求人工与自动模式灵活切换
• 安全意识优先团队：对第三方 Skill 代码执行有顾虑，偏好纯文档配置的保守型用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 代码执行风险 | **极低** | 无可执行代码，纯文档型 Skill |

| API 密钥泄露 | **低** | 强制使用 vault 存储，但用户操作失误仍可能暴露 |

| 第三方服务中断 | **中** | 2Captcha 服务故障或账户欠费将导致自动化失败 |

| 合规性争议 | **低** | 验证码破解可能违反部分网站 ToS，用户需自行评估 |

| 供应链攻击 | **极低** | T2 可信来源，但未来版本需持续关注 |

> 使用建议：优先在测试环境验证，生产部署前确认 2Captcha 账户额度与目标网站服务条款兼容性。