Skip to content

profile_info.db — 资料数据库 ​

profile_info.db 存人:好友、陌生人、机器人、公众号的资料,以及好友列表和分组。 本栏目的内容全部由 WeQ 依据自己的解析实现手写维护。

对应 WeQ 解析实现:

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

表一览 ​

本机实测(52243 行 profile / 195 个好友)的完整表清单:

表行数量级内容文档
profile_info_v65 万+资料主表,一行 = 一个人profile-info-v6
buddy_list好友数好友名单(权威)下见
category_list_v21好友分组定义(打包在一个 BLOB 里)下见
buddy_req_list_5十几好友申请列表下见
profile_info_adelie个位数AI 机器人资料(元宝 / Q 群管家等),88 列下见
profile_info_public_account个位数公众号 / 服务号资料下见
user_sec_quality_table1账号安全等级下见
user_tab_table1资料卡页签配置下见
user_like_id_table0点赞(本机为空)—
adelie_uid_friends / adelie_uid_recommended_v20AI 机器人好友 / 推荐(本机为空)—
profile_info_v6_fts*—资料全文索引(pinyin_letter 分词器)下见
profile_info_public_account_fts*—公众号全文索引同上

profile_info_v6 — 资料主表 ​

44 列,是这个库的绝对主体,单独成篇:profile_info_v6 详解。

一句话概括它的定位:这是一张缓存表,不是好友表。5 万多行里只有 195 个是好友, 其余全是「在群里见过一面」的陌生人。判定谁是好友要去 buddy_list,不能靠这张表有没有行。

buddy_list — 好友名单 ​

四列,短小但权威 —— 判定「是不是我好友」以这张表为准。

列含义置信度
1000uid(主键)已验证
1001QID(个性 ID,多数为空串)已验证
1002uin(QQ 号)已验证
25007所属分组 id,对应 category_list_v2 的分组。未分组的好友这里是 NULL 而非 0已验证

它与 profile_info_v6 同库,所以「好友 + 资料」是一次普通 JOIN,不用跨库:

sql
SELECT b."1000", b."1002", p."20002", p."20009", p."20070"
FROM buddy_list b
LEFT JOIN profile_info_v6 p ON b."1000" = p."1000"
ORDER BY COALESCE(p."20070", 0) DESC   -- 按亲密度排

这正是 WeQ「好友亲密度排行」用的查询(listFriendsByIntimacy)。用 LEFT JOIN 而非 INNER JOIN 是因为存在有好友关系但资料行缺失的情况,用内连接会悄悄少人。

category_list_v2 — 好友分组 ​

只有 1 行,因为所有分组打包在一个 BLOB 里(25011),不是一组一行。

列含义置信度
1000自己的 uid已验证
25006好友总数(实测 1640,含单向/历史)推测
25013另一个计数(实测 644)推测
25012 / 20075两个毫秒时间戳(版本 / 拉取时间)推测
25011分组定义列表,protobuf已验证
25015序列号推测

25011 的结构 —— 外层 tag 与列号同为 25011,repeated,一项一个分组:

text
25011 (BLOB)
└── 25011  分组项 (repeated)
    ├── 25007  分组 id
    ├── 25008  分组名
    ├── 25009  排序序号(本机恒等于分组 id)
    └── 25010  组内好友数

本机实测(5 个分组):

25007 分组 id25008 分组名25010 人数
0我的好友185
1日本朋友1
2家人3
3同学4
4老师2

WARNING

buddy_list."25007" 在本机 185 行是 NULL,只有被手动分过组的 10 个好友有值。

也就是说「默认组」是靠 NULL 表达的,不是靠写 0。按 25007 = 0 查默认组会查空 —— 要用 COALESCE("25007", 0)。这是本页最容易踩的一个坑。

buddy_req_list_5 — 好友申请 ​

26 列,一行 = 一条好友申请。已确认语义的列:

列含义置信度
21204申请时间(unix 秒)已验证
21001申请方 uid已验证
20002申请方昵称已验证
20004申请方头像 URL已验证
21509来源描述文本("QQ群" / "群查找" / "搜索账号"…)已验证
60001来源群号(从群里加的才有,否则 0)已验证
21505请求类型 BuddyReqType:0 自己发起、1 对方发起待处理、2–5 同意类结果、6–7 拒绝类结果、13 自己发起等待确认本机样本与 NTQQ 类型定义交叉核对;不是来源类型码,13 不是过期
21502isInitiator:0 对方发起,1 自己发起;读取层沿用旧字段名 isAccepted收到待处理、收到已同意、自己发出待确认三类样本对账;不是同意标记
21501isDecide:0 未处理,1 已处理;读取层沿用旧字段名 initiator同上;不是申请方向
21510 / 21511共同好友数 / 共同群数推测
21515 / 21526 / 21537各类状态 bool(已读 / 已处理 / 可回关…)推测

2026-10-26 更正:此前把 21502 当作同意标记、21501 当作方向,会把收到的未处理申请 误标成已同意并隐藏审批入口。三类字段组合分别为 (21502, 21501, 21505) = (0, 0, 1)、 (0, 1, 3)、(1, 0, 13),与 NapCat 原始通知记录 及 BuddyReqType 定义 一致。未建模的请求类型显示状态未知,不推断同意或允许审批。

profile_info_adelie — AI 机器人 ​

88 列,是全库列数最多的表,但只装 QQ 官方 AI 机器人(本机 4 行:元宝小 Q、Q 群管家等)。 adelie 是 QQ 内部对这套 AI 体系的代号(会话类型 KCHATTYPEADELIE = 42 也是它)。

已辨识的列:

列含义置信度
1000 / 1002uid / uin已验证
320001机器人名("元宝小Q" / "Q群管家")已验证
320002头像 URL已验证
320003长简介已验证
320004欢迎语已验证
320007归属方("@QQ")观测一致
320008 / 320009资料卡配图 / 背景图 URL观测一致
320068主题色,形如 #1E74FF 的 CSS 十六进制串已验证
320047创建/更新时间(unix 秒)观测一致
320011语音配置(音色 id + 试听 URL),protobuf观测一致
320084合规声明(规则链接 +《…信息处理规则》标题)观测一致
320086模型清单,内嵌 JSON:{"model_list":["hy3","hy3-think","deepseek-v4-pro",…]}已验证
320066功能入口列表(AI 搜索 / 画图 / 录音纪要…图标 + 文案)观测一致
320065 / 320082资料卡 / 聊天背景素材组推测

剩下 60 多个 3200xx 列在本机全是 0 或空。这张表 QQ 明显是按「最大化字段」建的, 实际填充的不到三成 —— 与其瞎猜,不如留空。

其余小表 ​

profile_info_public_account —— 公众号/服务号,6 列:1000 uid、1002 uin、 20002 名称(本机全空)、410001 类型码(实测恒为 3)、410002 更新时间(毫秒)、20032。

user_sec_quality_table —— 只有自己一行,20501 是个 6 字节 protobuf,解出来只有 { 20501: { 1: 1 } } 一个位。样本只有 1 个,语义不下结论。

user_tab_table —— 只有自己一行,49572 是资料卡页签配置,repeated: [{49573:2, 49574:1}, {49573:1, 49574:0}] —— 两个页签项,各带一个 id 和一个显隐/顺序位。

FTS 表打不开是正常的 ​

profile_info_v6_fts / profile_info_public_account_fts 用 PRAGMA table_info 一碰就报:

text
Error: no such tokenizer: pinyin_letter

这不是解密失败,而是这两张虚拟表声明了腾讯自己实现的拼音分词器,SQLite 本体没有它。 所以:

  • 别去查 *_fts 虚拟表,会直接抛错;扫全库表清单时要 try/catch 包住。
  • 想要索引内容,读它的影子表 *_fts_data / *_fts_idx / *_fts_docsize(普通表,能读)。
  • 按昵称搜人不要指望 FTS,直接 LIKE 扫 profile_info_v6."20002" 就行 —— 5 万行 SQLite 扛得住。

← 返回数据库分析

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