Skip to content

elementType 8 — 灰字提示 ​

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

「小灰条」是聊天中居中显示的那一行灰色提示:撤回、拍一拍、入群、禁言、临时会话…… 它们共用一个 elementType,靠 45003 (subType) 再分一次类, 而不同 subType 使用的 tag 段几乎不重叠——实际上是六种完全不同的结构挤在同一个类型下。


一、subType 全表 ​

名字取自 QQ NT 的 NTGrayTipElementSubTypeV2 枚举。 目前只观测到 1 / 4 / 10 / 12 / 15 / 17;其余声明出来只为将来遇到时有名字可对。

值名称WeQ 的 kind说明tag 段
0UNKNOWN—占位(未观测)—
1REVOKEgrayTipRevoke撤回提示(「XX 撤回了一条消息」)477xx
2PROCLAMATION—群公告(未观测)—
3EMOJI_REPLY—表情回应(未观测)—
4GROUP_TIPgrayTipGroup群通知:入群 / 退群 / 禁言 / 改群名485xx
5BUDDY—好友相关提示(未观测)—
6FEED—动态 Feed 提示(未观测)—
7ESSENCE—设为精华消息(未观测)—
8GROUP_NOTIFY—群通知(系统下发,未观测)—
9BUDDY_NOTIFY—好友通知(系统下发,未观测)—
10FILEgrayTipFileRecv文件传输完成灰条(接收或上传成功)文件族 454xx/455xx
11FEED_CHANNEL_MSG—频道消息 Feed(未观测)—
12XML_MSGgrayTipInviteXML 灰条(通用 XML 消息)482xx
13LOCAL_MSG—本地消息,仅本端可见(未观测)—
14BLOCK—拉黑相关(未观测)—
15AIO_OPgrayTipTempSession临时会话提示475xx
16WALLET—钱包相关(未观测)—
17JSONgrayTipPokeJSON 灰条:拍一拍、互动标识482xx

历史上 subType=12 曾被 WeQ 当作「邀请」处理,故 kind 名叫 grayTipInvite; 实际它是通用的 XML 灰条。


二、subType=1 — 撤回 ​

tag字段名类型必有含义
47702recallFlag47702uint32✅未知整数
47703recallRevokeUidstring✅撤回操作者 uid
47704recallSenderUidstring✅被撤回消息发送者 uid
47705recallSenderNickstring✅被撤回者昵称
47713recallDisplayTextstring✅撤回展示文案
47714recallRevokeNickstring✅撤回者昵称
47710recallElementsrepeated ReplyElementWire被撤回消息的原始 element 副本。只在撤回自己的消息时才有
47711recallFlag47711uint32未知整数
47712recallFlag47712uint32两条观测行均为 1

六个昵称字段的关系 ​

47706/47715 是昵称副本,47707/47716 装的是群名片。这一点在一次群撤回上得到验证: 该用户昵称为「🍬🐱帕罗丁,然后8年之誓」,而群名片是「期中考试加油」,两者确实不同。

QQ 会同时写一份「被撤回者」副本和一份「撤回者」副本,即使两者是同一个人。 所以自己撤回自己的消息时,这六个字段值全部一致。

tag字段名归属含义
47705recallSenderNick被撤回者昵称
47706recallSenderNickCopy被撤回者昵称副本(同 47705)
47707recallSenderGroupNick被撤回者群名片(群里与昵称不同)
47714recallRevokeNick撤回者昵称
47715recallRevokeNickCopy撤回者昵称副本(同 47714)
47716recallRevokeGroupNick撤回者群名片

三、subType=4 — 群通知 ​

tag字段名类型必有含义
48501groupTipTypeuint32✅事件类型,见下表
48503user1Uidstring用户 1 uid
48504user1Nickstring用户 1 昵称
48505user1GroupNickstring用户 1 群名片
48506user2Uidstring用户 2 uid
48507user2Nickstring用户 2 昵称
48508user2GroupNickstring用户 2 群名片
48509groupTipGroupNamestring群名称 —— 出现在「XX 邀请你加入 <群名>」这类提示上(该群不是当前会话)
48541muteInfomessage禁言详情,见下
48542grayTipTimestampuint32提示时间戳,unix 秒。约 9700 个不同取值,均与消息自身发送时间一致

groupTipType(48501) ​

名字取自 QQ NT 的 TipGroupElementType 枚举。本地库里出现过 1/2/3/5/8。

值名称说明
0KUNKNOWN占位(未观测)
1KMEMBERADD成员入群:user1 是新成员,user2 是邀请人(无邀请人时 QQ 只写 user1)
2KDISBANDED群已解散
3KQUITTE成员被移出群聊:user1Nick 是操作者昵称,user2Uid 是被移出者
4KCREATED群创建成功(未观测)
5KGROUPNAMEMODIFIED群名被修改:user1 是操作者,groupTipGroupName 是新群名
6KBLOCK成员被拉黑(未观测)
7KUNBLOCK成员被移出黑名单(未观测)
8KSHUTUP禁言:详情在 muteInfo,时长为 0 表示解除禁言
9KBERECYCLED群因违规被回收(未观测)
10KDISBANDORBERECYCLED群被解散或被回收(未观测)

muteInfo(48541) ​

tag字段名类型含义
48521operatormessage操作者,内含 1000: uid
48522mutedUsermessage被禁言者,内含 1000: uid、20002: groupNick
48531timestampuint64时间戳
48532durationuint32禁言时长(秒),0 = 解除

未验证 ​

tag字段名观测情况
48502groupTipFlag48502取值 0/1/2
48510groupTipFlag48510只要出现就恒为 1
48511groupTipFlag48511取值 0(×2874)/ 2 / 1 / 3

四、subType=10 — 文件传输完成 ​

结构上是一个披着 elementType=8 外壳的 FILE element:它复用 454xx/455xx 文件族 tag, 一个灰条专属字段都没有。QQ 把它作为一条独立的行,写在真正的 FILE 消息旁边。

它表示一次文件传输已完成——既可能是收到对方发来的文件,也可能是自己上传成功, 灰条本身不带方向标记,所以 WeQ 统一渲染为中性文案「文件传输完成」。 行级 msgType 为 40011=5 / 40012=1(系统提示)或 40011=1 / 40012=2。

tag字段名类型必有
45402fileNamestring✅
45405fileSizeuint32✅
45407md5Bytes2bytes
45503fileTokenstring
45411 / 45412imgWidth / imgHeightuint32
45410videoDurationuint32

fileName 在 wire 上出现了两次,WeQ 取第一个。


五、subType=15 — 临时会话 ​

QQ 渲染为「该用户通过 xxx 群聊向你发起临时会话」。 恒为一个 C2C 会话的首条消息(seq=1),且该行本身不带发送者(40020 为空)。

tag字段名类型必有含义
47502tempSessionGroupCodestring✅发起临时会话的来源群号(十进制字符串)
47501aioOpFlag47501uint32恒为 1,疑似提示变体标识
40021origReceiverUidstring行级对端 uid 的冗余副本

47502 已验证确实是群号而非对方 QQ 号:所有观测值在 group_msg_table 里都有真实群聊记录, 且没有一个与对端自身 uin 相同。


六、subType=17(JSON)与 subType=12(XML) ​

这两者共用 482xx 段。subType=17 是拍一拍、互动标识(畅聊之火 / 初泛涟漪)等; subType=12 是通用 XML 灰条。

tag字段名类型含义
48210actionInitiatormessage动作发起者,内含 1005: uid、1006: nickname
43210actionTargetmessage动作目标,结构同上
48211actionIduint32动作类型 id。观测到 12(拍一拍)、16(红包)
48212detailedIduint32详细动作 id。1=系统,1061=拍一拍,19357=红包
48213typeFlaguint32类型标志。观测到 7
48214grayTipXmlContentstringXML 预览文档
48215businessIduint32业务 id,见下方 JsonGrayBusiId 全表。观测到 1132
48216actionUniqueIduint32本次动作的唯一 id
48217actionAttributesrepeated message附加属性,每项 {1005: key, 1006: value}
48271tipJsonstring提示的 JSON 负载(subType=17 必有)
48273tipTypeuint32提示类型,1=系统,与 detailedId 对应
48274grayTipPlainTextstring互动标识提示原文,如「你和XX互发消息连续超过7天,已获得畅聊之火标识」。tipJson 的纯文本版
48542grayTipTimestampuint32提示时间戳

tipJson(48271)的形状 ​

jsonc
{
  "items": [
    { "type": "nor", "txt": "文本片段" },
    { "type": "qq",  "uid": "u_xxx", "col": "#ff0000", "jp": "跳转协议" },
    { "type": "img", "src": "图片地址" },
    { "type": "url", "txt": "链接文字", "jp": "跳转地址" }
  ]
}

type 已知 img / qq / nor / url 四种;jp 是点击跳转协议。

grayTipXmlContent(48214)的形状 ​

xml
<gtip align="...">
  <qq uin="..." col="..." nm="..." tp="..."/>
  <img src="..." />
  <nor txt="..." />
</gtip>

贴表情回应灰条(subType=12)的消息链接实测为 <url jp="" msgseq="63954" col="3" txt="消息:"/>,msgseq 指向被回应的群消息, 不是灰条自身的消息序号。聊天区点击该文字复用引用消息的定位与高亮;没有有效正整数 msgseq 的链接仍只显示文字,不从 jp 或灰条自身序号猜测目标。

未验证 ​

tag字段名观测情况
48218grayTipReserved保留字段(string)
48219grayTipFlag48219取值 0(×49)/ 1(×1)
48220grayTipFlag48220取值 0(×59)/ 64(×1)
48272grayTipFlag48272观测为 true
48275grayTipFlag48275uint32,语义未知

七、businessId(48215)全表 ​

取值来自 QQ NT 自身的 JsonGrayBusiId 枚举 —— 它标识这条 JSON 灰条由哪个业务下发, 决定了 tipJson 里的文案与跳转协议属于什么场景。本地样本只覆盖到其中极少数(如 1132), 这里完整列出以便遇到时能直接对号入座。

WARNING

枚举仅记录在此文档,未进代码:解析层不依赖它,48215 照旧按裸数字解析。 取值命名保留 QQ 原样。

在线文件传输(1..13) ​

值名称含义
1ONLINE_FILE_STOP_SEND停止发送
2ONLINE_FILE_STOP_SEND_ON_SENDING发送中停止发送
3ONLINE_FILE_REFUSE_RECV拒绝接收
4ONLINE_FILE_CANCEL_RECV_ON_RECVING接收中取消接收
5ONLINE_FILE_STOP_ALL_SEND停止全部发送
6ONLINE_FILE_STOP_ALL_SEND_ON_SENDING发送中停止全部发送
7ONLINE_FILE_REFUSE_ALL_RECV拒绝接收全部
8ONLINE_FILE_REFUSE_ALL_RECV_ON_RECVING接收中拒绝接收全部
9ONLINE_FILE_SEND_ERROR发送出错
10ONLINE_FILE_RECV_ERROR接收出错
11ONLINE_FILE_GO_OFFLINE离线
12ONLINE_FILE_GO_OFFLINE_ALL全部离线
13ONLINE_FILE_RECV_BY_MOBILE已由手机接收

杂项 ​

值名称含义
51ONLINE_GROUP_HOME_WORK群作业
81RED_BAG红包
86LITE_ACTION轻量动作

关系链(1000..1022) ​

值名称含义
1000RELATION_CHAIN_BLACKED被拉黑
1001RELATION_EMOJIEGG_SHOW表情彩蛋展示
1002RELATION_EMOJIEGG_WILL_DEGRADE表情彩蛋即将降级
1003RELATION_C2C_LOVER_BONUS情侣加成
1004RELATION_C2C_SAY_HELLO打招呼
1005RELATION_C2C_GROUP_AIO_SETUP_GROUP_AND_REMARK设置分组与备注
1006RELATION_FRIEND_CLONE_INFO好友克隆信息
1007RELATION_CHAIN_MATCH_FRIEND匹配好友
1008RELATION_NEARBY_GOTO_VERIFY附近的人去验证
1009RELATION_CREATE_GROUP_GRAY_TIP_ID创建群聊
1010RELATION_YQT一起听
1011RELATION_LIMIT_TMP_CONVERSATION_SET临时会话限制设置
1012RELATION_ONEWAY_FRIEND_GRAY_TIP_ID单向好友
1013RELATION_ONEWAY_FRIEND_NEW_GRAY_TIP_ID单向好友(新)
1014RELATION_GROUP_SHUT_UP群禁言
1015RELATION_GROUP_MEMBER_ADD_WITH_MODIFY_NAME加群成员并改名
1016RELATION_GROUP_MEMBER_ADD_WITH_WELCOME加群成员并欢迎
1017RELATION_C2C_MEMBER_ADD添加好友
1018RELATION_C2C_REACTIVE_UPGRADE_MSG亲密度升级
1019RELATION_C2C_REACTIVE_DEGRADE_MSG亲密度降级
1020RELATION_GROUP_BATCH_ADD_FRIEND群内批量加好友
1021RELATION_GROUP_MEMBER_RECOMMEND群成员推荐
1022RELATION_GROUP_MEMBER_ADD加群成员

AIO 会话内提示(2000..2100) ​

值名称含义
2000AIO_RECALL_MSGCUSTOM_WORDINGGUIDE撤回自定义文案引导
2021AIO_AV_C2C_NOTICE私聊音视频通知
2022AIO_AV_GROUP_NOTICE群音视频通知
2041AIO_NUDGE_CUSTOM_GUIDE拍一拍自定义引导
2050AIO_CRM_FLAGS_TIPSCRM 标识提示
2060PTT_AUTO_CHANGE_GUIDE语音自动变声引导
2100AIO_C2C_DONT_DISTURB私聊免打扰

Z-Plan / 机器人 / 推送(2201..2701) ​

值名称含义
2201AIO_ROBOT_SAFETY_TIP机器人安全提示
2300AIO_ZPLAN_SEND_MEMEZ-Plan 发送梗图
2301AIO_ZPLAN_EMOTICON_GUIDEZ-Plan 表情引导
2302AIO_ZPLAN_SCENE_LINKAGEZ-Plan 场景联动
2601QCIRCLE_SHOW_FULE_TIPS小世界提示
2602QWALLET_GRAY_TIP_IDQQ 钱包
2603DISBAND_DISCUSSION_GRAY_TIP_ID解散讨论组
2701AIO_PUSH_GUIDE_GRAY_TIPS推送引导

群会话(2401..2408) ​

值名称含义
2401AIO_GROUP_ESSENCE_MSG_TIP群精华消息
2402GROUP_AIO_SHUTUP_GRAY_TIP_ID群禁言
2403GROUP_AIO_UPLOAD_PERMISSIONS_GRAY_TIP_ID群上传权限
2404GROUP_AIO_HOME_SCHOOL_WELCOME_GRAY_TIP_ID家校群欢迎
2405GROUP_AIO_TEMPORARY_GRAY_TIP_ID群临时会话
2406GROUP_AIO_MSG_FREQUENCY_GRAY_TIP_ID群消息频率
2407GROUP_AIO_CONFIGURABLE_GRAY_TIPS群可配置灰条
2408GROUP_AIO_UNREAD_MSG_AI_SUMMARY群未读消息 AI 总结

文件大小限制(3001..3003) ​

值名称含义
3001VAS_FILE_UPLOAD_OVER_LIMIT上传超出限制
3002VAS_FILE_UPLOAD_OVER_1G上传超过 1G
3003FILE_SENDING_SIZE_4GB_LIMIT发送 4GB 限制

群加好友 / 破冰(10405, 19264..19273) ​

值名称含义
10405TROOP_BREAK_ICE群破冰
19264TROOP_ADD_FRIEND_ACTIVE加好友:活跃成员
19265TROOP_ADD_FRIEND_HOT_CHAT加好友:热聊
19266TROOP_ADD_FRIEND_REPLY_OR_AT加好友:回复或 @
19267TROOP_ADD_FRIEND_NEW_MEMBER加好友:新成员
19273TROOP_FLAME_IGNITED群火花点燃

预留 ​

值名称含义
100000UI_RESERVE_100000_110000UI 预留区间起点(100000–110000)

TIP

WeQ 的防撤回功能正是构造一条 subType=17 的自定义灰条 来记录被拦截的撤回事件。


← 返回消息段索引

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