one-pipe-system/openspec/changes/update-agent-registration-and-voucher-recognition/tasks.md

1. 代理注册页表单调整

• 1.1 店铺名称改为注册者自行填写，移除从 URL 带入与锁定逻辑（src/views/agent-registration/index.vue）
• 1.2 店铺编号由前端生成后提交为 shop_code，移除 URL 带入、锁定与输入框
• 1.3 用户名增加「长度必须大于 2 个字符」校验规则与提示
• 1.4 店铺详情页注册二维码 URL 移除 shop_name、shop_code 查询参数（src/views/shop-management/detail/index.vue）

2. 代理注册页缺陷修复

• 2.1 修复未登录访问注册页被跳转登录页：存储兼容性检查排除免登录路由（src/utils/storage/storage.ts）
• 2.2 修复 H5 页面溢出后无法纵向滚动（src/views/agent-registration/index.vue / src/assets/styles/app.scss）

3. 核销申请付款凭证识别

• 3.1 将付款凭证字段移动到外部交易流水号字段上方（ApplicationFormDialog.vue）
• 3.2 新增付款凭证「识别凭证」按钮与 OCR 调用，复用 POST /api/admin/agent-recharges/payment-voucher-ocr
• 3.3 付款凭证上传成功后自动识别一次，保留手动识别
• 3.4 识别期间展示 loading，失败只提示且不清空已填内容、不阻断提交

4. 线下代充上传后自动识别

• 4.1 支付凭证上传成功后自动触发一次识别，保留手动「识别凭证」按钮（src/views/finance/agent-recharge/index.vue）

5. 验证

• 5.1 运行 eslint、vue-tsc --noEmit、vite build --mode production 均通过
• 5.2 运行 openspec validate update-agent-registration-and-voucher-recognition --strict 通过