8.0 KiB
id, title, phase, deps, status, created, vikunja_task_id, context_ref, work_branch, needs_device, needs_human_review, write_paths
| id | title | phase | deps | status | created | vikunja_task_id | context_ref | work_branch | needs_device | needs_human_review | write_paths | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| T-105 | 数量设置、读回与闸门二 | 1 |
|
DOING | 2026-08-04 | 40 | 67b4278 |
task/t-105-quantity-gate2 | true | true |
|
问题 / 背景
T-104 将把规格选择、闸门一读价、原始截图和安全退出固化为受控能力。T-105 先对当前真机数量控件和读回位置取证，再实现规格面板内的数量设置、精确读回与闸门二；不进入确认页、不接触最终提交。
关联需求与交互
- 功能：F-010、F-015。
- 用户故事：US-004、US-005。
- 依赖：T-104；T-103 由其传递满足。
- 后续消费者：T-106、T-305。
- 本任务需要真机与人工证据确认。
方案
- 阶段一只读取证：人分别准备初始数量与目标数量状态，脚本只采集 screenshot/XML/App/设备摘要；记录 PDD 版本、goods_id、规格、目标数量、路径和 hash。人工确认数量控件、读回位置和页面对应性前，不写点击判据。
- 阶段二从本项目证据提取最小 fixture，固化数量显示、增减控件、选中规格和价格节点的精确唯一结构；版本/包/面板/规格/控件任一失配都零点击。
- QuantityGate2Flow 接受 T-104 Gate1Observation、目标数量和最高总价。数量必须为服务端任务正整数，不接受浮点、字符串猜测或超上限值。
- 每次数量修改只点击证据证明的唯一控件一次，并等待明确后置条件；超时或结果不明不得重试该次点击。达到目标前每一步都重新定位和读回，不使用裸坐标或缓存节点。
- 闸门二重新读取颜色、尺码、数量和规格面板单价；颜色/尺码必须等于目标，数量精确等于请求，gate2 单价逐字规范化后等于 gate1 单价，并用十进制运算确认单价×数量不超最高总价。
- 成功结果是不可变 Gate2Observation，包含请求/实际规格、quantity_read、gate1/gate2_unit_price、max_total_price、规格面板原始 screenshot_path 与 UTC captured_at。
- 失败、价格不可读/多候选、规格漂移、数量不符或超价都安全停止并使用 T-104 一次性安全退出；Back 结果不明不重试。
- 能力与 T-103/T-104 分层：T-103 不能反向导入本任务；本任务不暴露确认页导航、通用 click、最终提交控件、围栏或付款能力。
验收要点
- 先证据后实现，执行记录包含两态截图/XML/hash、版本、设备、goods_id 与人工确认。
- 离线覆盖数量边界、每步单击一次、后置条件、超时不重试、节点缺失/重复、SystemUI/锁屏/版本漂移。
- 覆盖闸门二规格不变、价格严格相等、Decimal 总价、数量读回及所有失败分支零确认页动作。
- 静态证明 T-103 不导入数量，本任务不可达确认页、围栏、submit_order_once 或付款。
- 真机人工确认目标数量、规格、两次价格、截图、一次安全退出，且未进入确认/提交/支付页、未创建订单。
- client 全量 unittest、compileall、完整 init、上下文校验、Vikunja 导出与 diff-check 通过；agent 保持 DOING 等人工验收。
执行记录
2026-08-04T13:58:34Z · ila
2026-08-04 预研定值：T-105 依赖 T-104 的一次安全退出，严格分“数量两态只读取证”和“人工确认后实现”两个门禁；闸门二输出显式 screenshot_path/captured_at，且不可达确认页、提交或付款。
2026-08-05T09:58:46Z · ila
2026-08-05 T-104 已在 git/线上完成，T-105 依赖解除，现由 root 领取；领取基线 67b4278，沿用工作路径 task/t-105-quantity-gate2。
严格按两阶段门禁：
- 先实现只读
quantity_gate2_spike.py与 CLI，只接受显式 serial、goods_id、human-declared state/quantity 和全新 output-dir；核验 PKG110/Android16/PDD8.17.0/PDD 前台/1080x2376 后，仅采 screenshot/XML/App/设备摘要并原子发布。不得 intent、页面 click、坐标、数量修改、Back、确认、提交或支付。 - 项目所有者分别把目标商品规格面板停在黑色CHA(纯棉)+M(建议100-115)+数量1，以及相同规格+数量2；各运行一次只读取证并人工确认控件、读回、价格、规格和页面对应性。
- 只有两态人验后才从本项目 raw 提取最小 fixture，实现逐步单击一次、每步 fresh 定位/readback、Gate2 Decimal 总价和 T-104 一次性安全退出。任一失败不进入确认页。
写路径严格限于 T-105 frontmatter；共享 current-state 由 root 合入。needs_device/needs_human_review 保持，未完成人工验收前不得 DONE。
2026-08-05T10:08:24Z · ila
2026-08-05 T-105 阶段一只读取证代码完成并推送，代码 commit 994b6c8。新增 quantity_gate2_spike.py 与 CLI：只接受显式 serial、固定 goods_id 937122477375、人工声明 initial=1 / target=2 和全新目录；每次重新核验 PKG110 / Android 16 / PDD 8.17.0 / PDD 前台 / 1080×2376，只调用 takeScreenshot 与 dumpWindowHierarchy，保存 screenshot/XML/App 摘要/manifest，前后台或版本漂移不发布。接口与静态测试证明无 intent、click、swipe、Back、数量修改、确认、提交或支付能力。专项 13/13、客户端全量 311/311、compileall、agent-context、完整 init.ps1 均通过。下一步必须由人分别准备同一商品、黑色CHA(纯棉)+M(建议100-115) 的数量 1 和数量 2 两态并运行只读取证；两态人工确认前不实现数量点击、readback 或 Gate2 判据。任务保持 DOING。
边界
- 必须先由人在拼多多 8.17.0 的目标规格面板分别准备初始数量与目标数量状态，只读采集并人工确认 screenshot/XML/版本/goods_id/规格/数量的对应性，之后才允许从本项目证据编写数量判据和点击代码。 不得从前序项目、旧 XML、控件常识、OCR、裸坐标或推理直接实现。
- 数量控件、读回位置、规格选中态和两次价格都必须证据绑定且精确唯一。每次修改数量最多点击已批准 控件一次并等待明确后置条件；超时或结果不明不得重试同一次点击，不得缓存节点跨状态继续操作。
- 闸门二必须重新核对颜色/尺码未漂移、数量精确等于任务、gate2 单价严格等于 gate1 单价，并以 十进制运算验证单价乘数量不超最高总价。价格只从规格面板读取，不用详情页或其他数字兜底。
- 只有规格、数量、价格、总价上限和原始截图全部通过后才返回不可变 Gate2Observation；它必须显式
携带
screenshot_path与 UTCcaptured_at，不得让后续任务枚举目录或读取 manifest 猜证据。 - 任一判据失败、规格漂移、数量不符、价格不可读/多候选/变化或超价都停止前进，只能调用 T-104 已验证的一次性安全退出；Back 超时或结果不明不重试，不把“面板消失”当作退出成功。
- T-103/T-104 不得反向导入本任务。本任务不进入确认页、不观察或获取最终提交控件，不实现通用 click、 事件、证据上传、围栏或结果接口；不编写或引用点击“提交订单”的代码，不编写任何付款能力。
needs_device: true：agent 完成离线实现后仍保持 DOING。只有人确认真机数量、规格、两次价格、 截图和安全退出，且未进入确认/提交/支付页、未创建订单，才可完成任务。