Skip to content

group_info.db — 群资料 ​

group_info.db 是群聊的资料库:群名/群主/成员列表/群头衔/精华消息/群通知全在这里。 nt_msg.db 只冗余了会话行那一层的展示信息(见 recent-contact 的「冗余快照」),群的完整资料得来这边查。

对应 WeQ 解析实现:

文件职责
packages/db/src/group_info/detail.tsgroup_detail_info_ver1 → GroupDetail
packages/db/src/group_info/member.tsgroup_member3 → GroupMember
packages/db/src/group_info/member_level.tsgroup_member_level_info → 等级配置
packages/db/src/group_info/bulletin.tsgroup_bulletin → GroupBulletin
packages/db/src/group_info/essence.tsgroup_essence → GroupEssence
packages/db/src/group_info/ext.tsgroup_ext_list → GroupExt
packages/db/src/group_info/notify.tsgroup_notify_list / doubt_group_notify_list → GroupNotify

所有表都以 60001(群号 groupCode) 为关联键。


一、group_detail_info_ver1 — 群详情 ​

列字段名类型含义置信度
60001groupCodeINTEGER群号已验证
60007groupNameTEXT群名已验证
60216pinnedAnnounceTEXT置顶公告已验证
60217descriptionTEXT群简介已验证
60026remarkTEXT我给群的备注已验证
60002ownerUidTEXT群主 uid(join group_member3.1000)已验证
60004createTimeINTEGER建群时间观测一致
60005maxMemberCountINTEGER群人数上限已验证
60006memberCountINTEGER当前群人数已验证
60218labelsTEXT群标签观测一致
60224entranceQTEXT入群问题观测一致
60340leaveFlagINTEGER0 = 在群,1 = 已退群观测一致
60240groupTagsRawBLOB群资料 tag 40 的原始标签内容,列表编码及缺省语义尚未建模;当前详情 API 未提取官方静态映射
60241customLabelsBLOBprotobuf,群标签记录(标签 id / 内容 / 设置人/时间),不是成员专属头衔官方静态映射/观测一致
60242addressBLOBprotobuf,群地址(经纬度 / 地点名 / 设置人/时间)观测一致

分类目录 0x967C 的 id/name/type 与群资料标签/记录是不同结构;创建分类目录项不表示已经应用到当前群。

二、group_member3 — 群成员 ​

列字段名类型含义置信度
60001groupCodeINTEGER群号已验证
1000uidTEXT成员 uid已验证
1002uinINTEGER成员 QQ 号已验证
64003cardTEXT群名片(群内专属昵称)已验证
20002nickTEXT全局昵称已验证
64007joinTimeINTEGER入群时间已验证
64008lastSpeakTimeINTEGER最后发言时间已验证
64009muteUntilINTEGER禁言截止时间(unix 秒)已验证
64010adminFlagINTEGER0 = 普通成员,1 = 管理员已验证
64016memberFlagINTEGER0/NULL = 在群,1 = 已退群已验证
64023customTitleTEXT专属头衔已验证
64035memberLevelINTEGER等级数值已验证

成员列表的排序约定(listMembersInGroup):群主最前(uid = group_detail_info_ver1.60002 置顶)、其次管理员(64010 DESC)、再按入群时间升序 —— 与 QQ 群成员页的顺序一致。 查询默认过滤 64016 = 0 OR NULL,只列在群成员。

显示名取 card || nick(群名片优先,与 QQ 一致)。

三、group_member_level_info — 等级配置 ​

列字段名类型含义
60001groupCodeINTEGER群号
67100memberLevelINTEGER等级数值(语义待确认)
67103levelConfigBLOBprotobuf:等级 → 头衔名映射(如「 LV1 潜水」)

群成员头上那串「活跃头衔」文本来自 67103;member.ts 的 64035 数值对回这份配置 才能显示成文字。

四、group_bulletin — 群公告 ​

列字段名类型含义
60001groupCodeINTEGER群号
64205contentBLOBprotobuf 公告正文

64205 的嵌套路径(bulletin.ts):root → body(64205) → detail(64202) → contentContainer(64227) → items(64242, repeated) → textContent(64452)。 内容项的 64451 是类型:已观测到 0 为正文、3 为图片、10 为标题/类型标签(如“群公告”)。读取正文时跳过类型 10 及没有 64452 的项,避免把标签拼到正文末尾或让图片额外插入空行;保留正文的空段落、换行,以及旧数据缺失类型/未知类型里的文本,不按“群公告”字符串截尾。发布人 uid、公告 fid、发布时间都在 detail 里。

五、group_essence — 精华消息 ​

列字段名类型含义置信度
60001groupCodeINTEGER群号已验证
67501msgSeqINTEGER被设精消息的 seq,回指消息表已验证
67502msgRandomINTEGER该消息的 random观测一致
67503senderUinINTEGER原发送者 QQ 号已验证
67504senderNickTEXT原发送者昵称已验证
67505setStatusINTEGER1 = 当前是精华,2 = 已被取消已验证
67506operatorUinINTEGER设精/取消的操作人 QQ 号已验证
67507operatorNickTEXT操作人昵称已验证
67508timestampINTEGER操作时间已验证

注意:取消精华的行不删,只把 67505 改成 2。所以「当前精华列表」必须 按 67505 = 1 过滤(listEssenceSeqs 就是这么做的,给聊天窗口打精华角标用)。

六、group_ext_list — 群扩展信息 ​

列字段名类型含义置信度
60001groupCodeINTEGER群号,主键已验证
66720activityScoreINTEGER群活跃度分值观测一致
66721luckyCharIdINTEGER幸运字符 id(0 = 无)观测一致
66722luckyCharLitCountINTEGER幸运字符点亮个数观测一致
66723luckyCharContentTEXT幸运字符文本(如 yyds)观测一致
66726periodMsgCountINTEGER周期内消息量(0 = 无统计)观测一致
66730hasActivityINTEGER布尔:群近期是否有活动观测一致
66731activityRecordIdINTEGER活动 64 位 id(0 = 无)观测一致
66732ownerInfoBLOBprotobuf:群主 uid + uin(detail 表只有 uid,uin 在这里)观测一致
66733hasSpecialMarkINTEGER布尔标志,含义待确认推测

七、group_notify_list / doubt_group_notify_list — 群通知 ​

入群申请、踢人、设管等通知事件。两张表列布局相同, doubt_ 那张存「疑似相关」的通知(WeQ 分开读取,来源标记在 sourceTable)。

列字段名类型含义置信度
61001msgTimeINTEGER通知时间,毫秒(读时除以 1000 转秒)已验证
61002statusINTEGER事件类型,见下已验证
61003verifyStatusINTEGER处理状态:0 无需处理 / 1 待处理 / 2 已同意 / 3 已拒绝已验证
61004groupInfoBLOBprotobuf:群号 + 群名已验证
61005operatedUserBLOBprotobuf:被操作者 uid + 昵称(QQ 号列里没有,service 层查 profile 库补)已验证
61006—BLOB实测恒为 null,操作人真身在 61007已验证
61007operatorUserBLOBprotobuf:操作发起人 uid + 昵称(先 61007 后 61006 兜底)已验证
61008opTimeINTEGER操作时间(秒)观测一致
61010remarkTEXT申请留言观测一致
61011systemRemarkTEXT系统附言观测一致

61002 的枚举(GroupNotifyStatus):

值含义
1申请入群
3被设为管理员
6被踢出
11申请被拒绝
13退群
15被撤销管理员

← 返回数据库分析

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