[Bug] 远距离章节导航（10→2）因最大尝试次数不足而超时失败

[syokounya]

autowsgr_2026-04-16.debug.log

---

name: 🐛 问题反馈
type: Bug

相关环境信息

• 操作系统: Windows 11
• 模拟器: MuMu 模拟器 (1920×1080)
• AutoWSGR 版本: main 分支 (commit 7a26b4e 附近)
• 相关文件: �utowsgr/ui/map/panels/sortie.py, �utowsgr/ui/map/data.py

问题描述

当任务需要从第 10 章导航到第 2 章（或类似远距离）时，
avigate_to_chapter 会在走到第 4 章时就因超过 CHAPTER_NAV_MAX_ATTEMPTS = 12 而判定超时失败，导致整轮常规战被跳过。

根本原因是当前实现采用单步点击 + 逐轮 OCR 验证的策略。每次点击后，游戏页面动画过渡期间 OCR 会出现抖动（例如连续采样得到 [10, 10, 9] 或 [4, 4, 3]），程序检测到抖动后会本轮不点击，等下一轮重新验证。这导致每一章实际要消耗约 2 次尝试机会。从 10 → 2 需要跨越 8 章，理论上约需 8 × 2 = 16 次尝试，但上限只有 12，因此必然失败。

复现方法

1. 当前地图页面处于出征面板，且 OCR 识别为第 10 章（如 10-1）。
2. 启动一个目标为第 2 章的常规战任务（如 2-5）。
3. 观察日志：章节导航从 10 → 9 → 8 → 7 → 6 → 5 → 4，随后触发 超过最大尝试次数 (12)。

Log输出

shell 14:30:08.232 | INFO | ui/map/panels/sortie.py:248 | [UI] 章节导航: 当前第 10 章 -> 目标第 2 章 14:30:08.233 | INFO | ui/map/panels/sortie.py:164 | [UI] 地图页面 -> 上一章 (y=0.358) 14:30:10.244 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [10, 10, 9]，本轮不点击 14:30:12.402 | INFO | ui/map/panels/sortie.py:248 | [UI] 章节导航: 当前第 8 章 -> 目标第 2 章 14:30:14.449 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [8, 8, 7]，本轮不点击 14:30:18.416 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [7, 7, 6]，本轮不点击 14:30:22.635 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [6, 6, 5]，本轮不点击 14:30:26.943 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [5, 5, 4]，本轮不点击 14:30:31.284 | WARNING | ui/map/panels/sortie.py:223 | [UI] 章节导航: OCR 抖动 [4, 4, 3]，本轮不点击 14:30:31.787 | WARNING | ui/map/panels/sortie.py:269 | [UI] 章节导航: 超过最大尝试次数 (12), 目标第 2 章 14:30:31.916 | ERROR | ops/normal_fight.py:301 | [OPS] 地图章节导航失败: 无法导航到第 2 章 14:30:31.918 | WARNING | ops/normal_fight.py:302 | [OPS] 已放弃本轮常规战，尝试返回主页面以继续后续队列

建议的优化方向

1. 提高 CHAPTER_NAV_MAX_ATTEMPTS：从 12 提升到 20，确保能覆盖 10 → 1 的最远距离。
2. 远距离批量点击策略：当目标距离当前章节 > 2 章时，改为一次性连续点击若干章（如最多 4 章），然后统一等待动画完全结束后再 OCR 验证，减少过渡态抖动导致的轮空等待。
3. 近距离保持单步：当距离 ≤ 2 章时继续单步点击，避免过冲，保证精度。

[github-actions]

Issue 概要

• issue：#446
• 版本 / 分支 / 环境：Windows 11，MuMu 1920x1080，main（用户报告约 7a26b4eb，当前分析基于 7345dab62731da85cfee5a2858d006c4e5b65f4d）
• 任务 / 入口 / 相关设置：常规战任务进入地图页「出征」面板后执行章节导航（navigate_to_chapter），章节导航最大尝试次数 CHAPTER_NAV_MAX_ATTEMPTS=12
• 关键提示 / 报错文案：[UI] 章节导航: OCR 抖动 ... 本轮不点击、[UI] 章节导航: 超过最大尝试次数 (12)、[OPS] 地图章节导航失败
• 用户现象：从第 10 章切到第 2 章时，中途超时，当前轮常规战被放弃

附件概览

• 实际可读文件：issue 正文日志片段 + 1 条 bot 评论（AI 分析进行中）
• 缺失或未上传的证据：完整运行日志文件、截图、配置导出、崩溃转储均未提供

关键证据

点击此处展开

• issue 正文 / 评论：
  • 日志时间线显示章节从 10 -> 9 -> 8 -> ... -> 4，多次出现 OCR 抖动 [x,x,x-1]，本轮不点击，随后触发 超过最大尝试次数 (12)。
  • 评论仅有 bot 自动回复，无维护者技术结论。
• 运行时日志：
  • ui/map/panels/sortie.py 路径日志直接给出抖动导致跳过点击。
  • ops/normal_fight.py 日志显示导航失败后放弃本轮常规战。
• UI / 服务日志：无独立附件，只有 issue 内联日志。
• 配置快照：无。
• 现场图 / 转储：无。
• 代码依据（当前 HEAD）：
  • 最大尝试次数固定为 12：

    AutoWSGR/autowsgr/ui/map/data.py

    Lines 197 to 201 in 7345dab

    	CHAPTER_NAV_DELAY: float = 0.5
    	"""章节切换后等待动画的延迟 (秒)。"""
    	CHAPTER_NAV_MAX_ATTEMPTS: int = 12
    	"""章节导航最大尝试次数。"""

  • 导航主循环按“尝试轮次”计数；检测到抖动则“本轮不点击”但仍消耗尝试：

    AutoWSGR/autowsgr/ui/map/panels/sortie.py

    Lines 223 to 256 in 7345dab

    	_log.warning('[UI] 章节导航: OCR 抖动 {}，本轮不点击', chapters)
    	return candidate, last_screen, stable
    	confirm_hits = 0
    	for attempt in range(CHAPTER_NAV_MAX_ATTEMPTS):
    	current, screen, stable = _read_chapter_stable()
    	if current is None:
    	_log.warning('[UI] 章节导航: OCR 识别失败 (第 {} 次尝试)', attempt + 1)
    	return None
    	if current == target:
    	confirm_hits += 1
    	_log.info(
    	'[UI] 章节导航: 命中目标第 {} 章，二次确认 {}/2',
    	target,
    	confirm_hits,
    	)
    	if confirm_hits >= 2:
    	_log.info('[UI] 章节导航: 已到达第 {} 章', target)
    	return current
    	time.sleep(CHAPTER_NAV_DELAY)
    	continue
    	confirm_hits = 0
    	_log.info(
    	'[UI] 章节导航: 当前第 {} 章 -> 目标第 {} 章',
    	current,
    	target,
    	)
    	if not stable or screen is None:
    	time.sleep(CHAPTER_NAV_DELAY)
    	continue

  • 命中目标还要求二次确认（也消耗轮次）：

    AutoWSGR/autowsgr/ui/map/panels/sortie.py

    Lines 234 to 245 in 7345dab

    	if current == target:
    	confirm_hits += 1
    	_log.info(
    	'[UI] 章节导航: 命中目标第 {} 章，二次确认 {}/2',
    	target,
    	confirm_hits,
    	)
    	if confirm_hits >= 2:
    	_log.info('[UI] 章节导航: 已到达第 {} 章', target)
    	return current
    	time.sleep(CHAPTER_NAV_DELAY)
    	continue

  • 超过尝试次数直接失败：

    AutoWSGR/autowsgr/ui/map/panels/sortie.py

    Lines 269 to 274 in 7345dab

    	_log.warning(
    	'[UI] 章节导航: 超过最大尝试次数 ({}), 目标第 {} 章',
    	CHAPTER_NAV_MAX_ATTEMPTS,
    	target,
    	)
    	return None

  • 上层收到失败后跳过本轮常规战：

    AutoWSGR/autowsgr/ops/normal_fight.py

    Lines 299 to 307 in 7345dab

    	map_page.enter_sortie(self._plan.chapter, self._plan.map_id)
    	except NavigationError as e:
    	_log.error('[OPS] 地图章节导航失败: {}', e)
    	_log.warning('[OPS] 已放弃本轮常规战，尝试返回主页面以继续后续队列')
    	try:
    	goto_page(self._ctx, PageName.MAIN)
    	except NavigationError as back_err:
    	_log.error('[OPS] 返回主页面失败: {}', back_err)
    	raise ActionFailedError('地图章节识别/导航失败，已跳过本轮并返回主页面') from e

根因判断

• 直接结论：这是已证实的实现缺陷，核心是“尝试计数模型”与“远距离导航 + 过渡态 OCR 抖动”不匹配。
• 证据链：
  • 10 -> 2 需要至少 8 次有效点击。
  • 现实现中，抖动轮会 continue（不点击）但照样占用一次 attempt；常见模式是“一次点击 + 一次抖动空轮”，约 2 轮/章。
  • 仅位移阶段就可能约 8 * 2 = 16 轮；再加目标章节二次确认，预算更高（通常 >= 18）。
  • 固定上限 12 在该场景天然不足，因此中途超时是可预期结果，不是偶发。
• 当前主线是否可能已修复：未修复。用户提到的 7a26b4eb 与当前 main 在该逻辑上保持一致（常量与流程一致）。

修复方案

1. 代码 / 配置 / 资源层修复
   将“尝试上限”改为与距离相关或拆分计数：
   • 方案 A（低改动）：动态上限 max(20, abs(current-target)*2 + 4)（含二次确认余量）。
   • 方案 B（更稳）：拆成“点击预算 + 观测预算”，抖动观测不消耗点击预算；或在点击后进入“等待稳定”子循环再决定下一步。
2. 需要补充的测试、日志或截图
   新增导航单测：模拟 10->2 且每次点击后插入一轮抖动序列（如 [10,10,9]），验证不会在中途提前超时；同时覆盖“目标二次确认”消耗预算。
3. 如问题属于不支持场景，应如何限制入口或改进提示
   该问题不属于“不支持场景”。建议仅在预算耗尽时提示“建议手动先切近目标章或重试”，避免误判为纯 OCR 失败。

给用户的建议

• 用户现在可以直接尝试的动作：任务开始前手动把地图章位切到接近目标（例如先切到 3~4 章再启动 2 章任务）。
• 是否建议升级 / 重下完整包 / 重置配置 / 更换环境：当前看不是安装包或配置损坏，升级到同逻辑版本不会根治；等待合入修复更有效。
• 是否有临时绕过方案：有，减少单次跨章距离（拆分任务或人工预定位章节）。

给修复 AI 的建议（可复制）

点击此处展开

现象：
从第10章导航到第2章时，章节导航在第4章附近因“超过最大尝试次数(12)”失败，常规战被整轮跳过。

关键证据：
[UI] 章节导航: OCR 抖动 [10, 10, 9]，本轮不点击
...
[UI] 章节导航: 超过最大尝试次数 (12), 目标第 2 章
[OPS] 地图章节导航失败: 无法导航到第 2 章

可能相关线索（待验证）：
当前循环把“尝试次数”同时用于点击与观测；抖动轮不点击但会消耗attempt，且目标命中需要二次确认，导致远距离跨章预算不足。
建议改为动态预算或“点击预算/观测预算”分离，并补充10->2抖动场景单测。

置信度

• 高
• 还缺什么证据：缺完整原始日志与现场截图，但现有 issue 日志 + 当前实现已足够闭环定位根因

---

点击此处展开分析过程

● skill(generic-issue-log-analysis)

● Get issue details (MCP: github-mcp-server) · method: "get", owner: "OpenWSGR", repo: "AutoWSGR", …
  └ {"number":446,"title":"[Bug]
    远距离章节导航（10→2）因最大尝试次数不足而超时失败","body":"---\nn...

● Get issue details (MCP: github-mcp-server) · method: "get_comments", owner: "OpenWSGR", repo: "Au…
  └ [{"id":4261428103,"body":"🤖 **AI 正在分析该 Issue...**
    \n\n感谢您的反馈！AI 正在自动分析...

我先把相关实现和常量定位出来，对照 issue 日志确认是否是当前代码缺陷，以及主线是否已经修复。

● Search (grep)
  │ "CHAPTER_NAV_MAX_ATTEMPTS|navigate_to_chapter|章节导航|OCR 抖动" in **/*.py
  └ 40 lines found

● Search (glob)
  │ "**/*{locale,locales,i18n,lang,langs,translations}*"
  └ No matches found

● Read sortie.py
  │ autowsgr/ui/map/panels/sortie.py
  └ 377 lines read

● Read normal_fight.py
  │ autowsgr/ops/normal_fight.py
  └ L250:360 (111 lines read)

● Read data.py
  │ autowsgr/ui/map/data.py
  └ L160:240 (80 lines read)

● Read test_unit.py
  │ testing/ui/map_page/test_unit.py
  └ L130:240 (49 lines read)

● Get current commit SHA (shell)
  │ git --no-pager rev-parse HEAD && git --no-pager rev-parse --short HEAD
  └ 3 lines...

● Read data.py
  │ autowsgr/ui/map/data.py
  └ L1:160 (160 lines read)

● Search (grep)
  │ "TOTAL_CHAPTERS|MAP_DATABASE|MapIdentity|parse_map_title"
  │ (autowsgr/ui/map/data.py)
  └ 15 lines found

● Read data.py
  │ autowsgr/ui/map/data.py
  └ L232:320 (88 lines read)

● Compare issue commit constants and loop (shell)
  │ (git cat-file -e 7a26b4eb^{commit} && echo HAS_COMMIT || echo NO_COMMIT)
  │ && if git cat-file -e 7a26b4eb^{commit} 2>/dev/null; then git --no-pager
  │ show 7a26b4eb:autowsgr/ui/map/data.py | rg -n
  │ "CHAPTER_NAV_MAX_ATTEMPTS|TOTAL_CHAPTERS" && git --no-pager show
  │ 7a26b4eb:autowsgr/ui/map/panels/sortie.py | rg -n "for attempt in …
  └ 4 lines...

● Get commit details (MCP: github-mcp-server) · owner: "OpenWSGR", repo: "AutoWSGR", sha: "7a26b4eb…
  └ {"sha":"7a26b4eb165151a94b17c9b3c00b61f8a4456b2e","html_url":"https://gi...

● Get file or directory contents (MCP: github-mcp-server) · autowsgr/ui/map/panels/sortie.py · owne…
  └ successfully downloaded text file (SHA: 2769d760c0ebd14eee9e77a08c857e9b...

● Get file or directory contents (MCP: github-mcp-server) · autowsgr/ui/map/data.py · owner: "OpenW…
  └ successfully downloaded text file (SHA: bd4d0956e140b232df9e30c5f71699d9...

● Get file or directory contents (MCP: github-mcp-server) · autowsgr/ui/map/panels/sortie.py · owne…
  └ successfully downloaded text file (SHA: 2769d760c0ebd14eee9e77a08c857e9b...

● Get file or directory contents (MCP: github-mcp-server) · autowsgr/ui/map/data.py · owner: "OpenW…
  └ successfully downloaded text file (SHA: bd4d0956e140b232df9e30c5f71699d9...

● Check if output file exists (shell)
  │ test -f copilot_answer.md && echo exists || echo missing
  └ 2 lines...

● Edit
  └ Create copilot_answer.md

● Read copilot_answer.md
  └ 87 lines read

已完成：Issue #446 的分析结论已写入 `copilot_answer.md`（仓库根目录）。

结论是**已证实的实现缺陷**：章节导航把“观测轮次”和“点击动作”共用同一尝试计数，OCR 抖动轮与目标二次确认都会消耗预算，导致 `10 -> 2` 这类远距离切章在 `CHAPTER_NAV_MAX_ATTEMPTS=12` 下天然容易中途超时并触发本轮常规战跳过。


Changes   +88 -0
Requests  1 Premium (3m 30s)
Tokens    ↑ 511.4k • ↓ 7.8k • 449.0k (cached) • 4.5k (reasoning)

🔗 GitHub Action 运行记录