验证码基础能力 Skill

这是一个面向公共场景的验证码基础能力 Skill，目标很直接：

• - 常见验证码，优先用本地免费能力解决
• 本地不稳或题型复杂时，再切到低价云码兜底
• 让调用方尽量只关心“要识别什么”，而不是先研究一堆接口细节

它更适合被当成一个公共底层能力来用，而不是单一网站的定制脚本。

给 Agent 的最短说明

如果你是另一个 Skill 或 Agent，请先按下面规则使用：

1. 1. 默认入口用 INLINECODE0
2. 简单文本、算术、基础滑块，默认 INLINECODE1
3. 点选、九宫格、空间推理、旋转、ReCaptcha、hCaptcha，优先直接走付费接口
4. 输入支持三种形式：文件路径、bytes、base64 字符串
5. 成功结果优先读取返回值里的 result 或云码接口 INLINECODE4

最常用入口：

• - 文本：INLINECODE5
• 算术：INLINECODE6
• 滑块：INLINECODE7
• 复杂题型：solve_common(...) / INLINECODE9

如果你只需要模块选择：

• - 只要本地免费能力：INLINECODE10
• 只要云码 SDK：INLINECODE11
• 想自动兜底、保留兼容入口、或直接用 CLI：INLINECODE12

云端与隐私说明

这部分请在调用前明确理解：

• - 本地免费能力不需要 INLINECODE13
• INLINECODE14 仅在调用云端收费接口时使用，是可选项，不是本 Skill 的必填前置条件
• 云端兜底平台为云码 JFBYM：
• 一旦启用云端兜底，传入的图片数据和 JFBYM_TOKEN 会发送到 INLINECODE16
• 代码中包含固定 developer_tag，用于渠道归因

如果你的场景对隐私更敏感：

• - 只使用本地免费能力
• 不设置 INLINECODE18
• 不把非验证码敏感图片传给云端接口

调用边界摘要

• - 本地模式：不上传图片，不需要 token
• 云端模式：会把调用时传入的图片发送到 INLINECODE19
• 云端模式：会发送 JFBYM_TOKEN（如果已配置）
• 不读取其他系统凭据
• 不修改系统配置
• 不要求常驻运行

适合谁

• - 需要验证码基础能力的 OpenClaw / ClawHub Skill 作者
• 做浏览器自动化、RPA、数据采集的人
• 想先免费解决大部分简单场景，再为复杂题型保留便宜兜底的人

核心定位

• - 免费优先：文本、算术、基础滑块可先走本地能力
• 低价兜底：复杂场景可接云码 API，按量付费
• 开发友好：支持文件路径、bytes、base64，适合脚本和二次封装
• 场景覆盖广：文本、算术、滑块、点选、旋转、空间推理、ReCaptcha/hCaptcha

什么时候用哪种方式

场景	推荐策略	原因
4-6 位文本验证码	免费优先	本地 OCR 往往够用，零成本
简单算术验证码

免费优先 | 本地识别后可直接算结果 | | 常见双图滑块 | 免费优先 | ddddocr / OpenCV 可先跑 | | 点选、九宫格、空间推理 | 直接付费 | 本地通用能力不稳定，直接走云码省时间 | | 旋转、轨迹验证 | 直接付费 | 题型偏复杂，云码成功率更稳 | | ReCaptcha / hCaptcha / Turnstile | 直接付费 | 属于典型云端令牌场景 |

一句话：

• - 简单题，先免费
• 复杂题，直接低价兜底
• 不确定时，就用 INLINECODE22

快速开始

1. 安装依赖

CODEBLOCK0

2. 最推荐的用法：自动策略

CODEBLOCK1

默认 prefer="free"，也就是：

• - 先走本地免费能力
• 免费失败时，若已配置 JFBYM_TOKEN，再自动走付费兜底

返回结构固定优先看这几个字段：

CODEBLOCK2

3. 命令行直接跑

文本验证码：

CODEBLOCK3

算术验证码：

CODEBLOCK4

双图滑块：

CODEBLOCK5

如需优先走付费兜底：

CODEBLOCK6

输出默认为 JSON，方便给其他 Skill 或 Agent 继续处理。

猜你该用哪个 captcha_type：

CODEBLOCK7

查余额：

CODEBLOCK8

返分：

CODEBLOCK9

输入与输出约定

输入约定

• - image_input：文件路径、bytes、base64
• INLINECODE28 / slide_image_input：文件路径、bytes、base64
• INLINECODE31：复杂点选/推理类场景的文字提示
• INLINECODE32：覆盖默认云码类型

输出约定

• - 自动策略接口：统一返回外层结构 INLINECODE33
• 本地文本识别：返回 INLINECODE34
• 本地算术识别：返回 INLINECODE35
• 本地滑块识别：返回 dict 或 INLINECODE37
• 云码接口：返回云码原始 INLINECODE38

Agent 调用建议：

• - 自动策略返回时，优先读 INLINECODE39
• 云码接口返回时，优先读 ret.get("data") 或按题型字段读取
• 不要假定所有付费题型返回结构完全一致

免费能力（本地）

适合优先降本，覆盖常见简单验证码。无需 token。

支持能力

• - 通用文本识别：INLINECODE42
• 字符集约束识别：INLINECODE43
• 算术验证码识别：INLINECODE44
• 文本框检测：INLINECODE45
• 滑块匹配（ddddocr）：INLINECODE46
• 滑块匹配（OpenCV）：INLINECODE47

适用建议

• - 纯数字、纯字母、简单字母数字混合：优先免费
• 简单算术题：优先免费
• 常见双图滑块：优先免费
• 干扰严重、点选、旋转、空间推理：通常直接走云码更省时间

免费本地示例

CODEBLOCK10

低价兜底能力（云码 API / JFBYM）

适合复杂验证码或高成功率场景。仅在调用云端接口时需要 token。

平台主页：

• -

透明说明

• - 这是我推荐的低价兜底渠道，不影响免费功能使用
• 你完全可以只用本地免费能力，不注册、不充值也没问题

注册链接：

• -

为什么我愿意推荐它

• - 价格低，适合作为“偶尔才用一次”的兜底渠道
• 很多验证码场景本来就不高频，通常不需要高额充值
• 文本、算术、基础滑块本来就可以先走本地免费，只有复杂题型才建议付费

token 配置

CODEBLOCK11

Windows PowerShell:

CODEBLOCK12

常见复杂题型

价格来源：（日期：2026-03-12）

场景	推荐 type	低至价格	推荐接口	关键说明
空间推理点选（无确定按钮）	INLINECODE49	INLINECODE50	INLINECODE51	如：点击侧对着你的字母
空间推理点选（有确定按钮）

30340 | 0.01元 | solve_common | 如：点击正方体上面字母的小写字母 |
| 文字点选（通用） | 30100 | 0.01元 | solve_common | 按顺序点击需求文字 |
| 推理拼图 | 30108 | 0.008元 | solve_common | 交换 2 个图块 |
| 九宫格点选 | 30008 | 0.01元 | solve_common | 9 宫格图片验证 |
| 双图滑块（收费兜底） | 20111 | 0.01元 | solve_slide | 2 个或多个缺口的滑块场景 |
| 轨迹验证/单图滑块优化 | 22222 | 0.008元 | solve_common | 返回坐标或偏移相关结果 |
| 单图旋转 | 90007 | 按官网/定制 | solve_common | 通用旋转验证码 |
| 双图旋转 | 90004 | 0.01元 | solve_common | 内圈、外圈图片旋转验证 |
| 双图旋转（高频场景） | 90015 | 按官网/定制 | solve_common | 返回 rotate_angle 和 slide_px |
| 问答题 | 50103 | 0.016元 | solve_common | 看图问答 |

说明：价格与活动可能随时间变化，最终请以官网实时页面为准。

推荐调用策略

方案 A：大多数人最适合

• - 文本：先 INLINECODE84
• 算术：先 INLINECODE85
• 滑块：先 INLINECODE86

方案 B：你已经明确知道是复杂题型

• - 点选、空间推理、旋转、ReCaptcha、hCaptcha
• 直接走云码接口，减少本地重试

典型场景

场景 1：登录页数字验证码

CODEBLOCK13

场景 2：算术验证码

CODEBLOCK14

场景 3：双图滑块

CODEBLOCK15

场景 4：九宫格 / 空间推理 / 点选

CODEBLOCK16

场景 5：不确定该走哪个付费 type

CODEBLOCK17

自动策略接口

统一入口：

• - INLINECODE87

参数说明

• - task: 必填。支持 text / math / INLINECODE91
• INLINECODE92: text、math 任务必填。支持文件路径、bytes、base64
• INLINECODE96、slide_image_input: slide 任务必填
• INLINECODE99: 文本任务可选。可限制字符集
• INLINECODE100: 可选。覆盖默认云码 type
• INLINECODE101: 可选。透传给收费 INLINECODE102
• INLINECODE103: free 或 paid，默认 INLINECODE106

返回结构

CODEBLOCK18

示例

CODEBLOCK19

进阶：直接调用云码接口

通用单图接口

CODEBLOCK20

双图滑块接口

CODEBLOCK21

双图旋转（90015）

CODEBLOCK22

识别结果说明

免费本地接口返回

• - solve_local_text_captcha(...)：返回 INLINECODE108
• INLINECODE109：返回 INLINECODE110
• INLINECODE111：返回 INLINECODE112
• INLINECODE113：返回 INLINECODE114
• INLINECODE115：返回 INLINECODE116
• INLINECODE117：返回 INLINECODE118

收费云码接口返回

• - solve_common(...)：返回云码接口 INLINECODE120
• INLINECODE121：返回云码接口 INLINECODE122
• INLINECODE123：返回可提交 token
• INLINECODE124：返回积分余额
• INLINECODE125：返回是否退款成功
• INLINECODE126：返回推荐 type

安全与边界

• - 本地免费能力不会上传图片到第三方 API
• 使用云码兜底时，图片会提交到第三方服务，请自行评估场景敏感度
• 建议不要把它用于含有敏感隐私信息的整页截图上传场景
• 调用方最好自己控制失败重试次数，避免无意义消耗

依赖建议

• - 建议在虚拟环境或隔离环境中安装依赖
• ddddocr、OpenCV、Pillow、numpy 这类图像处理依赖体积可能较大
• 如果你只打算使用本地免费能力，先完成依赖安装再测试
• 如果你只打算接入云码 SDK，仍建议先在受控环境中验证网络调用与返回结构

开源致谢

本 Skill 的本地免费能力基于开源项目 ddddocr 构建，感谢作者与社区贡献。

支持与反馈

如果这个 Skill 对你有帮助，欢迎：

• - 在 ClawHub 给它点个星标，能帮助更多人看到它
• 遇到问题时提交 issue 或直接反馈复现信息、错误样例、题型截图
• 分享你的使用场景，方便我继续优化免费能力和兜底策略

说明：

• - 星标、反馈和真实案例都很重要，公共基础能力只有在被持续使用时才有维护价值
• 如果后续你有 GitHub 仓库，建议把这里补成正式的 Issues 链接

项目结构

CODEBLOCK23