docs: align Gate2 with quantity total evidence

docs/api.md

@@ -326,17 +326,21 @@ claim/renew 的格式错误固定为 `400 {"error":"invalid_request"}`，超限
   "selected_color": "黑色CHA(纯棉)",
   "selected_size": "M(建议100-115)",
   "gate1_unit_price": "12.88",
-  "gate2_unit_price": "12.88",
+  "gate2_panel_total_price": "32.76",
   "quantity_read": 2,
-  "confirm_page_amount": "25.76",
+  "confirm_page_amount": "32.76",
   "submit_control_match_count": 1
 }
 ```
 
 服务端在一个事务中校验：任务/版本/claim/attempt 一致；授权有效未消费且字段等于任务快照；
-规格与授权相等；数量相等；两个单价相等；计算金额及确认页金额均不超过 `total_price_cap`；提交控件
-计数为一；此前不存在该授权或 attempt 的 submission。随后创建唯一 `order_submission`，授权转
-`FENCED`，任务保持不可重领。
+规格与授权相等；数量相等；闸门一单价预检通过；闸门二目标数量面板总额不超过 `total_price_cap`；
+确认页金额严格等于闸门二面板总额且再次不超过上限；提交控件计数为一；此前不存在该授权或 attempt
+的 submission。随后创建唯一 `order_submission`，授权转 `FENCED`，任务保持不可重领。
+
+`gate2_panel_total_price` 是目标数量下规格面板顶部证据角色的总额，不是单价。拼多多多件优惠可能
+非线性，禁止用 `gate1_unit_price × quantity_read` 推导它，也禁止继续用旧字段名
+`gate2_unit_price` 承载总额。底部“提交订单 ¥...”文字不属于价格来源。
 
 首次明确成功响应：
 
@@ -443,6 +447,7 @@ events/fail/fence/result 或完整 `ResultSink`。T-304/T-306 必须通过 `Dura
 | `select_sku_options()` | 维度 → 精确值 | 选中态摘要 | 维度内唯一匹配并读回 |
 | `read_sku_unit_price()` | 已确认规格面板 | 十进制单价 | 排除原价、按钮价和歧义候选 |
 | `set_quantity_and_readback()` | 授权数量 | 实际数量 | 精确读回，否则停 |
+| `read_sku_panel_total_price()` | 已读回目标数量 | 十进制面板总额 | 只读证据绑定的顶部当前金额；排除底部提交按钮金额和歧义候选 |
 | `go_to_order_confirm()` | 已通过闸门二 | 确认页摘要 | 后续真机任务取证后才实现 |
 | `submit_order_once()` | 不可伪造的首次 `SubmissionPermit` | 观察结果 | 许可、闸门、唯一控件全校验；点前持久化；绝不重试 |