在动手前把那份「待评审」的设计与当前代码逐行对了一遍: 1. 方向成立(CK 确实只存在于 login_tasks.cookie),但原文 §5 漏了 4 处耦合点: - services/account_service.py:31 账号列表的 CK 筛选 - services/douyu_service.py:283 业务任务页的账号可见性 - routers/accounts.py:629-643 账号详情概览的裸 SQL(账号事件功能新增,原文写作时还没有) - routers/login.py:259 与 cookie_holding_filter 同口径的重复实现 2. latest_cookie() 是死代码,原文列为改造目标,实际直接删即可; 3. 修正漂移的行号(accounts.py 285/324/374 → 295/338/391); 4. 补 §13「账号全生命周期信息模型」:现状把账号事实散在 5 张表 7 个页面, 指出「账号没独立」在数据/接口/UI 三层的具体表现,以虎牙账号(已解耦的样板)为参照, 给出四层信息模型、生命周期阶段缺口表与 S1~S6 落地顺序。
2.9 KiB
2.9 KiB
虎牙设备标识符命名规范 (ID NOMENCLATURE)
强制约定:所有文档、代码注释、变量名、日志,凡是提到设备标识,必须带前缀 (下列表格中的「规范名」)。禁止裸写 "hdid"/"GUID"/"device_id" 等无前缀词 —— 历史教训:这些词在不同体系下含义完全不同,已造成多次混淆(见 §11.11 去混记录)。
规范名总表
| 规范名 | 长度 | 含义 | 出现位置 | 签发方 | 可铸性 |
|---|---|---|---|---|---|
| GUID32 | 32hex | doLaunch 响应的 sGuid(launch 体系) | 登录外的启动注册;HySignalGUIDCache.xml | 服务端(按 MID16 确定性签发) | ✅ 已打通(铸币机) |
| HDID32 | 32hex | 登录帧 t1.t0 的 appSign(登录体系) | WUP 登录请求 t1.t0;native 内存 | app 版本级常量 (R15 定案): md5("5008_" + appVersion + "_" + k1),k1 = libhydeviceid datadiv 内嵌常量 (R39);同版本所有设备同值,随 appVersion 变化按公式重算 | ✅ 纯 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。