fix(douyu): 修正绑定状态与换绑冷却判定

This commit is contained in:
yml
2026-11-22 02:10:29 +08:00
parent 21956d952c
commit fa75ce66ee
9 changed files with 636 additions and 104 deletions
+48 -22
View File
@@ -73,7 +73,7 @@
| `bindAccount=1` | 已绑定腾讯账号 |
| `bindRole=1` | 已选中游戏角色 |
| `bindAct=1` | 最终活动绑定已生效,这是唯一 `bound` 信号 |
| `bindAct=0 + bindRole=1` | 接口观察态是角色已选中但未确认;是否属于本轮扫码仍需 baseline 迁移 |
| `bindAct=0 + bindRole=1` | 角色已选中但未最终生效,是可确认 pending;允许在生成新二维码前已存在 |
| `needBindAct=1` | 当前活动允许继续绑定;这是长期能力标志,不等于本轮刚扫码 |
| `needBindRole=1` | 当前流程仍需要角色选择/角色信息 |
| `changeRoleWaitTime` | 换绑倒计时;只有 `bindAct=1` 时才可能是真实冷却 |
@@ -87,33 +87,37 @@
单个候选按以下顺序解释,详细结果由 `binding_pending_decision()` 返回:
1. 没有角色名:不可确认;
2. 没有扫码前 baseline:不可确认。当前 `bindAct=1` 返回 `already_bound`,
其他情况返回 `pending_without_baseline`;
2. 当前 `bindAct=1`:已经最终绑定,不可确认,原因 `already_bound`;
3. 角色名与 baseline 不同:可确认,原因 `role_changed`;
4. 角色名相同但缺少完整 baseline 快照:不可确认;
5. 同 alias 从 `bindAct=1` 变为 `bindAct=0`:可确认,原因
4. 同 alias 从 `bindAct=1` 变为 `bindAct=0`:可确认,原因
`same_alias_after_bound_transition`;
6. 同 alias 从 `needBindAct=0` 变为 `needBindAct=1`,且当前 `bindAct=0`:
5. 同 alias 从 `needBindAct=0` 变为 `needBindAct=1`,且当前 `bindAct=0`:
可确认,原因 `same_alias_after_pending_transition`;
7. 当前仍是 `bindAct=1`:视为已经绑定,原因 `already_bound`;
8. 其他同名角色:视为旧残留。baseline 本身是 pending 时原因
6. 动作 alias 当前是 `bindAct=0 + needBindAct=1 + roleName`:可确认,原因
`existing_actionable_pending`。即使它在二维码生成前已经存在、没有发生
状态迁移,官网也允许直接 `actBind`;
7. 没有 baseline 且不是动作 alias pending:不可确认,原因
`pending_without_baseline`;
8. 角色名相同但缺少完整 baseline 快照:不可确认;
9. 其他同名角色:视为旧残留。baseline 本身是 pending 时原因
`same_role_stale_pending`,否则为 `same_role_stale`。
2026-11-22 生产历史证明:账号早已 `bind_ok confirmed`,但活动 alias 长期同时返回
`bindAct=1 + needBindAct=1`。因此 `needBindAct=1` 不能单独证明本轮扫码,同名角色
必须看到扫码前后的真实状态迁移,否则确认按钮会把历史角色误报为新 pending。
`bindAct=1 + needBindAct=1`。因此 `needBindAct=1` 不能单独证明 pending;
真正决定 pending 的是 `bindAct=0`,不是角色名是否变化。
二维码预检只建立 baseline,生成二维码后固定进入 `waiting_scan`;只有轮询观察到
上述状态迁移或新角色后才进入 `role_ready`。旧任务如果已经是无迁移的
`role_ready`,`refresh_binding()` 会记录 `binding_stale_role_ignored` 并自动回到
未开始状态,不要求人工改库。
二维码预检若发现动作 alias 已有 `bindAct=0` pending,会发布二维码并立即进入
`role_ready`;没有合法 pending 时才进入 `waiting_scan`。历史错误的
`bindAct=1` `role_ready` 会被 `refresh_binding()` 记录为
`binding_stale_role_ignored` 并自动退回未开始状态。
### 完整流程
```text
查询所有 query_act_aliases
-> 找当前 bindAct=1(bound)
-> 保存扫码前 baseline,不能把静态 pending 直接当成本轮结果
-> 找动作 alias 上真实的 bindAct=0 pending
-> 保存扫码前 baseline,用于识别新角色和状态迁移
-> 生成二维码
-> 持久化 baseline、候选来源、判定原因
-> binding_poll 每轮先查 legacy(cjm)
@@ -340,8 +344,7 @@ docker compose logs douyu-login | grep '确认前状态'
初次修复:只要动作 alias 仍返回 `needBindAct=1`,同名角色也进入可确认状态。
> 2026-11-22 更正:该结论不成立。`needBindAct=1` 在该活动里可以长期存在;同名角色
> 必须依赖扫码前后状态迁移。候选选择仍优先真正变化的新角色,但不会再接受静态
> 同名 pending。
> 不能只靠它进入 pending。最终规则是 `bindAct=0` 才算 pending,`bindAct=1` 已绑定。
### 2026-11-22:历史绑定记录证明静态 pending 会误报
@@ -349,17 +352,40 @@ docker compose logs douyu-login | grep '确认前状态'
但二维码预检仍长期看到同名角色和 `bindAct=1 + needBindAct=1`。旧逻辑把该状态
写成 `role_ready`,随后客服页和履约页都显示“待确认角色”,实际用户尚未扫码。
修复:共享判定器要求 baseline 和状态迁移;二维码预检不再提前推进 `role_ready`;
客服页、履约工作台和账号探针统一消费同一判定结果;账号探针仅在活动 alias 明确
未绑定、legacy alias 为 `bindRole=1 + bindAct=0` 时保留只读观察到的 pending。
初次修复错误地要求所有同名 pending 都必须有状态迁移。这样虽然挡住了
`bindAct=1` 历史角色误报,却也会让合法的已有 `bindAct=0` pending 超时。
### 2026-11-22:最新 HAR 重新确认 pending 与平台冷却
`11.22-绑定成功-1.har`:二维码轮询 70 次都没有出现新的 `isScan=true`,但活动
alias 和 `cjm` 一开始就有 `bindAct=0 + bindRole=1 + roleName=只为爱杰宝`;
官网仍允许直接 `actBind` 并成功,随后回查变为 `bindAct=1`。
`11.22-绑定-换绑失败.har`:扫码已经出现 `isCompleted=true`,`cjm` 也返回了新角色
`巫师基尔斯84`,但活动 alias 仍绑定旧角色,且 `canChangeTime=1795449600`
(2026-11-24 00:00 CST)。`actBind` 返回:
```json
{"error":-200001,"msg":"该平台账号未到可换绑时间,请使用其他平台账号"}
```
这说明 `-200001` 限制的是斗鱼平台账号,不是腾讯游戏角色。失败时必须保留活动
alias 上的旧角色,不能把 `cjm` 的新角色写入账号库。
最终修复:`bindAct=0` 的已有 pending 可确认;`bindAct=1` 永远不是 pending;
二维码预检遇到平台账号冷却时不发码;确认接口保留原始 error code,结构化为
`account_role_cooldown`;失败前后都只写回活动 alias 的原绑定角色。
### 历史固定规则
- 不要把 `bindRole=1` 当成已绑定;
- 不要把未确认时的换绑倒计时当成冷却;
- 不要用 `cjm` 的旧角色覆盖活动 alias 当前状态;
- 不要要求每次绑定都必须换一个不同的角色,但同名重绑必须有扫码前后状态迁移;
- `bindAct=0` 是 pending,可以在发新二维码前已经存在;
- `bindAct=1` 是 bound,即使同时返回 `needBindAct=1` 也不是 pending;
- 不要把 `needBindAct=1` 单独当成本轮扫码结果;
- `actBind=-200001` 是当前斗鱼账号冷却,不是客户游戏角色冷却;
- `actBind` 失败后必须保留旧绑定,不能写入新扫码角色;
- 不要在页面层重新实现 `bindAct/needBindAct` 判断;
- 不要把原始 `bind_summary` 当业务文案,它只用于排障。
@@ -371,4 +397,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` 不再作为扫码证据,二维码预检统一等待状态迁移 |
| 2026-11-22 | 按成功/失败 HAR 重构绑定判定:已有 `bindAct=0` 可确认,`bindAct=1` 不误报,`-200001` 归为斗鱼账号冷却并保留旧角色 |