# 虎牙纯Python全自动登录 — 总结与交接（2026-08-25）

## 一、已达成 ✅（全部实测验证）

### 核心链路（可信账号，零设备零手动）
```
账号+密码
  → SHA1
  → build_password_login_wup() 组TAF包 (servant=huyaudbwebui, func=hypasswordLogin)
  → POST https://wup.huya.com   [body=原始TAF字节, CT=application/multipart-formdata]
  → HTTP 200 → 解析响应bean → 新鲜cred(114B, 0a开头, 每次登录轮换)
  → cert_forge.build_p1(fingerprint + 新nonce + cred) → forge_cert(key_idx=0x20)
  → 扫码绑定流 getQrId→scanQrPicNotify→bindQrLoginUser→tryQrLogin
  → POST /web/cookie/verify {"appId":5002}  ← 关键最后一步!
  → 全套网页Cookie: udb_cred/yyuid/udb_uid/udb_passport/username/udb_biztoken...
```

### 一键工具
| 命令 | 功能 |
|---|---|
| `.venv/bin/python tools/full_web_cookie.py <账号> <密码>` | 密码→全套网页Cookie（写 evidence/web_cookies_full.txt）|
| `.venv/bin/python tools/full_auto_test.py <账号> <密码>` | 密码→cred→铸证→bind 全链路自测 |

## 二、关键知识（踩坑实录）

1. **wupData信封有服务端TTL**：bind用的一次性wupData(session/nonce)过期即40020
   CERT_BIZERR_CREATE_ERROR——与cred无关！刷新方法：设备跑 scripts/hook_cert_keycap.py
   (Java桥自动触发getQUrlData，无需人工)。
2. **cred每次登录轮换**，第二字节是代次计数器(0x10/0x20/.../0x80循环)；旧cred短期仍有效。
3. **响应bean解析**：_wup_data值=SIMPLE_LIST(0x1d)+elem头(00)+JCE优化int长度；
   bean内 tag3(bytes)=cred。虎牙TAF类型表: STR1=6/STR4=7/MAP=8/LIST=9/
   STRUCT_BEGIN=10(0xa)/STRUCT_END=11(0xb)/ZERO=12/SIMPLE_LIST=13。
4. **udb消息载荷=JSON命名键**(非二进制JCE)，msgId: LoginPassport=0x1001,
   Response=0x2001; wire双体系: 0x0Bxxxxxx业务推送族 vs udb裸id。
5. **证书算法**=标准AES-128-ECB；P1=[01 04]["5008"][u16le20+20B nonce][u16le40+40B指纹][u16le114+cred]；
   cert=b64([0x0C][key_idx][AES128(key16,zeropad(P1))])；钥表@rodata 0x1bc810(AESkeyMgr注册)。
6. **存储侧**: cred0文件=AES-128-ECB("HuyaUdb192837465")加密的JSON，
   cred路径 /loginHistory[0]/apploginData/cred。

## 三、新账号风控(safe_auth)——当前唯一待完成项

### 定性（已实锤）
- App渠道(WUP)对新/异地账号返回 `aq.huya.com/p/safe_auth/pt_auth.html?param=xxx`
- 页面走 **udbrtt.huya.com 滑块**（主chunk含slideBlock*字段）
- **与 core/huya/verification/solver.py 已实现的 udbrtt get3→verify3 闭环同源**
- web渠道(5002)才是qr_auth扫码型；App渠道=滑块=可自动

### 下会话开工清单
1. 抓 pt_auth 页初始化 udbrtt 的请求(param如何传入get3)：
   页面JS chunk: https://a.msstatic.com/huya/hd/h5/udb/js/safe_auth-pt_auth.1a35e28a.js
2. 用 HuyaVerificationSolver 解滑块→verify3 提交(带param上下文)
3. 重发 WUP 登录 → cred 直出 → 新账号也全自动
4. 备选: 对比真机App解滑块时的请求(hook udbrtt 流量)加速逆向

## 四、多账号运营模型
```
新账号首次: 手机App正常登录一次(建设备信任, 若遇滑块人工滑一下)
之后永久:  密码 → full_web_cookie.py → 全套cookie 自动出
```

## 五、资产清单
- 组包: tools/huya_wup_encoder.py (build_password_login_wup, 自检对金样本)
- 铸证: tools/cert_forge.py (build_p1/forge_cert/parse_p1)
- 绑定: scripts/probe_forge_cert_bind.py (QrRole四步流+cert替换)
- 网页登录: core/huya/login.py (含滑块solver集成, web渠道)
- 滑块: core/huya/verification/{solver,track}.py + core/geetest/v3_slide
- 设备指纹: core/huya/device_fingerprint.py (get_huya_sdid)
- 证据: evidence/* (金样本wup_passwordlogin_taf.bin等)
- 协议细节全记录: docs/虎牙hyCred签发-侦察笔记.md (按Round追加)