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 列里的东西结构完全一致。
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 | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 40001 | msgId | int64 | 消息 id(雪花 id) |
| 40002 | msgRandom | uint32 | 消息随机数,用于去重 |
| 40003 | msgSeq | uint32 | 消息序列号 |
类型与状态
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 40010 | isSender | bool | 是否本机发送(语义同 ElementWire.isSender) |
| 40011 | msgType | uint32 | 消息类型,见下方 MsgType |
| 40012 | msgSubType | uint32 | 消息子类型 |
| 40013 | sendType | uint32 | 消息来源,见下方 SendType |
| 40041 | sendStatus | uint32 | 发送状态,见下方 SendStatus |
收发双方
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 40020 | senderUid | string | 发送者 uid |
| 40021 | peerUid | string | 会话对端 uid |
| 40033 | senderUin | uint32 | 发送者 QQ 号 |
| 40093 | sendNick | string | 发送者昵称 |
时间
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 40050 | sendTime | uint32 | 发送时间,unix 秒 |
| 40058 | sendDayStartTime | uint32 | 发送当天 00:00 的时间戳,unix 秒 |
内容与嵌套
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 40600 | senderInfo | message | 发送者展示信息,见下方嵌套结构 |
| 40800 | elements | repeated ElementWire | 消息正文,结构与 40800 列 完全一致 |
| 40801 | proto40801 | bytes | 消息装扮 protobuf(气泡 / 聊天字体 / 挂件),详见 40801 解析 |
| 40802 | proto40802 | bytes | 同上 |
| 40900 | subMsgs | repeated MsgCache | 递归:被缓存的源 / 引用消息 |
语义未知的标量
以下 tag 为往返保真而解析,语义未定,字段名统一为 flagNNNNN(均为 uint32):
40005 · 40006 · 40008 · 40009 · 40016 · 40105
四、嵌套结构
发送者展示块(tag 40600)
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 42261 | flag42261 | uint32 | 未知 |
| 42341 | avatar | message | 头像信息,见下 |
头像信息(tag 42341,位于 40600 内)
| tag | 字段名 | 类型 | 含义 |
|---|---|---|---|
| 42342 | flag42342 | uint32 | 未知 |
| 42343 | flag42343 | uint32 | 未知 |
| 42344 | avatarType | uint32 | 头像图片类型 |
| 42345 | encryptedUin | string | 头像加密 uin |
| 42346 | avatarUrl | string | 头像加密外链 URL |
五、枚举
MsgType(tag 40011)
其中 8 / 9 已在真实数据上确认;其余镜像自 QQ NT 的 KMSGTYPE* 表,视作尽力而为。
| 值 | 名称 | 说明 |
|---|---|---|
| 0 | UNKNOWN | |
| 1 | NULL | QQ 撤回 / 删除消息时会把行级 40011 改写为 1 |
| 2 | MIX | 图文混排(普通消息的常见值) |
| 3 | FILE | |
| 4 | STRUCT | |
| 5 | GRAY_TIP | 小灰条 |
| 6 | PTT | |
| 7 | VIDEO | |
| 8 | MULTI_FORWARD | 合并转发(已确认) |
| 9 | REPLY | 引用回复(已确认) |
| 10 | WALLET | |
| 11 | ARK_STRUCT | |
| 12 | STRUCT_LONG_MSG | |
| 13 | GIPHY | |
| 14 | GIFT | |
| 15 | TEXT_GIFT | |
| 21 | ONLINE_FILE | |
| 24 | FACE_BUBBLE | |
| 25 | SHARE_LOCATION | |
| 27 | ONLINE_FOLDER | |
| 29 | PROLOGUE |
SendType(tag 40013)
消息相对于本设备 / 本账号的来源。
| 值 | 名称 | 说明 |
|---|---|---|
| 0 | RECEIVED | 别人发来的消息 |
| 1 | LOCAL | 本机发送 |
| 2 | OTHER_CLIENT | 本账号的其它客户端发送 |
| 5 | FORWARD | 转发产生的消息 |
这几档解释了为什么
isSender(40010)语义那么窄:只有LOCAL才置位;OTHER_CLIENT虽然也是「我发的」,却不带isSender。
SendStatus(tag 40041)
注意取值不与 NapCat 的 SendStatusType 命名一一对应,下列语义来自实际观测。
| 值 | 名称 | 说明 |
|---|---|---|
| 0 | BLOCKED | 发送被阻止(如不是对方好友) |
| 1 | PENDING | 尚未发送成功(如网络问题) |
| 2 | SUCCESS | 发送成功 |
| 3 | BANNED | 消息被 QQ 封禁 |
