QQReader 2026.09.27 串行交接检查与验证码即停

本版重点

串行交接更安全（QQR-53）

• 每两项任务之间先做交接检查：每一帧先查验证码，确认回到书架才启动下一项。途中只点 OCR 实际看到的「取消」「放弃奖励」「书架」tab、「跳过」，其他页面按返回，必要时重启一次 App。
• 验证码不再被当成普通失败：任务结束时处于验证码，或交接检查发现验证码，整轮立即停止，后续任务记为跳过，等待人工处理。
• 退出码细分：0 成功 / 2 任务未成功 / 3 致命错误或书源白名单拒绝 / 10 验证码阻塞 / 11 超时 / 12 设备错误 / 13 取消 / 20 交接失败。
• 串行记录（runtime/records/daily_flows/，record_version 2）逐项记录结果、退出码含义和交接证据；GUI 与 scripts/daily_all.py 语义一致。

等级页广告（QQR-54）

• 识别被截断的倒计时（如「观看20秒」），倒计时中不再提前点 × 关闭广告。
• 出现「观看视频30秒，才能获得奖励 / 继续观看 / 放弃奖励」挽留弹窗时先点「继续观看」（最多 3 次），之后点「放弃奖励」，不再连按 8 次无效返回。

自动阅读入口（QQR-55）

• 书架判定不再被书城横幅「勋章/装扮限时返场」误导；书城页直接点书架 tab。
• 书架上确实没有目标书 → 仍 exit 3（书目保护不放宽）；确认不了书架 → exit 2，并记录页面类型、完整 OCR 和截图。
• 书城横幅不再被当成活动弹窗盲点；关闭按钮固定为「取消」优先。

GUI：模拟器地址与书目选择

• 标题栏可选择模拟器地址（MuMu 多开端口、adb devices 在线设备或手动输入）。
• 自动阅读可设置小说书名；听书可设置书名、封面（支持从当前画面截取），以及找不到时是否换书。

验证

• 单元测试：py -3.10 -m pytest ：424 passed / 4 failed（已知，见下）/ 2 skipped；新增回归测试均基于真实 OCR 帧。
• 实机极端场景（开发时）：冷启动开屏、App 被强杀、正文页、4 层深页面、退出确认框、书城页、排行榜二级页、「我的/发现」tab、从书城页启动自动阅读、等级广告失败后交接——全部回到书架或正常完成。
• 两账号实机验收（GUI 每日流程）：
  • daily_20260927_233314_e4d1416a：自动阅读 → 游戏 → 听书，3/3 成功。
  • daily_20260928_000449_dad048be：自动阅读 ×2 → 游戏 → 广告 → 等级广告 → 听书，6/6 成功；每项启动前交接检查均为 READY。

已知限制

• 验证码阻塞、QQR-54 的截断倒计时和挽留弹窗在实机上尚未出现，只由单元测试和真实 OCR 回放测试覆盖。
• 从 GitHub 克隆的仓库不含本机目录 dev/（Maa 资源）和 _backup_old_project_*（听书/等级广告依赖的旧流程），需要单独拷贝。
• 未附带 exe：请用 启动QQReaderGUI.cmd 启动（运行源码）。
• 4 项已知单元测试失败与上一版相同（广告 40/35 秒不一致 ×2、直播退出 ×1、滑块截图样本 ×1）。

完整改动见 CHANGELOG.md。

QQReader 2026.09.23 GUI 启动修复与完整运行包

QQReader Windows 应用快照 2026.09.23

完整发布包包含重建的 QQReaderGUI.exe、当前源码、MaaFramework DLL/OCR 模型、所需旧流程 runner 和配置模板。

本次修复

• GUI 启动脚本统一 UTF-8 无 BOM、CRLF、控制台代码页和 Python/PowerShell 输出编码。
• 修复奖励页入口识别及打开后误返回的问题。
• 视频广告默认等待 35 秒，退出后确认页面，避免连续返回。
• 启用历史滑块求解模块，验证消失后继续新版流程。

已检查

• 2026-09-23 GUI 广告完整流程最终 SUCCEEDED。
• 两个启动入口中文输出正常，--help 返回码为 0。
• 发布包在包含中文和空格的解压路径中通过启动检查。
• ZIP 完整性、配置相对路径与 SHA-256 已检查。

使用

完整解压，阅读包内「使用说明.txt」，配置 Python 3.10 和 MuMu 路径，运行「启动QQReaderGUI.cmd」。外部 Python 需要 numpy、opencv-python；GUI exe 仍通过外部 Python 执行任务。

此附件为当前工作目录快照（含当前修改），不等同于标签所指提交的自动源码归档。个人日志、截图、任务记录及临时调试文件未包含。

2026-09-25 跨页面测试与 Windows 包更新

• 从书架主页、书城“男生”页和奖励页顶部运行 DailyAdFlow，均能进入或确认奖励页；广告已达 12/12 时，却误报 ad_watch_entry_not_found。将已完成广告卡片置于可见区域后，同一任务返回 SUCCESS。已知问题：QQR-41，尚未修复。
• 模拟器桌面上的 GUI“识别检查”通过截图预检（1280×720、退出码 0）；这不是每日任务完成的证明。阅读、听书、游戏的跨页面实机执行仍待验证。
• 新增测试证据附件 QQReader-page-entry-test-2026-09-25.zip 与对应 .sha256，包含报告、4 条任务记录、预检日志和 2 张页面截图。附件 SHA-256：51af089397b0573a611d0b0c99c77b19d3a506c779f58ce6170e197d113f5ead。

2026-09-25 Windows 包

• 最新完整 Windows 包：QQReader-2026.09.25-windows.zip，校验文件：.sha256。
• GUI EXE 已从当前源码重建。ZIP 含 181 个文件，完整性检查通过；SHA-256：1e4d2c8266b37be212d60f0935264f5849a9a09eb0af313b1c5e0a86bcb87b36。
• 此包是 2026-09-25 当前工作区快照。Release 标签仍为 v2026.09.23-gui-fix，其源码标签没有移动；包内快照与 GitHub 标签源码不完全相同。
• 已知问题 QQR-41 尚未修复：广告已达 12/12 时，从部分页面启动可能误报广告入口缺失。跨页面测试范围与证据见上方测试附件。