OPC/goauto
2
0
Fork 0
Code Issues 200 Pull Requests Actions Packages Projects Releases Wiki Activity

Agent 识别 PDD 无效链接跳回首页并明确失败 #103

New Issue
Open
opened 2026-08-27 09:56:21 +08:00 by ila · 0 comments
ila commented 2026-08-27 09:56:21 +08:00
Owner
Copy Link
Copy Source

需求来源

  • 来源：用户于 2026-08-27 确认。
  • 类型：Android Agent 采集链路独立缺陷工单。
  • 原始需求摘要：PDD 链接打开拼多多 App 后，有时没有进入商品详情页，而是直接停留或返回拼多多首页。第一步先可靠确认这是“链接失效后回到首页”，并给出明确错误；暂不自动寻找替代商品。
  • 当前状态：待实施。

当前事实

  • 当前 Agent 对“未进入商品详情页”主要返回通用错误 PDD_DETAIL_ENTRY_FAILED，无法区分稳定停在 PDD 首页与普通页面加载失败。
  • 现有详情页进入流程已经支持首次进入失败后，通过浏览器重新打开同一原始 URL 一次。
  • “商品详情页真实售罄”及其下拉刷新属于另一条判断链路，不能与“打开后返回首页”混用。

目标

当原始 PDD 链接打开 App 后，Agent 能够可靠识别“没有进入商品详情页且稳定停在 PDD 首页”的场景：

  1. 首次确认在首页时，复用现有恢复能力，从浏览器重新打开同一原始 URL 一次。
  2. 再次稳定确认在首页时，结束采集并提交明确错误：
    • 错误码：PDD_LINK_RETURNED_HOME
    • 用户提示：商品链接已失效，打开后返回拼多多首页
  3. 避免把页面切换过程、加载中、登录页、验证码/风控页、真实商品详情页误判为首页。

实施方案

识别时机

在“确认已进入商品详情页”阶段执行，早于规格面板定位和真实售罄恢复。

首页强证据

首页判断必须同时满足：

  • 当前前台包名是 PDD；
  • 命中规则中配置的多个独立首页强证据，或命中经真机确认的首页 Activity 与首页控件组合；
  • 未命中商品详情页强证据，例如商品标题、价格、规格/购买入口；
  • 连续两次读取结果一致，读取间隔使用有上限的短等待，排除过渡动画和页面加载中。

不得只根据单个“首页”文字、单个底部导航项或包名作判断。首页证据应由采集规则集中配置，Agent 负责稳定性、互斥证据和恢复次数控制。

恢复与终止

  • 第一次稳定识别为首页：仅允许复用现有浏览器重开流程，重新打开同一原始 URL 一次。
  • 第二次稳定识别为首页：返回 PDD_LINK_RETURNED_HOME。
  • 最多执行“首次打开 + 一次重开”，禁止循环重开。
  • 首页场景不执行下拉刷新，不点击首页推荐商品或相似商品。
  • 登录失效、验证码、风控、人机验证仍按原错误立即失败。
  • 已进入商品详情页但确认售罄时仍走现有售罄判断，不返回首页错误。
  • 无法确认首页且无法进入详情页时保留原 PDD_DETAIL_ENTRY_FAILED。

影响范围

  • Android Agent：页面分类、详情页进入恢复和错误提交。
  • 采集规则：补充可版本化的 PDD 首页强证据。
  • 服务端沿用现有任务失败结果提交与详情展示，不新增数据库字段，不修改 Admin 页面和共享 API。
  • 每个判断和动作继续关联 taskId、deviceId 和任务内 ruleSnapshot。
  • 不保存原始控件树和截图。

非目标

  • 不点击“相似商品”或首页推荐商品。
  • 不使用 SYB 图片搜索 PDD。
  • 不自动替换 PDD URL 或 goods_id。
  • 不实现 OCR/VLM。
  • 不涉及采购、创建订单或支付。
  • 不修改商品数据、数据库结构或管理端页面。

设计证据

本工单复用现有任务失败详情展示，没有新增页面、组件、导航或权限交互；错误分类、恢复矩阵和文案已在本工单中明确，因此不要求新增 QuantUX/HTML 原型。

验收标准

  • 首次连续稳定识别为 PDD 首页后，只从浏览器重开原 URL 一次。
  • 重开后再次连续稳定识别为首页，任务失败并提交 PDD_LINK_RETURNED_HOME 与“商品链接已失效，打开后返回拼多多首页”。
  • 最多打开两次，不出现无限重试。
  • 首页场景不下拉刷新、不点击推荐或相似商品。
  • 页面短暂经过首页后进入有效商品详情页时，不误报链接失效。
  • 有效详情页、真实售罄页、登录页、验证码/风控页及普通超时分别保持既有处理。
  • 无法形成首页强证据时仍返回原通用详情页进入失败，不猜测为链接失效。
  • 自动化测试覆盖首页正例、过渡页反例、详情页互斥证据、一次重开上限和既有错误回归。
  • Android 单元测试及构建通过。
  • 真机分别验证一个“打开后返回首页”的无效链接和一个有效商品链接；真机验证前另行取得用户授权。

风险与控制

  • PDD 首页与详情页可能共享包名或部分控件：采用多个强证据、详情页互斥证据和连续两次稳定读取降低误判。
  • 不同 PDD 版本首页结构可能变化：首页证据进入规则快照，不将全部页面文案写死在 Agent。
  • 恢复逻辑可能与现有重开流程重复：统一复用现有恢复入口并固定一次上限。

文档影响

实施后如错误码、规则契约或采集恢复规则成为长期事实，需要更新线上 Wiki 的业务规则/词汇与 Agent API/规则契约相关页面，在线回读 revision 后同步本地镜像；若最终没有共享契约变化，则在工单说明仅为 Agent 内部分类并跳过对应 Wiki 更新。

## 需求来源 - 来源：用户于 2026-08-27 确认。 - 类型：Android Agent 采集链路独立缺陷工单。 - 原始需求摘要：PDD 链接打开拼多多 App 后，有时没有进入商品详情页，而是直接停留或返回拼多多首页。第一步先可靠确认这是“链接失效后回到首页”，并给出明确错误；暂不自动寻找替代商品。 - 当前状态：待实施。 ## 当前事实 - 当前 Agent 对“未进入商品详情页”主要返回通用错误 `PDD_DETAIL_ENTRY_FAILED`，无法区分稳定停在 PDD 首页与普通页面加载失败。 - 现有详情页进入流程已经支持首次进入失败后，通过浏览器重新打开同一原始 URL 一次。 - “商品详情页真实售罄”及其下拉刷新属于另一条判断链路，不能与“打开后返回首页”混用。 ## 目标 当原始 PDD 链接打开 App 后，Agent 能够可靠识别“没有进入商品详情页且稳定停在 PDD 首页”的场景： 1. 首次确认在首页时，复用现有恢复能力，从浏览器重新打开同一原始 URL 一次。 2. 再次稳定确认在首页时，结束采集并提交明确错误： - 错误码：`PDD_LINK_RETURNED_HOME` - 用户提示：`商品链接已失效，打开后返回拼多多首页` 3. 避免把页面切换过程、加载中、登录页、验证码/风控页、真实商品详情页误判为首页。 ## 实施方案 ### 识别时机 在“确认已进入商品详情页”阶段执行，早于规格面板定位和真实售罄恢复。 ### 首页强证据 首页判断必须同时满足： - 当前前台包名是 PDD； - 命中规则中配置的多个独立首页强证据，或命中经真机确认的首页 Activity 与首页控件组合； - 未命中商品详情页强证据，例如商品标题、价格、规格/购买入口； - 连续两次读取结果一致，读取间隔使用有上限的短等待，排除过渡动画和页面加载中。 不得只根据单个“首页”文字、单个底部导航项或包名作判断。首页证据应由采集规则集中配置，Agent 负责稳定性、互斥证据和恢复次数控制。 ### 恢复与终止 - 第一次稳定识别为首页：仅允许复用现有浏览器重开流程，重新打开同一原始 URL 一次。 - 第二次稳定识别为首页：返回 `PDD_LINK_RETURNED_HOME`。 - 最多执行“首次打开 + 一次重开”，禁止循环重开。 - 首页场景不执行下拉刷新，不点击首页推荐商品或相似商品。 - 登录失效、验证码、风控、人机验证仍按原错误立即失败。 - 已进入商品详情页但确认售罄时仍走现有售罄判断，不返回首页错误。 - 无法确认首页且无法进入详情页时保留原 `PDD_DETAIL_ENTRY_FAILED`。 ## 影响范围 - Android Agent：页面分类、详情页进入恢复和错误提交。 - 采集规则：补充可版本化的 PDD 首页强证据。 - 服务端沿用现有任务失败结果提交与详情展示，不新增数据库字段，不修改 Admin 页面和共享 API。 - 每个判断和动作继续关联 `taskId`、`deviceId` 和任务内 `ruleSnapshot`。 - 不保存原始控件树和截图。 ## 非目标 - 不点击“相似商品”或首页推荐商品。 - 不使用 SYB 图片搜索 PDD。 - 不自动替换 PDD URL 或 goods_id。 - 不实现 OCR/VLM。 - 不涉及采购、创建订单或支付。 - 不修改商品数据、数据库结构或管理端页面。 ## 设计证据 本工单复用现有任务失败详情展示，没有新增页面、组件、导航或权限交互；错误分类、恢复矩阵和文案已在本工单中明确，因此不要求新增 QuantUX/HTML 原型。 ## 验收标准 - [ ] 首次连续稳定识别为 PDD 首页后，只从浏览器重开原 URL 一次。 - [ ] 重开后再次连续稳定识别为首页，任务失败并提交 `PDD_LINK_RETURNED_HOME` 与“商品链接已失效，打开后返回拼多多首页”。 - [ ] 最多打开两次，不出现无限重试。 - [ ] 首页场景不下拉刷新、不点击推荐或相似商品。 - [ ] 页面短暂经过首页后进入有效商品详情页时，不误报链接失效。 - [ ] 有效详情页、真实售罄页、登录页、验证码/风控页及普通超时分别保持既有处理。 - [ ] 无法形成首页强证据时仍返回原通用详情页进入失败，不猜测为链接失效。 - [ ] 自动化测试覆盖首页正例、过渡页反例、详情页互斥证据、一次重开上限和既有错误回归。 - [ ] Android 单元测试及构建通过。 - [ ] 真机分别验证一个“打开后返回首页”的无效链接和一个有效商品链接；真机验证前另行取得用户授权。 ## 风险与控制 - PDD 首页与详情页可能共享包名或部分控件：采用多个强证据、详情页互斥证据和连续两次稳定读取降低误判。 - 不同 PDD 版本首页结构可能变化：首页证据进入规则快照，不将全部页面文案写死在 Agent。 - 恢复逻辑可能与现有重开流程重复：统一复用现有恢复入口并固定一次上限。 ## 文档影响 实施后如错误码、规则契约或采集恢复规则成为长期事实，需要更新线上 Wiki 的业务规则/词汇与 Agent API/规则契约相关页面，在线回读 revision 后同步本地镜像；若最终没有共享契约变化，则在工单说明仅为 Agent 内部分类并跳过对应 Wiki 更新。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#103