feat: 顺运宝登录接入验证码自动识别 (#47)
#46 的登录只有手工输验证码一条路,而会话 24 小时就过期——每天第一次 同步都得有人在场,将来也做不了定时同步。 docs/admin/08 §8 当时写死"不引入 OCR 服务",理由是"多一个必须先启动的 东西"。那条判断基于示例脚本里的 http://127.0.0.1:8000/ocr(本机服务)。 用户提供了托管地址后前提不成立,本工单推翻它——文档里改写并保留原文, 让后来人知道这个决定变过、为什么变。 OCR 优先、手工兜底:识别成功直接登录,失败或服务不可达降级到 #46 已有的 手工弹窗,并在弹窗里说明是"已尝试 N 次"还是"服务不可用"。手工路径不删, 外部服务挂了不该让整个同步功能不可用。 识别失败也是 code:200。实测拿无文字图片探测 https://ocr.ilapage.cn/ocr 返回 {"code":200,"message":"Success","data":""}——不是错误码。所以 Recognize 只负责"这次 HTTP 调用有没有问题",空 data 照常返回 (", nil), 业务校验交给调用方;空 data 和长度不对收敛到同一个 len(code) != 4, 一条规则覆盖两种情况。 不合格的验证码不拿去登录:白费一次尝试,且频繁错误登录可能触发风控。 审查时变异测试发现这条没有测试守着——原测试只断言"重新取图了"和 "最终登录成功",禁用长度校验后依然成立。已补 loginRecorder 记录每次 提交到 /am/auth/login 的 code,断言登录只被调用一次且提交的是合格的那个。 每次重试重新取图(同一张图再识别结果一样,且可能已被上次失败的登录作废); OCR 用独立 HTTP 客户端不带顺运宝 Cookie;验证码图片只在内存里传,不落盘。 OCR 不可达立即降级、不占用重试次数——对着连不上的地址重试 5 次, 操作员要等 50 秒才看到手工输入框,结果注定一样。 测试全部用 httptest,不打真实的 ocr.ilapage.cn 和 shunyunbaoerp.com。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -112,8 +112,23 @@ password: 0012345 # ✗ 解析成整数 12345
|
||||
没有这个文件时,点「同步」会提示"没有找到配置文件……请复制
|
||||
config.example.yaml",不是一句读不出原因的报错。
|
||||
|
||||
`config.yaml` 里还有两个和验证码自动识别相关的配置(工单 #47):
|
||||
|
||||
```yaml
|
||||
syb:
|
||||
ocr_url: https://ocr.ilapage.cn/ocr # 留空则只用手工输入弹窗,不报错
|
||||
ocr_max_attempts: 5 # 识别失败的重试次数上限
|
||||
```
|
||||
|
||||
配了 `ocr_url` 后,会话过期时点「同步」会先自动识别验证码登录,
|
||||
无需人在场;识别失败或服务连不上会自动降级到手工输入弹窗,弹窗里
|
||||
会说明降级原因。`ocr_url` 留空就和 #46 时一样,一直走手工输入。
|
||||
|
||||
`[必须]` 验证码图片会被发送到 `ocr_url` 配置的地址,见
|
||||
[08 顺运宝接口](08-顺运宝接口.md) §8.1。
|
||||
|
||||
接口细节和这几个配置项各自的含义见
|
||||
[08 顺运宝接口](08-顺运宝接口.md) §8。
|
||||
[08 顺运宝接口](08-顺运宝接口.md) §8、§8.1。
|
||||
|
||||
## 4. 你应该看到什么
|
||||
|
||||
|
||||
Reference in New Issue
Block a user