{"id":50711249,"url":"https://github.com/andywang425/gtaol-dre-helper","last_synced_at":"2026-06-09T15:30:52.455Z","repository":{"id":344403332,"uuid":"1181610988","full_name":"andywang425/gtaol-dre-helper","owner":"andywang425","description":"GTAOL别惹德瑞助手","archived":false,"fork":false,"pushed_at":"2026-04-12T15:02:38.000Z","size":6181,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-12T16:29:07.552Z","etag":null,"topics":["gta","gta5-enhanced","gtaol"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andywang425.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-14T11:33:35.000Z","updated_at":"2026-04-12T15:14:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/andywang425/gtaol-dre-helper","commit_stats":null,"previous_names":["andywang425/gtaol-ceo-helper","andywang425/gtaol-dre-helper"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/andywang425/gtaol-dre-helper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywang425%2Fgtaol-dre-helper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywang425%2Fgtaol-dre-helper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywang425%2Fgtaol-dre-helper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywang425%2Fgtaol-dre-helper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andywang425","download_url":"https://codeload.github.com/andywang425/gtaol-dre-helper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andywang425%2Fgtaol-dre-helper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34114426,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gta","gta5-enhanced","gtaol"],"created_at":"2026-06-09T15:30:49.653Z","updated_at":"2026-06-09T15:30:52.444Z","avatar_url":"https://github.com/andywang425.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GTAOL Dre Helper\n\n这是一个帮助 GTA Online 玩家利用德瑞 bot 直接开“别惹德瑞”任务终章时自动执行“卡CEO“和“卡单”操作的小工具。\n\n![TUI 截图](assets/TUI截图.png)\n\n## 环境要求\n\n- 操作系统：Windows 11 (x64)\n- 终端：Windows Terminal\n- GTA5 增强版（传承版未测试，如果游戏 UI 类似也许也能用）\n\n## 功能\n\n### 卡 CEO\n\n开始匹配差事后，通过 OCR 识别屏幕右下角的文字，当检测到已加入人数 \u003e=2 时，自动执行预设的按键操作注册为 CEO。\n\n### 卡单\n\n加入 bot 的房间进入任务准备页面后，通过检查指定区域颜色的方式判断菜单是否消失，检测到菜单消失时，自动执行预设的按键操作触发小红帽（[QuellGTA](https://www.mageangela.cn/QuellGTA/)）的自动卡单功能。\n\n## 安装\n\n1. 前往 [Release 页面](https://github.com/andywang425/gtaol-dre-helper/releases/latest)。\n2. 优先下载 `gtaol-dre-helper.7z`；若遇到兼容性问题，可尝试 `gtaol-dre-helper-pyinstaller.7z`（如果有的话）。\n3. 解压下载好的压缩包到任意目录。\n4. 双击运行 `gtaol-dre-helper.exe`。\n5. 按 `ctrl+e` 编辑配置文件；改完保存后，回到程序按 `ctrl+r` 重载配置。如需定位 OCR/颜色识别区域，请参考后文的[定位识别区域](#定位识别区域)部分。\n\n\u003e 初次运行时程序会根据你的屏幕分辨率生成推荐的识别区域配置（仅支持部分常见分辨率）。\n\n## 更新\n\n目前程序不支持自动更新，需要手动下载最新版本。\n\n可以沿用旧的 `config.yaml` 配置文件。如果配置格式发生变化，程序会报错并提示你修改。\n\n## 配置项说明\n\n`config.yaml` 完整结构如下：\n\n```yaml\n# 识别区域\n# 单位：屏幕像素\n# left, top: 矩形左上角坐标\n# width, height: 矩形宽高\nregion:\n  # 卡 CEO: OCR 识别区域\n  # 程序会截图这个矩形区域识别“已加入人数/人数上限”\n  #\n  # 全屏游戏时各屏幕分辨率推荐设置：\n  # 4k (3840x2160): left=3609, top=1974, width=172, height=55\n  # 2k (2560x1440): left=2409, top=1314, width=105, height=37\n  # 1080p (1920x1080): left=1807, top=986, width=78, height=27\n  ceo:\n    left: 3609\n    top: 1974\n    width: 172\n    height: 55\n\n  # 卡单: 颜色识别区域\n  # 程序会获取这区域内像素的颜色值，判断菜单是否消失\n  #\n  # 全屏游戏时各屏幕分辨率推荐设置：\n  # 4k (3840x2160): left=633, top=408, width=367, height=55\n  # 2k (2560x1440): left=424, top=275, width=241, height=29\n  # 1080p (1920x1080): left=319, top=206, width=180, height=22\n  single:\n    left: 633\n    top: 408\n    width: 367\n    height: 55\n\n# 监控方案\n# 每个方案包含一个名称 (name)、一个类型 (type)、一个开关键 (toggle_key) 和一个按键序列 (sequence)\n# 开关键 (toggle_key)：以当前方案开始监控/停止监控/切换到当前方案，也支持用 '+' 连接组合键，如 'ctrl+f11'\n# 类型 (type)：ceo（卡CEO） 或 single（卡单）\n# 按键序列 (sequence)：包含多个按键操作\n# 每个按键操作包含一个动作按键 (key)、一个按住时间 (hold)、一个组合键间隔时间 (interval)、一个延迟时间 (delay) 和一个执行次数 (times)\n# 动作按键 (key)：支持 'm', 'enter', 'up', 'down' 等，也支持用 '+' 连接组合键，如 'ctrl+c'\n# 按住时间 (hold)：按键保持按下的时间（单位秒，默认值为 0.05）\n# 组合键间隔时间 (interval)：组合键中每个按键之间的间隔时间（单位秒，默认值为 0.05），等所有键被按下后才开始计算按住时间\n# 延迟时间 (delay)：每次按键之后等待的时间（单位秒，默认值为 0.1）\n# 执行次数 (times)：按键操作执行的次数（默认值为 1）\nprofiles:\n  - name: 室外\n    type: ceo\n    toggle_key: f11\n    sequence:\n      - key: m # 打开菜单\n        delay: 0.18\n      - key: down # 向下移动一次\n        delay: 0.06\n      - key: enter # 连续确认三次\n        delay: 0.06\n        times: 3\n\n  - name: 室内\n    type: ceo\n    toggle_key: f12\n    sequence:\n      - key: m # 打开菜单\n        delay: 0.18\n      - key: down # 向下移动两次\n        delay: 0.06\n        times: 2\n      - key: enter # 连续确认三次\n        delay: 0.06\n        times: 3\n\n  - name: 卡单\n    type: single\n    toggle_key: alt+numpad1\n    sequence:\n      # 小红帽的卡单快捷键（流程详解：先按住 alt 0.5 秒，然后 alt+1 一起按住 0.5 秒，最后立刻全部松开）\n      # 小红帽热键引擎模式说明：本软件不支持代理模式，仅支持直连模式和轮询模式\n      # 如果开了轮询模式，请将 hold 和 interval 调大一点 （建议至少 0.5 秒），否则可能无法触发快捷键\n      - key: alt+1\n        hold: 0.5\n        interval: 0.5\n```\n\n`toggle_key` 和 `sequence.key` 支持的按键：\n\n- 支持单键，也支持使用 `+` 连接组合键，例如 `f11`、`alt+numpad1`\n- 不区分大小写，程序会自动规范化为小写，例如 `Ctrl+F12` 会被当成 `ctrl+f12`\n- 同一个组合键里不能出现重复按键，例如 `ctrl+ctrl+f11` 不合法\n- 支持以下标准名称：\n\n| 分类       | 支持的按键                                                                                       |\n| ---------- | ------------------------------------------------------------------------------------------------ |\n| 字母       | `a` \\~ `z`                                                                                       |\n| 数字       | `0` \\~ `9`                                                                                       |\n| 功能键     | `f1` \\~ `f24`                                                                                    |\n| 修饰键     | `shift`、`ctrl`、`alt`                                                                           |\n| 常用控制键 | `backspace`、`tab`、`enter`、`pause`、`capslock`、`esc`、`space`                                 |\n| 导航键     | `pageup`、`pagedown`、`home`、`end`、`left`、`up`、`right`、`down`、`insert`、`delete`           |\n| 小键盘     | `numpad0` \\~ `numpad9`、`numpad_mul`、`numpad_add`、`numpad_sub`、`numpad_decimal`、`numpad_div` |\n\n- 也支持以下别名，程序会自动转换为右侧标准名称：\n\n| 别名           | 标准名称               |\n| -------------- | ---------------------- |\n| `control`      | `ctrl`                 |\n| `return`       | `enter`                |\n| `escape`       | `esc`                  |\n| `del`          | `delete`               |\n| `ins`          | `insert`               |\n| `pgup`         | `pageup`               |\n| `pgdn`         | `pagedown`             |\n| `kp0` \\~ `kp9` | `numpad0` \\~ `numpad9` |\n| `num_mul`      | `numpad_mul`           |\n| `num_add`      | `numpad_add`           |\n| `num_sub`      | `numpad_sub`           |\n| `num_decimal`  | `numpad_decimal`       |\n| `num_div`      | `numpad_div`           |\n\n\u003e 注：`pause` 是特例，`toggle_key` 支持但 `sequence.key` 不支持\n\n## 使用方法\n\n1. 双击运行 `gtaol-dre-helper.exe`。\n2. 游戏中打开手机，选择快速加入，开始匹配差事。\n3. 按某个卡 CEO 方案对应的开关键（默认室外 `f11` , 室内 `f12`）以该方案开启监控。\n4. 当匹配到差事并且已加入人数 \u003e=2 时，程序会执行当前方案的动作序列。执行完成后监控自动停止。\n   \u003e 如果长时间匹配不到差事弹出了”注意“警告，或者匹配到差事之后秒进了，请手动退出来打开手机重新匹配。\n5. 进入任务准备页面后，按下某个卡单方案对应的开关键（默认 `alt+小键盘数字1`）以该方案开启监控。\n6. 当菜单消失时，程序会执行当前方案的动作序列，触发小红帽的自动卡单功能。执行完成后监控自动停止。\n7. 最后正常完成任务即可。\n\n## 定位识别区域\n\n如果需要定位 OCR/颜色 识别区域，可使用 `RegionLocator.exe` 辅助工具。在程序中按 `ctrl+p` 打开命令面板，选择 `Open RegionLocator` 命令即可运行该工具。\n\n### OCR 识别区域示例\n\n红色矩形是你需要手动定位的区域：\n\n![OCR 识别区域示例](assets/OCR识别区域示例.png)\n\n定位方法：首先进游戏匹配差事，像示例中那样匹配到差事后，全屏截图。运行 `RegionLocator.exe`，以全屏的方式打开这张截图，然后根据软件提示定位矩形识别区域区域。定位需要准确，不能太多（比如把左侧差事名称包含进去），也不能太少（注意”已加入人数”和“人数上限”这两个数都可能为两位数）。\n\n### 颜色识别区域示例\n\n红色矩形是你需要手动定位的区域：\n\n\u003e 其实也可以选取别的区域，只要你选的区域是纯色的且菜单消失时会一并消失即可\n\n![颜色识别区域示例](assets/颜色识别区域示例.png)\n\n定位方法：在任务准备页面全屏截图。运行 `RegionLocator.exe`，以全屏的方式打开这张截图，然后根据软件提示定位矩形识别区域区域。\n\n## 注意\n\n本程序会频繁获取屏幕截图，注册为 CEO 和卡单时会模拟键盘按键。这两个操作底层都是通过win32 API实现的。可能存在风险，介意勿用。\n\n\u003e 我个人认为风险不大，因为本程序没有任何直接读写游戏数据的操作（截图也是屏幕截图而不是获取游戏窗口画面）\n\n## 更新日志\n\n详见 [CHANGELOG.md](CHANGELOG.md)\n\n## 相关推荐\n\n### [QuellGTA](https://www.mageangela.cn/QuellGTA/)\n\n建议搭配 QuellGTA（小红帽）一起用，本程序的卡单功能依赖于小红帽的自动卡单功能。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandywang425%2Fgtaol-dre-helper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandywang425%2Fgtaol-dre-helper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandywang425%2Fgtaol-dre-helper/lists"}