---
id: T-212
title: 修复 Top 5 候选 ordinal 与证据映射
phase: 2
deps:
  - T-211
status: DONE
created: 2026-07-27
context_ref: edfee2c
work_branch: null
write_paths:
  - docs/tasks/T-212.md
  - docs/current-state.md
  - android-buyer/app/src/main/java/com/roubao/autopilot/MainActivity.kt
  - android-buyer/app/src/main/java/com/roubao/autopilot/procurement/**
  - android-buyer/app/src/main/java/com/roubao/autopilot/vlm/**
  - android-buyer/app/src/test/java/com/roubao/autopilot/procurement/**
  - android-buyer/app/src/test/java/com/roubao/autopilot/vlm/**
---

## 问题 / 背景

T-211 对通过 SKU 硬约束的候选重新排序并生成连续回传 ordinal，但人工接受仍使用
VLM 原始候选 ordinal 查找已经重排的 `ExecutionCandidateDraft`。当原始候选 3 得分
最高并被重排为回传候选 1 时，现有查找可能错误选择回传候选 3，导致人工结论与推荐、
截图证据不一致。

## 关联需求与交互

- 功能：F-007、F-008、F-009。
- 用户故事：US-005、US-008。
- 交互：IX-007、IX-009 的建议候选接受、拒绝和结果回传。
- 架构/API：不修改后端 candidate batch schema；修复 Android 本地从原始曝光
  ordinal 到回传 ordinal、证据和人工终态候选的映射。

## 方案

1. 增加纯 Kotlin 的候选重排结果模型，同时保存 `source_ordinal`、连续
   `ranked_ordinal`、评估结果和证据 SHA-256，不再靠两个列表的位置或相同整数隐式关联。
2. 候选批次、推荐项和人工接受结果从同一份重排结果生成。非空批次推荐固定指向排序
   后的候选 1；人工接受候选也必须使用该候选及其同源证据。
3. 拒绝、无匹配和空候选路径不携带候选；不得回退到“找不到就取第一个”掩盖映射错误。
4. 保持 T-211 的 `0..5`、颜色/尺码硬约束、阈值和排序规则不变。

## 验收要点

- [x] 原始候选 3 得分最高时，回传候选 1、推荐项和人工接受终态都引用原候选 3 的证据。
- [x] 过滤后只剩原始候选 2、5 时，回传 ordinal 为 1、2，证据分别保持 2、5 的来源。
- [x] 相同分数按置信度和原始曝光顺序稳定排序，重试不会改变映射。
- [x] 空候选、单候选、拒绝和无匹配路径不产生越界或错误 fallback。
- [x] 后端 schema v2 的推荐首项、连续 ordinal 和证据资产校验继续通过。
- [x] Android 单元测试和 Debug 构建通过；人工接受仍保持
  `order_submitted=false`。

## 边界

- 不改变拼多多页面自动化、VLM prompt 或 SKU 匹配含义。
- 不增加候选数量，不实现 T-208 人工标签数据集。
- 不加入购物车、不选择规格、不提交订单或支付。

## 执行记录

- 2026-07-27：从 T-211 完成后的代码审查登记。先修复结果身份映射，再扩展规格弹窗
  采集，避免把错误候选写入后续优化数据。
- 2026-07-27：基于 `1d9dd08` 领取任务，先建立可单测的显式映射模型，再接入候选
  批次和人工接受路径。
- 2026-07-27：新增 `RankedCandidateAssessment` 和
  `ExecutionCandidateSourceIdentity`，显式保存原始 ordinal、重排 ordinal 和证据
  SHA-256。候选批次、推荐和人工接受均从同一映射生成；删除按原始 ordinal 查找和
  “找不到就取第一个”的 fallback，映射不一致时进入受控证据失败。
- 2026-07-27：新增原候选 3 重排为 1、过滤后原候选 2/5 重排为 1/2、空候选和
  缺失 ordinal 回归测试。`.\gradlew.bat :app:testDebugUnitTest :app:assembleDebug
  --no-daemon` 通过，21 个 suite 共 113 个测试、0 失败；
  `GOTOOLCHAIN=local go test -count=1 ./...` 通过。