4.1 KiB
虎牙精英宝典联调指南
更新时间：2026-09-02
当前 Cookie 字段状态见 HUYA_COOKIE路线状态.md。
本次联调结论
当前联调阶段只验收 App 登录后的网页 Cookie 完整性，精英宝典任务统一使用 WSS：
| 阶段 | 结果 | 证据 |
|---|---|---|
| WUP 登录 | 通过 | cred=114B，返回真实 UID |
| hydevice 指纹 | 通过 | 返回 sdid、hdid |
| QR 绑定 | 通过 | getQrId、bindQrLoginUser、tryQrLogin(stage=2) |
| 网页 Cookie | 已验证 | App 登录补齐网页字段；活动会话优先复用 wsLaunch guid |
| 精英宝典任务 | 已验证 | 活动 WSS 查询、商品、详情和兑换记录链路已跑通 |
旧登录结果中的 Cookie 缺少网页设备态，已不再作为成功登录或任务链路使用。
纯 App/HTTP 登录不会由 web/cookie/verify 下发完整网页设备 Cookie。浏览器只用于
人工调试和抓取来源，未集成到脚本；登录链已接入匿名设备态协议
（core/huya/anon_device.py）补 udb_deviceid/udb_guiddata/udb_anobiztoken/
udb_anouid，剩余脚本字段（guid/game_did/_qimei_uuid42/__yamid_new）
缺失时警告并保存，不伪造、不启动浏览器。
推荐联调顺序
- 在
http://localhost:5174/登录一个测试账号，确认日志出现App协议登录成功。 - 配置精英宝典
SID。9.1 抓包对应活动 SID 为2203；以页面“精英宝典设置”中的当前值为准。 - 按下面顺序在精英宝典工作台执行任务：
query_game_name：验证角色绑定状态。query_points：验证积分响应和数据库写回。query_exchange_records：验证记录解码和页面展示。refresh_goods：拉取商品快照。- 选一个明确可兑换、价格低于余额的商品，再执行
exchange_goods。
- 兑换成功后再次执行
query_points和query_exchange_records，核对余额扣减与新增记录。 - 充值/开通链路单独联调：先
refresh_recharge_goods，再只生成支付码create_recharge_order。支付确认不要和查询任务混在同一批次。
如何判定传输通道
执行器只检查字段是否存在，不记录字段值：
必要字段：udb_cred、udb_biztoken、udb_uid、yyuid、sdid、udb_deviceid、udb_guiddata、udb_anobiztoken
- 字段齐全：尝试活动或商城 WSS。
- 缺少字段：任务日志列出缺失字段并停止，不创建 HTTP 客户端，例如：
Cookie 缺少网页设备态(udb_deviceid, udb_guiddata, udb_anobiztoken)，已停止活动 HTTP 回退
guid/game_did/_qimei_uuid42/__yamid_new 四个脚本字段无统一服务端签发接口；
当前登录链已接入 guid 会话值、__yamid_new、game_did、fingerprint 和
_qimei_uuid42 的 SDK 算法，WSS 判定不要求脚本字段全部来自浏览器。
- WSS 握手、
wsLaunch、getConfig或业务 RPC 任一步失败：任务直接失败并记录具体阶段，便于修复 Cookie 或协议参数。
WSS 专项验收
只有从同一网页会话取得真实 guid 后，才做 WSS 专项联调。验收顺序为：
- 活动 WSS 初始化：
wsLaunch -> AUTH -> mobileui.getConfig -> CONFIRM。 - 活动 RPC：
checkUserBindGameAccount -> getUserScore -> getUserPrizeRecords。 - 商城 WSS 初始化：
wsLaunch -> getConfig -> register -> CONFIRM。 - 商城只读 RPC：
getGoodsInfoV5 -> listPayChannelV5 -> checkHyProtocolV5。 - 最后才验证
createOrder -> payOrderSubmit -> orderDetail。
网页设备字段必须来自同一网页/设备会话；_merge_web_cookie 不会根据长度、正则或 UID 生成 guid、QIMEI、udb_anobiztoken 等字段。
本次测试命令
.venv/bin/python -m pytest -q tests/test_huya_app_login.py tests/test_huya_runner_transport.py
.venv/bin/python -m ruff check core/huya web/backend/services/huya_runner_core.py tests/test_huya_runner_transport.py
git diff --check
预期：测试通过、Ruff 无错误、差异检查无输出。真实联调以 logs/app-YYYY-MM-DD.log 中每个 RPC 的状态码和任务最终状态为准。