msg_unread_info_table — 未读信息
设备会话未读使用真实 chatType(8/134)和设备伪 UID,不复用普通私聊的 1_uid 水位。 设备未读直接采用小表独立计数及手动标志,不用普通会话序号差,也不遍历设备消息历史。 账号配置切换隔离来源及迟到结果。
nt_msg.db 里记录每个会话读到哪了的表,两列而已,但第二列是一个嵌套 protobuf, 里面藏着「特别关心 / @我 / @全体 / 回复我 / 新文件 / 群公告 / 群提醒词」这些提醒标记 —— 它们不是独立的列或表。
对应 WeQ 解析实现:
| 文件 | 职责 |
|---|---|
packages/db/src/msg/unread_info.ts | 取行 + 展平高亮 → UnreadInfoResult;markRead() 抬已读 seq、清高亮组 |
packages/codec/src/proto/msg/48902.ts | 48902 blob 的 protobuf 结构 |
apps/desktop/src/renderer/src/im-template/template/unreadDock.ts | 把未读/高亮转成「跳转点」序列(纯函数) |
一、列结构
只有两列:
| 列 | 类型 | 含义 |
|---|---|---|
| 48901 | TEXT | 会话键,格式 "chatType_uid",如 2_100000001(群)、1_u_xxxx(好友) |
| 48902 | BLOB | 未读信息 protobuf,见下 |
注意
48901/48902这对列号在nt_uid_mapping_table里是另一套含义(sortNo / uid)。 QQ 的列号只在表内唯一,跨表复用很常见,不要按列号去猜语义。
查询就是一次主键命中:
SELECT "48901", "48902" FROM msg_unread_info_table WHERE "48901" = ? LIMIT 1;
-- 参数形如 "2_100000001"二、直接使用 QQ 维护的未读状态
可写私聊/群聊用 max(41002, 41032) 作阅读下限, 从最近会话最新序号差中扣除区间内去重的 41024.40003 减计数项。 QQ 已维护减项集合,WeQ 不再查询消息表重建发送者列表。 最近会话小表的 40020 确认最新消息为自己发出时,该序号也参与去重扣减, 补偿跨端自发消息与 QQ 减项更新之间的短暂时差,不提高阅读水位。 手动未读通过 41027 维持最小标记,不降低水位。
41022 与 41037 是特定会话使用的独立计数,并不是普通会话的通用当前未读数。 设备会话按类型读取独立计数。缺阅读字段时不将全历史序号解释成未读,使用可用标志和提醒; 暂时失败保留旧结果,下一次小表更新自动修正。
unread.json 只供只读目录及数据线会话保存 WeQ 的显式阅读/手动标记。 不再保存实时未读序号集合,也没有精确统计队列。完整行为见 统一未读来源。
三、48902 的结构
外壳只有一个 tag 同为 48902 的子消息。整体形状(已在真实 blob 上验证):
48902 (BLOB)
└── 48902 {
├── 40010 chatType 会话类型(与 48901 前缀重复)
├── 40021 peerUid 会话 uid(与 48901 后缀重复)
├── 41002 msgSeq ★ 已读到的消息序号
└── 50005 { 会话扩展
├── 50001 peerUid 再重复一次
├── 50002 chatType 再重复一次
└── 50060 { ★ 提醒高亮组(没有提醒时整块不存在)
├── 50000 kind 类别码,见第四节
└── 50040 { 该类别下的高亮消息(可多条)
├── 50020 msgSeq
├── 50022 senderUid
├── 50023 sendTime
└── 50024 text
}
}
}
}顶层字段
| tag | 字段名 | 类型 | 含义 | 置信度 |
|---|---|---|---|---|
| 40010 | chatType | uint32 | 会话类型,同 recent_contact_v3_table.40010 | 已验证 |
| 40021 | peerUid | string | 会话 uid | 已验证 |
| 41002 | msgSeq | uint32 | 已读到的消息序号 | 已验证 |
| 41024 | decreases | repeated message | 减计数项,子项 40003 为序号 | QQNT macOS 机器码与小表样本核对 |
| 41027 | markUnread | uint32 | 手动未读标志,非条数 | 同上 |
| 41032 | localReadSeq | uint32 | 本地阅读水位,非条数 | 同上 |
| 41022 | unreadCount | uint32 | 特定会话独立计数 | 已定位存储 setter,不作普通会话通用计数 |
| 41037 | localUnreadCount | uint32 | 本地消息独立计数 | 同上 |
| 50005 | ext | message | 会话扩展,见下 | 已验证 |
会话扩展(tag 50005)
| tag | 字段名 | 类型 | 含义 | 置信度 |
|---|---|---|---|---|
| 50001 | peerUid | string | 会话 uid(重复 40021) | 已验证 |
| 50002 | chatType | uint32 | 会话类型(重复 40010) | 已验证 |
| 50060 | highlight | repeated message | 提醒高亮组,见下 | 已验证 |
普通会话的 50005 里只有 50001 / 50002 两个字段,没有 50060。 所以判定很直接:50060 存在 ⇒ 这个会话有提醒类未读。
提醒高亮组(tag 50060)
| tag | 字段名 | 类型 | 含义 | 置信度 |
|---|---|---|---|---|
| 50000 | kind | uint32 | 类别码,见第四节 | 已验证 |
| 50040 | items | repeated message | 该类别下的高亮消息 | 已验证 |
每个类别一个 50060 组,壳子结构完全一样,只有 50000 的值不同。所以它被建模成 repeated。
高亮消息(tag 50040)
| tag | 字段名 | 类型 | 含义 | 置信度 |
|---|---|---|---|---|
| 50020 | msgSeq | uint32 | 该条消息的序号 | 已验证 |
| 50022 | senderUid | string | 发送者 uid | 已验证 |
| 50023 | sendTime | uint32 | 发送时间,unix 秒 | 已验证 |
| 50024 | text | string | 预览文本,实测常为空 | 观测一致 |
四、50000 类别码枚举
这是本页的重点。这批码不是从 QQ 的枚举表抄来的,QQ 前端不暴露它; 它是逐个触发场景、每次抓一份 blob 做 diff 逆向出来的 —— 同一个群(100000001)反复制造不同提醒, 观察到壳子完全不变、只有 50000 的值在变,于是把值和场景一一对上。
| 值 | 类别 | WeQ HighlightKind | 触发场景 | 置信度 |
|---|---|---|---|---|
| 1000 | @我 | atMe | 群里有人 @ 我 | 已验证 |
| 1002 | 回复我 | replyMe | 群里有人回复我的消息 | 已验证 |
| 1006 | 特别关心 | specialCare | 被设为「特别关心」的好友/群友发来消息 | 已验证 |
| 1007 | QQ 红包 | redPacket | 会话内有未领取的红包 | 观测一致 |
| 2000 | @全体 | atAll | 群里有人 @全体成员 | 已验证 |
| 2001 | 新文件 | newFile | 群文件有新上传 | 已验证 |
| 2005 | 群公告 | groupAnnouncement | 群公告有更新 | 已验证 |
| 2006 | 群提醒词 | groupKeyword | 群里有人发出你设置的「关注词 / 提醒词」 | 已验证 |
未映射到的码会落到 'unknown',同时保留 rawKind 原值,方便后续继续逆向。
补一个新类别的成本很低 —— 三处各加一行: HIGHLIGHT_KIND_BY_CODE(db)、ConversationHighlightKind(前端类型)、ConversationList 的渲染分支。
数值本身也透着分组规律:
10xx像是「找我的」(@我 / 回复我 / 特别关心 / 红包),20xx像是「群内广播」(@全体 / 新文件)。未验证,仅供继续逆向时参考。
五、展平约定
一个类别下可能有多条高亮消息(比如被 @ 了三次)。WeQ 每个类别只保留 seq 最大的那一条 (extractHighlights),因为界面只需要「有没有」这个布尔,msgSeq 保留但不展示。
结果对象:
interface UnreadHighlight {
kind: HighlightKind; // 映射后的类别
rawKind: number; // 50000 原值,未映射类别也能被识别
msgSeq: number; // 该类别下最新的一条
senderUid: string;
sendTime: number;
}五之二、标记已读(markRead)
打开会话时 WeQ 会把未读/高亮「读进内存 → 标记已读」:
getUnreadInfo()读出高亮与已读水位(这一步必须在清库之前,清完就没了);markRead(chatType, uid, latestSeq?)把该会话标记为已读:- 把
41002抬到会话最新 seq(latestSeq,缺省时从recent_contact_v3_table.40003读); - 只删除确认水位以内的
50040高亮条目;组内条目全部读完后删除对应50060组。 新到的提醒和无法识别序号的条目保留(组在50005.ext里,需要深度查找)。
- 把
写回通过原 48902 BLOB 比较更新,避免覆盖 QQ 在读取之后写入的新水位或提醒; 冲突时重新读取并重算,最多尝试三次,耗尽后报错。目标水位在首次请求时固定, 重试不会跟随新消息扩大已读范围。addHighlight 同样使用比较更新和有限重试, 且不补写已读水位以内的晚到提醒。
关键:写回走 wire 级编辑树,不能用 schema 重编码。 48902 里有大量 WeQ 还没 逆向的字段(例如 50006/50007),历史版本用不完整 schema 重编码时, 用 ProtoMsg(UnreadInfo).encode() 重新序列化会把它们全丢掉(实测 405 字节 → 335 字节)。 所以 markRead 用 @weq/codec/raw 的 buildEditTree / updateNode / removeNode / encodeEditTree:只修改阅读、手动标记及范围内高亮路径,其余节点逐字节照抄原文, 未解析字段原样保留(回归见 packages/db/test/unread_info.test.ts)。
幂等:已无需要清理的高亮且 41002 ≥ latestSeq 时直接返回 false,不再写库。 静态账号(离线快照)在 IPC 层直接短路 —— 写进去 QQ 也不会读。
未读列表刷新
getUnreadInfos(targets) 每批最多 256 个会话,一条 SQL 同时取已读 BLOB 和最近会话 最新序号。目标去重,缺行返回空水位,单行解码失败用 readError 标记,不清除其旧状态, 也不阻塞同批正常会话。临时会话等无法按标准类型关联最新序号时,前端保留最近会话列表水位兜底。
账号服务用 getAllUnreadInfos() 共享两张小表的快照;文件变更合并为 50ms 刷新窗口, 有订阅者时再共享每 1.5 秒补查。前端首批统一交付,不维护精算队列。 失败保留上一次结果;标记操作保存固定位置,写入失败自动重试,不扩大确认范围。
可选服务端上报
全局偏好 reportReadEnabled 默认开启,已有配置沿用原值;会话列表设置不再提供上报开关。 开启后,桌面端已读入口在本地写入完成后异步请求 trpc.msg.msg_svc.MsgService.SsoReadedReport,不阻塞聊天页,也不批量补报开启之前的阅读。 上报关闭时取消尚未发出的重试,但不能撤销已发出的网络请求。
- 群聊:
group@1 { groupUin@1, sequence@2 }。 - 私聊:
c2c@2 { targetUid@2, timestamp@3, sequence@4 }。序号取本地40003, 时间取这个序号对应的原消息40050,不使用clientSeq或当前时间;缺少消息则跳过。 - 序号必须处于本地最近会话水位内;设备伪 UID、临时会话无法关联的水位与不支持的类型不猜测上报。
- PC 签名白名单包含该命令,必须
needSign=true,复用已有 SSO 与本机 wrapper,不新增登录、 不为上报触发读内存或提权。完全离线、静态账号、缺少已登记的在线会话时不上报。 - 同会话合并重复请求,较大水位等待在途请求后上报。传输异常最多尝试三次,退避 150ms / 450ms; 重试前检查开关、账号生命周期、PID 与 SSO 会话代次,切换后不再发送旧请求。
- 空 SSO 应答记作
acknowledged,仅表示收到上报应答;未知非空响应记作unconfirmed, 不猜业务成功,也不因未知响应直接重发。本地阅读结果与上报状态分别返回。
设置页仅显示同步开关和功能说明,不展示或轮询最近上报状态;服务层继续记录上报结果。没有持久化补报队列, 重启后不会自动补报历史;后续在 WeQ 触发阅读时可再次尝试。 本地写入或空 SSO 应答都不代表 QQ 本体界面及手机等其它端已确认已读,实际同步仍需真机验收。
协议字段参考 acidify 请求结构 及服务实现; 签名依据 Lagrange.Core PC 白名单。
五之三、写入群提醒词高亮(addHighlight)
markRead 之外,还有一条写路径:addHighlight(chatType, uid, hit) 往 50005 → 50060 里追加一组高亮(hit.kind 原值,例如群关键词提醒用 2006)。它让 WeQ 自己产出的提醒 也能出现在会话列表的 [群提醒词] 角标,并且 QQ 客户端同样能读到。
关键点:
- 同样走 wire 级编辑树写回,未逆向字段逐字节保留;
- 已有同类
50060组时往它下面追加一条50040,没有就新建组; - 会话还没有
48902行时,插一条只带chatType/peerUid/ 本次高亮的最小 blob; - 幂等:同一
(kind, msgSeq)重复写直接返回false。
调用方是主进程的群关键词匹配器(见下节):命中新到的群消息时弹系统通知卡(图标用群头像) 并调 addHighlight。这条链路与 SSE 推送互相独立 —— SSE 推送地址没配 / 「实时消息」 关掉都不影响群提醒,因为匹配器有自己的 nt_msg.db 监听。
五之四、未读跳转坞(前端)
打开会话后,右上角会出现一串「跳转点」按钮,逐个引导用户跳转 (见 unreadDock.ts):
- 首屏可见就不跳:第一条未读(
41002 + 1)已落在首页 seq 范围内 ⇒ 整串不显示。 - 否则把所有高亮(不分类别)混在一起按 seq 从大到小排,右上角始终只显示一个 (最新的那条);点掉它再显示下一个,依次类推。
- 高亮跳完还有普通未读时,最后补一个「新的 N 条未读消息」,跳到最早那条未读。
跳转本身复用引用消息那套「快慢路径」(jumpToSeq):目标在当前窗口内就直接滚 (快路径),在窗口外就重建以目标为中心的窗口(慢路径,恒定开销)。
目标落在「空消息」上时不丢回原地:跳转目标的 seq 可能没有对应行(被撤回 / 删除 / QQ 从未同步)。这时仍然把窗口定位过去、滚到最近的邻居,让相邻两行之间的 seq 缺口渲染出可点击的「此处有 N 条消息缺失 · 点击拉取」占位条,同时弹一条 Toast 说明。默认的缺口条只在跳空 > 1 时自动渲染;恰好只缺这一条(seq 差为 1)时, 由这次跳转在最近邻旁补一条同样的缺口条(见 missingJumpSeq),保证「跳到空消息」 永远有可点击的拉取入口。用户据此就能把消息拉下来 —— 引用消息跳转走的是同一套逻辑。
界面上分成两类颜色:「找我的」告警类用红色([特别关心] / [有人@我] / [@全体] / [有人回复我] / [群提醒词]), 内容类用蓝色([新文件] / [群公告])。
六、和免打扰的关系:没有关系
一个容易走的弯路:免打扰状态不在这张表里。它在 recent_contact_v3_table 的 41220 列。 这张表只管「读到哪了」和「有哪些提醒」,不管「要不要提醒」。
