fix(douyu): 修正扫码前待确认角色误判

This commit is contained in:
yml
2026-11-22 01:08:10 +08:00
parent b57fe16e0c
commit 21956d952c
8 changed files with 197 additions and 120 deletions
+45 -23
View File
@@ -59,7 +59,7 @@
| 来源 | 典型值 | 职责 | 不能做什么 |
| --- | --- | --- | --- |
| 活动动作 alias | `20260120QYOOB` | 当前精英宝典二维码、待确认和最终确认的权威动作通道 | 不能被 legacy 的旧角色覆盖 |
| legacy 最新态 | `cjm` | 补充最新换绑/扫码角色,常更早暴露新角色 | 不能单独代表当前活动已确认;不能压掉活动 alias pending |
| legacy 最新态 | `cjm` | 补充最新换绑/扫码角色,常更早暴露新角色 | 不能单独代表当前活动已确认;不能覆盖活动 alias 当前状态 |
| 历史查询 alias | `20250213NQCYX` 等配置值 | 兼容旧活动查询 | 不作为当前动作主通道 |
`query_act_aliases` 是“要查哪些来源”的集合;`action_act_aliases` 是“哪些来源可以
@@ -73,8 +73,8 @@
| `bindAccount=1` | 已绑定腾讯账号 |
| `bindRole=1` | 已选中游戏角色 |
| `bindAct=1` | 最终活动绑定已生效,这是唯一 `bound` 信号 |
| `bindAct=0 + bindRole=1` | 角色已选中但未确认,是 `pending` |
| `needBindAct=1` | 当前活动要求继续执行确认 |
| `bindAct=0 + bindRole=1` | 接口观察态是角色已选中但未确认;是否属于本轮扫码仍需 baseline 迁移 |
| `needBindAct=1` | 当前活动允许继续绑定;这是长期能力标志,不等于本轮刚扫码 |
| `needBindRole=1` | 当前流程仍需要角色选择/角色信息 |
| `changeRoleWaitTime` | 换绑倒计时;只有 `bindAct=1` 时才可能是真实冷却 |
| `canChangeTime` | 可换绑绝对时间;未确认绑定不能据此拦截 |
@@ -87,28 +87,33 @@
单个候选按以下顺序解释,详细结果由 `binding_pending_decision()` 返回:
1. 没有角色名:不可确认;
2. 动作 alias 上 `bindAct=0 + needBindAct=1 + roleName`:可确认,原因
`existing_actionable_pending`;
3. 没有扫码前 baseline:可确认,原因 `first_role_without_baseline`;
4. 角色名与 baseline 不同:可确认,原因 `role_changed`;
5. 角色名相同,但同 alias 仍返回 `needBindAct=1`:可确认,即使当前
`bindAct=1`,原因 `same_alias_after_bound_transition`;
6. 动作 alias 上 `bindAct=1 + needBindAct=1 + 同名角色`:可确认;
7. 角色名相同且接口不再要求绑定:视为已经绑定,原因 `already_bound`;
8. 其他同名角色:视为旧残留,原因 `same_role_stale`。
2. 没有扫码前 baseline:不可确认。当前 `bindAct=1` 返回 `already_bound`,
其他情况返回 `pending_without_baseline`;
3. 角色名与 baseline 不同:可确认,原因 `role_changed`;
4. 角色名相同但缺少完整 baseline 快照:不可确认;
5. 同 alias 从 `bindAct=1` 变为 `bindAct=0`:可确认,原因
`same_alias_after_bound_transition`;
6. 同 alias 从 `needBindAct=0` 变为 `needBindAct=1`,且当前 `bindAct=0`:
可确认,原因 `same_alias_after_pending_transition`;
7. 当前仍是 `bindAct=1`:视为已经绑定,原因 `already_bound`;
8. 其他同名角色:视为旧残留。baseline 本身是 pending 时原因
`same_role_stale_pending`,否则为 `same_role_stale`。
规则 2 是 2026-11-21 线上修复:动作 alias 已经存在同名 pending 时,它仍是可执行
确认的 pending,不应因为“角色名没变化”一直灰掉确认按钮。
2026-11-22 生产历史证明:账号早已 `bind_ok confirmed`,但活动 alias 长期同时返回
`bindAct=1 + needBindAct=1`。因此 `needBindAct=1` 不能单独证明本轮扫码,同名角色
必须看到扫码前后的真实状态迁移,否则确认按钮会把历史角色误报为新 pending。
规则 5、6 解决“重新绑定同名角色”:业务不要求每次都必须选择一个不同的角色。
只要官方动作 alias 仍要求绑定,同名角色也必须能进入确认流程。
二维码预检只建立 baseline,生成二维码后固定进入 `waiting_scan`;只有轮询观察到
上述状态迁移或新角色后才进入 `role_ready`。旧任务如果已经是无迁移的
`role_ready`,`refresh_binding()` 会记录 `binding_stale_role_ignored` 并自动回到
未开始状态,不要求人工改库。
### 完整流程
```text
查询所有 query_act_aliases
-> 找当前 bindAct=1(bound)
-> 找动作 alias 上的可确认 pending
-> 保存扫码前 baseline,不能把静态 pending 直接当成本轮结果
-> 生成二维码
-> 持久化 baseline、候选来源、判定原因
-> binding_poll 每轮先查 legacy(cjm)
@@ -307,12 +312,15 @@ docker compose logs douyu-login | grep '确认前状态'
`QYOOB.bindAct=0 + needBindAct=1`。旧逻辑只接受“角色名变化”或“同 alias 从
`bindAct=1` 转为 pending”,把已经存在的活动 pending 误判成旧残留。
修复:动作 alias 已存在同名 pending 时直接视为可确认,原因
初次修复:动作 alias 已存在同名 pending 时直接视为可确认,原因
`existing_actionable_pending`;二维码预检也会立即收敛为 `role_ready`。
回归:`tests/test_douyu_binding_state.py`、`tests/test_douyu_account_probe.py`、
`tests/test_douyu_task_concurrency.py`。
> 2026-11-22 更正:该修复把长期静态的 `needBindAct=1` 当成了新扫码结果,已废弃。
> 当前规则见上方“pending 判定顺序”。
### 2026-11-21:扫码成功但轮询超时、确认按钮不稳定
生产失败任务中大量出现 `role_timeout`,但 `result` 实际已经带回角色,且部分
@@ -329,16 +337,29 @@ docker compose logs douyu-login | grep '确认前状态'
相同的角色名。旧判定先看 `bindAct=1` 并直接返回 `already_bound`,导致用户重新
绑定同名角色时任务一直等待。
修复:只要动作 alias 仍返回 `needBindAct=1`,同名角色也进入可确认状态;候选选择
仍先选真正变化的新角色,再选择同名可确认角色,避免活动 alias 的旧快照压掉
`cjm` 上的新角色。
初次修复:只要动作 alias 仍返回 `needBindAct=1`,同名角色也进入可确认状态。
> 2026-11-22 更正:该结论不成立。`needBindAct=1` 在该活动里可以长期存在;同名角色
> 必须依赖扫码前后状态迁移。候选选择仍优先真正变化的新角色,但不会再接受静态
> 同名 pending。
### 2026-11-22:历史绑定记录证明静态 pending 会误报
生产账号 `2212`、`24372` 的 `bind_ok` 历史分别确认于 2026-10-22 和 2026-11-15,
但二维码预检仍长期看到同名角色和 `bindAct=1 + needBindAct=1`。旧逻辑把该状态
写成 `role_ready`,随后客服页和履约页都显示“待确认角色”,实际用户尚未扫码。
修复:共享判定器要求 baseline 和状态迁移;二维码预检不再提前推进 `role_ready`;
客服页、履约工作台和账号探针统一消费同一判定结果;账号探针仅在活动 alias 明确
未绑定、legacy alias 为 `bindRole=1 + bindAct=0` 时保留只读观察到的 pending。
### 历史固定规则
- 不要把 `bindRole=1` 当成已绑定;
- 不要把未确认时的换绑倒计时当成冷却;
- 不要用 `cjm` 的旧角色覆盖活动 alias pending;
- 不要要求每次绑定都必须换一个不同的角色,同名重绑是正常流程;
- 不要用 `cjm` 的旧角色覆盖活动 alias 当前状态;
- 不要要求每次绑定都必须换一个不同的角色,但同名重绑必须有扫码前后状态迁移;
- 不要把 `needBindAct=1` 单独当成本轮扫码结果;
- 不要在页面层重新实现 `bindAct/needBindAct` 判断;
- 不要把原始 `bind_summary` 当业务文案,它只用于排障。
@@ -350,3 +371,4 @@ docker compose logs douyu-login | grep '确认前状态'
| 2026-11-21 | 补充 `storehome` 单账号全量商品资格、`storedetail`/`batchExchangeLimit` 边界和抓包证据入口 |
| 2026-11-21 | 补充同名重绑、轮询退避、直接绑定识别和角色接口原始响应留档 |
| 2026-11-21 | 按最新 HAR 更新鱼翅余额/充值二维码/支付状态、积分 multipart、到期批次和积分流水协议 |
| 2026-11-22 | 修正同名待确认误判:静态 `needBindAct` 不再作为扫码证据,二维码预检统一等待状态迁移 |