Files
cwu7/README.zh-CN.md
T
2025-05-25 20:17:17 +08:00

3.2 KiB

CWU7 - 7 点起床困难户

一个用于在早上 7:00 准时预约羽毛球场地的 Python 自动化脚本。该机器人可以自动导航预约界面,处理验证码挑战,并记录整个过程。

功能特性

  • 精确计时: 等到早上 7:00 准时开始预约流程
  • 自动导航: 自动点击预约界面的各个步骤
  • 验证码识别: 使用 OCR 技术识别并解决验证码挑战
  • 重试机制: 失败时自动重试,可配置重试次数
  • 完整日志: 将所有操作和错误记录到文件和控制台
  • 鼠标跟踪工具: 包含用于查找 UI 坐标的辅助工具

系统要求

  • Python 3.6+

  • Windows 操作系统

  • 所需 Python 包:

    pyautogui
    ddddocr
    numpy
    Pillow
    

安装说明

  1. 克隆此仓库:

    git clone https://github.com/xixu-me/CWU7.git
    cd CWU7
    
  2. 安装所需依赖:

    pip install pyautogui ddddocr numpy Pillow
    

使用方法

运行预约机器人

  1. 如需要,在 run.py 中配置预约时间和坐标

  2. 运行主脚本:

    python run.py
    

机器人将等到早上 7:00,然后自动尝试预约羽毛球场地。

鼠标位置跟踪器

使用跟踪工具来查找 UI 元素的坐标:

python tracker.py

这将实时显示当前鼠标位置和像素颜色。按 Ctrl+C 退出。

配置说明

时间设置

修改 run.py 中的这些常量来更改预约时间:

RESERVATION_HOUR = 7    # 目标小时(24小时制)
RESERVATION_MINUTE = 0  # 目标分钟

坐标配置

run.py 中的 COORDINATES 字典包含所有点击位置。使用 tracker.py 为您的屏幕分辨率和界面找到正确的坐标。

重试设置

MAX_RETRY_ATTEMPTS = 100  # 最大重试次数

工作原理

  1. 等待目标时间: 脚本等到配置的预约时间
  2. 打开小程序: 点击预约界面
  3. 导航界面: 自动点击完成预约步骤
  4. 处理验证码: 使用 OCR 解决验证码挑战
  5. 失败重试: 任何步骤失败时自动重试
  6. 记录结果: 记录所有操作和结果

文件结构

  • run.py - 主要的预约机器人脚本
  • tracker.py - 鼠标位置跟踪工具
  • LICENSE - GNU GPL v3 许可证
  • .gitignore - Git 忽略文件
  • reservation.log - 生成的日志文件(执行时创建)

故障排除

常见问题

  1. 坐标错误: 使用 tracker.py 找到正确的点击位置
  2. 验证码失败: OCR 可能需要针对不同的验证码样式进行调整
  3. 时序问题: 调整像素检查函数中的 check_interval
  4. 屏幕分辨率: 不同屏幕尺寸可能需要调整坐标

日志

查看 reservation.log 获取详细的执行日志和错误信息。

法律声明

本软件仅供教育目的提供。用户有责任遵守预约系统的服务条款。作者不对任何误用或违规行为负责。

许可证

本项目采用 GNU 通用公共许可证 v3.0 - 详见 LICENSE 文件。

贡献

  1. Fork 仓库
  2. 创建功能分支
  3. 提交更改
  4. 推送到分支
  5. 创建 Pull Request

免责声明

这是一个旨在帮助合法预约的自动化工具。请负责任地使用,并遵守预约系统的服务条款。