Skip to content

recent_contact_v3_table — 会话列表 ​

nt_msg.db 里的最近会话列表,一行 = 一个会话(好友 / 群 / 临时会话 / 公众号 / 频道…)。 它是聊天软件左侧那一栏的数据源:会话名、头像、最后一条消息的外显文本、时间、免打扰状态全在这里。

对应 WeQ 解析实现:

文件职责
packages/db/src/contact/recent_contact.ts取行 + 列 → RecentContact
packages/db/src/contact/types.tsRecentContact 的字段语义
packages/codec/src/proto/msg/40051.ts40051 预览列的 protobuf 外壳

一、这张表的定位 ​

关键认识:这张表是一份「冗余快照」,不是消息表的视图。

会话的最新一条消息,其正文明明已经存在 c2c_msg_table / group_msg_table 里, QQ 仍然把「发送者昵称 / 群名片 / 外显文本 / 头像路径」等一整套展示信息再抄一份进这张表。 原因很实际:渲染会话列表时不能为每个会话都去消息表里查一次、再去 profile 库查一次昵称, 那是 N 次跨库查询。抄一份进来,列表就是一条 ORDER BY 40050 DESC LIMIT n。

带来的两个后果,写代码时必须记住:

  1. 这里的展示信息可能过时。对方改了昵称、群改了名,只有下次这个会话来消息、这一行被重写时才会更新。 要「当前」的昵称/群名,得去 profile_info.db / group_info.db,不能信这里。
  2. 删掉这一行 ≠ 删掉聊天记录。QQ 里「删除会话」删的就是这一行,消息表纹丝不动。 WeQ 的「WeQ 助手」开关也正是这么做的(关掉只删 recent_contact_v3_table 的行, c2c_msg_table 从不动 —— 见 packages/service/src/account/weq_assistant.ts)。

二、列结构 ​

WeQ 实际读取的列(SELECT 见 recent_contact.ts),按用途分组。

会话身份 ​

列字段名类型含义置信度
41102—INTEGER行主键。WeQ 只在插入伪造会话时用到(取 MAX + 随机),读取路径不关心观测一致
40010chatTypeINTEGER会话类型,见下方 ChatType已验证
40021targetUidTEXT会话标识:c2c 是对端 uid,群是群号已验证
40030targetUinINTEGER会话对端的 QQ 号(c2c 用;无则 0)已验证
40027—INTEGER会话 sortNo,同 nt_uid_mapping_table.48901,与消息表的分区列同义观测一致

注意 40021 一列同时兼任「好友 uid」和「群号」两种身份 —— 靠 40010 区分。 这与消息表的 40021 是同一约定。

最后一条消息 ​

列字段名类型含义置信度
40001—INTEGER最后一条消息的 msgId,指回消息表观测一致
40003msgSeqINTEGER最后一条消息的序列号。未读数就是拿它减去已读 seq 算的,见 msg_unread_info_table已验证
40011—INTEGER最后一条消息的 msgType,枚举同 40900 · MsgType观测一致
40050sendTimeINTEGER最后一条消息的时间,unix 秒。无草稿时它就是排序时间,见 41136已验证
41136—INTEGER排序键。无草稿时 = 40050;有草稿时替换成草稿时间;置顶行另置 2^47 高位。见 41136 — 真正的排序键观测一致
40051previewBLOB外显预览,protobuf,见下方第三节已验证

发送者展示信息(最后一条消息的发送者) ​

列字段名类型含义置信度
40020senderUidTEXT发送者 uid已验证
40033—INTEGER发送者 QQ 号观测一致
40090senderDisplayNameTEXT发送者展示名,群聊场景主要是群名片已验证
40093senderNickTEXT发送者昵称已验证
40095senderRemarkTEXT发送者备注名已验证

三个名字列的优先级由使用方决定。WeQ 的会话列表取 senderDisplayName || senderNick。

会话自身展示信息 ​

列字段名类型含义置信度
40094targetDisplayNameTEXT会话名:好友昵称 / 群名已验证
41135targetRemarkTEXT会话备注名(好友备注)已验证
41110targetAvatarTEXT会话头像。是本地文件的绝对路径,不是 URL —— QQ 直接读这个路径渲染已验证
41148targetGroupNickTEXT对方的群名片,只在「群里发起的临时会话」行上有值,其它场景为空观测一致

41110 是本地路径这一点被 WeQ 反向利用:「WeQ 助手」把自己的头像图片写进 QQ 自己的 nt_data/avatar/weq/ 目录,再把绝对路径填进这一列,QQ 就会像渲染任何缓存头像一样渲染它。

会话设置与来源 ​

列字段名类型含义置信度
41220notifyLevelINTEGER免打扰。0/1 = 正常提醒,其它值(实测 4)= 免打扰已验证
60001tempSourceGroupCodeINTEGER临时会话的来源群号。非临时会话为 0已验证

41220 是逆向出来的:开关某个群的免打扰、前后各 dump 一次整行做 diff,只有这一列变。 84 个群被这一列干净二分。msg_unread_info_table 里没有免打扰字段,别去那边找。

判定写法(MainView.tsx):

ts
function mutedFromNotifyLevel(notifyLevel: number | undefined): boolean {
  return notifyLevel !== undefined && notifyLevel !== 0 && notifyLevel !== 1;
}

60001 用于「群 xxx 的临时会话」这种标题回退:群还在我的群列表里就显示群名,退群了就退化成群号。

草稿与置顶标记(41103 / 41104 / 41108) ​

列字段名类型含义置信度
41103topTimeINTEGER置顶时间,unix 秒。与 recent_contact_top_table 的同名列逐秒相等;未置顶为 0已验证
41104pinnedINTEGER置顶标记:1 = 已置顶,0 = 未置顶已验证
41108draftTimeINTEGER草稿更新时间,unix 秒。与 draft_storage_table_v1 同会话行的 40050 逐秒相等;无草稿为 0已验证

这三列都只在极少数行上非零,且长期被误读 —— 因为最常见的观测环境里,「置顶」和「有草稿」 总是同时发生,两个特征叠在同一批行上。用下面这组对照样本才能把它们拆开 (162 行取 3 行,覆盖置顶 × 草稿的四种组合里的三种):

会话411034110441108置顶有草稿
100000001(群「示例群 A」)178550906311790184773✅✅
u_EXAMPLEFRIEND…(好友 示例好友)178550905711790184913✅✅
100000002(群「示例群 B」)001790185263❌✅

由此定案:

  • 41104 是置顶标记,不是草稿标记。 判据是集合恒等:41104 = 1 的行集与 recent_contact_top_table 的行集完全相等,而上面那个未置顶的草稿群 41104 = 0。
  • 41108 是草稿时间。 三行的 41108 都与 draft_storage_table_v1 对应行的 40050 逐秒相等,与置顶无关。
  • 41103 是置顶时间,与 recent_contact_top_table.41103 逐秒相等(其含义见 recent-contact-top)。

验证手法值得记一笔:41108 与 trigger 无关 —— nt_msg.db 里一条 trigger 都没有 (sqlite_master 里 type='trigger' 零行),这个值是 QQ 进程自己写的。 用 SQL 往草稿表插一行(40050 写成未来时间)时 QQ 界面毫无反应, 只有在输入框里真的改动草稿才更新 —— 详细时间线见 draft-storage · 直接写表会被 QQ 认吗。

41136 — 真正的排序键 ​

41136 常见值是「与 40050 相等」,很容易被当成无意义的时间镜像;但拿上面 3 行一比对, 它其实是个复合排序键,编码了「这条会话该排在列表的哪个位置」:

会话40050(最后消息)41136解释
10000000217901841241790185263= 草稿时间(草稿比最后消息新,会话应被顶上去)
1000000011790029015140739278540101= 2^47 + 1790184773(草稿时间,外加置顶标记)
u_EXAMPLEFRIEND…1790182808140739278540241= 2^47 + 1790184913(同上)

规则可以这样概括:

text
41136 = 2^47 × [已置顶] + 排序时间
排序时间 = 有草稿 ? 草稿时间 : 40050

会话因此会被草稿顶到前面:输入框里打了字,列表里那条会话就冒到最上面。置顶行再置上 bit 47(2^47 = 140737488355328),排序时一次比较就能把置顶组整体提前、组内仍按同一 时间轴排。

全表 162 行里 159 行 41136 = 40050,剩下 3 行正是上面这些有草稿的行 —— 所以「无草稿时 41136 = 40050」这个旧观察本身没错,只是漏掉了有草稿时的情形。

未验证的两点,别当成结论:

  • 「有草稿就取草稿时间」还是「取两者较新者」分不出来。 实测 3 行的草稿时间都晚于 最后消息时间(刚打的草稿必然最新),两种解释给出同一个值。要区分得构造 「仓库里有旧草稿 + 之后来了新消息」的场景。
  • bit 47 是「已置顶」标记这一条只有 2 个样本支撑(实测有草稿的行恰好都置顶), 归为观测一致而非已验证。

三、40051 — 外显预览 ​

会话列表里那句「张三:[图片]」的来源。它是 protobuf,外壳里只有一个 tag 同为 40051 的子消息:

text
40051 (BLOB)
└── 40051  PreviewElementWire     ← 单个消息段,不是列表
    ├── …  与 40800 的 ElementWire 完全相同的全部字段
    └── 49093  displayText        ← 会话列表外显文本

理解要点:

  • 它就是一个 ElementWire(结构见 40800 解析),只是单个,不是 repeated。 多消息段的消息(图 + 文)只挑第一段做预览。
  • 多出来的只有一个 tag:49093,装的是最终外显文本。图片消息这里就是 "[图片]", 也就是说外显文案是 QQ 写进库的,不需要解析方自己按类型翻译。
tag字段名类型含义置信度
49093displayTextstring会话列表外显的最新消息文本已验证

解码同样先过 sanitizeBytes 容错(原因见 40800 · 容错解码), 一个猜错类型的 tag 不至于让整个会话列表少一行。

四、ChatType(会话类型) ​

40010 的取值,来自 QQ NT 自身的 KCHATTYPE* 枚举(packages/codec/src/domain/msg/enums.ts)。 下表按「WeQ 是否实际渲染」分组,值全部来自枚举定义本身。

常规会话 ​

值名称说明
1KCHATTYPEC2C好友单聊
2KCHATTYPEGROUP群聊
3KCHATTYPEDISC讨论组(历史遗留)
8KCHATTYPEDATALINE数据线(我的手机 / 电脑 / 平板),消息落在 dataline_msg_table
134KCHATTYPEDATALINEMQQ数据线(手机 QQ)

临时会话 ​

值名称说明
99KCHATTYPETEMPC2CFROMUNKNOWN来源未知的临时会话
100KCHATTYPETEMPC2CFROMGROUP群聊发起的临时会话,来源群号在 60001,对方群名片在 41148
101KCHATTYPETEMPFRIENDVERIFY好友验证
102KCHATTYPETEMPBUSSINESSCRM商家客服
103KCHATTYPETEMPPUBLICACCOUNT公众号 / 服务号
111KCHATTYPETEMPADDRESSBOOK通讯录来源
117KCHATTYPETEMPWPA网页发起会话
119KCHATTYPETEMPNEARBYPRO附近的人(Pro)

系统 / 折叠入口 ​

这些不是真人会话,而是各种「助手」「通知」的折叠入口。

值名称说明
5KCHATTYPEBUDDYNOTIFY好友通知
6KCHATTYPEGROUPNOTIFY群通知
7KCHATTYPEGROUPHELPER群助手
30KCHATTYPESUBSCRIBEFOLDER订阅号折叠
40KCHATTYPEWEIYUN微云
41KCHATTYPEFAV收藏
42KCHATTYPEADELIEAdelie(内部)
104 / 109KCHATTYPEMATCHFRIEND(FOLDER)交友匹配(及其折叠)
105 / 116KCHATTYPEGAMEMESSAGE(FOLDER)游戏消息(及其折叠)
106 ~ 112KCHATTYPENEARBY*附近的人相关(助手 / 折叠 / 互动 / 打招呼折叠)
113KCHATTYPECIRCLE圈子
115KCHATTYPESQUAREPUBLIC广场
118 / 201KCHATTYPESERVICEASSISTANT(SUB)服务号助手(及子项)
131KCHATTYPERELATEACCOUNT关联账号
132KCHATTYPEQQNOTIFYQQ 官方通知
133KCHATTYPEGROUPBLESS群祝福

频道(被 WeQ 排除) ​

值名称说明
0KCHATTYPEUNKNOWN占位
4KCHATTYPEGUILD频道
9KCHATTYPEGROUPGUILD群频道
16KCHATTYPEGUILDMETA频道元信息

16 被 WeQ 显式过滤掉(BLOCKED_CHAT_TYPES)。原因是频道行换了一套列布局: 会话名在 40091 而不是 40094,预览嵌在 41150 而不是 40051,也没有头像列 —— 按常规列读出来是一行空白,不如不显示。

五、常见查询 ​

会话列表(WeQ 的读法):

sql
SELECT "40003","40010","40020","40021","40030","40050","40051",
       "40090","40093","40094","40095","41110","41135","41148","41220","60001"
FROM recent_contact_v3_table
WHERE "40010" NOT IN (16)          -- 排除频道元信息行
ORDER BY "40050" DESC
LIMIT ? OFFSET ?;

40050 上有索引,会话数量本身也就几百,所以单条有序 LIMIT 足够,不需要分页优化。

注意排序键:QQ 自己排序用的是 41136(见 41136 — 真正的排序键), 它会把「有草稿」的会话按草稿时间提前。

上面的 SQL 是 WeQ 取会话行的读法(按 40050 分页拉窗口);真正决定列表次序的排序 在渲染层重做:置顶会话整体排最前,置顶与非置顶两组内部均按 max(40050, 41108) 倒序,不按 41103 的置顶操作时间排 —— 即「最后消息时间」与「草稿时间」取较新者,让打了字 的会话冒头。为此额外读一条轻量查询:

sql
SELECT "40021","41108" FROM recent_contact_v3_table WHERE "41108" > 0;

与 QQ 的 41136 有一处差别:41136 的官方语义到底是「有草稿就取草稿时间」还是 「取较新者」尚未验证(见上文「未验证的两点」),WeQ 选的是后者 —— 两者的差别只会在 「仓库里有旧草稿、之后又来了新消息」时显现。另外 WeQ 排序只认库里的时间:输入框里 正在编辑、还没写回库的内容不参与排序(写回时机见 draft-storage · 写入策略)。

会话的置顶状态在 recent_contact_top_table 里有完整登记(靠 40021 / targetUid 关联); 本表的 41103 / 41104 也各存了一份置顶时间与置顶标记的副本。


← 返回 nt_msg.db

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