﻿====================================
  AutoDrive Lite 使用说明 (OCR 版)
====================================

★ 重要免责声明 ★
  - 任何自动化工具都存在风险, 使用即视为你愿意承担一切后果
  - 仅在单机/离线模式下使用, 联机后果自负
  - 不修改游戏内存/文件, 不注入进程, 不绕过反作弊
  - 输入路径走标准 Windows API, 与真键盘/真手柄等价
  - ViGEmBus 是微软 WHQL 签名认证驱动, 不是外挂组件

【它是干啥的】
  专门用来反复重开同一个赛事 (单机/独立挑战)
  - 虚拟 Xbox 手柄持续推满油门 (RT=255)
  - OCR 识别屏幕状态, 自动按对的键, 不会误退出赛事

【完整自动化流程】
  比赛结束 -> 屏幕显示 [开始竞赛赛事]   -> 脚本按 Enter
       菜单弹出: 继续 / 重新开始 / 回放  -> 脚本按 X
       确认弹窗: 嗯 / 不                  -> 脚本按 Enter (选嗯)
       比赛重新开始, 油门一直推满, 循环

【首次使用】
  1. 双击 启动.bat (UAC 确认)
  2. 自动安装 ViGEmBus 驱动 (已内置, 无需联网)
  3. 首次启动会自动弹出 OCR 框选工具:
       - 切到 Forza 窗口 (建议无边框/窗口模式)
       - 走到比赛结束界面截图参考
       - Alt+Tab 回到框选窗口
       - 鼠标拖拽框出 [重新开始] 按钮那块区域
         建议范围: 整个弹窗中央带按钮文字的部分
       - 松开鼠标 = 确定, ESC = 取消
       - 工具会自动跑 OCR 测试, 显示是否识别到关键词
  4. 框选完成后回到主程序, 切游戏窗口按 F8 启用

【日常使用】
  双击 启动.bat -> 切游戏 -> F8 启用 -> F9 退出
  重新框选: 双击 框选识别区.bat

【热键】
  F8  =  启用 / 暂停切换
  F9  =  退出脚本

【常见问题】
  Q: 其他电脑没有 OCR / ORC 组件怎么办?
  A: 本工具使用 Windows 自带 OCR, 支持 Windows 10 / Windows 11 正常完整版系统。
     如果缺少简体中文 OCR 组件, 程序会在管理员权限下自动尝试安装:
       Language.OCR~~~zh-CN~0.0.1.0
     如果自动安装失败, 请手动安装:
       方式 1: 以管理员打开 PowerShell, 执行:
         Add-WindowsCapability -Online -Name Language.OCR~~~zh-CN~0.0.1.0
       方式 2: Windows 设置 -> 时间和语言 -> 语言和区域
              添加 "中文(简体, 中国)", 并安装语言/OCR 相关组件
     安装完成后建议重启电脑, 再运行本工具。

  Q: OCR 识别不到关键词怎么办?
  A: 重新框选, 把区域往里收一点, 避免背景干扰
     或检查游戏语言是否为简体中文

  Q: 重新开始按钮位置变了/分辨率变了?
  A: 双击 框选识别区.bat 重新标定

  Q: 4K / 2K / 1080P 分辨率能用吗?
  A: 能用。框选工具已经做了 DPI 感知, 保存的是物理像素坐标;
     OCR 还会自动放大较小区域, 1080P 下按钮较小也能识别。
     注意: 换电脑、换分辨率、改缩放比例、移动游戏窗口、切换显示器后,
     都建议重新双击 框选识别区.bat 标定一次。
     建议游戏使用无边框窗口模式。多显示器也支持, 但请在游戏所在屏幕上框选。

  Q: 全屏独占模式下框选工具看不到?
  A: 把游戏改成无边框窗口模式 (Forza 设置 -> 视频 -> 显示)

  Q: 杀毒报警?
  A: 脚本会模拟按键, 部分杀软误报, 加白即可

  Q: 想改 OCR 关键词?
  A: 暂未做配置文件, 改 auto_drive.ps1 里的 -match 那几行

【目录结构】
  启动.bat                          ← 主入口
  框选识别区.bat                    ← 重新标定 OCR 区域
  run.ps1                           调度脚本
  auto_drive.ps1                    主程序 (OCR 状态机)
  frame_select.ps1                  框选工具
  ocr_helper.ps1                    OCR 辅助函数
  Nefarius.ViGEm.Client.dll         虚拟手柄客户端
  ViGEmBus_1.22.0_x64_x86_arm64.exe ViGEmBus 驱动安装器
  config\ocr_region.txt             OCR 识别区坐标 (框选后生成)
  config\ocr_region_preview.png     框选区域预览图
  说明.txt                          本文件

====================================
  请理性使用, 单机娱乐, 自负盈亏
====================================
