Skip to content

profile_info_v6 — 资料主表 ​

profile_info.db 的绝对主体:44 列,一行 = 一个人的完整资料。 好友、群友、只在某个群里发过一句话的陌生人,全在这一张表里。

对应 WeQ 解析实现:

文件职责
packages/db/src/profile/profile_info.ts取行 + 列 → UserProfile
packages/codec/src/proto/profile/21000.ts21000 扩展资料列
packages/codec/src/proto/profile/20057.ts20057 自定义状态列
packages/codec/src/proto/profile/20072.ts20072 密友关系列

一、这张表的定位 ​

它是缓存,不是名册。 本机实测 52243 行,其中好友只有 195 个 —— 99.6% 是陌生人。 只要你在群里见过某人一次,QQ 就会把他的昵称/头像塞进这张表,方便下次渲染群消息时不用回源。

由此推出三条写代码时的铁律:

  1. 判定「是不是好友」必须查 buddy_list,不能靠这张表有没有行。
  2. 陌生人行是残缺的。5 万行里只有约 4.8% 填了生日/性别/年龄这批「资料卡字段」, 剩下的只有 uid / uin / 昵称 / 头像四样。所以任何字段都要当可空处理。
  3. 行可以比现实旧。资料是拉过一次就留着,对方后来改了昵称,这里不会自动跟。

另一个反直觉的点:头像 URL(20004)只有 19.9% 的行有。剩下 80% 连头像都没缓存。 这就是 WeQ 走 md5(md5(md5(uid)+uid)+uid) 本地头像路径推导、而不是依赖这一列的原因。

二、标量列 ​

按用途分组。「填充率」一列是本机 4000 行采样的实测非空比例,用来判断这个字段可不可靠。

身份 ​

列字段名类型填充率含义置信度
1000uidTEXT100%主键,u_xxxxxxxx 形式的不透明标识已验证
1002uinINTEGER100%QQ 号已验证
1001qidTEXT0.7%QID(个性 ID,如 hydr0g3n)。极少人设置已验证
20002nickTEXT100%昵称已验证
20009remarkTEXT3.1%我给对方设的备注名已验证
20011signatureTEXT3.0%个性签名(纯文本版,富文本版见 24105)已验证

20009 / 20011 的填充率 ≈ 好友占比,符合预期:只有好友才会有备注和签名缓存。

资料卡字段 ​

这一组的填充率高度一致地卡在 4.8% —— 它们是同一次「拉完整资料」写进去的,要么全有要么全无。

列字段名类型填充率含义置信度
20006birthYearINTEGER4.8%出生年(0 = 未填)已验证
20007birthMonthINTEGER4.8%出生月已验证
20008birthDayINTEGER4.8%出生日已验证
24103ageINTEGER4.8%年龄。由生年算出的冗余值,实测 179/180 行与 2026 - 20006 吻合已验证
20014genderINTEGER4.8%性别:1 男 / 2 女 / 0 未知 / 255 保密已验证

20014 = 255 是个坑:WeQ 的 rowToProfile 只认 1/2,其余一律归 0(未知), 所以「保密」和「没填」在上层是一回事。实测 4000 行里有 20 行是 255。

头像 ​

列字段名类型填充率含义置信度
20004avatarUrlTEXT19.9%头像 CDN URL(qh.qlogo.cn/g?b=qq&ek=…)已验证
20005—INTEGER19.9%头像 URL 的写入时间(毫秒)观测一致
20016—INTEGER19.9%头像更新时间(unix 秒),与 20017.20102 恒等(60/60)已验证
20017—BLOB19.6%头像摘要,见 第四节已验证

关系与互动 ​

列字段名类型填充率含义置信度
20070intimacyINTEGER4.8%好友亲密度。WeQ 的「亲密度排行」就排这一列已验证
20072extRelationBLOB3.3%密友关系,见 第六节已验证
20057customStatusBLOB0.02%自定义在线状态,见 第五节已验证
24104sigUpdateTimeINTEGER4.8%签名更新时间(unix 秒)观测一致
24105—BLOB3.0%签名富文本容器,见 第七节已验证

未解语义的列 ​

诚实记录 —— 这些列有数据,但语义没验证出来,别在代码里用:

列类型填充率观测
20001INTEGER4.8%只有 4 种取值,130/192 行是同一个大数 1785936742016
20003INTEGER99.9%90 种取值,形如 2019839462274 的 13 位数。填充率 100% 却高度重复,像是「资料来源/渠道」的编码
20010 / 20012INTEGER4.8%两个大数时间戳,128/192 行共用同一个值 237579889225
20043INTEGER19.9%761/795 行是 60,其余是 0/4/12/13/28。像某种 TTL 或缓存档位
20037 / 20048 / 20056 / 20067 / 20075 / 20083INTEGER4.8%几乎全 0,偶有一两行非零,样本不足以定性
20060 / 20061 / 24110INTEGER4.8%本机恒为 0,没有任何信息量
24111INTEGER4.8%190/192 行为 0,2 行是 unix 秒时间戳
20042 / 20059 / 20066BLOB0%全库为空。注意 20059/20066 这两个号在 21000 内部另有含义(特权容器/相册容器),别混
24106 ~ 24109TEXT0%全库为空

三、21000 — 扩展资料(最大的一列) ​

整张表最复杂的东西。BLOB,本机 6% 的行有,中位数 195 字节,最大 9784 字节。 外层 tag 与列号同为 21000,里面按 2200x 分成七个功能块:

text
21000 (BLOB)
└── 21000
    ├── 22003  好友互动标识(拍一拍/一起看/情侣…)
    ├── 22004  VIP 与特权
    ├── 22005  扩展资料(星座/生肖/地区/教育/兴趣/老资料)
    ├── 22006  隐私与状态开关
    ├── 22007  更多开关
    └── 22009  QQ 空间相册

本机全量扫描(682 个非空行)共观测到 142 条 tag 路径。下面只记已定性的。

22003 — 好友互动标识 ​

QQ 资料卡上那排「你和 TA 拍了 12 次」「一起看了 3 部电影」的小徽章。 31000 是 repeated,一个好友可以同时挂多个。

tag字段名含义置信度
31024type类型名:pat(拍一拍)/ intimate / lover / partner_dining / partner_sport / mysteriousCharacter / fire …已验证
31002markId标识种类 id,不是等级。实测按 type 固定:pat=44、spray=75、fire=17已验证
31015—小图标 URL(downv6.qq.com/qqweb/res/mutualmark/<type>/<level>_0_0_small.png)已验证
31019—图标 URL 模板,带 {level}_{sub_level}_{style}_{size} 占位已验证
31001—视觉档位,取值集中在 0 / 64 / 88 / 92 / 144 / 150推测
31003—小整数 1~5,多数为 1推测
31005—计数(互动次数?)0~300推测
31006 / 31017—两个 unix 秒时间戳(点亮时间 / 最近互动时间)推测
31016 / 31018—两个 bool推测
31020—0~6 的小整数(等级?)推测
31012—皮肤/主题子块:20606 是款名(Mangata/Breeze/Copain/Mars),20602/20607 是素材 URL已验证

31002 曾被误读成「等级」。实测同一 type 下所有人的 31002 完全相同(44 出现 25 次), 它是种类 id。真正的视觉等级藏在 31015 图标 URL 的文件名首段(5_0.png → 5 级)。

22004 — VIP 与特权 ​

分两部分:20059 是特权清单(有结构),28xxx 是一堆扁平散列。

20059 特权清单:

tag字段名含义置信度
20431—特权页入口 URL。本人是 club.vip.qq.com/privilege,看别人是 guestprivilege已验证
20432opened已开通特权项(repeated)已验证
20433unopened未开通特权项(repeated)已验证

每一项特权(20432/20433 内部):

tag字段名含义置信度
20447bizId特权业务 id:1 超级会员、4 腾讯视频、101 红钻、102 黄钻、103 音乐 SVIP、105 微云、107 SVIP 音乐、108 微客、109 音乐、113 大会员、116 文档 VIP、117 卡片、118 蓝钻、119 情侣 SVIP已验证
20448level等级,与图标文件名 big_light_N 一致已验证
20444 / 20442iconUrl图标 URL。gray_N = 灰/未开通,big_light_N = 亮/已开通。两个位轮流用,取值时要 20444 || 20442已验证
20441jumpUrl点击跳转 URL已验证
20446—是否已开通的 bool,与所处的 20432/20433 分支一致观测一致
20449—另一个 bool(是否年费?)推测

28xxx 散列 —— 填充率 99.9%(只要有 21000 就有),但绝大多数恒为 0:

tag含义置信度
28004超级会员等级。实测与 bizId=1 那项的 20448 命中 22/24观测一致
28018当前装扮 itemId(10016/10049/59500 等,与 home_dress 用的 itemId 同域)观测一致
28014某个等级值,取值分为 1~8 和 101~108 两段。与超会等级只命中 1/24,不是超会等级推测
280270~26 的整数,66/195 好友非零。曾被当作 QQ 等级候选,但上限只到 26,形态不符推测
28001/28002/28003/28008四个 bool,两两同步(28001 与 28003 完全一致)推测
28015 / 28017 / 28024 / 28026大整数 id / 时间戳,绝大多数为 0推测
28007repeated(一行出现 2 次),取值 0/2/36/258推测
280190/1/2/4,分布均匀推测
28005/28006/28009~28013/28016/28020~28023/28025/28028/28029几乎恒 0推测

22005 — 扩展资料 ​

这一块信息密度最高,也藏着最有意思的东西。

tag字段名含义置信度
20018—星座,1~12 = 水瓶/双鱼/白羊/金牛/双子/巨蟹/狮子/处女/天秤/天蝎/射手/摩羯已验证
20019—生肖,1~12 = 鼠/牛/虎/兔/龙/蛇/马/羊/猴/鸡/狗/猪已验证
20020—血型,0 未填 / 1~5(5 出现 18 次,疑为「其它」)观测一致
20022—职业,0 未填,13(24 次)与 14(15 次)占绝大多数 —— 学生党画像观测一致
20023degree学历(文本,如「初二中级」)已验证
20026school学校(「电子科技大学」「成都信息工程大学」)已验证
20027country国家已验证
20028province省份已验证
20036city城市已验证
20029—邮编(实测多为空,有人填了「621700」,也有人填「看地址」)已验证
20030—详细地址(同样是自由文本,实测「四海为家」「阳光城 77 栋…」)已验证
20038—资料创建/注册时间(unix 秒,多在 2015~2019)推测
20041.20410interests兴趣标签(repeated string)已验证
20042—子块,20401~20405 五个 0~3 的小整数,疑似隐私可见范围推测
20021—未解,见下—
20039—老版个人档案 TLV,见 第八节已验证

关于 20018 / 20019 的验证方式:拿同一行的生日列(20006/20007/20008)算出星座和生肖, 再与这两个 tag 比对 —— 星座 116/118 命中,生肖 103/125 命中。 生肖差的那些是因为部分人填的生日年份不真实(2021-01-01 之类的占位值),星座只依赖月日所以更准。

关于 20021:形如 "49-102-55" / "222-0-229" 的三段串,70 种取值,227 行是 0-0-0。 两个假设都验过、都不成立:

  • 不是昵称颜色 RGB —— 与超级会员开通状态无相关性(开通超会的 16 有色/36 全零, 非超会的 112 有色/191 全零,比例几乎一样)。
  • 不是地区码 —— 同一个段值对应的国家/省/市文本五花八门(第 2 段 104 同时对应 四川、广东、北京、英格兰、台湾、福建)。

数值集中在 48~57 和 97~108 这两段,恰好是 ASCII 的 '0'~'9' 和 'a'~'l', 更像是某个字符串被逐字节拆开存的。留作未解。

22006 / 22007 — 开关位 ​

两块全是 bool 和小整数,本机几乎全为 0。22006.27006 是个毫秒时间戳, 22007.29002 偶尔出现 10115/20124 这类五位数 id。未确认项不解析。

21000 → 22006 → 20032 已通过官方客户端静态路径确认是好友免打扰状态: 0 为关闭、1 为开启,仅字段明确存在时使用。它是 QQ 本机资料缓存,不是服务端写入确认; 缺失、损坏和其他数值保持未知,不能取 recent_contact.41220 代替。 请求参数中的内部字段 26062 不是这里的缓存字段。定位与验证边界见 交互修复记录。

22006 的 20080 / 20081 / 20082 分别是企点主号、员工标记及员工扩展标记。 本机企业账号的实际缓存命中后两项,普通账号三项均为 0;任一正值由 ProfileExtInfo.isEnterprise 表示。机器人与企业用户的获赞指标不适用,不发起 查询、不保留获赞缓存,也不在资料卡、名片及列表显示获赞项。

例外是 22007.29100(botMark,见 packages/codec/src/proto/profile/21000.ts): 只有机器人的资料里有这一块,29101 是类型(1 = 第三方机器人,2 = QQ 官方小Q)。 但它不完整——只有客户端回写过资料的机器人才有,很多真机器人这块还是 NULL。 因此机器人判定要用「21000 里有无 botMark」+「uin 是否落在机器人号段」两路兜底 (见 packages/db/src/profile/profile_info.ts 的 BOT_UIN_RANGES)。

22009 — QQ 空间相册 ​

tag字段名含义置信度
20066.20461—每张照片(repeated)已验证
20471photoId照片 hash已验证
20472time上传时间(unix 秒)已验证
20473.20481size尺寸档位:1 原图 / 2 = 640 / 3 = 160 / 4 = 100已验证
20473.20482url该档位的完整可访问 URL(ugc.qpic.cn/mqq_photo/…)已验证

四个档位是齐全的 —— 实测 78 张照片 × 4 档 = 312 条,一条不缺。所以要缩略图直接取 size=4, 不用自己拼 URL 参数。


四、20017 — 头像摘要 ​

小 BLOB(44~56 字节),19.6% 的行有。结构很简单:

text
20017 (BLOB)
└── 20017
    ├── 20100  头像 md5(32 位 hex)—— 与 20101 二选一
    ├── 20101  头像 md5(32 位 hex)—— 与 20100 二选一
    ├── 20102  头像更新时间(unix 秒)
    └── 20103  同上,或 1

实测 783 行里 20100 出现 637 次、20101 出现 146 次,从不同时出现。 两者应该是「默认头像 / 自定义头像」之类的区分,但没有证据,暂不下结论。

已经排除的两个猜想(各 60 样本,0 命中):

  • 它不是本地头像文件名 hash md5(md5(md5(uid)+uid)+uid)(见 头像 hash 公式)。
  • 它不出现在 20004 那个 CDN URL 的 ek= 参数里。

确定成立的一条:20102 与列 20016 恒等(60/60),所以这两个是同一个时间戳的两份拷贝。

五、20057 — 自定义状态 ​

就是 QQ 资料卡昵称下面那行「在线状态」(如「学习中」「emo 中」)。 本机 4000 行只有 1 行有 —— 这东西 QQ 只给自己和极少数人缓存。

tag字段名含义置信度
1id状态 id(实测 264)已验证
2desc状态文案(实测 "cd ~" —— 自定义文本)已验证
3—bool,恒为 1推测

六、20072 — 密友关系 ​

这一列的存在性本身就是信息:profile_info.ts 里 isFriend 就是判断它非 NULL。 不过实测这个判据不严谨 —— 本机 132 行有 20072,但好友有 195 个,对不上。 判定好友仍应查 buddy_list。

内容极简,132 行里有 129 行是空壳(4 字节,只有外层 tag 没有内容):

tag字段名含义置信度
20073preselectedIds可选的密友关系 id(repeated,实测 81/82/101)观测一致
20074displayId当前展示的密友关系 id观测一致

七、24105 — 签名富文本 ​

不是 protobuf,是 QQ 老式的 [u8 tag][u8 len][payload] TLV 串。 本机 436 行全部能被这个格式完整解析(436/436),且其中 417 行的内容里含 20011 的纯文本签名 —— 所以它是签名的富文本版本,20011 是它的降级纯文本副本。

tag含义置信度
0x03 (3)签名正文(UTF-8)。436 行全有已验证
0x04 (4)地理位置文本(「电子科技大学(清水河校区)」「荷兰阿姆斯特丹」「网安学院图书馆」)已验证
0x94 (148)话题标签(#新的一年 好事鼠不完#、#一约既定 万山无阻#),前缀有几字节二进制已验证
0x90 (144)元数据串:开头就是这个人的 uin,后接 28 位十六进制(如 100000004 + 69fcb339…)观测一致
0x91 / 0x92 (145/146)4 字节大端整数,绝大多数为 0 或 1推测
0x81 / 0x82 (129/130)8 字节,几乎全 0推测
0x95 (149)零长度占位(58 次)推测
0x01 (1)出现 1 次,内容「祈愿平安」推测

解析注意:len 是单字节,所以单段最长 255 字节。签名超过这个长度会怎么切分没有样本, 本机最长的一行 324 字节也是靠多段拼出来的。

八、21000.22005.20039 — 老版个人档案 ​

另一个不是 protobuf 的东西,也是 TLV,但用的是 [u16 tag][u16 len][UTF-8] 大端格式。 本机 14 行有内容,14/14 完整解析。

这是 QQ 十几年前那套「个人档案」问卷的遗留数据 —— 里面装的全是 2008~2012 年填的答案, 现在的 QQ 客户端已经不再展示,但数据一直躺在库里跟着同步。

已观测到的 key(1~55,连续):

key含义实测样例
1~3偶像 / 喜欢的理由 / 喜欢的歌「成龙」「Rammstein」「龙的传人」
4会的乐器「电子琴」「萧」「笛」
5~9电影 / 影片 / 影片类型 / 动画 / 电视剧「变形金刚2」「喜剧片」「兄弟连」
10~12身材 / 最满意的部位 / 性格「苗条」「保密」「活泼开朗」
13休闲方式「电子游戏/网游」「睡觉/发呆」
14~15手机品牌-型号(现用 / 曾用)「诺基亚-5700」「摩托罗拉-」
16~17电脑品牌-型号「华硕(ASUS)-Z99」「惠普(HP)-911」
18MP3 / 随身听「昂达(ONDA)」「魅族(MEIZU)-x3」
19相机「佳能(CANON)-IXUS200」「索尼(SONY)-120」
20~22汽车(现有 / 想要 / 梦想)「大众」「奥迪-TT」「兰博基尼-110」
23~27饰品 / 服装 / 包 / 珠宝 / 鞋 品牌「Converse 匡威」「Jack Jones」「nike」
28~31化妆品 / 护肤 / 饮品类「无」「工夫茶」
32~34去过 / 想去 / 最想去的地方「阳朔」「九寨沟」「塞班岛」
35~37游戏类型 / 游戏 / 网游「格斗游戏」「魔兽争霸3」「跑跑卡丁车」
38~43菜系 / 菜 / 食材 / 餐厅 / 主食 / 饮料「川菜系」「干煸鸡」「可口可乐.雪碧」
44感情状态「热恋中」「未恋过」「追求中」
45~48书类型 / 书 / 作者 / 杂志「小说」「诛仙」「唐家三少」「读者」
49~51宠物 / 奶粉 / 母婴品牌「金毛寻回犬」「雀巢」「强生」
52~55运动 / 另一项运动 / 运动品牌 / 运动员「足球」「游泳」「李宁」「刘翔」

WARNING

这一列会被 raw protobuf 解码器误判成嵌套消息或字节串。 想读它必须先按 u16 TLV 拆, 直接丢给 protobuf 解析器会得到一堆无意义的假 tag。这是本页第二个容易踩的坑。


九、没找到的东西 ​

诚实记录两个确认不在这个库里的字段,省得下次再翻一遍。

QQ 等级 ​

全库找过,没有。筛查方法:QQ 等级的形态特征是「好友几乎人人有、取值 1~256 连续宽分布」, 按这个形态扫了 195 个好友行的全部 44 个标量列 + 21000 里的全部整数 tag, 形态匹配的候选只有这些,逐个排除:

候选为什么不是
列 20007 / 20008是出生月(1~12)和出生日(1~31)
列 24103是年龄,与生年吻合 179/180
21000.22004.20448是 SVIP 等级(1~9),只有开通的人有
21000.22004.28004同上,与 20448 命中 22/24
21000.22004.28027上限只到 26,且只有 66/195 好友非零
21000.22005.20018/20019星座 / 生肖,都是 1~12

结论:QQ 等级是现拉的,不落库。 合理 —— 等级每天变(活跃度累加), 缓存进本地库只会立刻过时,客户端显示时走接口反而更简单。

昵称颜色 / VIP 颜色 ​

同样没有。唯一形似的 21000.22005.20021("49-102-55" 三段串)已在 22005 节 排除 —— 与超会状态无关,与地区也无关。

推论:昵称颜色是客户端按 bizId + level 算出来的,不是存下来的。21000.22004.20059 里已经有完整的特权清单(谁开了超会、几级、图标 URL 是 big_light_4 还是 gray_0), 客户端拿这些就够渲染颜色了,没必要再存一份颜色值。


十、常见查询 ​

WeQ 实际读的列(profile_info.ts 的 SELECT_COLUMNS):

sql
SELECT "1000","1001","1002","20002","20004","20006","20007","20008",
       "20009","20011","20014","20057","20070","20072","24103","24104","21000"
FROM profile_info_v6
WHERE "1000" = ?

按昵称搜人 —— 不要用 FTS(pinyin_letter 分词器不存在,见 库总览):

sql
SELECT "1000","20002" FROM profile_info_v6 WHERE "20002" LIKE ? LIMIT 50

批量补昵称(WeQ 的 nicksByUids,避免 N 次单查):

sql
SELECT "1000","20002" FROM profile_info_v6 WHERE "1000" IN (?,?,?,…)

← 返回 profile_info.db | ← 返回数据库分析

当前文档对应 v2.7.4 · 已发布内容以 CHANGELOG 为准