Skip to content

40900 — 消息缓存(MsgCache) ​

40900 存贮转发 / 引用场景下缓存的源消息快照,为 protobuf,结构为可重复的 MsgCache 记录, 且可递归嵌套(转发里套转发)。

对应 WeQ 解析实现:packages/codec/src/proto/msg/40900.ts。

以列 40011(msgType)区分用途:

40011 值含义40900 内容
8合并转发被转发的源消息缓存
9回复引用被引用的源消息缓存

一、与 40800 的关系 ​

这是理解 40900 的入口:

  • 40800 是「一条消息的正文」 —— 只有 element 列表,没有身份、没有时间、没有发送者。
  • 40900 是「一整行消息的自包含快照」 —— 身份(msgId / seq / random)、路由(收发双方 uid + uin)、 时间、状态、发送者昵称头像,外加那条消息的 40800 element 列表本身。

换句话说:MsgCache ⊃ MsgBody。MsgCache 里 tag 为 40800 的字段, 就是原样的 repeated ElementWire,与 40800 列里的东西结构完全一致。

text
40900 (BLOB)
└── 40900  repeated MsgCache        ← 每项 = 一条被缓存的完整消息
    ├── 40001 msgId / 40003 msgSeq / 40050 sendTime / …   (行级标量)
    ├── 40600 senderInfo                                   (发送者展示信息)
    ├── 40800 repeated ElementWire  ← 这条消息的正文,同 40800 列
    └── 40900 repeated MsgCache     ← 递归:它自己缓存的源消息

二、递归嵌套 ​

当 msgType 为 MULTI_FORWARD (8) 或 REPLY (9) 时,这条消息会把它所缓存的源消息 挂在 tag 40900 下(repeated)。而那些条目本身也是完整的 MsgCache,可以再挂 40900 —— 即结构是任意深的。

典型场景:把一段「合并转发」再引用回复一次,就会出现两层嵌套。

实现上,subMsgs 字段用 (): ProtoMessageType => MsgCache 这个显式返回类型的 thunk 打断自引用的类型推导循环。运行时是惰性解析的,调用 thunk 时 MsgCache 早已定义完毕。

三、字段表 ​

身份与序号 ​

tag字段名类型含义
40001msgIdint64消息 id(雪花 id)
40002msgRandomuint32消息随机数,用于去重
40003msgSequint32消息序列号

类型与状态 ​

tag字段名类型含义
40010isSenderbool是否本机发送(语义同 ElementWire.isSender)
40011msgTypeuint32消息类型,见下方 MsgType
40012msgSubTypeuint32消息子类型
40013sendTypeuint32消息来源,见下方 SendType
40041sendStatusuint32发送状态,见下方 SendStatus

收发双方 ​

tag字段名类型含义
40020senderUidstring发送者 uid
40021peerUidstring会话对端 uid
40033senderUinuint32发送者 QQ 号
40093sendNickstring发送者昵称

时间 ​

tag字段名类型含义
40050sendTimeuint32发送时间,unix 秒
40058sendDayStartTimeuint32发送当天 00:00 的时间戳,unix 秒

内容与嵌套 ​

tag字段名类型含义
40600senderInfomessage发送者展示信息,见下方嵌套结构
40800elementsrepeated ElementWire消息正文,结构与 40800 列 完全一致
40801proto40801bytes消息装扮 protobuf(气泡 / 聊天字体 / 挂件),详见 40801 解析
40802proto40802bytes同上
40900subMsgsrepeated MsgCache递归:被缓存的源 / 引用消息

语义未知的标量 ​

以下 tag 为往返保真而解析,语义未定,字段名统一为 flagNNNNN(均为 uint32):

40005 · 40006 · 40008 · 40009 · 40016 · 40105

四、嵌套结构 ​

发送者展示块(tag 40600) ​

tag字段名类型含义
42261flag42261uint32未知
42341avatarmessage头像信息,见下

头像信息(tag 42341,位于 40600 内) ​

tag字段名类型含义
42342flag42342uint32未知
42343flag42343uint32未知
42344avatarTypeuint32头像图片类型
42345encryptedUinstring头像加密 uin
42346avatarUrlstring头像加密外链 URL

五、枚举 ​

MsgType(tag 40011) ​

其中 8 / 9 已在真实数据上确认;其余镜像自 QQ NT 的 KMSGTYPE* 表,视作尽力而为。

值名称说明
0UNKNOWN
1NULLQQ 撤回 / 删除消息时会把行级 40011 改写为 1
2MIX图文混排(普通消息的常见值)
3FILE
4STRUCT
5GRAY_TIP小灰条
6PTT
7VIDEO
8MULTI_FORWARD合并转发(已确认)
9REPLY引用回复(已确认)
10WALLET
11ARK_STRUCT
12STRUCT_LONG_MSG
13GIPHY
14GIFT
15TEXT_GIFT
21ONLINE_FILE
24FACE_BUBBLE
25SHARE_LOCATION
27ONLINE_FOLDER
29PROLOGUE

SendType(tag 40013) ​

消息相对于本设备 / 本账号的来源。

值名称说明
0RECEIVED别人发来的消息
1LOCAL本机发送
2OTHER_CLIENT本账号的其它客户端发送
5FORWARD转发产生的消息

这几档解释了为什么 isSender(40010)语义那么窄:只有 LOCAL 才置位; OTHER_CLIENT 虽然也是「我发的」,却不带 isSender。

SendStatus(tag 40041) ​

注意取值不与 NapCat 的 SendStatusType 命名一一对应,下列语义来自实际观测。

值名称说明
0BLOCKED发送被阻止(如不是对方好友)
1PENDING尚未发送成功(如网络问题)
2SUCCESS发送成功
3BANNED消息被 QQ 封禁

← 返回消息体解析

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