yml2213
eccc00e090
- docs/HUYA_ID_NOMENCLATURE.md: 规范总表 + 三条强制规则 + 代码变量对应 - 4 篇主文档头部去混声明 + §11.x 被证伪假设行标注更正 - 代码: GOLDEN_HDID→GOLDEN_HDID32, device_profile.HDID→HDID32, wup_encoder/app_login 注释前缀化 - 后续所有表述必须以 GUID32(doLaunch) / HDID32(登录t1.t0) / DEVID40(t5) 前缀书写
2.8 KiB
2.8 KiB
虎牙设备标识符命名规范 (ID NOMENCLATURE)
强制约定：所有文档、代码注释、变量名、日志，凡是提到设备标识，必须带前缀 （下列表格中的「规范名」）。禁止裸写 "hdid"/"GUID"/"device_id" 等无前缀词 —— 历史教训：这些词在不同体系下含义完全不同，已造成多次混淆（见 §11.11 去混记录）。
规范名总表
| 规范名 | 长度 | 含义 | 出现位置 | 签发方 | 可铸性 |
|---|---|---|---|---|---|
| GUID32 | 32hex | doLaunch 响应的 sGuid（launch 体系） | 登录外的启动注册；HySignalGUIDCache.xml | 服务端（按 MID16 确定性签发） | ✅ 已打通（铸币机） |
| HDID32 | 32hex | 登录帧 t1.t0 的 设备证书（登录体系） | WUP 登录请求 t1.t0；native 内存 | native 私钥（libhydeviceid） | ❌ 纯 Python 不可铸 |
| DEVID40 | 40hex | 登录帧 t2.t8 / 注册链 t5 的 device_id | WUP 登录 t2.t8、dfpReport 响应 t5、库 getHDID | 服务端（dfpReport 解密 cw 后签发）或库内生成 | ✅ 注册链可铸 |
| CDID40 | 40hex | CDID（库 getCDID） | 登录帧 fingerprint 附近 / 库内 | libhydeviceid | unidbg 可调 |
| MID16 | 16hex | mid（LiveUserbase→tUAEx→t5=sMId） | doLaunch 请求、库 getMID | 设备（可任意铸） | ✅ 任意 16hex |
| ACTION | 长串 | safedeviceid = 注册链 t2（登录授权令牌） | 登录帧 t0.t5 | 服务端（dfpReport 签发，每账号新拉） | ✅ 注册链可铸 |
| SIGDEV40 | 40hex | HYSIGNAL_DEVICE_ID_KEY（hysignal 设备键） | hysignalconfigcache | hysignal 缓存 | 未研究 |
三条必守规则
- 每次提及必须带前缀：
HDID32(登录t1.t0)、GUID32(doLaunch)、DEVID40(注册链t5)。 上下文允许时至少写前缀：HDID32、GUID32、DEVID40、MID16、ACTION。 - "hdid" 这个词默认指 HDID32（登录帧 t1.t0 设备证书）； "GUID" 默认指 GUID32（doLaunch sGuid）。两者绝不可互换/混用。
- 新增分析必须引用本规范表，并在初次出现时给出前缀 + 长度 + 体系，例如：
HDID32(ed0db8334cadd236c00cadf7e11ab5a5, 登录t1.t0设备证书)。
与代码变量的对应
| 代码中的旧名 | 规范名 | 说明 |
|---|---|---|
GOLDEN_HDID |
GOLDEN_HDID32 | 金样本 = ed0db8…（登录 t1.t0） |
build_password_login_wup(hdid=) |
HDID32 参数 | 登录帧 t1.t0 |
device_profile.HDID |
HDID32 | 同上 |
huya_device_register.t5 |
DEVID40 | 注册链 device_id |
huya_launch_mint.guid |
GUID32 | doLaunch 请求/响应 sGuid |
历史文档（§11.8 之前的章节）中裸写 "hdid"/"GUID" 处，按本表语义理解： 登录相关 = HDID32，launch/铸币相关 = GUID32，40hex = DEVID40/CDID40。