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

一、项目简介

纪念币预约自动化工具是一个基于Python开发的自动化预约系统，旨在帮助用户轻松完成纪念币的在线预约。该工具集成了Selenium网页自动化、OCR验证码识别等先进技术，能够自动填写个人信息、识别验证码、选择兑换网点，大大提高了预约成功率。

二、环境准备

Python环境要求

建议使用Python 3.6及以上版本，确保系统已安装必要的依赖库。

安装依赖包

打开命令行窗口，执行以下命令安装所需依赖：

pip install selenium
pip install pytesseract
pip install adb

获取项目代码

在命令行中执行以下命令克隆项目：

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

三、配置文件设置

项目中的general_settings.py文件是核心配置文件，需要根据个人实际情况进行修改：

# 个人信息配置
name = "您的姓名"
id_card = "您的身份证号码"
phone_number = "您的手机号码"

# 浏览器驱动选择（根据实际使用的浏览器选择）
driver_path = "driver/chromedriver.exe"  # Chrome浏览器
# driver_path = "driver/msedgedriver.exe"  # Edge浏览器

# 预约偏好设置
preferred_branch = "最近的兑换网点名称"
preferred_time = "上午9:00-11:00"

四、项目结构说明

auto_commemorative_coin_booking/
├── driver/                 # 浏览器驱动目录
│   ├── chromedriver.exe    # Chrome浏览器驱动
│   └── msedgedriver.exe    # Edge浏览器驱动
├── models/                 # 模型文件目录
│   ├── charsets.json       # 字符集配置文件
│   └── model.onnx          # 主要识别模型
├── ocr_jasper/             # OCR识别组件
│   ├── ocr_jasper/
│   │   ├── common.onnx     # 通用识别模型
│   │   ├── common_det.onnx # 检测模型
│   │   └── requirements.txt # 依赖要求
│   └── setup.py           # 安装脚本
├── main.py                # 主程序入口
├── captcha_get.py         # 验证码获取模块
├── general_settings.py    # 配置文件
└── README.md              # 项目说明文档

五、使用步骤

1. 完成环境配置：按照前述步骤安装Python环境和依赖库
2. 修改配置文件：编辑general_settings.py文件，填写真实的个人信息
3. 选择浏览器驱动：根据使用的浏览器类型，在配置文件中指定正确的驱动路径
4. 启动预约程序：在项目根目录下执行命令：

   python main.py
   

六、功能特点

自动化操作

• 自动打开浏览器并访问预约页面
• 智能填写姓名、身份证号、手机号等个人信息
• 自动识别图形验证码并填写
• 支持短信验证码的自动获取和填写
• 根据配置自动选择兑换网点和时间段

验证码识别优化

项目内置了经过优化的OCR识别模型：

• models/model.onnx：高性能验证码识别模型
• models/charsets.json：字符集配置文件，提高识别准确率
• ocr_jasper组件：专门针对验证码识别优化的OCR引擎

多浏览器支持

提供Chrome和Edge两种浏览器的驱动支持，用户可根据实际情况选择：

• driver/chromedriver.exe：Chrome浏览器驱动
• driver/msedgedriver.exe：Edge浏览器驱动

七、注意事项

1. 个人信息安全：配置文件中的个人信息仅存储在本地，不会上传到任何服务器
2. 浏览器版本匹配：确保使用的浏览器驱动与安装的浏览器版本相匹配
3. 网络环境稳定：预约过程中需要稳定的网络连接，建议使用有线网络
4. 提前测试：在正式预约前建议进行测试运行，确保各项功能正常

八、常见问题处理

浏览器驱动问题

如果出现浏览器无法启动的情况，请检查：

• 浏览器驱动文件是否完整
• 驱动版本是否与浏览器版本匹配
• 驱动文件路径配置是否正确

验证码识别失败

验证码识别可能受以下因素影响：

• 图片质量不佳
• 网络加载不完整
• 识别模型需要更新

建议在光线充足的环境下运行，并定期更新models目录中的识别模型。

预约过程卡顿

如遇预约过程卡顿，可尝试：

• 关闭其他占用网络带宽的程序
• 检查网络连接状态
• 重启工具重新尝试

九、更新维护

项目会定期更新以适配各大银行的预约系统变化，建议用户关注项目更新，及时获取最新版本：

cd auto_commemorative_coin_booking
git pull

更新后请重新检查配置文件，确保个人信息和设置正确无误。

通过本工具，即使没有编程经验的用户也能轻松完成纪念币预约，大大提高了预约效率和成功率。希望本文能帮助您顺利使用这款自动化预约工具。