Skip to content

elementType 2 — 图片 ​

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

图片是「文件族」中字段最全的一类,绝大多数 454xx / 455xx / 458xx tag 都能在图片行上看到。 文件族的共用字段(文件名 / 大小 / MD5 / 三档 URL 与本地路径 / CDN 信息 / 传输标记) 统一在 40800 总览 · 第五节 说明,本页不重复。


一、subType — 图片的来源分类 ​

名字取自 QQ NT 自身的 PicSubType 枚举。实践中 0 / 1 最常见,2/3/4/7 也确有出现; 另有 10..14 出现在野外,超出厂商枚举范围,未命名(需要有渲染结果才能确认)。

值名称说明
0NORMAL普通图片
1CUSTOM自定义表情(收藏的表情包)
2HOT热图
3DIPPER_CHART斗图
4SMART智能图
5SPACE空间图(未观测)
6UNKNOW厂商枚举里就叫 KUNKNOW(未观测)
7RELATED关联图

这是元素内 45003 的取值,与下面消息行的 40012 是两套东西,别混。

行级 40012:位标志,不是枚举(闪照) ​

消息行的 40012(subMsgType)在 40011 = 2 时按位标志解析, 等值比较会把闪照漏掉。安卓备份全量实测(2026-10-28):

40012二进制含义观测
20b0000000000_0010普通图片66 条(c2c)
40960b0100000000_0000群聊图片(位 12)200 条(group)
81940b1000000000_0010闪照 = 位 13 + 位 16 条(c2c)

判闪照用 (40012 & 0x2000) !== 0,不要写 40012 === 8194——位 1 是「图片」这个大类, 位 13 才是闪照,将来多叠一个标志就会漏判。

闪照在元素层的指纹(6/6 一致,其余 266 条图片 0 命中):

字段闪照普通图
fileToken(45503)以 / 开头的老式路径,如 /100000004-1108524972-<MD5>Base64 凭据串
contentHash(45408)缺失必有
thumbnailUrl / previewUrl / originalUrl三者全空均有 /download?…
cdnHost(45816)缺失必有
uploadTime / uploadTimestamp / fileTTL缺失必有
summary(45815)[""]视情况

也就是说闪照在本地库里只有文件名 / md5 / 尺寸,没有任何可下载 URL,图片本体从不落盘。 这解释了为什么离线读到的闪照只能显示占位:要看内容必须走在线接口现签链接。

注意元素自身的 45003 subType 在闪照上是 0(与普通图相同),imgType 也是 1000—— 只有行级 40012 能区分闪照。

样本:7701402912258514055 / 7701404990830751682 / 7701428997302103910(同一会话三次测试, 40012 均为 8194)。

另一处易错点:40011 = 2 只表示「消息主类型是图片」,不代表只有一个 pic 元素。 同表里 30 条 40012 = 1 的行解出来是 elementType = 1(文本),混排消息会这样。

二、imgType(45416) ​

值名称说明
1000NORMAL普通图
1001ORIGINAL原图
2000EMOJI表情

三、必有字段 ​

依据 element/spec.ts 的 PicElementSchema,一个图片 element 一定带这些字段:

tag字段名类型说明
45402fileNamestring图片文件名
45405fileSizeuint32字节数
45406md5Bytesbytes二进制 MD5
45408contentHashbytes内容校验 hash
45411imgWidthuint32宽(像素)
45412imgHeightuint32高(像素)
45416imgTypeuint32见上表
45418isOriginalbool是否原图
45424md5string大写十六进制 MD5
45503fileTokenstring下载凭据
45505uploadTimeuint32上传 / 处理时间戳
45517uploadTimestampuint32上传时间戳
45518fileTTLuint32有效期(秒)
45802thumbnailUrlstring缩略图 URL
45803previewUrlstring预览图 URL
45804originalUrlstring大图 URL
45815summarystring(repeated)摘要 / 描述
45816cdnHoststringCDN 域名

四、可选字段 ​

tag字段名类型含义
45004localPathstring本机原图缓存路径(…/nt_data/Pic/<yyyy-mm>/Ori/<md5>.png)。注意它落在通用段而非 454xx;在草稿里是一张「纯图片草稿」唯一的内容
45403filePathstring本地文件路径
45511picTransferStateuint32传输状态
45513transferVersionuint32传输版本
45806cdnServerIpuint32CDN 地址,大端打包 IPv4
45807cdnServerPortuint32CDN 端口
45812thumbnailLocalPathstring缩略图本地缓存路径(…_0.jpg)
45813previewLocalPathstring预览图本地缓存路径(…_198.jpg)
45814originalLocalPathstring大图本地缓存路径(…_720.jpg)
45507transferFlag45507int64近似常量哨兵,见总览
45509transferFlag45509uint32恒为 1(与 45507 成对)
45600picFlag45600bytes复杂嵌套结构(图片冗余信息),保留为原始字节

45004 早期叫 faceExtDesc(被当成 FACE 的「扩展描述」,因为只在通用段里见过 FACE 的注释)。 2026-09-26 观测到一条草稿的纯 PIC 行把它写成本机原图缓存路径后,改名为 localPath。 FACE 上是否也用同一语义仍未确认 —— 见 face.md。

五、观测到但语义未验证 ​

以下 tag 在图片行上出现过,但取值几乎恒定,携带不了可利用的信息,仅为往返保真而解析。

tag观测情况
45425只在 subType=13 的行上出现,取值 1(×93)/ 2(×2)
45801唯一一次观测为空字符串
45557唯一一次观测为 0
45805所有观测行恒为 0
45817PIC 协议标志(uint32)
45818 / 45819 / 45820string,语义未知
45821 / 45822 / 45823uint32,语义未知
45824string,语义未知
45825 / 45826 / 45827uint32,语义未知
45828string,语义未知
45829 / 45830 / 45831恒为 0

六、附:安卓 QQ 的 chatpic 缓存路径预测 ​

手机 QQ 的聊天图片缓存不按消息存,按 md5 存。目录在手机的外部存储:

text
/sdcard/Android/data/com.tencent.mobileqq/Tencent/MobileQQ/chatpic

下面按三个子目录分档:chatraw(原图)/ chatimg(普通图)/ chatthumb(缩略图)。 文件名与子目录完全由 md5 公式推出,不需要查任何表:

text
url      = `${folder}:${md5}`        // folder ∈ chatraw / chatimg / chatthumb
crc      = CRC64(url)                // 有符号 BigInt!
filename = `Cache_${crc.toString(16)}`
subdir   = filename 的最后 3 个字符
相对路径 = `${folder}/${subdir}/${filename}`

同一个 md5 在三个目录里各算一次,得到三个不同的文件名——寻址时逐个探测, 哪个存在用哪个(优先级 chatraw > chatimg > chatthumb:能显示出来比清晰度重要)。

关键细节:CRC64 用反射多项式 0x95AC9329AC4BC9B5、初值 -1、无最终异或, 且结果保留有符号 BigInt——实测 QQ 的文件名带负号,一旦无符号化所有寻址全部失效。

WeQ 实现:packages/service/src/account/chatpic.ts(金标准值单测钉死在 packages/service/test/chatpic.test.ts)。在桌面端导入完整的 chatpic 备份后, 本机缺失的聊天图片可按此公式找回(设置 → 账号信息 → 外部安卓图片缓存; weq-media://pic 链路在本地 miss 时自动按 md5 兜底,再不行才走 CDN)。


← 返回消息段索引

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