feat(agent): implement #90 task history

docs/02-architecture-and-code-map.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Architecture-and-Code-Map
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Architecture-and-Code-Map.-
-wiki_revision: 1c9841a942b5d5682ddada2ee7202e93adc422e4
-synchronized_at: 2026-08-25T09:44:21Z
+wiki_revision: 3b7a0cad581f615124aeeee8f8d3baf83e1dca28
+synchronized_at: 2026-08-26T01:17:16Z
 <!-- gitea-wiki-mirror:end -->
 
 # 架构与代码地图
@@ -166,3 +166,10 @@ Android Portal/Agent
 - `IdleReturnCoordinator` 只保存冷却时间、自动化前台包名与无障碍前台切换序号，不保存控件树或截图。用户切换到其他 App 后，即使又返回 PDD，也不会被强制拉回 Agent。
 - 返回请求只允许从 Agent 本次自动化停留的 PDD 或受支持浏览器页面发起，并由无障碍服务打开 `MainActivity` 状态 Tab；Android 后台 Activity 启动限制导致失败时只提示手动打开，不重复强拉。
 - 任务执行和冷却分别使用带超时的亮屏锁；`MainActivity` 仅在运行态标记要求时设置 `FLAG_KEEP_SCREEN_ON`。任务、新任务接管、取消、返回或服务销毁后统一释放，不绕过设备 PIN、图案或密码。
+
+## Agent 任务历史（#90）
+
+- Android 的采集任务与采购任务 Tab 由 `TaskHistoryFragment` 承载，复用搜索、状态筛选、分页、加载/空/失败状态和只读详情能力。
+- `AgentApiClient` 调用服务端当前设备历史接口；任务编号规范化由客户端先处理，服务端再次校验。
+- 服务端采集与采购模块各自使用 `agent_history.go` 负责 Device Token 设备隔离、最近 30 天过滤、分页和最小化 DTO。
+- `purchase_task.actual_unit_price_cent` 是可空字段，只记录 Agent 实际观察到的采购单价；旧任务不回填。

docs/03-business-rules-and-glossary.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Business-Rules-and-Glossary
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary.-
-wiki_revision: 6bad462cbf91d592ba95fbe2003402d20a589cc3
-synchronized_at: 2026-08-25T06:21:31Z
+wiki_revision: c956def096806541d5060c771504928d121eb127
+synchronized_at: 2026-08-26T01:17:27Z
 <!-- gitea-wiki-mirror:end -->
 
 # 业务规则与术语
@@ -224,3 +224,10 @@ synchronized_at: 2026-08-25T06:21:31Z
 - 同一颜色只有唯一有效价格时才保存颜色价格；出现多个价格时价格留空、PDD 商品保持 `pending` 并报告，禁止取最低价、最高价或平均价。
 - 蝦皮只聚合来源已解析的颜色和尺码，未解析内容不猜测。来源 PDD 关联不存在、已删除或无法转换时，蝦皮记录作为冲突跳过，不能静默关联其他商品。
 - 默认 dry-run 不写数据库；`--apply` 前必须查看精确影响并再次人工确认。apply 在目标单事务中执行，提交前校验 JSON、唯一键和关联完整性。
+
+## Agent 当前设备历史
+
+- Agent 只可查看当前 Device Token 对应设备最近 30 天的采集和采购任务，不能跨设备查看。
+- 采集历史可以查看结构化采集结果和错误；采购历史可以查看结构化采购数据和错误，但全部为只读。
+- 历史接口遵循数据最小化：不下发 Device Token、规则快照、PDD URL、收货地址、原始控件树或截图。
+- 实际采购单价只在 Agent 确实观察到时保存；旧任务或未观察到价格时显示“未记录”，不推算、不回填。

docs/08-agent-api-contract.md

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Android-Agent-API-Contract
 wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Android-Agent-API-Contract.-
-wiki_revision: e9da6212dd12bf200c9484cf1145bb17a3384b4e
-synchronized_at: 2026-08-23T15:20:49Z
+wiki_revision: 0f83e8f7333f2bec36f7b42f9ab558ec3b1e265e
+synchronized_at: 2026-08-26T01:18:14Z
 <!-- gitea-wiki-mirror:end -->
 
 # MVP 共享 API 契约
@@ -532,3 +532,21 @@ Android #42/#36 使用本地 SQLite 保存恢复与重传所需的任务、attem
 | `PURCHASE_ADDRESS_UPDATE_FAILED` | 收货地址修改失败，未创建订单 |
 | `PURCHASE_ORDER_RESULT_UNKNOWN` | 无法确认订单是否创建，请人工检查 |
 | `PURCHASE_PAYMENT_FORBIDDEN` | 系统禁止自动付款 |
+
+## Agent 当前设备任务历史（#90）
+
+四个只读接口统一使用设备注册所得的 Device Token，只返回该 Token 对应设备最近 30 天内的任务；设备 A 查询设备 B 的任务时按不存在处理，不泄露任务是否存在。
+
+```http
+GET /api/agent/v1/collection-tasks?page=1&pageSize=20&status=failed&taskNo=%2335
+GET /api/agent/v1/collection-tasks/{taskId}
+GET /api/agent/v1/purchase-tasks?page=1&pageSize=20&status=failed&taskNo=CG-12
+GET /api/agent/v1/purchase-tasks/{taskId}
+```
+
+- `pageSize` 最大为 50；`status` 与 `taskNo` 可以组合过滤。
+- 采集任务编号允许 `35` 或 `#35`，采购任务编号允许 `12` 或不区分大小写的 `CG-12`；服务端按精确编号匹配。
+- 列表和详情不返回 Device Token、URL、收货地址、规则快照或原始控件树；采购详情只读，不提供重试、取消、创建订单或支付入口。
+- 采集详情返回标题、店铺、销量、评价数、规格维度、颜色价格、SKU、缺失项和结构化错误。
+- 采购详情返回蝦皮订单号、PDD 商品、已匹配颜色/尺码、数量、实际单价、PDD 订单号、下单时间和结构化错误。
+- Agent 提交采购结果时可携带 `actualUnitPriceCent`（人民币分，非负）。服务端只保存 Agent 实际观察到的值；历史任务或未观察到价格的结果保持 `null`，客户端显示“未记录”。