桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载本文围绕 ZenlessZoneZero-OneDragon绝区零一条龙测试基建中的FixtureController展开讲解如何用固定截图驱动 opOperation的完整execute()流程多帧截图、轮询等待、节点间流转与恢复性点击。读完你将掌握流程测试的剧本phase设计、五大关键坑运行态前置、看门狗、恢复性 click、OpenGame 排除、剪贴板规避以及 EnterGame 自动登录全流程测试的具体写法。一、FixtureController 是什么一个会反应的假游戏在 ZenlessZoneZero-OneDragon 的测试方法论中见 docs/develop/testing/README.md单节点测试只覆盖单帧、单节点而 op 的流程逻辑节点图边、轮询、重试、恢复分支必须靠流程测试补齐。承担这一职责的就是FixtureController它是MockController的子类位于独立测试仓zzz-od-test的test/harness/fixture_controller.py主仓.gitignore忽略测试仓clone 到主仓根目录使用screenshot()返回当前 phase 的固定截图——不同 phase 对应不同画面帧click/input/press_key会记录动作并按剧本推进到下一 phase——即点击后画面发生变化模拟真实游戏中点击按钮后界面流转它配真 ctx真 OCR 真 screen_info因此 op 的识别、流转、决策逻辑是在固定帧上真实运行的不是被 mock 掉的。也就是说FixtureController 提供了一层最小可反应环境识别是真的画面是假的但会随动作切换。这样即可在无窗口、无游戏进程的前提下验证 op 在多帧下的完整执行路径。二、何时用验流程逻辑不验单节点按测试方法论README §3 动作二只有 op 存在返回round_wait或使用until_find_all/until_not_find_all的节点时才需要流程测试——这类节点期待点一下 → 等画面变 → 再识别的运行时推进单帧单测覆盖不到。典型场景就是EnterGame 自动登录流程ready打开游戏画面→ 点击进入游戏 →登录游戏服务器中→ 加载中 → 大世界。这一路每个节点都在轮询画面状态节点间通过 status 边流转可对照 enter_game.py 中node_from与operation_node的编排非常适合用 FixtureController 按 phase 逐步喂帧、逐步断言。三、剧本phase一帧 一个退出条件FixtureController 的核心概念是有序 phase 列表。每个 phase 由一帧截图 退出条件组成测试按顺序推进。文档定义了三种推进方式3.1on_click_in(region)只认区域内的流程 click只有 click 落在指定 region查 screen_info 的 areapc_rect或剧本直接给坐标 rect才推进到下一 phase。这是最常用也最安全的方式op 某些节点在 retry/recovery 时也会执行 click例如 EnterGame 的check_screen节点卡在登录时点击国服-返回按钮恢复见 enter_game.py#L109-L112。若用任何 click 都推进的方式这类恢复 click 会误推进 phase导致剧本错位。对有恢复性 click 的节点强制用on_click_in——只认期望的流程 area 的 click忽略恢复 click。3.2on_action任何 click/input 都推进只用于该 phase 唯一流程 click、无恢复 click的节点。因为任何动作都会推进若该 phase 存在恢复 click 就会被误推进所以使用前提是这帧上只有唯一一个流程性动作。3.3on_polls(n)截图 n 次后自动推进screenshot()被调用 n 次后自动推进用于模拟游戏自动流转如登录服务器中 → 大世界中间没有任何用户动作。文档明确警告这是最脆弱的推进方式见 §5 坑 2剧本对不齐会在 WAIT 段死循环优先少用。3.4 末 phase 粘住最后一个 phase 默认粘住多余的动作/识别请求一律返回末帧。这能抗轮询次数漂移——真实 op 中轮询次数可能因等待时间不同而漂移粘住末 phase 可保证测试在流程收尾后不会因多截了一次图而崩溃。四、关键坑必读流程测试的五大陷阱文档在关键坑一节列出五项全部有源码级依据坑 1运行态前置——不置 RUNNINGop 直接退出op.execute()的 while 循环首轮就检查is_context_stop见 operation.py#L430若_run_state STOP默认值就直接op_fail(人工结束)退出流程测试根本跑不起来。is_context_stop是只读属性无 setter见 application_run_context.py#L308-L316因此测试里不能直接赋值需要测试execute()前直接置ctx.run_context._run_state RUNNINGfinally复位置回STOP并调用ctx.run_context.event_bus.unlisten_all_event(op)清理 op 注册的事件——因为 session 级test_context会复用不复位会污染后续测试。项目为此提供 harness 封装enter_running_state(ctx, op)/reset_running_state(ctx, op)。坑 2看门狗必须——WAIT 无上限剧本对不齐会死循环op 框架的轮次上限只管 RETRY在 operation.py#L475-L482 中RETRY结果会累加node_retry_times超过node_max_retry_times才转 FAIL而WAIT直接continue回到下一轮没有任何轮次上限operation.py#L484-L485。后果如果剧本与 op 实际流转对不齐比如某个 phase 的帧始终不满足节点退出条件节点会一直在 WAIT 段循环测试永远跑不完。因此流程测试必须用WatchdogOperationMixin它覆盖_execute_one_round注意不是execute()execute 的主循环不能被覆盖达到轮次上限后置_run_state STOP让 execute 主循环下一轮检测到is_context_stop后正常退出对应 operation.py#L430 的检查。这也解释了为什么坑 1 与坑 2 要配合看门狗通过置 STOP 来终止而 execute 正是靠 STOP 检查退出。坑 3恢复性 click on_click_in门控如前所述op 节点在 retry/recovery 时也可能 click。以 EnterGame 为例check_screen节点在识别到国服-账号密码进入游戏-新区域时会**先点击国服-返回按钮**再round_retry(返回重试)enter_game.py#L108-L112——这是恢复路径不能推进 phase。对策该 phase 必须用on_click_in(期望的流程 area)只认流程 click若误用on_action任何 click 都推进恢复 click 会提前推进剧本导致后续帧全部错位。坑 4OpenGame 排除——只测画面驱动的 opOpenGame/OpenAndEnterGame这类 op 会写 Windows 注册表禁用/恢复自动 HDR并用subprocess.Popen拉起游戏 exe见 open_game.py#L24-L57。FixtureController 只能拦 controller 层的截图与输入拦不住注册表写入与子进程拉起。因此只测画面驱动的 op如 EnterGame 纯画面识别流转测试中令is_game_window_readyTrue绕过框架注入的 check-window 链——否则会被路由到打开并进入游戏而调起 OpenGame。坑 5剪贴板规避——别让测试污染真实 OS 剪贴板op 输入账号密码可能走PcClipboard.copy_and_pastepc_clipboard.py#L13-L23。该方法通过 win32clipboard 直接写真实 OS 剪贴板不经过 controllerFixtureController 无法 mock。对照源码EnterGame 的输入节点按type_input_way分流enter_game.py#L190-L202CLIPBOARD默认→PcClipboard.copy_and_paste(...)写真实剪贴板INPUT→self.ctx.controller.keyboard_controller.keyboard.type(...)走 keyboard 分支FixtureController 能 mock。测试对策把ctx.game_config.type_input_waypin 为INPUT枚举定义见 basic_game_config.py#L8-L10。fixture 中用monkeypatch同时改 controller 与type_input_way避免污染 session 级test_contextsession fixture 只 init 一次、跨测试复用见 README §2。五、参考实现与进一步阅读文档给出两个核心参考实现位于独立仓zzz-od-test文件内容zzz-od-test/test/harness/fixture_controller.pyFixtureControllerWatchdogOperationMixin 运行态 helperenter_running_state/reset_running_statezzz-od-test/test/zzz_od/operation/enter_game/test_enter_game_flow.pyEnterGame 自动登录流程测试 on_click_in门控单测配套阅读docs/develop/testing/README.md测试方法论总入口解释测试放哪、怎么跑uv run --env-file .env pytest zzz-od-test/、session 级test_contextfixture 如何注入MockController、以及动作一分支单测 动作二流程测试的完整性判据——流程测试是动作一的补充而非替代流程测试覆盖的节点仍需逐分支单测enter_game.pyEnterGame 节点图与恢复性 click 的源码依据operation.py#L420-L514execute()主循环RETRY/WAIT 处理与is_context_stop检查的实现位置application_run_context.py#L308-L336is_context_stop/is_context_running/is_context_pause只读属性basic_game_config.py#L8-L46TypeInputWay枚举与type_input_way配置项。六、小结FixtureController 为 ZenlessZoneZero-OneDragon 的 op 流程测试提供了一套固定帧 动作反应 运行态约束的仿真环境其核心心智模型可以概括为三句话剧本即状态机每个 phase 是一帧 一个退出条件on_click_in门控流程 click、on_action只用于无恢复 click 的 phase、on_polls模拟游戏自动流转但最脆弱运行态是开关is_context_stop只读且默认 STOP测试前必须enter_running_state、结束必须复位清理否则 session 复用的test_context会被污染看门狗是保底框架只给 RETRY 上限、WAIT 无上限WatchdogOperationMixin通过覆盖_execute_one_round并在轮次超限时置 STOP 终止死循环。掌握这三点再配合OpenGame 排除 剪贴板规避两个环境隔离措施即可为任意返回round_wait/ 使用until_*的节点写出可靠、不污染外部环境的流程测试。赞分享桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载相关推荐ZenlessZoneZero-OneDragon 自动化测试实战指南单节点单元测试与 FixtureController 流程测试方法论ZenlessZoneZero OneDragon 自动化测试实战指南单节点单元测试与 FixtureController 流程测试方法论 本文以 docs/桌面应用RPA计算机视觉ZenlessZoneZero-OneDragon 端到端开发流程实战从画面建档、双仓测试到跨仓 PR 协同ZenlessZoneZero OneDragon 端到端开发流程实战从画面建档、双仓测试到跨仓 PR 协同 导读 本文档面向在 ZenlessZoneZer桌面应用RPA计算机视觉绝区零一条龙ZenlessZoneZero-OneDragon开发指南环境搭建、编码规范、测试流程与打包发布全解析绝区零一条龙ZenlessZoneZero OneDragon开发指南环境搭建、编码规范、测试流程与打包发布全解析 导读 本文围绕 docs/develo桌面应用RPA计算机视觉创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
