fix: some

openspec/changes/update-agent-registration-and-voucher-recognition/specs/agent-recharge/spec.md

@@ -0,0 +1,26 @@
+## ADDED Requirements
+
+### Requirement: 线下代充付款凭证上传后自动识别
+
+线下代充弹窗 SHALL 在支付凭证上传成功后自动识别一次交易流水号，同时保留手动「识别凭证」按钮；自动识别失败 MUST NOT 阻断提交，且 MUST 只预填 `external_transaction_no`。
+
+#### Scenario: 上传支付凭证后自动识别
+
+- **GIVEN** 线下代充弹窗已选择支付凭证
+- **WHEN** 凭证上传成功
+- **THEN** 前端 MUST 自动调用 `POST /api/admin/agent-recharges/payment-voucher-ocr`
+- **AND** 识别成功时 MUST 将返回的 `external_transaction_no` 预填入交易流水号输入框
+
+#### Scenario: 保留手动识别
+
+- **GIVEN** 支付凭证已上传
+- **WHEN** 用户点击「识别凭证」
+- **THEN** 前端 MUST 支持手动触发识别
+
+#### Scenario: 自动识别失败不阻断
+
+- **GIVEN** 自动识别返回失败或超时
+- **WHEN** 识别结束
+- **THEN** 前端 MUST NOT 阻断用户手动填写与提交
+- **AND** MUST NOT 清空用户已填写内容
+- **AND** MUST 只预填 `external_transaction_no`，不得预填金额、付款人、付款时间或备注