纪念币预约自动化工具使用指南

一、工具简介

纪念币预约自动化工具是一款基于Python开发的自动化脚本，专门用于帮助用户自动完成纪念币预约流程。该工具能够模拟人工操作，自动填写个人信息、识别验证码、选择兑换网点并完成预约，大幅提高预约成功率。

二、项目结构说明

该项目包含多个核心文件和目录：

• main.py：主程序文件，包含完整的预约流程控制逻辑
• general_settings.py：配置文件，存储个人信息和预约参数
• captcha_get.py：验证码获取工具，用于下载验证码样本
• driver/：浏览器驱动目录，包含Chrome和Edge浏览器驱动
• models/：模型文件目录，存放验证码识别所需的模型和字符集
• ocr_jasper/：OCR识别组件，提供验证码识别功能

三、环境配置要求

必备软件安装

在使用本工具前，需要安装以下依赖包：

pip install selenium
pip install pytesseract
pip install opencv-python
pip install pymysql
pip install pillow

浏览器驱动配置

根据您使用的浏览器类型，在general_settings.py中配置对应的驱动路径：

• Chrome浏览器：使用./driver/chromedriver.exe
• Edge浏览器：使用./driver/msedgedriver.exe

四、详细配置指南

个人信息配置

打开general_settings.py文件，按照以下说明配置：

# 数据库连接信息（如果使用数据库存储信息）
host = "数据库主机地址"
port = 3306  # 数据库端口
user = "数据库用户名"
password = "数据库密码"
database = "数据库名"
table = "数据表名"

# 预约地址设置
place_arr = ['省份', '城市', '区县', 4]  # 第4个参数为默认营业厅序号

# 兑换时间设置
coindate = '2023-1-18'  # 格式：年-月-日

# 短信验证码截图范围
y_0 = 1550  # 起始Y坐标
y_1 = 1620  # 结束Y坐标
x_0 = 125   # 起始X坐标
x_1 = 345   # 结束X坐标

# 并发进程数
threads = 5  # 同时运行的预约进程数量

验证码识别配置

工具使用ocr_jasper组件进行验证码识别，相关模型文件位于：

• 图形验证码识别：./models/model.onnx
• 字符集配置：./models/charsets.json

五、使用步骤

1. 获取项目代码

git clone https://gitcode.com/gh_mirrors/au/auto_commemorative_coin_booking.git
cd auto_commemorative_coin_booking

2. 安装依赖包

pip install -r requirements.txt

3. 配置个人信息

编辑general_settings.py文件，填写正确的预约信息。

4. 启动预约工具

python main.py

六、功能详解

自动化预约流程

工具执行以下自动化步骤：

1. 打开预约页面：自动访问中国农业银行纪念币预约网址
2. 同意协议：自动点击同意按钮继续流程
3. 填写个人信息：从数据库或配置文件中读取并填写姓名、身份证号、手机号
4. 选择兑换网点：根据配置选择省、市、区县和具体营业厅
5. 验证码识别：自动识别图形验证码和短信验证码
6. 提交预约：完成所有信息填写后自动提交

多进程支持

工具支持多进程同时运行，通过配置threads参数可以设置同时运行的预约进程数量，提高预约成功率。

七、常见问题处理

验证码识别失败

如果验证码识别准确率不高，可以尝试：

1. 更新models目录下的识别模型
2. 调整验证码截图范围参数
3. 使用captcha_get.py获取更多验证码样本进行模型训练

浏览器驱动问题

确保浏览器驱动版本与安装的浏览器版本匹配，驱动文件需要放在driver目录下。

网络连接问题

预约过程中需要稳定的网络连接，建议使用有线网络以减少延迟。

八、注意事项

1. 个人信息安全：配置文件中的敏感信息不要泄露给他人
2. 合法使用：请确保使用本工具符合相关网站的使用条款
3. 及时更新：定期检查项目更新，以适配预约系统的变化
4. 测试验证：在正式预约前进行测试，确保工具正常工作

九、技术支持

如果在使用过程中遇到问题，可以：

1. 检查错误日志信息
2. 验证配置参数是否正确
3. 确保所有依赖包已正确安装
4. 确认网络连接正常

通过合理配置和使用本工具，您可以大大提高纪念币预约的成功率，节省大量时间和精力。