CapSkip 浏览器扩展指南
了解如何安装和配置 CapSkip 浏览器扩展以自动识别验证码。
CapSkip 浏览器扩展将你的浏览器连接到运行在你电脑或服务器上的 CapSkip 应用,并自动识别受支持的验证码挑战。
当出现验证码时,扩展会通过配置的 服务器 IP 和 端口将请求发送给 CapSkip。CapSkip 在本地识别并返回结果,扩展会自动将其应用到页面上。
支持的验证码类型: 图片验证码、reCAPTCHA v2、reCAPTCHA v2 Invisible、reCAPTCHA v3、Cloudflare Turnstile、GeeTest v3、ALTCHA、CaptchaFox、Capy Puzzle 和 Friendly Captcha.
浏览器扩展安装
安装 CapSkip 浏览器扩展,在浏览时自动检测并识别受支持的验证码挑战。

安装
CapSkip 扩展适用于 Chrome、Firefox 和基于 Chromium 的浏览器。
你可以直接从官方浏览器商店安装扩展:
Chrome 用户可从以下商店安装: Chrome 应用商店.
Firefox 用户可从以下商店安装: Firefox 附加组件商店.
对于 Brave、Edge、Opera 或 Vivaldi 等其他基于 Chromium 的浏览器,你可以从 Chrome 应用商店安装扩展,因为这些浏览器支持 Chrome 扩展。
扩展连接与验证码类型
点击浏览器工具栏中的 CapSkip 图标即可打开扩展弹窗。你可以在这里将扩展连接到 CapSkip 应用,并选择它要识别的验证码类型。

顶部控件
弹窗顶部有三个控件。
开 / 关开关:开启或关闭自动验证码识别。关闭时,扩展处于停用状态,不会向 CapSkip 发送任何内容。
语言:以英文、中文、西班牙文、俄文或波斯文显示扩展界面。
主题:“自动”跟随你的操作系统,“浅色”和“深色”则始终保持同一种外观。
服务器与 API 密钥
此部分将浏览器扩展连接到你本地的 CapSkip 应用。扩展会将验证码识别请求发送到运行在你机器或 VPS 上的 CapSkip 服务器。
1. 服务器 IP
输入 CapSkip 运行所在的 IP 地址。
localhost 当 CapSkip 与浏览器安装在同一台电脑上时,应使用它。 Localhost,即输入框旁边的按钮,可为你自动填入。
如果 CapSkip 运行在 VPS 或远程服务器上,请输入服务器的公网 IP 地址。
2. 端口
指定在 CapSkip 中配置的端口。默认端口是 8080.
扩展会将请求发送到 IP:Port 以与 CapSkip API 通信。
3. API 密钥
如果 CapSkip 应用中启用了 API 密钥校验 ,请输入你的 CapSkip API 密钥。
API 密钥增加了一层额外的安全保障,确保只有授权的应用或扩展才能向你的 CapSkip 实例发送验证码识别请求。
如果在 CapSkip 设置中禁用了 API 密钥校验,此字段可留空。
复制,即输入框末尾的图标,可将密钥复制到剪贴板。 获取订阅,即卡片顶部的链接,如果你还没有授权,它会打开 capskip.com。
启用 / 自动识别
此部分让你选择扩展应自动检测并识别哪些验证码类型。勾选某个类型即可开启,取消勾选则不处理该类型。
1. 图片验证码
通过 CapSkip 应用自动检测并识别受支持的基于图片的验证码。
要让图片验证码识别正常工作,你必须将验证码图片与应插入答案的输入框关联起来。 在页面上选择,即这一行上的按钮,用于启动引导式设置。详细说明请参阅 图片验证码设置 部分。
2. reCAPTCHA v2
处理 Google reCAPTCHA v2 挑战。提供两种识别模式:
Token:获取验证 token 并将其传给页面。
点击:像真人一样通过点击来完成图片挑战。
3. reCAPTCHA v2(隐形)
识别在提交表单或点击按钮时自动运行的隐形 reCAPTCHA v2 挑战。
4. reCAPTCHA v3
处理 reCAPTCHA v3 验证请求,并将所需的 token 返回给页面。
5. Cloudflare Turnstile
自动识别在受支持网站上检测到的 Cloudflare Turnstile 挑战。对于不断出现新挑战的网站,请参阅 高级设置.
6. GeeTest v3
识别 GeeTest v3 挑战。
7. ALTCHA
识别 ALTCHA 挑战。
8. CaptchaFox
识别 CaptchaFox 挑战。
9. Capy Puzzle
识别 Capy Puzzle 挑战。
10. Friendly Captcha
识别 Friendly Captcha 挑战。
图片验证码识别设置
要自动识别图片验证码,请配置扩展以检测验证码图片,并定义应插入识别结果的输入字段。此设置通常每个网站只需做一次。
你可以通过两种方式完成:
1. 在页面上选择:使用扩展弹窗中的引导式选取器(推荐大多数用户使用)。
2. 右键菜单:使用上下文菜单分别标记验证码图片和答案字段。
两种方法都会创建相同的已保存绑定。设置完成后,CapSkip 可在以后访问时捕获图片、发送给识别引擎,并自动插入答案。

方法 1:在页面上选择
使用此选项在一个引导流程中关联验证码图片和答案字段。它也适用于禁用右键菜单的网站。
打开显示图片验证码的网站,然后打开 CapSkip 扩展弹窗。
在“图像验证码”旁边,点击 在页面上选择。页面会进入选取模式,顶部会出现一个 CapSkip 横幅,并显示分步说明。
第 1 步,共 2 步:点击页面上的验证码。移动鼠标时,扩展会高亮显示元素。你所选内容的预览会显示在横幅中。
第 2 步,共 2 步:点击应输入验证码答案的输入框。
两步都完成后,横幅会确认验证码已关联,CapSkip 已准备好识别。随时按 Esc 即可取消。
已保存的绑定会显示在扩展设置的 已保存的绑定部分中,你可以在那里查看或删除它们。

方法 2:右键菜单
要通过右键菜单配置自动图片验证码识别,请先右键点击验证码图片,然后选择 “标记为 CAPTCHA 来源”。这会告诉扩展应捕获哪张图片并发送给 CapSkip 识别引擎。页面会确认图片位置已保存。
然后,右键点击应输入答案的输入框,并选择 “在此插入验证码答案”。页面会确认答案字段已保存,CapSkip 已准备好识别。
两个元素都配置完成后,每当页面上出现验证码,扩展都会自动捕获新的验证码图片,将其发送到 CapSkip 应用进行识别,并把返回的答案插入指定的输入框。

扩展设置
弹窗底部的“设置”卡片控制 CapSkip 浏览器扩展在浏览时的行为。

手动解决
启用后,只有当你点击识别按钮时才会识别验证码,该按钮的标签为 Solve with CapSkip,显示在页面上。这让你可以完全控制何时向 CapSkip 应用发送请求。禁用时,受支持的验证码会被自动识别。
开启“手动解决”后,识别按钮始终可见,即使其位置设置为“隐藏”也是如此。
域名黑名单
此选项让你在特定网站上禁用验证码识别。开启后,开关下方会展开一个面板:
添加:输入一个域名,例如
example.com再按“添加”或 Enter 键。添加当前网站:一键添加当前标签页中所打开网站的域名。
移除:每个条目旁边的按钮可将其从列表中移除。
域名同样涵盖其子域名,因此 example.com 会同时屏蔽 www.example.com 和 shop.example.com 。包含斜杠的条目,例如 example.com/login,只会屏蔽地址中包含该文本的页面。
此列表仅在该开关开启时生效。你也可以以纯文本形式编辑它(每行一个条目),入口位于 更多设置.
更多设置
在新标签页中打开完整的设置页面。其中的选项将在下面各部分中说明。
表单自动化
设置页面可通过弹窗中的 更多设置 打开。它的前两个卡片“服务器与 API 密钥”和“验证码类型”,用法与上文的弹窗部分完全相同。
此部分提供可选的自动化功能,在验证码处理之前、期间和之后增强识别流程。

自动提交表单
启用后,扩展会在验证码识别完成后自动提交表单。你可以定义提交前的延迟(以秒计)。
当某条 AutoSubmit 规则 与页面匹配时,会在相同的延迟后运行该规则,而不是执行默认的提交。
自动检查新的图片验证码
自动检测页面上的新图片验证码,并在不刷新的情况下为识别做好准备。
为图片验证码模拟类人输入
以逼真的延迟逐字符输入验证码答案,以更好地模拟人类行为。
按键延迟范围:两个字符之间的最短和最长停顿时间。默认值为 40 到 120 毫秒。
开始输入前的延迟:输入第一个字符前的短暂停顿。默认值为 250 毫秒。
输入前清空答案字段:在输入答案之前,清除输入框中已有的所有文本。
这些选项有助于让与验证码字段的交互更自然、更可靠。
出错时重试
如果识别出错,扩展可以自动重试。你可以指定重试次数,并设置每次尝试之间的延迟(以秒计)。设为 0 即关闭重试。
识别按钮位置
选择识别按钮在页面上的显示位置。
验证码表单内:按钮显示在表单内的验证码旁边。
固定在页面上(右下角):按钮悬浮在页面右下角。这是默认设置。
隐藏(仅自动求解):不显示按钮,验证码会被自动识别。如果开启了“手动解决”,按钮仍会显示在右下角,因为这是启动识别的唯一方式。
AutoSubmit 规则
此部分让你定义验证码识别后应运行的自定义操作。
默认情况下, AutoSubmit 功能会自动提交包含验证码答案字段的表单。但是,某些网站在验证码识别后需要额外步骤,例如点击特定按钮或触发另一操作。在这些情况下,你可以在此创建自定义规则。

创建新规则
创建新规则 用于为特定网站添加一条新的 AutoSubmit 规则。每条已保存的规则之后都可以编辑或删除。
URL 模式
定义规则应生效的网站。URL 模式是一个正则表达式,例如 ^https://example\.com/login。扩展只会在地址与其匹配的页面上运行该规则,并以第一条匹配的规则为准。
操作序列
“操作序列”字段定义了扩展在验证码识别后应执行的步骤。每个操作代表扩展执行的一条命令,用于与页面上的元素交互。
操作以单独的 JSON 对象编写,每行一个,并按其出现的顺序从上到下执行。
每个 action 都包含一个 type 和一个 value,某些 action 可能会使用 args 包含额外的参数。
基本结构
每个操作遵循以下格式:
{"type":"ACTION_TYPE","value":"ACTION_VALUE","args":[...]}多个操作写在不同的行上,例如:
{"type":"source","value":"document"}
{"type":"method","value":"querySelector","args":["#submit-button"]}
{"type":"method","value":"click"}在此示例中,扩展将:
从页面文档开始
找到与选择器匹配的元素
#submit-button点击所选元素
由于操作按顺序运行,行的顺序很重要。
常用操作
1. source
定义搜索元素的起始上下文。
示例:
{"type":"source","value":"document"}2. method: querySelector
使用 CSS 选择器选择一个元素。
示例:
{"type":"method","value":"querySelector","args":["#submit-button"]}这会找到 ID 为 submit-button.
3. method: click
在当前所选元素上触发点击。
示例:
{"type":"method","value":"click"}这会模拟点击上一步中所选的元素。
高级设置
针对特殊网站的额外功能。如非必要,请保持这些选项关闭。

解决重复出现的 Cloudflare Turnstile 验证
默认情况下,页面上只有第一个 Cloudflare Turnstile 挑战会被识别。如果网站在不刷新页面的情况下不断显示新挑战,请开启此项。
已保存的绑定
已保存的绑定记录了在特定网站上哪个元素是图片验证码、哪个输入框接收答案。 在页面上选择 和右键菜单选项会创建这些绑定。
列表显示每个网站及其 URL 模式、验证码预览和关联的答案字段。标记为 未链接字段 或 未链接验证码 的绑定只完成了一半设置。
删除任何错误或过时的绑定,然后在实际页面上重新设置。

代理
代理设置会将代理与每个 reCAPTCHA、Cloudflare Turnstile、ALTCHA、CaptchaFox 和 Friendly Captcha 任务一起发送给 CapSkip,让 CapSkip 通过该代理识别这些任务。代理关闭时,CapSkip 会沿用应用本身的代理设置,详见 设置指南.

启用代理
开启或关闭代理,不会删除你已输入的地址。
代理类型
选择你的代理所使用的协议:HTTP、HTTPS、SOCKS5 或 SOCKS5H。SOCKS5H 在代理端而不是在你的电脑上解析网站地址。
代理地址
请使用以下两种格式之一输入代理:
IP 认证:
IP:PORT账号认证:
login:password@IP:PORT
备份与恢复
将 CapSkip 扩展的所有设置保存到文件,或从文件恢复设置。这是将你的配置迁移到另一个浏览器或电脑的最快方式。

导出设置
下载一个包含你所有扩展设置的文件。该文件包含你的 API 密钥,请妥善保管。
导入设置
从导出的文件恢复设置。确认后,它会替换当前所有 CapSkip 设置。仅接受由 CapSkip 扩展导出的文件。
