Repository navigation
Conversation
Codecov Report❌ Patch coverage is
📢 Thoughts on this report? Let us know! |
| go_main_page(ctx, dismiss_overlays=dismiss_overlays) | ||
| _log.info('[Startup] 游戏就绪') | ||
| if dismiss_overlays: | ||
| handle_daily_overlays(ctx) |
There was a problem hiding this comment.
代码整体方向合理,但当前实现存在几个需要处理的问题/风险:
-
恢复流程可能被
_enter_from_start_screen的TimeoutError中断
recover_to_main_or_restart的while循环只捕获了NavigationError,但_enter_from_start_screen在点击启动页后如果等待游戏页超时,会直接抛TimeoutError。这会导致“恢复失败后强制重启”的兜底逻辑失效。建议把TimeoutError也纳入捕获,或统一转为恢复失败继续走重启分支。 -
恢复流程中没有限制
_enter_from_start_screen的等待预算
_enter_from_start_screen(ctrl)默认使用_STARTUP_TIMEOUT作为等待超时。如果_STARTUP_TIMEOUT大于_RECOVERY_TO_MAIN_TIMEOUT,在恢复路径中点击启动页后可能长时间阻塞,绕过recover_to_main_or_restart自身的deadline。建议改为传入剩余恢复预算,例如:remaining = deadline - time.monotonic() _enter_from_start_screen(ctrl, timeout=remaining)
-
go_main_page强制force=True会绕过每日浮层去重
之前handle_daily_overlays用daily_overlay_date做了当天去重,只有每天第一次需要真正检测和消除。现在go_main_page里只要dismiss_overlays=True就传force=True,会让每次回到主页面都执行完整浮层检测和wait_for_page。如果go_main_page被任务循环频繁调用,会产生不必要的截图和等待开销。建议仅在启动/恢复场景使用force=True,普通回主页仍按日去重。 -
ensure_game_ready和recover_to_main_or_restart可能重复执行go_main_page
recover_to_main_or_restart的成功路径(无论是启动页分支、识别页面分支,还是 while 循环恢复成功)内部都已经调用go_main_page;ensure_game_ready随后又调用一次go_main_page,会造成重复导航和重复浮层处理。建议让recover_to_main_or_restart只负责“恢复到主页面”,或让ensure_game_ready只在冷启动后负责go_main_page,避免重复。 -
go_main_page中wait_for_page(...)的返回值没有检查
需要确认wait_for_page在超时时的行为:- 如果它超时抛出异常,则当前逻辑能感知失败;
- 如果它只是返回
False,当前代码会忽略失败,导致go_main_page静默认为主页面已就绪。
建议显式判断返回值或依赖其抛异常语义,避免静默失败。
-
start_game的总超时预算可能让点击启动页后的等待时间过短
现在startup_timeout同时覆盖“等待启动页出现”和“点击启动页后等待游戏页”。如果游戏在接近超时才出现启动页,_enter_from_start_screen的剩余时间可能为 0,点击后几乎立刻超时。虽然这是预算语义的调整,但建议至少保留一个最小等待窗口,或在剩余时间不足时给出更明确的日志/错误信息。 -
小建议:
handle_daily_overlays的“先标记再执行”改为“清理成功后再标记”
这本身更合理,因为失败后可以重试;但要注意在force=True下每次都会执行完整检测。如果某个浮层无法被现有逻辑关闭,且go_main_page频繁调用,可能造成持续高开销。建议确认_OVERLAY_DISMISS_MAX和wait_for_page的超时机制足以防止此类情况。
|
|
||
| ### 页面导航 | ||
|
|
||
| **文件**: `autowsgr/ops/navigate.py` |
There was a problem hiding this comment.
以下是对该代码变更片段的审核意见:
-
文档占位符不清晰
wait_for_game_ui(ctrl, timeout=..., allow_start_screen=True)中的timeout=...不是有效的默认值表达方式。建议明确写出具体的默认数值(例如timeout=120)或改为timeout: float = 120的形式,避免使用省略号造成误解。 -
参数命名一致性不足
表格中start_game(ctrl, package)和restart_game(ctrl, package)使用package,而ensure_game_ready(ctx, app)仍使用app。建议统一参数名称,或在文档中补充说明app与package的关系(例如app是由package推导出的对象),以免调用者混淆。 -
文档描述与代码行为需保持一致
变更中特别提到了“点击进入后使用allow_start_screen=False,防止尚未离开启动页便报告成功”,但表格中未体现该默认值在start_game或restart_game内部是如何传递的。建议在文档中补充说明start_game内部调用了wait_for_game_ui(..., allow_start_screen=False),以便使用者理解该函数的实际等待逻辑。 -
缺少异常/边界行为说明
新增段落详细说明了“冷启动与恢复流程共用相同的进入检查”,但没有说明当超时或多次检查失败时会发生什么(例如是否抛异常、重试策略、返回何种状态)。建议补充一句失败时的行为约定,便于调用方正确处理错误。
整体改动方向合理,提升了文档对实际逻辑的描述准确度,但上述细节可进一步完善。
修复新版 MuMu 将游戏运行在独立显示屏时,脚本仍截取默认桌面而导致启动超时的问题。