40801:消息装扮信息
40801 是 c2c_msg_table、group_msg_table 和 dataline_msg_table 中的消息装扮列,保存每条消息对应的气泡、聊天字体和挂件等信息。
截至 2026 年 8 月 23 日,WeQ 已完成该列的主要字段解析。该列本质上是一个 protobuf:外层使用 tag 40801 包裹,真正的装扮字段位于内层消息中。
对应实现:
| 文件 | 职责 |
|---|---|
packages/codec/src/proto/msg/40801.ts | 40801 的 wire schema |
packages/codec/src/domain/msg/msg_dress.ts | 解码并提取气泡、字体、挂件 ID |
packages/service/src/account/msg_decoration.ts | 根据 ID 解析装扮资源 |
一、整体结构
40801 (BLOB)
└── tag 40801 (LEN / nested)
├── tag 41510 bubbleId
├── tag 41525 fontId(优先)
├── tag 41528 widgetId
└── tag 41531 fallback font value(备用字体 ID)外层 40801 是列本身的 protobuf 字段,内层字段不能直接按列号解释。
二、已确认的装扮字段
| 内层 tag | 字段名 | 类型 | 含义 | 备注 |
|---|---|---|---|---|
41510 | bubbleId | uint32 | 气泡皮肤 itemId | 直接使用 |
41525 | fontId | uint32 | 聊天字体皮肤 itemId | 字体 ID 的首选来源 |
41528 | widgetId | uint32 | 挂件 itemId | 直接使用 |
41531 | flag41531 | uint32 | 备用字体值 | 需要按规则解码后才能得到字体 ID |
三、字体 ID 获取规则
字体 ID 的读取顺序如下:
- 如果
41525存在且不为0,直接将41525作为字体 ID。 - 如果
41525为null或0,读取41531,记为stored。 - 使用下面的公式解码:
fontId = ((stored & 0xFF) << 8) | ((stored >> 8) & 0xFF)- 解码结果为
0或没有结果时,视为未设置聊天字体。
例如:
stored = 0x1234
fontId = 0x3412这里的 41531 不是直接可用的字体 itemId,而是一个低 16 位字节序交换后的值。
注意:41531 还有 bit 16 标志位,解码时会被掩掉
真机 41531 不只低 16 位:bit 16 是一个标志位。实测(c2c / group 各数百行):
- 真实字体 54981(=
0xD6C5)对应的41531 = 116182 = 0x1C5D6—— 比swap16(54981) = 0xC5D6多一个0x10000; - 没有字体的消息
41531 = 65536 = 0x10000(低 16 位为 0,只留标志位); 41525(首选字体)实际很少非零,字体基本都走41531这条回退路径。
上面的解码公式用 (stored >>> 8) & 0xFF 把 bit 16 掩掉 —— 这对「读出 itemId 给人看 / 查资源」 是对的,但不要把解码出的 itemId 再编码回 wire(那会丢失标志位)。
与消息元素(PushMsgBody)的恒等映射
40800(消息正文)里不存逐条装扮 —— 装扮只在 40801 列。发送 / 推送时的元素级装扮与 本列字段是恒等的(真机 41531 = 116182 与元素 generalFlags.font.fontId2 = 116182 相等):
| 40801 | 消息元素 |
|---|---|
41510 | tag 9 bubble.id |
41525 | tag 37 font.fontId1(56) |
41531 | tag 37 font.fontId2(15) |
41528 | tag 37 widgetId(17) |
所以转发已有消息时应当原样透传这四个原始值(codec 的 MsgDecoration.fontId1Raw / fontId2Raw 保留的就是它们),绝不能「解码 → 自己编码」——那会丢 bit 16、也会把字体写错槽位。
四、其他已观测字段
以下字段已经纳入 schema,可保证解码和保真,但语义暂不作为装扮 ID 使用:
| tag | 类型 | 当前说明 |
|---|---|---|
41501 | uint64 | 未知签名 / uid hash |
41502 | uint32 | proto 版本或标志 |
41511 | uint32 | 未知 |
41512 | uint32 | 气泡版本 / revision |
41513 | bool | 未知标志 |
41514 | uint32 | 未知小整数 |
41516 | uint32 | 未知小整数 |
41517 | bool | 未知标志 |
41518 | uint32 | 少量出现,可能是其他 itemId |
41519 | uint32 | 字体相关整数 |
41520 | uint32 | 字体标志 |
41521 | uint32 | 字体子标志 |
41522 | uint32 | 字体子标志 |
41523 | bool | 未知标志 |
41524 | uint32 | 与 41519 相似的字体相关值 |
41529 | bool | 未知标志 |
41530 | uint32 | 未知 itemId |
41532 | bool | 未知标志 |
41533 | bool | 未知标志 |
41534 | bool | 未知标志 |
41535 | uint32 | 未知整数 |
此外还观测到少量更高 tag,例如 41538、41665、42350、43301、43302、52180、52182、52346、52381、52382。这些字段目前只做 wire 层兼容,不参与气泡、字体和挂件 ID 提取。
五、解码后的使用链路
decodeMsgDressColumn 输出统一结构:
{
bubbleId: number;
fontId: number;
widgetId: number;
}后续资源解析和渲染只使用这个统一结构:
bubbleId用于解析气泡资源;fontId用于获取和注入聊天字体资源;widgetId用于解析挂件资源。
当三个 ID 都为 0 时,解码结果为 null,表示该消息没有可用的装扮信息。
