请注意本文档由LLM AI生成
在 Pokémon TCG Live（Unity）的 SHOP → REDEEM 界面，按相对坐标批量粘贴兑换码并领取。自动化可能违反游戏服务条款，请自行承担风险，仅建议自用。
- Windows
- Python 3.11+（建议）
- 游戏客户端为 英文 UI，宽高比固定 16:9，建议客户区 1280×720
pip install -r requirements.txt
python app.py或双击 run.bat。
powershell -ExecutionPolicy Bypass -File .\build.ps1产物在 dist/PTCG-Live-Auto-Redeem/（含完整 OCR tiny 模型）；同目录另有 PTCG-Live-Auto-Redeem.zip 便于拷贝。
- 打开游戏并停在
SHOP → REDEEM（工具不会自动导航） - 将 code 粘贴到主窗口（每行一个）
- 点「开始兑换」；紧急停止可将鼠标移到屏幕 左上角（PyAutoGUI failsafe），或点「停止」
标定偏移时打开菜单中的调试窗，调整点击点 / OCR ROI 并保存为 layout_override.json。
| 状态 | 含义 |
|---|---|
| SUCCESS | 领取后确认已回到 REDEEM |
| PENDING | 已提交入队，等待批量领取 |
| DUPLICATE / FAILED | OCR 识别为重复或无效 |
| ERROR | 提交确认超时等异常 |
| STOPPED | 未提交即停止 |
| UNCOLLECTED | 已入队但未确认领完（停止或领取确认失败）；码留在输入框，并写入 failed_codes.txt |
- 主路径：
game_flow.py+main_window.py deprecated/为历史网页/旧脚本资产，勿用- 设计文档：
docs/superpowers/specs/