slider-captcha-match

Slider Captcha Match

项目简介

Slider Captcha Match 是一个基于 Python 和 OpenCV 的滑块验证码匹配工具，旨在通过对比滑块和背景图像来计算滑块的正确偏移量。该项目主要用于验证图像处理和匹配算法。

目录结构

.
├── README.md
├── data
│   ├── bg3.jpeg
│   ├── output
│   └── slider3.png
├── pyproject.toml
├── requirements.txt
├── src
│   ├── __init__.py
│   └── slider_captcha_match.py
└── tests
    ├── __pycache__
    └── test_slider_match.py

安装

• 克隆仓库到本地：

git clone https://github.com/ityangs/slider-captcha-match.git
cd slider-captcha-match

• 创建虚拟环境并安装依赖：

python -m venv venv
source venv/bin/activate  # 在 Windows 上使用 `venv\Scripts\activate`
pip install -r requirements.txt

• 使用 Anaconda 或 Mamba 安装依赖：

or
mamba create -n slider-captcha-match python=3.10
mamva activate slider-captcha-match
pip install -r requirements.txt

使用说明

核心类 SlideCaptchaMatch

SlideCaptchaMatch 类包含了进行滑块匹配的核心方法。

from src.slider_captcha_match import SliderCaptchaMatch

processor = SliderCaptchaMatch(save_images=True, output_path="output")

# 通过图像路径获取滑块偏移量
offset = processor.get_slider_offset("data/bg3.jpeg", "data/slider3.png")
print(f"Offset (paths): {offset}")

# 通过 base64 编码获取滑块偏移量
background_base64 = "..."  # base64 编码的背景图像
slider_base64 = "..."  # base64 编码的滑块图像
offset = processor.get_slider_offset(background_base64, slider_base64)
print(f"Offset (base64): {offset}")

测试

项目包含基本的测试代码，测试代码位于 tests/test_slide_match.py 中，包含了两种测试方法： 通过路径获取滑块偏移量。 通过 base64 编码获取滑块偏移量。 可以直接运行测试文件来查看效果：

python tests/test_slider_match.py

贡献

如果你有兴趣为本项目做贡献，请遵循以下步骤：

1. Fork 本仓库
2. 创建你的 feature 分支 (`git checkout -b feature/fooBar`)
3. 提交你的修改 (`git commit -am 'Add some fooBar'`)
4. 推送到分支 (`git push origin feature/fooBar`)
5. 创建一个新的 Pull Request

许可证

此项目基于 MIT 许可证，详情请参阅 LICENSE 文件。

联系

如果你有任何问题或建议，请通过电子邮件联系我们：[e-mail]