feat(t211): return SKU-matched image search candidates

docs/current-state.md

@@ -5,10 +5,9 @@
 ## 当前快照
 
 - 日期：2026-07-27
-- 阶段：T-207 App 本地 VLM、候选、证据和结果回传完成；T-209 登录失败保留输入完成；
-  T-210 拼多多 8.17 结果页兼容完成，下一步 T-208
+- 阶段：T-211 参考图召回、SKU 颜色尺码过滤与 Top 5 回传完成，下一步 T-208
 - Git：当前分支为 `main`；T-001 至 T-004、T-101 至 T-104、T-201 至 T-207、T-209、
-  T-210 均已纳入 Git 历史
+  T-210、T-211 均已纳入 Git 历史
 - 生产代码：`android-buyer/` 已接入 Roubao Android 源码
 - Android：固定 `main@c8a6d7f03422eb01744b01f3ee77bf7757741f7e`；MIT 许可证已保留
 
@@ -18,10 +17,10 @@
 - 本机 Android 工具：JDK 17.0.13、Command-line Tools 22.0、SDK 34、
   Build Tools 34.0.0、Platform Tools/ADB 37.0.0；用户级 SDK 环境变量已设置
 - Android Studio：未安装；`winget` 静默安装卡住后已终止，不阻塞命令行构建
-- 测试：T-207 运行 `:app:testDebugUnitTest` 和 `:app:assembleDebug` 通过；Debug APK
-  已安装并在 PKG110 启动到任务登录页，无 crash/ANR
-- 后端测试：T-207 运行 `GOTOOLCHAIN=local go test -count=1 ./...`、全包 race 和
-  `go vet ./...` 通过；临时 SQLite migration 已验证 `status -> up -> down -> up`
+- 测试：T-211 运行 `:app:testDebugUnitTest` 和 `:app:assembleDebug` 通过，20 个 suite
+  共 108 个测试、0 失败；最新 Debug APK 已安装到 PKG110
+- 后端测试：T-211 运行 `GOTOOLCHAIN=local go test -count=1 ./...` 和
+  `go vet ./...` 通过；T-207 的全包 race 与 migration 验证继续有效
 - 原型：4 个管理 Web 页面和 7 个 Android 页面均可离线独立打开；Playwright
   以 1440×900、390×844、360×800 验证 36 个页面/视口组合，无页面横向溢出、
   脚本错误或外部请求，Android 可见交互控件均不小于 44px
@@ -47,12 +46,17 @@
   失败记录均按 execution 存储；Android 使用加密 outbox 按事件、截图、候选和终态
   顺序回传，授权到期补报单独审计，所有终态固定 `order_submitted=false`。管理任务
   详情展示模型/候选/人工理由/事件/证据摘要，不保存 VLM Key、完整 endpoint 或原始响应。
+- T-211 图片检索：后台任务固定使用经 SHA-256 校验的参考 JPEG，经一次性 MediaStore
+  图片进入拼多多拍照搜索；App 本地从 SKU 唯一提取颜色和尺码，schema v2 逐项返回
+  `MATCH/MISMATCH/UNKNOWN`。只有两项均匹配且分数/置信度不低于 `0.75` 的候选按
+  分数、置信度和曝光顺序回传 `0..5` 项，弱匹配和未知项不凑数。
 - Workflow：纯 Kotlin runner 已支持步骤 timeout、最多 3 次 retry、安全阻塞、
   用户停止和单 runner 并发拒绝；T-102 已接入搜索加有界候选采集五步
 - TaskSource：严格 CLI 已生成并验证真实私有 ProbeTask；默认 APK 不含私有 fixture
 - VLM：需求提取与候选评估均使用严格 schema、0.75 阈值、受控证据源、安全端点和
   单次调用边界；候选最多 5 个并按 ordinal 串行评估，本地产生建议并停在人工确认，
-  SKU/数量由本地原值回填，预算保持空，订单提交状态固定为 false
+  SKU/数量由本地原值回填，颜色/尺码硬约束由本地生成，预算保持空，订单提交状态固定
+  为 false
 - 后置数据闭环：已登记 T-208，在第一版 T-206/T-207 跑通后分离保存候选观测、
   模型预测、确定性推荐和人工标签；人工接受/拒绝使用结构化理由，20 条试验依赖它
 - VLM 部署决策：手机本地调用已配置的 OpenAI 兼容 provider；管理后端只负责身份、
@@ -63,8 +67,9 @@
   RUNNING 不自动重新分配
 - 测试设备：OnePlus PKG110，Android 16/API 36；肉包 `1.4.2 (7)`；拼多多
   `8.17.0 (81700)`
-- 设备就绪：肉包采购无障碍已启用并连接；拼多多首页、搜索输入、固定词结果页、
-  双列候选卡、详情截图和返回均已通过 8.17.0 真机验证
+- 设备就绪：拼多多首页、文字/图片搜索、双列候选卡、详情截图和返回均已通过 8.17.0
+  真机验证；最终 APK 重装/force-stop 后 ColorOS 已关闭肉包采购无障碍，当前需采购员
+  在系统无障碍设置中重新启用，不通过 ADB 绕过系统授权
 - 拼多多 8.17 兼容：结果页可识别新版显示查询词的文本搜索栏和“推荐、手机、女装”等
   分类栏，也保留旧版“综合、销量、价格、筛选”识别；长任务搜索词的拼多多省略显示须
   至少两个按序片段对应原词才通过。每次候选探针会重写本次搜索词，不复用已有结果页。
@@ -101,6 +106,7 @@
 | `docs/tasks/T-207.md` | DONE | App 本地 VLM、Key 加密、候选、事件、截图和结果回传 |
 | `docs/tasks/T-209.md` | DONE | 登录失败保留采购员和设备输入以便直接重试 |
 | `docs/tasks/T-210.md` | DONE | 兼容拼多多 8.17 搜索结果页与长词省略显示 |
+| `docs/tasks/T-211.md` | DONE | 参考图召回、SKU 颜色尺码硬匹配与 0..5 候选回传 |
 | `docs/design/` | 已确认 | T-202 原型索引、4 个管理页和 7 个 Android 页面 |
 | `deepseek总结.txt` | 已有 | 历史讨论摘要，不是正式需求权威 |
 | `android-buyer/` | 已有 | Roubao `main` 固定 commit 的 Android 基线 |
@@ -111,7 +117,7 @@
 
 ## 任务摘要
 
-- 已完成：T-001 至 T-004、T-101 至 T-104、T-201 至 T-207、T-209、T-210。
+- 已完成：T-001 至 T-004、T-101 至 T-104、T-201 至 T-207、T-209、T-210、T-211。
 - 正在进行：无。
 - 下一个可领取任务：T-208 候选决策数据与人工理由闭环。
 - 后置任务：T-208 候选决策数据与人工理由闭环；不得跳过 T-206/T-207 提前实现。
@@ -149,6 +155,13 @@ go run ./cmd/api
 `order_submitted` 始终为 false；日志敏感词、Base64、原始响应和 schema/prompt
 命中均为 0。该结果不代表真实模型的商品匹配质量。
 
+2026-07-27 完成 T-211 真机 smoke：PKG110 上从后台任务下载并校验参考 JPEG，写入
+一次性匿名 MediaStore 图片后进入拼多多拍照搜索并选择该图。App 完成 4 个有界候选
+详情和证据采集并以 `PDD_IMAGE_SEARCH` 回传后台；不足 5 个未凑数，临时图库图片在
+流程结束后删除。验证期间修复相机自动结果页竞态和 MediaStore volume URI 差异；
+测试任务随后取消，全程未进入购物车、订单或支付。真实 VLM provider 尚未参与本次
+smoke，当前结论只覆盖图片召回、严格契约和回传链路。
+
 同日完成 T-201 后端 smoke：本机迁移执行 `status -> up -> up -> down -> up`，
 第二次 `up` 应用数为 0；API 真实进程的 `GET /healthz` 返回 `200` 和稳定 JSON，
 未知路由返回 `404`，错误方法返回 `405`，无默认 CORS，stdout/stderr 均为空。