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

Android Agent 四 Tab 任务中心交互原型 #87

New Issue
Closed
opened 2026-08-25 14:59:53 +08:00 by ila · 4 comments
ila commented 2026-08-25 14:59:53 +08:00
Owner
Copy Link
Copy Source

所属

  • 父 MVP：#86
  • 类型：设计 / Android 原型
  • 实施状态：本工单只做设计证据，不写生产代码。

目标

使用 QuantUX 制作 Android Agent v0.3 四 Tab 交互原型，并导出本地可浏览 HTML 快照供用户审核。

v1 已完成三 Tab 草稿；用户于 2026-08-25 确认增加“设置”Tab并完成 v2。随后用户确认 Android Agent App 的采集任务和采购任务需要按任务编号搜索。v1、v2 均保留为历史审核证据，不原位覆盖；按本工单更新制作 v3。

原型范围

状态 Tab（默认）

  • 服务端连接、设备空闲/忙碌、当前任务和最近心跳。
  • 无障碍三态：已开启并就绪、已开启等待连接、未开启；提供“打开无障碍设置”。
  • 15 秒自动返回提示及取消入口。
  • 无障碍异常仍须在状态页醒目显示，不能只放在设置页。

采集 Tab

  • 当前设备采集记录的正常、加载、空、失败状态。
  • 支持按当前设备的采集任务编号搜索；示例 35、#35。只匹配采集任务编号，不搜索 goods_id、商品标题、订单号或其他字段。
  • 搜索忽略首尾空格；带或不带 # 均可。搜索条件与状态筛选同时生效，清空后恢复默认最近 30 天记录。
  • 搜索无结果时显示具体查询值和“清空搜索”，不与“当前没有任务”的普通空状态混用。
  • 列表进入详情，查看标题、店铺、销量、评价、颜色价格、尺码、SKU、缺失项和错误。
  • 终态任务显示“重新采集”；完成/部分完成时必须二次确认会清除现有任务结果。
  • 只表达“提交服务端并加入队列”，不允许绕过 claim/start/租约。

采购 Tab

  • 当前设备采购记录与只读详情。
  • 支持按当前设备的采购任务编号搜索；示例 12、CG-12，字母大小写不敏感。只匹配采购任务编号，不搜索蝦皮订单号、PDD 订单号、商品或其他字段。
  • 搜索忽略首尾空格；带或不带 CG- 均可。搜索条件与状态筛选同时生效，清空后恢复默认最近 30 天记录。
  • 搜索无结果时显示具体查询值和“清空搜索”，不与普通空状态混用。
  • 展示任务、蝦皮订单号、目标规格数量、价格、状态、PDD 订单号和下单时间、错误。
  • 不提供重新采购、取消订单、修改订单或支付入口。

设置 Tab

连接设置

  • 显示并允许编辑服务器地址。
  • 地址支持合法的 HTTP/HTTPS URL；输入错误时在字段附近显示普通用户能理解的提示。
  • 提供“测试连接”，明确显示测试中、连接成功和失败原因。
  • 提供“保存并重新连接”；保存成功后按现有设备身份流程重新连接服务端。
  • 设备执行采集或采购任务期间禁止修改服务器地址，并说明“任务执行中，暂时不能修改服务器”。

设备与诊断

  • 设备名称允许编辑，供管理端识别。
  • installId 只读显示。
  • Device Token 只显示“已配置/未配置”，不显示明文，也不提供普通编辑。
  • 显示注册状态、Agent 版本、服务端连接状态。
  • 显示“保持屏幕常亮”状态。
  • 显示无障碍状态和“打开无障碍设置”；状态页仍保留异常提醒。

第一阶段非目标

  • 15 秒自动返回保持固定规则，不做可调参数。
  • 不保存或展示 PDD 账号密码。
  • 不增加自动支付或任何支付入口。
  • 不在 Agent 提供采购订单写操作。

交互与可访问性

  • 底部导航固定为状态、采集、采购、设置，图标与文字同时存在；设置为第四项。
  • 触控区域至少 48dp；状态不能只靠颜色。
  • 列表详情返回后保持原 Tab 和滚动位置。
  • 覆盖正常、空、加载、失败、禁用和权限/安全边界。
  • 设置保存、测试连接需要加载、成功和失败反馈；异步期间按钮禁用，避免重复提交。
  • 采集与采购搜索框使用可见标签/提示、至少 48dp 高的输入和搜索按钮；搜索期间提供加载反馈，结果页保留当前 Tab 与状态筛选。
  • 修改服务器地址导致重新连接前给出明确说明。
  • 小屏不横向滚动，底栏避开系统手势区域。

设计证据门禁

  • QuantUX App ID、线上链接和覆盖范围写回本工单。
  • 已有 v1：QuantUX App ID 6a8d4607191a826306a7efec；Git 快照 prototypes/87/v1/index.html；提交 7f7336e。该版本只作历史证据。
  • v2：同一 QuantUX App；Git 快照 prototypes/87/v2/index.html；提交 46ab5bf。该版本只作历史证据。
  • 根据新增任务编号搜索制作 v3；完整后导出到 prototypes/87/v3/index.html，资源使用相对路径或单文件自包含。
  • 导出后验证四个 Tab、采集/采购编号搜索的结果与无结果状态、筛选组合、设置保存/测试/禁用状态及原有主要点击流程。
  • 用户明确审核 v3 通过前，#88～#92 不得编写生产代码。

验收标准

  • 四个 Tab 和主要详情可点击。
  • 无障碍状态与打开设置入口清楚，状态页与设置页职责明确。
  • 自动返回倒计时及取消状态清楚。
  • 采集结果与重新采集确认流程清楚。
  • Agent 采集 Tab 可按当前设备的采集任务编号搜索，展示命中与无结果状态，并可清空搜索。
  • Agent 采购 Tab 可按当前设备的采购任务编号搜索，展示命中与无结果状态，并可清空搜索。
  • 任务编号搜索与状态筛选组合生效，不扩展到商品编号、蝦皮订单号或 PDD 订单号。
  • 采购详情无任何订单写操作或支付入口。
  • 设置页可查看和编辑服务器地址、测试连接、保存并重新连接。
  • 任务执行中服务器地址编辑与保存明确禁用。
  • installId、Token 状态、注册状态、Agent 版本和屏幕常亮状态表达清楚。
  • Token 不显示明文；PDD 账号与支付能力不进入设置页。
  • v3 HTML 快照本地可离线浏览并通过交互校验。
  • 用户明确审核 v3 通过。

文档影响

原型证据只写工单和 Git 路径；本工单阶段不改变长期业务事实。后续生产实现若改变 Agent 配置、接口或安全边界，由对应实施工单更新长期 Wiki。

## 所属 - 父 MVP：#86 - 类型：设计 / Android 原型 - 实施状态：本工单只做设计证据，不写生产代码。 ## 目标 使用 QuantUX 制作 Android Agent v0.3 四 Tab 交互原型，并导出本地可浏览 HTML 快照供用户审核。 v1 已完成三 Tab 草稿；用户于 2026-08-25 确认增加“设置”Tab并完成 v2。随后用户确认 Android Agent App 的采集任务和采购任务需要按任务编号搜索。v1、v2 均保留为历史审核证据，不原位覆盖；按本工单更新制作 v3。 ## 原型范围 ### 状态 Tab（默认） - 服务端连接、设备空闲/忙碌、当前任务和最近心跳。 - 无障碍三态：已开启并就绪、已开启等待连接、未开启；提供“打开无障碍设置”。 - 15 秒自动返回提示及取消入口。 - 无障碍异常仍须在状态页醒目显示，不能只放在设置页。 ### 采集 Tab - 当前设备采集记录的正常、加载、空、失败状态。 - 支持按当前设备的采集任务编号搜索；示例 `35`、`#35`。只匹配采集任务编号，不搜索 goods_id、商品标题、订单号或其他字段。 - 搜索忽略首尾空格；带或不带 `#` 均可。搜索条件与状态筛选同时生效，清空后恢复默认最近 30 天记录。 - 搜索无结果时显示具体查询值和“清空搜索”，不与“当前没有任务”的普通空状态混用。 - 列表进入详情，查看标题、店铺、销量、评价、颜色价格、尺码、SKU、缺失项和错误。 - 终态任务显示“重新采集”；完成/部分完成时必须二次确认会清除现有任务结果。 - 只表达“提交服务端并加入队列”，不允许绕过 claim/start/租约。 ### 采购 Tab - 当前设备采购记录与只读详情。 - 支持按当前设备的采购任务编号搜索；示例 `12`、`CG-12`，字母大小写不敏感。只匹配采购任务编号，不搜索蝦皮订单号、PDD 订单号、商品或其他字段。 - 搜索忽略首尾空格；带或不带 `CG-` 均可。搜索条件与状态筛选同时生效，清空后恢复默认最近 30 天记录。 - 搜索无结果时显示具体查询值和“清空搜索”，不与普通空状态混用。 - 展示任务、蝦皮订单号、目标规格数量、价格、状态、PDD 订单号和下单时间、错误。 - 不提供重新采购、取消订单、修改订单或支付入口。 ### 设置 Tab #### 连接设置 - 显示并允许编辑服务器地址。 - 地址支持合法的 HTTP/HTTPS URL；输入错误时在字段附近显示普通用户能理解的提示。 - 提供“测试连接”，明确显示测试中、连接成功和失败原因。 - 提供“保存并重新连接”；保存成功后按现有设备身份流程重新连接服务端。 - 设备执行采集或采购任务期间禁止修改服务器地址，并说明“任务执行中，暂时不能修改服务器”。 #### 设备与诊断 - 设备名称允许编辑，供管理端识别。 - installId 只读显示。 - Device Token 只显示“已配置/未配置”，不显示明文，也不提供普通编辑。 - 显示注册状态、Agent 版本、服务端连接状态。 - 显示“保持屏幕常亮”状态。 - 显示无障碍状态和“打开无障碍设置”；状态页仍保留异常提醒。 #### 第一阶段非目标 - 15 秒自动返回保持固定规则，不做可调参数。 - 不保存或展示 PDD 账号密码。 - 不增加自动支付或任何支付入口。 - 不在 Agent 提供采购订单写操作。 ## 交互与可访问性 - 底部导航固定为状态、采集、采购、设置，图标与文字同时存在；设置为第四项。 - 触控区域至少 48dp；状态不能只靠颜色。 - 列表详情返回后保持原 Tab 和滚动位置。 - 覆盖正常、空、加载、失败、禁用和权限/安全边界。 - 设置保存、测试连接需要加载、成功和失败反馈；异步期间按钮禁用，避免重复提交。 - 采集与采购搜索框使用可见标签/提示、至少 48dp 高的输入和搜索按钮；搜索期间提供加载反馈，结果页保留当前 Tab 与状态筛选。 - 修改服务器地址导致重新连接前给出明确说明。 - 小屏不横向滚动，底栏避开系统手势区域。 ## 设计证据门禁 - QuantUX App ID、线上链接和覆盖范围写回本工单。 - 已有 v1：QuantUX App ID `6a8d4607191a826306a7efec`；Git 快照 `prototypes/87/v1/index.html`；提交 `7f7336e`。该版本只作历史证据。 - v2：同一 QuantUX App；Git 快照 `prototypes/87/v2/index.html`；提交 `46ab5bf`。该版本只作历史证据。 - 根据新增任务编号搜索制作 v3；完整后导出到 `prototypes/87/v3/index.html`，资源使用相对路径或单文件自包含。 - 导出后验证四个 Tab、采集/采购编号搜索的结果与无结果状态、筛选组合、设置保存/测试/禁用状态及原有主要点击流程。 - 用户明确审核 v3 通过前，#88～#92 不得编写生产代码。 ## 验收标准 - [ ] 四个 Tab 和主要详情可点击。 - [ ] 无障碍状态与打开设置入口清楚，状态页与设置页职责明确。 - [ ] 自动返回倒计时及取消状态清楚。 - [ ] 采集结果与重新采集确认流程清楚。 - [ ] Agent 采集 Tab 可按当前设备的采集任务编号搜索，展示命中与无结果状态，并可清空搜索。 - [ ] Agent 采购 Tab 可按当前设备的采购任务编号搜索，展示命中与无结果状态，并可清空搜索。 - [ ] 任务编号搜索与状态筛选组合生效，不扩展到商品编号、蝦皮订单号或 PDD 订单号。 - [ ] 采购详情无任何订单写操作或支付入口。 - [ ] 设置页可查看和编辑服务器地址、测试连接、保存并重新连接。 - [ ] 任务执行中服务器地址编辑与保存明确禁用。 - [ ] installId、Token 状态、注册状态、Agent 版本和屏幕常亮状态表达清楚。 - [ ] Token 不显示明文；PDD 账号与支付能力不进入设置页。 - [ ] v3 HTML 快照本地可离线浏览并通过交互校验。 - [ ] 用户明确审核 v3 通过。 ## 文档影响 原型证据只写工单和 Git 路径；本工单阶段不改变长期业务事实。后续生产实现若改变 Agent 配置、接口或安全边界，由对应实施工单更新长期 Wiki。
ila commented 2026-08-25 15:45:19 +08:00
Author
Owner
Copy Link
Copy Source

v1 原型已完成，等待用户审核

覆盖范围

  • 状态 Tab：设备在线/空闲、当前任务、心跳、诊断信息。
  • 无障碍三态：已开启并就绪、已开启等待连接、未开启；包含打开设置入口和任务暂停说明。
  • 任务完成后 15 秒自动返回提示及“留在当前页面”。
  • 采集 Tab：正常列表、加载、空数据、加载失败、部分完成详情、失败详情。
  • 重新采集：终态任务进入二次确认；明确清除旧结果、提交服务端校验并重新排队，不绕过任务租约流程。
  • 采购 Tab：正常列表、订单已创建详情、采购失败详情；全部只读，无重新采购、取消、修改或支付入口。
  • 底部三项导航、状态文字与标签、48dp 级触控区域及底部安全区。

验证

  • QuantUX 导出一致性：PASS。
  • 模型：14 个画面、293 个组件、106 条有效连线；无运行错误、无不支持组件。
  • 本地单文件：156895 bytes，包含离线模型、全部关键画面和安全边界文案；静态完整性检查全部通过。
  • 当前会话没有可用浏览器实例，因此未执行额外的可视化手工点击；QuantUX 导出器的导航与运行时自动校验已通过。

文档影响

无长期文档影响：本工单只新增版本化设计证据，不改变已确认业务、接口、状态或安全规则，因此跳过 Wiki 更新与同步。

状态：等待用户审核。用户明确审核通过前，不实施 #88～#92 的生产代码。

## v1 原型已完成，等待用户审核 - QuantUX App ID：`6a8d4607191a826306a7efec` - 线上原型：https://qux.ilapage.cn/#/apps/6a8d4607191a826306a7efec.html - 本地 HTML：`prototypes/87/v1/index.html` - Git 提交：`7f7336e` ### 覆盖范围 - 状态 Tab：设备在线/空闲、当前任务、心跳、诊断信息。 - 无障碍三态：已开启并就绪、已开启等待连接、未开启；包含打开设置入口和任务暂停说明。 - 任务完成后 15 秒自动返回提示及“留在当前页面”。 - 采集 Tab：正常列表、加载、空数据、加载失败、部分完成详情、失败详情。 - 重新采集：终态任务进入二次确认；明确清除旧结果、提交服务端校验并重新排队，不绕过任务租约流程。 - 采购 Tab：正常列表、订单已创建详情、采购失败详情；全部只读，无重新采购、取消、修改或支付入口。 - 底部三项导航、状态文字与标签、48dp 级触控区域及底部安全区。 ### 验证 - QuantUX 导出一致性：`PASS`。 - 模型：14 个画面、293 个组件、106 条有效连线；无运行错误、无不支持组件。 - 本地单文件：156895 bytes，包含离线模型、全部关键画面和安全边界文案；静态完整性检查全部通过。 - 当前会话没有可用浏览器实例，因此未执行额外的可视化手工点击；QuantUX 导出器的导航与运行时自动校验已通过。 ### 文档影响 无长期文档影响：本工单只新增版本化设计证据，不改变已确认业务、接口、状态或安全规则，因此跳过 Wiki 更新与同步。 状态：等待用户审核。用户明确审核通过前，不实施 #88～#92 的生产代码。
ila changed title from Android Agent 三 Tab 任务中心交互原型 to Android Agent 四 Tab 任务中心交互原型 2026-08-25 15:52:19 +08:00
ila commented 2026-08-25 16:07:58 +08:00
Author
Owner
Copy Link
Copy Source

v2 四 Tab 原型已完成，等待用户审核

本次更新

  • 全部页面底部导航由状态、采集、采购三项统一为状态、采集、采购、设置四项。
  • 设置首页：服务器地址、设备名称、测试连接、保存并重新连接。
  • 连接测试：测试中、成功、失败及字段旁可读错误。
  • 保存流程：重新连接影响说明、当前/新地址确认、保存成功和注册/连接结果。
  • 任务执行中：服务器字段、测试和保存均显示禁用，并说明等待当前任务完成。
  • 设备诊断：注册状态、installId、Token 配置状态、Agent 版本、保持屏幕常亮、无障碍状态和设置入口。
  • Token 不显示明文；未增加 PDD 账号密码、订单写操作或支付入口。

验证

  • QuantUX 导出校验：PASS。
  • 模型：21 个画面、473 个组件、203 条连线。
  • 组件：Box、Label、Button、Icon、TextBox、Switch 全部受支持；无运行错误。
  • v2 单文件：233813 bytes；21 个画面、四 Tab、连接三态、保存重连、任务中禁用和安全文案的静态完整性检查全部通过。
  • 当前本地浏览器连接不可用，未补充浏览器人工点击；QuantUX 自带运行时和导航验证已通过。

文档影响

本次仍只更新设计证据，不改变长期产品、接口或安全事实，因此跳过 Wiki 更新与同步。

状态：等待用户审核 v2；未编写 Android 生产代码。

## v2 四 Tab 原型已完成，等待用户审核 - QuantUX App ID：`6a8d4607191a826306a7efec` - 线上原型：https://qux.ilapage.cn/#/apps/6a8d4607191a826306a7efec.html - v2 本地 HTML：`prototypes/87/v2/index.html` - v1 保留：`prototypes/87/v1/index.html`（未覆盖） - Git 提交：`46ab5bf` ### 本次更新 - 全部页面底部导航由状态、采集、采购三项统一为状态、采集、采购、设置四项。 - 设置首页：服务器地址、设备名称、测试连接、保存并重新连接。 - 连接测试：测试中、成功、失败及字段旁可读错误。 - 保存流程：重新连接影响说明、当前/新地址确认、保存成功和注册/连接结果。 - 任务执行中：服务器字段、测试和保存均显示禁用，并说明等待当前任务完成。 - 设备诊断：注册状态、installId、Token 配置状态、Agent 版本、保持屏幕常亮、无障碍状态和设置入口。 - Token 不显示明文；未增加 PDD 账号密码、订单写操作或支付入口。 ### 验证 - QuantUX 导出校验：`PASS`。 - 模型：21 个画面、473 个组件、203 条连线。 - 组件：Box、Label、Button、Icon、TextBox、Switch 全部受支持；无运行错误。 - v2 单文件：233813 bytes；21 个画面、四 Tab、连接三态、保存重连、任务中禁用和安全文案的静态完整性检查全部通过。 - 当前本地浏览器连接不可用，未补充浏览器人工点击；QuantUX 自带运行时和导航验证已通过。 ### 文档影响 本次仍只更新设计证据，不改变长期产品、接口或安全事实，因此跳过 Wiki 更新与同步。 状态：等待用户审核 v2；未编写 Android 生产代码。
ila commented 2026-08-25 16:17:48 +08:00
Author
Owner
Copy Link
Copy Source

v3 原型待审核（Agent 任务编号搜索）

已按补充需求更新 #87 QuantUX 原型，仅更新设计证据，尚未开始 Android 生产代码。

设计证据

v3 新增范围

  • 采集记录支持按当前设备的采集任务编号搜索，示例：35、#35。
  • 采购记录支持按当前设备的采购任务编号搜索，示例：12、CG-12；前缀不区分大小写。
  • 自动去除输入首尾空格；编号前缀可省略。
  • 编号搜索与状态筛选按“同时满足”生效。
  • 清空搜索恢复当前设备最近 30 天记录。
  • 分别补齐采集/采购的搜索中、命中结果、无结果状态。
  • 不搜索蝦皮订单号、PDD 订单号或其他业务字段。

校验

  • QuantUX：27 个页面、621 个组件、269 条交互线。
  • quantux_verify_export：PASS，runtimeErrors=0，unsupportedTypes=0。
  • 导出文件：301919 bytes；必要文案与任务编号搜索状态检查通过。
  • 浏览器自动化环境此前已确认缺少可信原生桥接，本次未重复无效检查；QuantUX 导出器的运行时一致性校验已通过。
  • 无长期 Wiki 事实变化：本次是待审核设计稿，因此跳过 Wiki 更新与同步。

请审核 v3。审核通过前不实施 #88～#92 的 Android 生产代码。

## v3 原型待审核（Agent 任务编号搜索） 已按补充需求更新 #87 QuantUX 原型，仅更新设计证据，尚未开始 Android 生产代码。 ### 设计证据 - QuantUX App：`6a8d4607191a826306a7efec` - 在线原型：https://qux.ilapage.cn/#/apps/6a8d4607191a826306a7efec.html - 本地 HTML：`prototypes/87/v3/index.html` - Git 提交：`91c0b64` - v1/v2 保持原样，未覆盖。 ### v3 新增范围 - 采集记录支持按当前设备的采集任务编号搜索，示例：`35`、`#35`。 - 采购记录支持按当前设备的采购任务编号搜索，示例：`12`、`CG-12`；前缀不区分大小写。 - 自动去除输入首尾空格；编号前缀可省略。 - 编号搜索与状态筛选按“同时满足”生效。 - 清空搜索恢复当前设备最近 30 天记录。 - 分别补齐采集/采购的搜索中、命中结果、无结果状态。 - 不搜索蝦皮订单号、PDD 订单号或其他业务字段。 ### 校验 - QuantUX：27 个页面、621 个组件、269 条交互线。 - `quantux_verify_export`：PASS，runtimeErrors=0，unsupportedTypes=0。 - 导出文件：301919 bytes；必要文案与任务编号搜索状态检查通过。 - 浏览器自动化环境此前已确认缺少可信原生桥接，本次未重复无效检查；QuantUX 导出器的运行时一致性校验已通过。 - 无长期 Wiki 事实变化：本次是待审核设计稿，因此跳过 Wiki 更新与同步。 请审核 v3。审核通过前不实施 #88～#92 的 Android 生产代码。
ila commented 2026-08-25 16:25:45 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-25 明确确认 v3 原型通过审核。设计证据为 prototypes/87/v3/index.html，提交 91c0b64。本设计工单验收通过并关闭；#88～#92 的生产实施门禁解除，后续仍按各单元工单依赖顺序执行。

用户于 2026-08-25 明确确认 v3 原型通过审核。设计证据为 `prototypes/87/v3/index.html`，提交 `91c0b64`。本设计工单验收通过并关闭；#88～#92 的生产实施门禁解除，后续仍按各单元工单依赖顺序执行。
ila closed this issue 2026-08-25 16:25:45 +08:00
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#87