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

Android Agent 采集/采购搜索框增加快速清除入口 #93

New Issue
Closed
opened 2026-08-26 11:09:25 +08:00 by ila · 4 comments
ila commented 2026-08-26 11:09:25 +08:00
Owner
Copy Link
Copy Source

原始需求摘要

用户于 2026-08-26 验收 #91 后提出：Agent 的采集 Tab 和采购 Tab 搜索框清空内容目前需要逐字删除，希望在输入框内增加 × 快速清除入口，并要求创建小型优化工单后直接实施。

目标

降低设备操作人员重复搜索任务编号时的操作成本，同时保持当前紧凑搜索布局和两类任务的一致体验。

做什么

  • 采集 Tab 与采购 Tab 共用的搜索框右侧增加输入框内清除图标。
  • 输入为空时隐藏清除图标；有内容时显示。
  • 点击清除后清空输入、清除输入校验错误、回到第 1 页并立即加载当前设备全部任务。
  • 保持现有“搜索”按钮、编号规范化、状态筛选、任务详情和分页行为。
  • 清除图标使用 Material 原生控件语义，视觉图标约 24dp，实际触控区域至少 48dp，并提供“清除采集任务编号”或“清除采购任务编号”的无障碍说明。

不做什么

  • 不修改服务端接口、数据库、任务状态或权限。
  • 不增加搜索历史、联想、模糊搜索或新的筛选条件。
  • 不改变采购、创建订单或支付能力。

设计证据

  • 沿用已确认的 #87 v3 原型页面结构：prototypes/87/v3/index.html，仅优化既有搜索输入框内部操作。
  • 用户已明确确认采集/采购两个 Tab 均采用输入框内 ×，无需新增页面或重大交互原型。
  • UI/UX 检查：平台原生图标语义、仅非空时显示、Android 触控区域至少 48dp、明确 contentDescription、按压反馈且不引发布局位移。
  • 属于现有界面小范围交互优化，以上明确标注规范作为本工单设计证据，不生成新的 QuantUX/HTML 版本。

验收

  • 两个 Tab 输入为空时均不显示清除入口。
  • 输入任意内容后均显示清除入口。
  • 点击后内容和校验错误清空，并立即恢复全部任务第一页。
  • 清除图标点击区域、按压反馈和无障碍说明符合上述设计证据。
  • 原有搜索、状态筛选、详情、分页及重新采集无回归。
  • Android 单元测试和 APK 构建通过。

验证

  • Android 搜索交互单元测试。
  • ./scripts/verify.ps1 -Component android。
  • 小屏布局/无障碍属性检查；真机安装只在设备在线时执行。

风险

低风险 Android UI 变更。主要风险是清除图标挤压输入文字、清除后重复发起加载或无障碍无法识别；通过原生 Material 组件和状态测试约束。

文档影响

无长期文档影响：不改变接口、数据、状态、权限、业务规则、部署或运维方式，仅改善已有输入框操作。

## 原始需求摘要 用户于 2026-08-26 验收 #91 后提出：Agent 的采集 Tab 和采购 Tab 搜索框清空内容目前需要逐字删除，希望在输入框内增加 `×` 快速清除入口，并要求创建小型优化工单后直接实施。 ## 目标 降低设备操作人员重复搜索任务编号时的操作成本，同时保持当前紧凑搜索布局和两类任务的一致体验。 ## 做什么 - 采集 Tab 与采购 Tab 共用的搜索框右侧增加输入框内清除图标。 - 输入为空时隐藏清除图标；有内容时显示。 - 点击清除后清空输入、清除输入校验错误、回到第 1 页并立即加载当前设备全部任务。 - 保持现有“搜索”按钮、编号规范化、状态筛选、任务详情和分页行为。 - 清除图标使用 Material 原生控件语义，视觉图标约 24dp，实际触控区域至少 48dp，并提供“清除采集任务编号”或“清除采购任务编号”的无障碍说明。 ## 不做什么 - 不修改服务端接口、数据库、任务状态或权限。 - 不增加搜索历史、联想、模糊搜索或新的筛选条件。 - 不改变采购、创建订单或支付能力。 ## 设计证据 - 沿用已确认的 #87 v3 原型页面结构：`prototypes/87/v3/index.html`，仅优化既有搜索输入框内部操作。 - 用户已明确确认采集/采购两个 Tab 均采用输入框内 `×`，无需新增页面或重大交互原型。 - UI/UX 检查：平台原生图标语义、仅非空时显示、Android 触控区域至少 48dp、明确 contentDescription、按压反馈且不引发布局位移。 - 属于现有界面小范围交互优化，以上明确标注规范作为本工单设计证据，不生成新的 QuantUX/HTML 版本。 ## 验收 - [ ] 两个 Tab 输入为空时均不显示清除入口。 - [ ] 输入任意内容后均显示清除入口。 - [ ] 点击后内容和校验错误清空，并立即恢复全部任务第一页。 - [ ] 清除图标点击区域、按压反馈和无障碍说明符合上述设计证据。 - [ ] 原有搜索、状态筛选、详情、分页及重新采集无回归。 - [ ] Android 单元测试和 APK 构建通过。 ## 验证 - Android 搜索交互单元测试。 - `./scripts/verify.ps1 -Component android`。 - 小屏布局/无障碍属性检查；真机安装只在设备在线时执行。 ## 风险 低风险 Android UI 变更。主要风险是清除图标挤压输入文字、清除后重复发起加载或无障碍无法识别；通过原生 Material 组件和状态测试约束。 ## 文档影响 无长期文档影响：不改变接口、数据、状态、权限、业务规则、部署或运维方式，仅改善已有输入框操作。
ila commented 2026-08-26 11:10:21 +08:00
Author
Owner
Copy Link
Copy Source

开始实施。依赖 #87/#90 已满足，#91 已验收。实现仅修改 Android 共用任务历史搜索组件及测试/矢量图标；采集与采购 Tab 同时生效。设计按工单约束使用输入框内原生 Material end icon、24dp 图标/至少 48dp 触控区域、非空显示、明确无障碍说明；无服务端、数据库、权限、采购或支付变化。

开始实施。依赖 #87/#90 已满足，#91 已验收。实现仅修改 Android 共用任务历史搜索组件及测试/矢量图标；采集与采购 Tab 同时生效。设计按工单约束使用输入框内原生 Material end icon、24dp 图标/至少 48dp 触控区域、非空显示、明确无障碍说明；无服务端、数据库、权限、采购或支付变化。
ila commented 2026-08-26 11:12:55 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，待验收

实现

  • 采集/采购 Tab 共用搜索输入框增加 Material 输入框内 × 清除图标。
  • 输入为空隐藏，输入非空显示；点击后清除输入校验错误、回到第 1 页并立即加载全部记录。
  • 分别设置“清除采集任务编号”“清除采购任务编号”无障碍说明；24dp 矢量图标由 Material end icon 提供原生按压反馈和至少 48dp 触控区域。
  • 保留原有搜索按钮、编号规范化、筛选、详情、分页和重新采集行为。
  • Agent 版本更新为 0.5.1（versionCode 8）。

验证

  • ./scripts/verify.ps1 -Component android：通过（Debug/Release 单元测试及 Debug APK 构建）。
  • python dev_scripts/harness.py check --strict：通过。
  • git diff --check：通过。
  • 新增清除图标显隐策略测试，覆盖空值、采集编号和采购编号。
  • APK：android/app/build/outputs/apk/debug/app-debug.apk。
  • 当前 adb devices 无在线设备，未执行真机安装和小屏视觉验收；需设备重新连接后安装确认。

提交

  • 147c66a feat(agent): add #93 search clear action
  • 已推送 main。

文档影响

无长期文档影响：接口、数据、状态、权限、业务规则、部署和运维方式均未改变，因此按工单约定跳过 Wiki 更新与同步。

工单保持打开，等待用户验收。

## 实施完成，待验收 ### 实现 - 采集/采购 Tab 共用搜索输入框增加 Material 输入框内 `×` 清除图标。 - 输入为空隐藏，输入非空显示；点击后清除输入校验错误、回到第 1 页并立即加载全部记录。 - 分别设置“清除采集任务编号”“清除采购任务编号”无障碍说明；24dp 矢量图标由 Material end icon 提供原生按压反馈和至少 48dp 触控区域。 - 保留原有搜索按钮、编号规范化、筛选、详情、分页和重新采集行为。 - Agent 版本更新为 `0.5.1`（versionCode 8）。 ### 验证 - `./scripts/verify.ps1 -Component android`：通过（Debug/Release 单元测试及 Debug APK 构建）。 - `python dev_scripts/harness.py check --strict`：通过。 - `git diff --check`：通过。 - 新增清除图标显隐策略测试，覆盖空值、采集编号和采购编号。 - APK：`android/app/build/outputs/apk/debug/app-debug.apk`。 - 当前 `adb devices` 无在线设备，未执行真机安装和小屏视觉验收；需设备重新连接后安装确认。 ### 提交 - `147c66a feat(agent): add #93 search clear action` - 已推送 `main`。 ### 文档影响 无长期文档影响：接口、数据、状态、权限、业务规则、部署和运维方式均未改变，因此按工单约定跳过 Wiki 更新与同步。 工单保持打开，等待用户验收。
ila commented 2026-08-26 11:17:51 +08:00
Author
Owner
Copy Link
Copy Source

三星真机补充验证

  • 已安装正式 Debug APK，设备报告 versionName=0.5.1、versionCode=8。
  • Agent 正常前台启动；GoAuto 无障碍服务保持 enabled + bound，crashed 为空。
  • 采集 Tab：空输入时清除图标隐藏，输入任务编号后显示；点击 × 后输入清空、图标隐藏并恢复全部记录。
  • 采购 Tab：同样完成非空显示和点击清除后隐藏验证。
  • 验证过程只读取任务历史，没有发起采集、采购、创建订单或支付。

#93 当前已具备真机验收条件，继续保持打开，等待用户明确验收通过。

### 三星真机补充验证 - 已安装正式 Debug APK，设备报告 `versionName=0.5.1`、`versionCode=8`。 - Agent 正常前台启动；GoAuto 无障碍服务保持 enabled + bound，crashed 为空。 - 采集 Tab：空输入时清除图标隐藏，输入任务编号后显示；点击 `×` 后输入清空、图标隐藏并恢复全部记录。 - 采购 Tab：同样完成非空显示和点击清除后隐藏验证。 - 验证过程只读取任务历史，没有发起采集、采购、创建订单或支付。 #93 当前已具备真机验收条件，继续保持打开，等待用户明确验收通过。
ila commented 2026-08-28 15:07:20 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。

用户于 2026-08-28 明确确认本工单验收通过。按项目流程记录验收结论并关闭工单；本次仅更新工单状态，无新增长期文档事实，不重复同步 Wiki。
ila closed this issue 2026-08-28 15:07:23 +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#93