xby-captcha

Readme

# xby-captcha

DeepSeek Harness (DSH) 的插件：验证码识别工具集

验证码识别工具集，支持文本、滑块、旋转、选择等验证方式的识别。注意：一定要遵守目标网站或系统的使用条款和法律法规，在允许的条件下使用。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **find_chars** — 识别图片中的文字（数字、字母、汉字），输入常见验证码图片，返回验证码文本内容和置信度。 需要输入图片文件链接。
- **find_chars_for_data_base64** — 识别图片中的文字（数字、字母、汉字），输入常见验证码图片，返回验证码文本内容和置信度。 需要输入图片文件的BASE64编码。
- **find_chars_for_data_file** — 识别图片中的文字（数字、字母、汉字），输入常见验证码图片，返回验证码文本内容和置信度。 需要输入图片文件的文件路径。
- **slide_match_target_background** — 根据目标（滑块）图在背景图（带缺口）中找到最佳匹配位置，返回缺口坐标。 需要输入图片文件链接。
- **slide_match_target_background_for_data_base64** — 根据目标（滑块）图在背景图（带缺口）中找到最佳匹配位置，返回缺口坐标。 需要输入图片文件的BASE64编码。
- **slide_match_target_background_for_data_file** — 根据目标（滑块）图在背景图（带缺口）中找到最佳匹配位置，返回缺口坐标。 需要输入图片文件的文件路径。
- **slide_match_only_background** — 在背景图（带缺口）中找到缺口位置，即滑块的最佳匹配位置，返回缺口坐标。 需要输入图片文件链接。
- **slide_match_only_background_for_data_base64** — 在背景图（带缺口）中找到缺口位置，即滑块的最佳匹配位置，返回缺口坐标。 需要输入图片文件的BASE64编码。
- **slide_match_only_background_for_data_file** — 在背景图（带缺口）中找到缺口位置，即滑块的最佳匹配位置，返回缺口坐标。 需要输入图片文件的文件路径。
- **slide_compare** — 找到目标图与背景图的差异区域，定位阴影滑块位置。返回差异区域起始坐标。 需要输入图片文件链接。
- **slide_compare_for_data_base64** — 找到目标图与背景图的差异区域，定位阴影滑块位置。返回差异区域起始坐标。 需要输入图片文件的BASE64编码。
- **slide_compare_for_data_file** — 找到目标图与背景图的差异区域，定位阴影滑块位置。返回差异区域起始坐标。 需要输入图片文件的文件路径。
- **rotate_double** — 计算目标图像（内圈）相对于背景图像（外圈）的旋转角度，返回旋转角度。 需要输入图片文件链接。
- **rotate_double_for_data_base64** — 计算目标图像（内圈）相对于背景图像（外圈）的旋转角度，返回旋转角度。 需要输入图片文件的BASE64编码。
- **rotate_double_for_data_file** — 计算目标图像（内圈）相对于背景图像（外圈）的旋转角度，返回旋转角度。 需要输入图片文件的文件路径。
- **rotate_single** — 识别图像的旋转角度，支持 0-359 度范围，返回旋转角度 (0-359) 需要输入图片文件链接。
- **rotate_single_for_data_base64** — 识别图像的旋转角度，支持 0-359 度范围，返回旋转角度 (0-359) 需要输入图片文件的BASE64编码。
- **rotate_single_for_data_file** — 识别图像的旋转角度，支持 0-359 度范围，返回旋转角度 (0-359) 需要输入图片文件的文件路径。
- **detect_icon** — 根据顺序提示图中的图标顺序，在目标图中检测对应图标并按顺序返回坐标。 需要输入图片文件链接。
- **detect_icon_for_data_base64** — 根据顺序提示图中的图标顺序，在目标图中检测对应图标并按顺序返回坐标。 需要输入图片文件的BASE64编码。
- **detect_icon_for_data_file** — 根据顺序提示图中的图标顺序，在目标图中检测对应图标并按顺序返回坐标。 需要输入图片文件的文件路径。
- **detect_text** — 根据顺序提示图中的文字顺序，在目标图中检测对应文字并按顺序返回坐标。 需要输入图片文件链接。
- **detect_text_for_data_base64** — 根据顺序提示图中的文字顺序，在目标图中检测对应文字并按顺序返回坐标。 需要输入图片文件的BASE64编码。
- **detect_text_for_data_file** — 根据顺序提示图中的文字顺序，在目标图中检测对应文字并按顺序返回坐标。 需要输入图片文件的文件路径。
- **compare_image** — 计算两张图片的相似度，输入两张图片，返回相似度分数 (0-1，越接近1越相似)。 需要输入图片文件链接。
- **compare_image_for_data_base64** — 计算两张图片的相似度，输入两张图片，返回相似度分数 (0-1，越接近1越相似)。 需要输入图片文件的BASE64编码。
- **compare_image_for_data_file** — 计算两张图片的相似度，输入两张图片，返回相似度分数 (0-1，越接近1越相似)。 需要输入图片文件的文件路径。
- **solve_math** — 识别图像中的数学表达式，支持加减乘除运算，自动计算结果。返回算术表达式和计算结果。 需要输入图片文件链接。
- **solve_math_for_data_base64** — 识别图像中的数学表达式，支持加减乘除运算，自动计算结果。返回算术表达式和计算结果。 需要输入图片文件的BASE64编码。
- **solve_math_for_data_file** — 识别图像中的数学表达式，支持加减乘除运算，自动计算结果。返回算术表达式和计算结果。 需要输入图片文件的文件路径。

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-captcha
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-captcha
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。