# 虎牙纯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_safe.py <账号> <密码>` | 同上, 且新账号safe_auth滑块自动过 |
| `.venv/bin/python tools/full_auto_test.py <账号> <密码>` | 密码→cred→铸证→bind 全链路自测 |

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

1. **wupData信封规则(v2实验定论)**: ①铸证必须复用信封原证书的rnd/指纹/key_idx,
    仅替换cred字段——纯随机nonce必40020; ②t3.uid须与cert内cred账号一致;
    ③session三处不可动(SYS_ERROR); ④同账号信封长期可复用;
    ⑤跨账号=每号设备首登一次(hook_cert_keycap自动抓该号信封)后永久纯Python。
   补丁工具 tools/envelope_forge.py (patch_uid/patch_cert/patch_session)。
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)——已实现 ✅(2026-08-25夜)

### 定性与实现
- App渠道(WUP)对新/异地账号返回 `aq.huya.com/p/safe_auth/pt_auth.html?param=xxx`
  → **udbrtt.huya.com 滑块** → tools/app_login_flow.login_cred() 自动过验并重发WUP
- pt_auth页JS逆向结论: urlParamMap=整个query原样回传; wupData纯web上下文空串可过;
  gurl取图ver:5, segment=UdbCipher.decrypt乱序还原表; vurl提交act=UdbCipher.encrypt;
  成功后服务端标记param风控会话通过, 直接重发同参WUP登录即放行。
- qr_auth(扫码型)明确不可自动化 → QrAuthRequiredError 提示先真机首登建信任。

### 残留优化项(非阻塞)
1. 数小时前老信封复用边界未单独验证(E-B)——不影响主流程, 失败则hook重抓即可
2. 完全零设备跨账号需逆向nonce签发机制, 收益低(运营模型本就要求每号设备首登一次)

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

## 五、资产清单
- 组包: tools/huya_wup_encoder.py (build_password_login_wup, 自检对金样本)
- 登录流: tools/app_login_flow.py (login_cred/solve_safe_auth, safe_auth滑块闭环)
- 铸证: tools/cert_forge.py (build_p1/forge_cert/parse_p1)
- 信封: tools/envelope_forge.py (Envelope原位补丁uid/cert/session)
- 绑定: scripts/probe_forge_cert_bind.py (QrRole四步流+cert替换)
- 实验: scripts/probe_envelope_rules2.py (信封规则X0-X3紧凑对照)
- 网页登录: 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, envelope_rules2.json等)
- 协议细节全记录: docs/虎牙hyCred签发-侦察笔记.md (按Round追加)