fix(douyu): 修正扫码前待确认角色误判
This commit is contained in:
@@ -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` 不再作为扫码证据,二维码预检统一等待状态迁移 |
|
||||
|
||||
Reference in New Issue
Block a user