补充采购规格面板失败的脱敏结构化诊断 #206

Open
opened 2026-09-03 16:00:06 +08:00 by ila · 1 comment
Owner

需求摘要

CG63 在最新 Agent 0.9.39 中两次于 openSpecPanel 阶段失败,报“点击后未识别到商品规格面板”。用户授权建单实施诊断修复。现有日志只有通用失败码,无法辨别点击后的 PDD 页面缺少哪一项严格面板证据。

范围

  • 在采购规格面板点击成功后的超时失败中,回传固定、脱敏的结构化面板证据:面板类型、受限滚动容器数、规格标题数、可选项数、已选摘要/数量控件/唯一订单动作/商品页证据布尔值。
  • 不保存原始无障碍控件树、节点文字、路径、截图、账号、地址、订单或支付信息。
  • 为该失败结果补 Android 单元测试并构建 APK。

非范围

不自动重试、不点击订单/支付、不放宽规格面板识别条件、不修改采购规则、服务端状态机或数据库。拿到下一次实际结构化证据后,再单独评估具体页面形态兼容。

方案与设计证据

复用现有 ParsedPddScreen 已计算的标量字段;失败消息附加固定键值诊断,不含动态原始文本。非 UI 行为与日志增强,无需新页面或原型。

验收

  1. 点击成功但 30 次轮询仍未识别规格面板时,错误消息含全部允许字段。
  2. 不出现原始控件树、节点文本、截图及敏感信息。
  3. 找不到入口、点击失败和已识别面板等路径语义不变。
  4. Android 单元测试、Debug 构建通过;不执行真实采购或重试。

文档影响

无长期业务/API/运维契约变化;仅补充已有结构化失败的诊断细节,工单说明原因即可。

## 需求摘要 CG63 在最新 Agent 0.9.39 中两次于 openSpecPanel 阶段失败,报“点击后未识别到商品规格面板”。用户授权建单实施诊断修复。现有日志只有通用失败码,无法辨别点击后的 PDD 页面缺少哪一项严格面板证据。 ## 范围 - 在采购规格面板点击成功后的超时失败中,回传固定、脱敏的结构化面板证据:面板类型、受限滚动容器数、规格标题数、可选项数、已选摘要/数量控件/唯一订单动作/商品页证据布尔值。 - 不保存原始无障碍控件树、节点文字、路径、截图、账号、地址、订单或支付信息。 - 为该失败结果补 Android 单元测试并构建 APK。 ## 非范围 不自动重试、不点击订单/支付、不放宽规格面板识别条件、不修改采购规则、服务端状态机或数据库。拿到下一次实际结构化证据后,再单独评估具体页面形态兼容。 ## 方案与设计证据 复用现有 ParsedPddScreen 已计算的标量字段;失败消息附加固定键值诊断,不含动态原始文本。非 UI 行为与日志增强,无需新页面或原型。 ## 验收 1. 点击成功但 30 次轮询仍未识别规格面板时,错误消息含全部允许字段。 2. 不出现原始控件树、节点文本、截图及敏感信息。 3. 找不到入口、点击失败和已识别面板等路径语义不变。 4. Android 单元测试、Debug 构建通过;不执行真实采购或重试。 ## 文档影响 无长期业务/API/运维契约变化;仅补充已有结构化失败的诊断细节,工单说明原因即可。
Author
Owner

实施完成,待验收。提交并已推送:13b1580 fix(agent): 回传规格面板失败证据 (#206)。当规格入口点击成功但 30 次受限轮询仍未确认面板时,错误消息现附带固定标量:type、scrollables、headings、options、summary、quantity、orderAction、pageEvidence。该信息不含控件树、节点文字、路径、截图、账号、地址、订单或支付数据。新增单测覆盖未知面板返回全部标量且不泄露面板文本。验证通过:gradlew :app:testDebugUnitTest --tests cn.ilapage.goauto.agent.PurchaseRehearsalExecutorTest;gradlew :app:assembleDebug。APK 已生成于 android/app/build/outputs/apk/debug/app-debug.apk,未安装到真机,未重试 CG63,未执行采购、下单或支付。长期文档影响:无;仅增强既有结构化失败诊断,未改变业务/API/运维契约,因此未更新 Wiki。

实施完成,待验收。提交并已推送:13b1580 fix(agent): 回传规格面板失败证据 (#206)。当规格入口点击成功但 30 次受限轮询仍未确认面板时,错误消息现附带固定标量:type、scrollables、headings、options、summary、quantity、orderAction、pageEvidence。该信息不含控件树、节点文字、路径、截图、账号、地址、订单或支付数据。新增单测覆盖未知面板返回全部标量且不泄露面板文本。验证通过:gradlew :app:testDebugUnitTest --tests cn.ilapage.goauto.agent.PurchaseRehearsalExecutorTest;gradlew :app:assembleDebug。APK 已生成于 android/app/build/outputs/apk/debug/app-debug.apk,未安装到真机,未重试 CG63,未执行采购、下单或支付。长期文档影响:无;仅增强既有结构化失败诊断,未改变业务/API/运维契约,因此未更新 Wiki。
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#206