Files
live-hub-py/docs/虎牙/HUYA_ID_NOMENCLATURE.md
T
yml2213 44a1a2bc95 docs(account): 逐行核对 CK 解耦设计,并补账号全生命周期信息模型
在动手前把那份「待评审」的设计与当前代码逐行对了一遍:

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 落地顺序。
2026-10-04 13:31:39 +08:00

2.9 KiB
Raw Blame History

虎牙设备标识符命名规范 (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 缓存 未研究

三条必守规则

  1. 每次提及必须带前缀:HDID32(登录t1.t0)、GUID32(doLaunch)、DEVID40(注册链t5)。 上下文允许时至少写前缀:HDID32、GUID32、DEVID40、MID16、ACTION。
  2. "hdid" 这个词默认指 HDID32(登录帧 t1.t0 设备证书); "GUID" 默认指 GUID32(doLaunch sGuid)。两者绝不可互换/混用。
  3. 新增分析必须引用本规范表,并在初次出现时给出前缀 + 长度 + 体系,例如: 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。