Skip to content

elementType 1 — 文本 / @ ​

对应 WeQ 解析实现:packages/codec/src/proto/msg/element.ts(elementType = 1)。

文本是最常见的消息段。@ 提及并不是独立的 elementType,它同样是 elementType = 1, 靠额外字段区分。


一、text 与 at 的区分 ​

WeQ 在 element/registry.ts 里的判据只有一句:

ts
const kind = wire.bubbleId ? 'at' : 'text';

即:45105 有值就是 @,没值就是普通文本。

@ 元素上三个字段的实际用途(注意字段名是历史遗留,与聊天「气泡」无关):

tag字段名@ 元素中装的东西
45101textContent展示文本,形如 @某人 (末尾带一个空格)
45105bubbleId被 @ 者的 uid
45103textEncodingFlag被 @ 者的 uin(QQ 号)

@全体成员 同样走这条路径,只是 uid / uin 为特殊值。

二、subType — 是链接安全分级,不是文字样式 ​

45003 (subType) 在文本上的语义容易误解:它不表示字体或样式,而是 QQ 对链接的安全分类。 全表扫描的结论是:subType > 0 只出现在内容是 / 含 URL 的消息上。

值名称说明
0PLAIN普通文本,不含链接
1EXTERNAL_LINK外部链接。会附带 45112 (urlVerifyFlag) —— QQ 扫描域名后附的安全校验 + 抓取结果,见下节
2TRUSTED_LINK可信链接(腾讯系域名:docs.qq.com / mp.weixin.qq.com …)。不带 45112,QQ 对自家域名跳过安全检查

三、45112 — QQ 自己抓好的链接元数据 ​

45112 (urlVerifyFlag) 不是一坨不透明的校验负载,而是一段嵌套 protobuf:QQ 服务端 扫描链接时顺手抓了页面,标题 / 描述 / 封面图都在里面。解析实现见 packages/codec/src/element/url_verify.ts(decodeUrlVerify)。

tag字段名类型全库出现次数含义
50200titlestring311页面标题(长了 QQ 会截断加 ...)
50201imageUrlstring311封面图 URL
50202scannedAtuint321087扫描时间(unix 秒),恒有
50204descstring311页面描述(og:description;页面没写描述时 QQ 拿主机名顶上)
50205—uint321087恒为 2,语义未验证
50206—uint32190 或 1,语义未验证

两个要点:

  • 50204 是描述,不是站点名。 容易误读成域名,是因为「页面没给描述」时它确实填的是 主机名。站点名 QQ 根本没给,要显示得自己从 URL 取 host。
  • 只有约两成带元数据。 1087 条 payload 里只有 229 条有标题;其余是 12 字节的短包, 只有 50202 + 50205。所以 decodeUrlVerify 在无标题时返回 null,调用方据此决定 是直接渲染卡片,还是退回去自己抓(见 LinkPreviewService)。

四、字段 ​

核心 ​

tag字段名类型必有含义
45101textContentstring✅文本内容
45102textReserveuint32文本信封标志。构造 @ 时 WeQ 写 2

观测到但语义未验证 ​

以下字段在真实文本行上出现过,会被解析(这样 tag 字典能给它们名字),但既不会被提升进 TextElement 的渲染路径,也不参与回写。含义列均为推测,无一验证。

tag字段名类型推测含义
45103textEncodingFlaguint32文本编码 / 加密标志。@ 元素中确定装的是被 @ 者 uin
45104fontStyleuint32字体 / 样式相关
45105bubbleIdstring气泡 ID。实际用途见上:@ 的目标 uid
45106textInputStateuint32文本输入状态
45108translationFlaguint32翻译 / 转换标志
45109linkDetectionFlaguint32链接识别标志
45110atMentionMaskstring@ 相关位掩码(字符串编码)
45111walletFlaguint32红包 / 钱包含义标志
45112urlVerifyFlagbytes网址校验 + 抓取结果,见第三节

45107 至今未观测到。


← 返回消息段索引

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