玩家对战（PVP）协议

243 字小于 1 分钟

任务入口

项	值
任务名	见 `tasks/pvp.json`
entry	以该文件中定义为准（通常自检主页后进对战）
流程	`resource/base/pipeline/pvp.json`

选项

战斗次数由任务选项控制（如 1–5 次），通过 Custom（如 InitPVPBattleCount / CheckPVPBattleCount）维护计数。

典型流程

CheckHomePage → Entry → CheckBattleInterface
  → InitBattleCount
  → SelectPlayer
       → CheckChallengeLimit（今日次数用尽则回主页）
       → StartBattle
       → BeginCombat（可重试直至进入战斗）
       → CheckInBattle → Speed2x
       → BattleLoop → CheckBattleEnd（OCR「跳过」）
       → WaitSettlement → ReadResult（Custom 读分/排名）
       → ExitResult → BackToBattleInterface
       → CheckBattleCount
            → 未满：SelectPlayer
            → 已满：ReturnMain

关键约定

BeginCombat：一次点击可能无响应；next / on_error 应允许重试，直到 CheckInBattle 成功
BattleLoop：长超时等待结算；失败可兜底 ReadResult
ReadResult：ReadPVPResult 自定义识别，ROI 在 pipeline 的 custom_recognition_param 中
挑战上限：challenge_limit 模板命中则 toast/日志提示并退出

图片目录

resource/base/image/pvp/（入口、对战界面、开始、作战中、倍速、退出结果等）。

说明

自动化只负责操作流程，不保证胜负。