- 本工具设计的初衷是用来获取微信账号的相关信息并解析PC版微信的数据库。
- 程序以 Python 语言开发,可读取、解密、还原微信数据库并帮助用户查看谈天记录,还可以将其谈天记录导出为csv、html等格式用于AI训练,主动复兴或备份等等作用。下面我们将深入探讨这个工具的各个方面及其工作原理。
- 本项目仅供学习交换使用,严禁用于商业用途或非法途径,任何违反法律法规、侵占他人合法权益的举动,均与本项目及其开发者无关,结果由举动人自行承担。
【完整演示工具下载】
https://www.chwm.vip/index.html?aid=23
我们上一篇文章《劫持微信谈天记录并分析还原 —— 合并解密后的数据库(三)》已经讲解了如何将解密后的微信数据库合并成一整个.db文件,那么本次我们将具体介绍一下微信数据库的结构与各个数据库的作用。
微信PC端各个数据库简述
- 说明:针对 .../WeChat Files/wxid_xxxxxxxx/Msg下的各个文件解密后的内容进行概述。
- 未作特别说明的情况下,“谈天记录数据”指代的数据结构上都和Multi文件夹中的完整谈天记录数据相同或类似。
一、微信小程序相关
微信小程序的相关数据,包括但不限于:
- 你使用过的小程序 RecentWxApp
- 星标的小程序 StarWxApp
- 各个小程序的基本信息 WAContact
用处不大,不过可以看到你使用过的小程序的名称和图标,以及小程序的AppID
二、企业微信相关
BizChat
企业微信接洽人数据,包括但不限于:
- 在微信中可以访问的企业微信会话ChatInfo
- 一部门会话的信息ChatSession(未确认与ChatInfo的关系;这其中的Content字段是最近一条消息,疑似用于缓存展示的内容)
- 包括群聊在内的谈天涉及的所有企业微信用户身份信息UsrInfo
- 该微信账号绑定的企业微信身份MyUsrInfo
- 特别说明:未经具体查证,这其中的谈天是否包含使用普通微信身份与企业微信用户发起的谈天,还是只包含使用绑定到普通微信的企业微信身份与其它企业微信身份发起的谈天。
BizChatMsg
- 企业微信谈天记录数据,包括所有和企业微信谈天的数据。
- 与BizChat一样,未确定涉及的范围究竟是只有企业微信-企业微信还是同时包含普通微信-企业微信。
- 另外,此处的消息与Multi文件夹中真正的微信消息不同的是在于没有拆分数据库。
OpenIM 前缀
- 这个也是企业微信的数据,包括接洽人、企业信息、与企业微信接洽人的消息等。
- 这个是普通微信-企业微信的数据,上面biz前缀的是企业微信-企业微信
- 这个不常用,而且也没有全新的数据结构,不再具体说了。
PublicMsg
- 看起来像是企业微信的通知消息,可以理解为企业微信的企业应用消息
三、微信功能相关
Emotion
顾名思义表情包相关,包括但不限于以下内容:
- CustomEmotion:顾名思义用户手动上传的GIF表情,包含下载链接,不过看起来似乎有加密(内有aesKey字段但我没测试)
- EmotionDes1 和 EmotionItem 应该也是类似的内容,没细致研究
- EmotionPackageItem:账号添加的表情包的集合列表(从商店下载的那种)
ps:用处不大,微信的MSG文件夹有表情包的url链接,可以直接网络获取谈天记录中的表情包。
Favorite
- FavItems:收藏的消息条目列表
- FavDataItem:收藏的具体数据。大概可以确定以下两点
- 即使只是简朴收藏一篇公众号文章也会在 FavDataItem 中有一个对应的记录
- 对于收藏的合并转发类型的消息,合并转发中的每一条消息在 FavDataItem 中都是一个独立的记录
- FavTags:为收藏内容添加的标签
Misc
- 有BizContactHeadImg和ContactHeadImg1两张表,应该是二进制格式的各个头像
Sns
微信朋友圈的相关数据:
- FeedsV20:朋友圈的XML数据
- CommentV20:朋友圈点赞或品评记录
- NotificationV7:朋友圈通知
- SnsConfigV20:一些设置信息,能读懂的是其中有你的朋友圈背景图
- SnsGroupInfoV5:猜测是旧版微信朋友圈可见范围的可见或不可见名单
FTS(搜索)
- 前缀为 FTS 的数据库大概都和全文搜索(Full-Text Search)相关(就是微信那个搜索框)
FTSContact
有一堆表
- FTSChatroom15_content 和 FTSContact15_content 分别对应的是微信“谈天”界面会展示的消息会话(包括公众号等)和“接洽人”界面会出现的所有人(有的时候并不是所有接洽人都会出如今“谈天”中),信息包含昵称、备注名和微信号,也和微信支持搜索的字段相匹配。
FTSFavorite
搜索收藏内容的索引
ps:对于收藏内容通过文字搜索,电脑版是把所有东西拼接成一个超长字符串来实现的。这对于文本、链接等没啥问题,但是对于合并转发消息,就会出现搜索[图片] 这一关键词。
MultiSearchChatMsg
- 这个数据库前缀不一样,但是看内容和结构应该还是一个搜索相关,搜索的是谈天记录中的文件
- 存储了文件名和其所在的谈天
- 不过FTSMsgSearch18_content和SessionAttachInfo两张表记录数量有显著差异,不确定是哪个少了或是怎样。
HardLink(文件在磁盘存储的位置)
- 将文件/图片/视频的文件名指向保存它们的文件夹名称(例如2023-04),有用但不多。
Media
- ChatCRVoice和MediaInfo 大概为语音信息
四、MicroMsg (接洽人核心)
一个数据库,不应该和分类平级,但是我认为这是分析到目前以来最核心的,因此单独来说了。
AppInfo(表)
一些软件的介绍,猜测大概是关于某些直接从手机APP跳转到微信的转发会带有的转发来源小尾巴的信息
Biz 前缀
与公众号相关的内容,应该重要是账号本身相关。
能确定的是 BizSessionNewFeeds 这张表保存的是订阅号大分类底下的会话信息,包括头像、最近一条推送等。
ChatInfo
保存“谈天”列表中每个会话最后一次标记已读的时间
ChatRoom 和 ChatRoomInfo
存储群聊相关信息
- ChatRoom:存储每个群聊的用户列表(包括微信号列表和群昵称列表)和个人群昵称等信息
- ChatRoomInfo:群聊相关信息,重要是群公告内容,与成员无关 趁便再吐槽一下,微信这个位置有一个定名出现异常的,别的表前缀都是ChatRoom,而突然出现一个ChatroomTool
Contact
顾名思义,接洽人。不过这里的接洽人并不是指你的好友,而是所有你大概看见的人,除好友外还有所有群聊中的所有陌生人。
- Contact:这张表存储的是用户基本信息,包括但不限于微信号(没有好友的陌生人也能看!)、昵称、备注名、设置的标签等等,甚至还有生成的各种字段的拼音,大概是用于方便搜索的吧
- ContactHeadImgUrl:头像地址
- ContactLabel:好友标签 ID 与名称对照
- ExtraBuf: 存储位置信息、手机号、邮箱等信息
PatInfo
存了一部门好友的拍一拍后缀,但是只有几个,我记得我电脑上显示过的拍一拍似乎没有这么少?
Session
真正的“谈天”栏目显示的会话列表,一个不多一个不少,包括“折叠的群聊”这样子的特殊会话;信息包括名称、未读消息数、最近一条消息等
TicketInfo
这张表在我这里有百余条数据,但是我实在没搞明白它是什么
五、FTSMSG
FTS 这一前缀了——这代表的是搜索时所需的索引。
其内重要的内容是这样的两张表:
- FTSChatMsg2_content:内有三个字段
- docid:从1开始递增的数字,相当于当前条目的 ID
- c0content:搜索关键字(在微信搜索框输入的关键字被这个字段包含的内容可以被搜索到)
- c1entityId:尚不明白用途,大概是校验相关
- FTSChatMsg2_MetaData
- docid:与FTSChatMsg2_content表中的 docid 对应
- msgId:与MSG数据库中的内容对应
- entityId:与FTSChatMsg2_content表中的 c1entityId 对应
- type:大概是该消息的类型
- 其余字段尚不明白
特别地,表名中的这个数字2,个人猜测大概是当前数据库格式的版本号。
六、MediaMSG (语音消息)
这里存储了所有的语音消息。数据库中有且仅有Media一张表,内含三个有用字段:
- Key
- Reserved0 与MSG数据库中消息的MsgSvrID一一对应
- Buf silk格式的语音数据
七、MSG(谈天记录核心数据库)
内部重要的两个表是 MSG 和 Name2ID
Name2ID
- Name2ID 这张表只有一列,内容格式是微信号或群聊ID@chatroom
- 作用是使MSG中的某些字段与之对应。虽然表中没有 ID 这一列,但事实上微信默认了第几行 ID 就是几(从1开始编号)。
MSG
- localId:字面意思消息在当地的 ID,暂未发现其功用
- TalkerId:消息所在房间的 ID(该信息为猜测,猜测原因见 StrTalker 字段),与Name2ID对应。
- MsgSvrID:猜测 Srv 大概是 Server 的缩写,代指服务器端存储的消息 ID
- Type:消息类型,具体对照见表1
- SubType:消息类型子分类,暂时未见其实际用途
- IsSender:是否是本身发出的消息,也就是标记消息展示在对话页左边还是右边,取值0或1
- CreateTime:消息创建时间的秒级时间戳。此处需要进一步实验来确认该时间具体标记的是哪个时间节点,个人猜测的规则如下:
- 从这台电脑上发出的消息:标记代表的是每个消息点下发送按钮的那一刻
- 从其它设备上发出的/收到的来自其它用户的消息:标记的是当地从服务器吸收到这一消息的时间
- Sequence:次序,虽然看起来像一个毫秒级时间戳但其实不是。这是 CreateTime 字段末尾接上三位数字组成的,通常情况下为000,如果在出现两条 CreateTime 相同的消息则最后三位依次递增。需要进一步确认不重复范围是在一个会话内还是所有会话。 CreateTime 相同的消息则最后三位依次递增。需要进一步确认不重复范围是在一个会话内还是所有会话。
- StatusEx、FlagEx、Status、MsgServerSeq、MsgSequence:这五个字段个人暂时没有分析出有用信息
- StrTalker:消息发送者的微信号。特别说明,从这里来看的话,上面的 TalkerId 字段大概率是指的消息所在的房间ID,而非发送者ID,固然也大概和 TalkerId 属于重复内容,这一点待确认。
- StrContent:字符串格式的数据。特别说明的是,除了文本类型的消息外,别的大多类型这一字段都会是一段 XML 数据标记一些相关信息。通过解析xml可以得到更多的信息,例如图片的宽高、语音的时长等等。
- DisplayContent:对于拍一拍,保存拍者和被拍者账号信息
- Reserved0~6:这些字段也还没有分析出有用信息,也有的字段恒为空
- CompressContent:字面意思是压缩的数据,实际上也就是微信任性不想存在 StrContent 里的数据在这里(例如带有引用的文本消息等;采用lz4压缩算法压缩)
- BytesExtra:额外的二进制格式数据
- BytesTrans:目前看这是一个恒为空的字段
表1:MSG.Type字段数值与含义对照表(大概可以扩展到其它数据库中同样标记消息类型这一信息的字段)
分类Type子分类SubType对应类型10文本30图片340语音430视频470动画表情(第三方开发的表情包)491类似文字消息而不一样的消息,目前只见到一个阿里云盘的邀请注册是这样的。估计和57子类的情况一样495卡片式链接,CompressContent 中有标题、简介等,BytesExtra 中有当地缓存的封面路径496文件,CompressContent 中有文件名和下载链接(但不会读),BytesExtra 中有当地保存的路径498用户上传的 GIF 表情,CompressContent 中有CDN链接,不过似乎不能直接访问下载4919合并转发的谈天记录,CompressContent 中有具体谈天记录,BytesExtra 中有图片视频等的缓存4933/36分享的小程序,CompressContent 中有卡片信息,BytesExtra 中有封面缓存位置4957带有引用的文本消息(这种类型下 StrContent 为空,发送和引用的内容均在 CompressContent 中)4963视频号直播或直播回放等4987群公告4988视频号直播或直播回放等492000转账消息(包括发出、吸收、主动退还)492003赠予红包封面100000系统通知(居中出现的那种灰色文字)100004拍一拍100008000系统通知(特别包含你邀请别人加入群聊)更多内容查看:
微信PC端各个数据库文件结构与功能简述 - 根目录_微信电脑端目录格式
以下是各个数据库的处理实现代码:- # -*- coding: utf-8 -*-#
- # -------------------------------------------------------------------------------
- # Name: dbbase.py
- # Description:
- # Author: Rainbow
- # Date: 2024/11/08
- # -------------------------------------------------------------------------------
- import importlib
- import os
- import sqlite3
- import time
- from .utils import db_loger
- from dbutils.pooled_db import PooledDB
- # import logging
- #
- # db_loger = logging.getLogger("db_prepare")
- class DatabaseSingletonBase:
- # _singleton_instances = {} # 使用字典存储不同db_path对应的单例实例
- _class_name = "DatabaseSingletonBase"
- _db_pool = {} # 使用字典存储不同db_path对应的连接池
- # def __new__(cls, *args, **kwargs):
- # if cls._class_name not in cls._singleton_instances:
- # cls._singleton_instances[cls._class_name] = super().__new__(cls)
- # return cls._singleton_instances[cls._class_name]
- @classmethod
- def connect(cls, db_config):
- """
- 连接数据库,如果增加其他数据库连接,则重写该方法
- :param db_config: 数据库配置
- :return: 连接池
- """
- if not db_config:
- raise ValueError("db_config 不能为空")
- db_key = db_config.get("key", "chwm.vip")
- db_type = db_config.get("type", "sqlite")
- if db_key in cls._db_pool and cls._db_pool[db_key] is not None:
- return cls._db_pool[db_key]
- if db_type == "sqlite":
- db_path = db_config.get("path", "")
- if not os.path.exists(db_path):
- raise FileNotFoundError(f"文件不存在: {db_path}")
- pool = PooledDB(
- creator=sqlite3, # 使用 sqlite3 作为连接创建者
- maxconnections=0, # 连接池最大连接数
- mincached=4, # 初始化时,链接池中至少创建的空闲的链接,0表示不创建
- maxusage=1, # 一个链接最多被重复使用的次数,None表示无限制
- blocking=True, # 连接池中如果没有可用连接后,是否阻塞等待。True,等待;False,不等待然后报错
- ping=0, # ping 数据库判断是否服务正常
- database=db_path
- )
- elif db_type == "mysql":
- mysql_config = {
- 'user': db_config['user'],
- 'host': db_config['host'],
- 'password': db_config['password'],
- 'database': db_config['database'],
- 'port': db_config['port']
- }
- pool = PooledDB(
- creator=importlib.import_module('pymysql'), # 使用 mysql 作为连接创建者
- ping=1, # ping 数据库判断是否服务正常
- **mysql_config
- )
- else:
- raise ValueError(f"不支持的数据库类型: {db_type}")
- db_loger.info(f"{pool} 连接句柄创建 {db_config}")
- cls._db_pool[db_key] = pool
- return pool
- class DatabaseBase(DatabaseSingletonBase):
- _class_name = "DatabaseBase"
- existed_tables = []
- def __init__(self, db_config):
- """
- db_config = {
- "key": "test1",
- "type": "sqlite",
- "path": r"C:\***\wxdump_work\merge_all.db"
- }
- """
- self.config = db_config
- self.pool = self.connect(self.config)
- self.__get_existed_tables()
- def __get_existed_tables(self):
- sql = "SELECT tbl_name FROM sqlite_master WHERE type = 'table' and tbl_name!='sqlite_sequence';"
- existing_tables = self.execute(sql)
- if existing_tables:
- self.existed_tables = [row[0].lower() for row in existing_tables]
- return self.existed_tables
- else:
- return None
- def tables_exist(self, required_tables: str or list):
- """
- 判断该类所需要的表是否存在
- Check if all required tables exist in the database.
- Args:
- required_tables (list or str): A list of table names or a single table name string.
- Returns:
- bool: True if all required tables exist, False otherwise.
- """
- if isinstance(required_tables, str):
- required_tables = [required_tables]
- rbool = all(table.lower() in self.existed_tables for table in (required_tables or []))
- if not rbool: db_loger.warning(f"{required_tables=}\n{self.existed_tables=}\n{rbool=}")
- return rbool
- def execute(self, sql, params=None):
- """
- 执行SQL语句
- :param sql: SQL语句 (str)
- :param params: 参数 (tuple)
- :return: 查询结果 (list)
- """
- connection = self.pool.connection()
- try:
- # connection.text_factory = bytes
- cursor = connection.cursor()
- if params:
- cursor.execute(sql, params)
- else:
- cursor.execute(sql)
- return cursor.fetchall()
- except Exception as e1:
- try:
- connection.text_factory = bytes
- cursor = connection.cursor()
- if params:
- cursor.execute(sql, params)
- else:
- cursor.execute(sql)
- rdata = cursor.fetchall()
- connection.text_factory = str
- return rdata
- except Exception as e2:
- db_loger.error(f"{sql=}\n{params=}\n{e1=}\n{e2=}\n", exc_info=True)
- return None
- finally:
- connection.close()
- def close(self):
- self.pool.close()
- db_loger.info(f"关闭数据库 - {self.config}")
- def __del__(self):
- self.close()
- # class MsgDb(DatabaseBase):
- #
- # def p(self, *args, **kwargs):
- # sel = "select tbl_name from sqlite_master where type='table'"
- # data = self.execute(sel)
- # # print([i[0] for i in data])
- # return data
- #
- #
- # class MsgDb1(DatabaseBase):
- # _class_name = "MsgDb1"
- #
- # def p(self, *args, **kwargs):
- # sel = "select tbl_name from sqlite_master where type='table'"
- # data = self.execute(sel)
- # # print([i[0] for i in data])
- # return data
- #
- #
- # if __name__ == '__main__':
- # logging.basicConfig(level=logging.INFO,
- # style='{',
- # datefmt='%Y-%m-%d %H:%M:%S',
- # format='[{levelname[0]}] {asctime} [{name}:{levelno}] {pathname}:{lineno} {message}'
- # )
- #
- # config1 = {
- # "key": "test1",
- # "type": "sqlite",
- # "path": r"D:\e_all.db"
- # }
- # config2 = {
- # "key": "test2",
- # "type": "sqlite",
- # "path": r"D:\_call.db"
- # }
- #
- # t1 = MsgDb(config1)
- # t1.p()
- # t2 = MsgDb(config2)
- # t2.p()
- # t3 = MsgDb1(config1)
- # t3.p()
- # t4 = MsgDb1(config2)
- # t4.p()
- #
- # print(t4._db_pool)
- # # 销毁t1
- # del t1
- # # 销毁t2
- # del t2
- # del t3
- #
- # # 销毁t4
- # del t4
- # import time
- # time.sleep(1)
- #
- # t1 = MsgDb(config1)
- # t1.p()
- # t2 = MsgDb(config2)
- # t2.p()
- #
- #
- # print(t2._db_pool)
复制代码- # -*- coding: utf-8 -*-#
- # -------------------------------------------------------------------------------
- # Name: Favorite.py
- # Description: 负责处理wx收藏数据库
- # Author: Rainbow
- # Date: 2024/11/08
- # -------------------------------------------------------------------------------
- from collections import defaultdict
- from .dbbase import DatabaseBase
- from .utils import timestamp2str, xml2dict
- # * FavItems:收藏的消息条目列表
- # * FavDataItem:收藏的具体数据。大概可以确定以下两点
- # * 即使只是简单收藏一篇公众号文章也会在 FavDataItem 中有一个对应的记录
- # * 对于收藏的合并转发类型的消息,合并转发中的每一条消息在 FavDataItem 中都是一个独立的记录
- # * FavTags:为收藏内容添加的标签
- class FavoriteHandler(DatabaseBase):
- _class_name = "Favorite"
- Favorite_required_tables = ["FavItems", "FavDataItem", "FavTagDatas", "FavBindTagDatas"]
- def get_tags(self, LocalID):
- """
- return: {LocalID: TagName}
- """
- if not self.tables_exist("FavTagDatas"):
- return {}
- if LocalID is None:
- sql = "select LocalID, TagName from FavTagDatas order by ServerSeq"
- else:
- sql = "select LocalID, TagName from FavTagDatas where LocalID = '%s' order by ServerSeq " % LocalID
- tags = self.execute(sql) # [(1, 797940830, '程序语言类'), (2, 806153863, '账单')]
- # 转换为字典
- tags = {tag[0]: tag[1] for tag in tags}
- return tags
- def get_FavBindTags(self):
- """
- return: [(FavLocalID, TagName)]
- """
- sql = ("select DISTINCT A.FavLocalID, B.TagName "
- "from FavBindTagDatas A, FavTagDatas B where A.TagLocalID = B.LocalID")
- FavBindTags = self.execute(sql)
- return FavBindTags
- def get_favorite(self):
- """
- return: [{FavItemsFields}, {FavItemsFields}]
- """
- FavItemsFields = {
- "FavLocalID": "本地收藏ID",
- "SvrFavId": "服务器收藏ID",
- "SourceId": "源ID",
- "Type": "类型",
- "SourceType": "源类型",
- "LocalStatus": "本地状态",
- "Flag": "标记",
- "Status": "状态",
- "FromUser": "源用户",
- "RealChatName": "实际聊天名称",
- "SearchKey": "搜索关键字",
- "UpdateTime": "更新时间",
- "reseverd0": "预留字段0",
- "XmlBuf": "XML缓冲区"
- }
- FavDataItemFields = {
- "FavLocalID": "本地收藏ID",
- "Type": "类型",
- "DataId": "数据ID",
- "HtmlId": "HTML ID",
- "Datasourceid": "数据源ID",
- "Datastatus": "数据状态",
- "Datafmt": "数据格式",
- "Datatitle": "数据标题",
- "Datadesc": "数据描述",
- "Thumbfullmd5": "缩略图全MD5",
- "Thumbhead256md5": "缩略图头256MD5",
- "Thumbfullsize": "缩略图全尺寸",
- "fullmd5": "全MD5",
- "head256md5": "头256MD5",
- "fullsize": "全尺寸",
- "cdn_thumburl": "CDN缩略图URL",
- "cdn_thumbkey": "CDN缩略图KEY",
- "thumb_width": "缩略图宽度",
- "thumb_height": "缩略图高度",
- "cdn_dataurl": "CDN数据URL",
- "cdn_datakey": "CDN数据KEY",
- "cdn_encryver": "CDN加密版本",
- "duration": "时长",
- "stream_weburl": "流媒体WEB URL",
- "stream_dataurl": "流媒体数据URL",
- "stream_lowbandurl": "流媒体低带宽URL",
- "sourcethumbpath": "源缩略图路径",
- "sourcedatapath": "源数据路径",
- "stream_videoid": "流媒体视频ID",
- "Rerserved1": "保留字段1",
- "Rerserved2": "保留字段2",
- "Rerserved3": "保留字段3",
- "Rerserved4": "保留字段4",
- "Rerserved5": "保留字段5",
- "Rerserved6": "保留字段6",
- "Rerserved7": "保留字段7"
- }
- if not self.tables_exist(["FavItems", "FavDataItem"]):
- return False
- sql1 = "select " + ",".join(FavItemsFields.keys()) + " from FavItems order by UpdateTime desc"
- sql2 = "select " + ",".join(FavDataItemFields.keys()) + " from FavDataItem B order by B.RecId asc"
- FavItemsList = self.execute(sql1)
- FavDataItemList = self.execute(sql2)
- if FavItemsList is None or len(FavItemsList) == 0:
- return False
- FavDataDict = {}
- if FavDataItemList and len(FavDataItemList) >= 0:
- for item in FavDataItemList:
- data_dict = {}
- for i, key in enumerate(FavDataItemFields.keys()):
- data_dict[key] = item[i]
- FavDataDict[item[0]] = FavDataDict.get(item[0], []) + [data_dict]
- # 获取标签
- FavTags = self.get_FavBindTags()
- FavTagsDict = {}
- for FavLocalID, TagName in FavTags:
- FavTagsDict[FavLocalID] = FavTagsDict.get(FavLocalID, []) + [TagName]
- rdata = []
- for item in FavItemsList:
- processed_item = {
- key: item[i] for i, key in enumerate(FavItemsFields.keys())
- }
- processed_item['UpdateTime'] = timestamp2str(processed_item['UpdateTime'])
- processed_item['XmlBuf'] = xml2dict(processed_item['XmlBuf'])
- processed_item['TypeName'] = Favorite_type_converter(processed_item['Type'])
- processed_item['FavData'] = FavDataDict.get(processed_item['FavLocalID'], [])
- processed_item['Tags'] = FavTagsDict.get(processed_item['FavLocalID'], [])
- rdata.append(processed_item)
- try:
- import pandas as pd
- except ImportError:
- return False
- pf = pd.DataFrame(FavItemsList)
- pf.columns = FavItemsFields.keys() # set column names
- pf["UpdateTime"] = pf["UpdateTime"].apply(timestamp2str) # 处理时间
- pf["XmlBuf"] = pf["XmlBuf"].apply(xml2dict) # 处理xml
- pf["TypeName"] = pf["Type"].apply(Favorite_type_converter) # 添加类型名称列
- pf["FavData"] = pf["FavLocalID"].apply(lambda x: FavDataDict.get(x, [])) # 添加数据列
- pf["Tags"] = pf["FavLocalID"].apply(lambda x: FavTagsDict.get(x, [])) # 添加标签列
- pf = pf.fillna("") # 去掉Nan
- rdata = pf.to_dict(orient="records")
- return rdata
- def Favorite_type_converter(type_id_or_name: [str, int]):
- """
- 收藏类型ID与名称转换
- 名称(str)=>ID(int)
- ID(int)=>名称(str)
- :param type_id_or_name: 消息类型ID或名称
- :return: 消息类型名称或ID
- """
- type_name_dict = defaultdict(lambda: "未知", {
- 1: "文本", # 文本 已测试
- 2: "图片", # 图片 已测试
- 3: "语音", # 语音
- 4: "视频", # 视频 已测试
- 5: "链接", # 链接 已测试
- 6: "位置", # 位置
- 7: "小程序", # 小程序
- 8: "文件", # 文件 已测试
- 14: "聊天记录", # 聊天记录 已测试
- 16: "群聊视频", # 群聊中的视频 可能
- 18: "笔记" # 笔记 已测试
- })
- if isinstance(type_id_or_name, int):
- return type_name_dict[type_id_or_name]
- elif isinstance(type_id_or_name, str):
- return next((k for k, v in type_name_dict.items() if v == type_id_or_name), (0, 0))
- else:
- raise ValueError("Invalid input type")
复制代码- # -*- coding: utf-8 -*-#
- # -------------------------------------------------------------------------------
- # Name: MediaMSG.py
- # Description: 负责处理语音数据库
- # Author: Rainbow
- # Date: 2024/11/08
- # -------------------------------------------------------------------------------
- from .dbbase import DatabaseBase
- from .utils import silk2audio
- class MediaHandler(DatabaseBase):
- _class_name = "MediaMSG"
- Media_required_tables = ["Media"]
- def Media_add_index(self):
- """
- 添加索引, 加快查询速度
- """
- if self.tables_exist("Media"):
- self.execute("CREATE INDEX IF NOT EXISTS MsgSvrID ON Media(Reserved0)")
- def get_audio(self, MsgSvrID, is_play=False, is_wave=False, save_path=None, rate=24000):
- if not self.tables_exist("Media"):
- return False
- sql = "select Buf from Media where Reserved0=? "
- DBdata = self.execute(sql, (MsgSvrID,))
- if not DBdata:
- return False
- if len(DBdata) == 0:
- return False
- data = DBdata[0][0] # [1:] + b'\xFF\xFF'
- try:
- pcm_data = silk2audio(buf_data=data, is_play=is_play, is_wave=is_wave, save_path=save_path, rate=rate)
- return pcm_data
- except Exception as e:
- return False
复制代码- # -*- coding: utf-8 -*-#
- # -------------------------------------------------------------------------------
- # Name: MicroMsg.py
- # Description: 负责处理联系人数据库
- # Author: Rainbow
- # Date: 2024/11/08
- # -------------------------------------------------------------------------------
- import logging
- from .dbbase import DatabaseBase
- from .utils import timestamp2str, bytes2str, db_loger, db_error
- import blackboxprotobuf
- class MicroHandler(DatabaseBase):
- _class_name = "MicroMsg"
- Micro_required_tables = ["ContactLabel", "Contact", "ContactHeadImgUrl", "Session", "ChatInfo", "ChatRoom",
- "ChatRoomInfo"]
- def Micro_add_index(self):
- """
- 添加索引, 加快查询速度
- """
- # 为 Session 表添加索引
- if self.tables_exist("Session"):
- self.execute("CREATE INDEX IF NOT EXISTS idx_Session_strUsrName_nTime ON Session(strUsrName, nTime);")
- self.execute("CREATE INDEX IF NOT EXISTS idx_Session_nOrder ON Session(nOrder);")
- self.execute("CREATE INDEX IF NOT EXISTS idx_Session_nTime ON Session(nTime);")
- # 为 Contact 表添加索引
- if self.tables_exist("Contact"):
- self.execute("CREATE INDEX IF NOT EXISTS idx_Contact_UserName ON Contact(UserName);")
- # 为 ContactHeadImgUrl 表添加索引
- if self.tables_exist('ContactHeadImgUrl'):
- self.execute("CREATE INDEX IF NOT EXISTS idx_ContactHeadImgUrl_usrName ON ContactHeadImgUrl(usrName);")
- # 为 ChatInfo 表添加索引
- if self.tables_exist('ChatInfo'):
- self.execute("CREATE INDEX IF NOT EXISTS idx_ChatInfo_Username_LastReadedCreateTime "
- "ON ChatInfo(Username, LastReadedCreateTime);")
- self.execute(
- "CREATE INDEX IF NOT EXISTS idx_ChatInfo_LastReadedCreateTime ON ChatInfo(LastReadedCreateTime);")
- # 为 Contact 表添加复合索引
- if self.tables_exist('Contact'):
- self.execute("CREATE INDEX IF NOT EXISTS idx_Contact_search "
- "ON Contact(UserName, NickName, Remark, Alias, QuanPin, PYInitial, RemarkQuanPin, RemarkPYInitial);")
- # 为 ChatRoom 和 ChatRoomInfo 表添加索引
- if self.tables_exist(['ChatRoomInfo', "ChatRoom"]):
- self.execute("CREATE INDEX IF NOT EXISTS idx_ChatRoom_ChatRoomName ON ChatRoom(ChatRoomName);")
- self.execute("CREATE INDEX IF NOT EXISTS idx_ChatRoomInfo_ChatRoomName ON ChatRoomInfo(ChatRoomName);")
- @db_error
- def get_labels(self, id_is_key=True):
- """
- 读取标签列表
- :param id_is_key: id_is_key: True: id作为key,False: name作为key
- :return:
- """
- labels = {}
- if not self.tables_exist("ContactLabel"):
- return labels
- sql = "SELECT LabelId, LabelName FROM ContactLabel ORDER BY LabelName ASC;"
- result = self.execute(sql)
- if not result:
- return labels
- if id_is_key:
- labels = {row[0]: row[1] for row in result}
- else:
- labels = {row[1]: row[0] for row in result}
- return labels
- @db_error
- def get_session_list(self):
- """
- 获取会话列表
- :return: 会话列表
- """
- sessions = {}
- if not self.tables_exist(["Session", "Contact", "ContactHeadImgUrl"]):
- return sessions
- sql = (
- "SELECT S.strUsrName,S.nOrder,S.nUnReadCount, S.strNickName, S.nStatus, S.nIsSend, S.strContent, "
- "S.nMsgLocalID, S.nMsgStatus, S.nTime, S.nMsgType, S.Reserved2 AS nMsgSubType, C.UserName, C.Alias, "
- "C.DelFlag, C.Type, C.VerifyFlag, C.Reserved1, C.Reserved2, C.Remark, C.NickName, C.LabelIDList, "
- "C.ChatRoomType, C.ChatRoomNotify, C.Reserved5, C.Reserved6 as describe, C.ExtraBuf, H.bigHeadImgUrl "
- "FROM (SELECT strUsrName, MAX(nTime) AS MaxnTime FROM Session GROUP BY strUsrName) AS SubQuery "
- "JOIN Session S ON S.strUsrName = SubQuery.strUsrName AND S.nTime = SubQuery.MaxnTime "
- "left join Contact C ON C.UserName = S.strUsrName "
- "LEFT JOIN ContactHeadImgUrl H ON C.UserName = H.usrName "
- "WHERE S.strUsrName!='@publicUser' "
- "ORDER BY S.nTime DESC;"
- )
- db_loger.info(f"get_session_list sql: {sql}")
- ret = self.execute(sql)
- if not ret:
- return sessions
- id2label = self.get_labels()
- for row in ret:
- (strUsrName, nOrder, nUnReadCount, strNickName, nStatus, nIsSend, strContent,
- nMsgLocalID, nMsgStatus, nTime, nMsgType, nMsgSubType,
- UserName, Alias, DelFlag, Type, VerifyFlag, Reserved1, Reserved2, Remark, NickName, LabelIDList,
- ChatRoomType, ChatRoomNotify, Reserved5, describe, ExtraBuf, bigHeadImgUrl) = row
- ExtraBuf = get_ExtraBuf(ExtraBuf)
- LabelIDList = LabelIDList.split(",") if LabelIDList else []
- LabelIDList = [id2label.get(int(label_id), label_id) for label_id in LabelIDList if label_id]
- nTime = timestamp2str(nTime) if nTime else None
- sessions[strUsrName] = {
- "wxid": strUsrName, "nOrder": nOrder, "nUnReadCount": nUnReadCount, "strNickName": strNickName,
- "nStatus": nStatus, "nIsSend": nIsSend, "strContent": strContent, "nMsgLocalID": nMsgLocalID,
- "nMsgStatus": nMsgStatus, "nTime": nTime, "nMsgType": nMsgType, "nMsgSubType": nMsgSubType,
- "LastReadedCreateTime": nTime,
- "nickname": NickName, "remark": Remark, "account": Alias,
- "describe": describe, "headImgUrl": bigHeadImgUrl if bigHeadImgUrl else "",
- "ExtraBuf": ExtraBuf, "LabelIDList": tuple(LabelIDList)
- }
- return sessions
- @db_error
- def get_recent_chat_wxid(self):
- """
- 获取最近聊天的联系人
- :return: 最近聊天的联系人
- """
- users = []
- if not self.tables_exist(["ChatInfo"]):
- return users
- sql = (
- "SELECT A.Username, LastReadedCreateTime, LastReadedSvrId "
- "FROM ( SELECT Username, MAX(LastReadedCreateTime) AS MaxLastReadedCreateTime FROM ChatInfo "
- "WHERE LastReadedCreateTime IS NOT NULL AND LastReadedCreateTime > 1007911408000 GROUP BY Username "
- ") AS SubQuery JOIN ChatInfo A "
- "ON A.Username = SubQuery.Username AND LastReadedCreateTime = SubQuery.MaxLastReadedCreateTime "
- "ORDER BY A.LastReadedCreateTime DESC;"
- )
- db_loger.info(f"get_recent_chat_wxid sql: {sql}")
- result = self.execute(sql)
- if not result:
- return []
- for row in result:
- # 获取用户名、昵称、备注和聊天记录数量
- username, LastReadedCreateTime, LastReadedSvrId = row
- LastReadedCreateTime = timestamp2str(LastReadedCreateTime) if LastReadedCreateTime else None
- users.append(
- {"wxid": username, "LastReadedCreateTime": LastReadedCreateTime, "LastReadedSvrId": LastReadedSvrId})
- return users
- @db_error
- def get_user_list(self, word: str = None, wxids: list = None, label_ids: list = None):
- """
- 获取联系人列表
- [ 注意:如果修改这个函数,要同时修改dbOpenIMContact.py中的get_im_user_list函数 ]
- :param word: 查询关键字,可以是wxid,用户名、昵称、备注、描述,允许拼音
- :param wxids: wxid列表
- :param label_ids: 标签id
- :return: 联系人字典
- """
- if isinstance(wxids, str):
- wxids = [wxids]
- if isinstance(label_ids, str):
- label_ids = [label_ids]
- users = {}
- if not self.tables_exist(["Contact", "ContactHeadImgUrl"]):
- return users
- sql = (
- "SELECT A.UserName, A.Alias, A.DelFlag, A.Type, A.VerifyFlag, A.Reserved1, A.Reserved2,"
- "A.Remark, A.NickName, A.LabelIDList, A.ChatRoomType, A.ChatRoomNotify, A.Reserved5,"
- "A.Reserved6 as describe, A.ExtraBuf, B.bigHeadImgUrl "
- "FROM Contact A LEFT JOIN ContactHeadImgUrl B ON A.UserName = B.usrName WHERE 1==1 ;"
- )
- if word:
- sql = sql.replace(";",
- f"AND ( A.UserName LIKE '%{word}%' "
- f"OR A.NickName LIKE '%{word}%' "
- f"OR A.Remark LIKE '%{word}%' "
- f"OR A.Alias LIKE '%{word}%' "
- f"OR LOWER(A.QuanPin) LIKE LOWER('%{word}%') "
- f"OR LOWER(A.PYInitial) LIKE LOWER('%{word}%') "
- f"OR LOWER(A.RemarkQuanPin) LIKE LOWER('%{word}%') "
- f"OR LOWER(A.RemarkPYInitial) LIKE LOWER('%{word}%') "
- f") "
- ";")
- if wxids:
- sql = sql.replace(";", f"AND A.UserName IN ('" + "','".join(wxids) + "') ;")
- if label_ids:
- sql_label = [f"A.LabelIDList LIKE '%{i}%' " for i in label_ids]
- sql_label = " OR ".join(sql_label)
- sql = sql.replace(";", f"AND ({sql_label}) ;")
- db_loger.info(f"get_user_list sql: {sql}")
- result = self.execute(sql)
- if not result:
- return users
- id2label = self.get_labels()
- for row in result:
- # 获取wxid,昵称,备注,描述,头像,标签
- (UserName, Alias, DelFlag, Type, VerifyFlag, Reserved1, Reserved2, Remark, NickName, LabelIDList,
- ChatRoomType, ChatRoomNotify, Reserved5, describe, ExtraBuf, bigHeadImgUrl) = row
- ExtraBuf = get_ExtraBuf(ExtraBuf)
- LabelIDList = LabelIDList.split(",") if LabelIDList else []
- LabelIDList = [id2label.get(int(label_id), label_id) for label_id in LabelIDList if label_id]
- # print(f"{UserName=}\n{Alias=}\n{DelFlag=}\n{Type=}\n{VerifyFlag=}\n{Reserved1=}\n{Reserved2=}\n"
- # f"{Remark=}\n{NickName=}\n{LabelIDList=}\n{ChatRoomType=}\n{ChatRoomNotify=}\n{Reserved5=}\n"
- # f"{describe=}\n{ExtraBuf=}\n{bigHeadImgUrl=}")
- users[UserName] = {
- "wxid": UserName, "nickname": NickName, "remark": Remark, "account": Alias,
- "describe": describe, "headImgUrl": bigHeadImgUrl if bigHeadImgUrl else "",
- "ExtraBuf": ExtraBuf, "LabelIDList": tuple(LabelIDList),
- "extra": None}
- extras = self.get_room_list(roomwxids=filter(lambda x: "@" in x, users.keys()))
- for UserName in users:
- users[UserName]["extra"] = extras.get(UserName, None)
- return users
- @db_error
- def get_room_list(self, word=None, roomwxids: list = None):
- """
- 获取群聊列表
- :param word: 群聊搜索词
- :param roomwxids: 群聊wxid列表
- :return: 群聊字典
- """
- # 连接 MicroMsg.db 数据库,并执行查询
- if isinstance(roomwxids, str):
- roomwxids = [roomwxids]
- rooms = {}
- if not self.tables_exist(["ChatRoom", "ChatRoomInfo"]):
- return rooms
- sql = (
- "SELECT A.ChatRoomName,A.UserNameList,A.DisplayNameList,A.ChatRoomFlag,A.IsShowName,"
- "A.SelfDisplayName,A.Reserved2,A.RoomData, "
- "B.Announcement,B.AnnouncementEditor,B.AnnouncementPublishTime "
- "FROM ChatRoom A LEFT JOIN ChatRoomInfo B ON A.ChatRoomName==B.ChatRoomName "
- "WHERE 1==1 ;")
- if word:
- sql = sql.replace(";",
- f"AND A.ChatRoomName LIKE '%{word}%' ;")
- if roomwxids:
- sql = sql.replace(";", f"AND A.ChatRoomName IN ('" + "','".join(roomwxids) + "') ;")
- db_loger.info(f"get_room_list sql: {sql}")
- result = self.execute(sql)
- if not result:
- return rooms
- for row in result:
- # 获取用户名、昵称、备注和聊天记录数量
- (ChatRoomName, UserNameList, DisplayNameList, ChatRoomFlag, IsShowName, SelfDisplayName,
- Reserved2, RoomData,
- Announcement, AnnouncementEditor, AnnouncementPublishTime) = row
- UserNameList = UserNameList.split("^G")
- DisplayNameList = DisplayNameList.split("^G")
- RoomData = ChatRoom_RoomData(RoomData)
- wxid2roomNickname = {}
- if RoomData:
- rd = []
- for k, v in RoomData.items():
- if isinstance(v, list):
- rd += v
- for i in rd:
- try:
- if isinstance(i, dict) and isinstance(i.get('1'), str) and i.get('2'):
- wxid2roomNickname[i['1']] = i["2"]
- except Exception as e:
- db_loger.error(f"wxid2remark: ChatRoomName:{ChatRoomName}, {i} error:{e}", exc_info=True)
- wxid2userinfo = self.get_user_list(wxids=UserNameList)
- for i in wxid2userinfo:
- wxid2userinfo[i]["roomNickname"] = wxid2roomNickname.get(i, "")
- owner = wxid2userinfo.get(Reserved2, Reserved2)
- rooms[ChatRoomName] = {
- "wxid": ChatRoomName, "roomWxids": UserNameList, "IsShowName": IsShowName,
- "ChatRoomFlag": ChatRoomFlag, "SelfDisplayName": SelfDisplayName,
- "owner": owner, "wxid2userinfo": wxid2userinfo,
- "Announcement": Announcement, "AnnouncementEditor": AnnouncementEditor,
- "AnnouncementPublishTime": AnnouncementPublishTime}
- return rooms
- @db_error
- def ChatRoom_RoomData(RoomData):
- # 读取群聊数据,主要为 wxid,以及对应昵称
- if RoomData is None or not isinstance(RoomData, bytes):
- return None
- data = get_BytesExtra(RoomData)
- bytes2str(data) if data else None
- return data
- @db_error
- def get_BytesExtra(BytesExtra):
- if BytesExtra is None or not isinstance(BytesExtra, bytes):
- return None
- try:
- deserialize_data, message_type = blackboxprotobuf.decode_message(BytesExtra)
- return deserialize_data
- except Exception as e:
- db_loger.warning(f"\nget_BytesExtra: {e}\n{BytesExtra}", exc_info=True)
- return None
- @db_error
- def get_ExtraBuf(ExtraBuf: bytes):
- """
- 读取ExtraBuf(联系人表)
- :param ExtraBuf:
- :return:
- """
- if not ExtraBuf:
- return None
- buf_dict = {
- '74752C06': '性别[1男2女]', '46CF10C4': '个性签名', 'A4D9024A': '国', 'E2EAA8D1': '省', '1D025BBF': '市',
- 'F917BCC0': '公司名称', '759378AD': '手机号', '4EB96D85': '企微属性', '81AE19B4': '朋友圈背景',
- '0E719F13': '备注图片', '945f3190': '备注图片2',
- 'DDF32683': '0', '88E28FCE': '1', '761A1D2D': '2', '0263A0CB': '3', '0451FF12': '4', '228C66A8': '5',
- '4D6C4570': '6', '4335DFDD': '7', 'DE4CDAEB': '8', 'A72BC20A': '9', '069FED52': '10', '9B0F4299': '11',
- '3D641E22': '12', '1249822C': '13', 'B4F73ACB': '14', '0959EB92': '15', '3CF4A315': '16',
- 'C9477AC60201E44CD0E8': '17', 'B7ACF0F5': '18', '57A7B5A8': '19', '695F3170': '20', 'FB083DD9': '21',
- '0240E37F': '22', '315D02A3': '23', '7DEC0BC3': '24', '16791C90': '25'
- }
- rdata = {}
- for buf_name in buf_dict:
- rdata_name = buf_dict[buf_name]
- buf_name = bytes.fromhex(buf_name)
- offset = ExtraBuf.find(buf_name)
- if offset == -1:
- rdata[rdata_name] = ""
- continue
- offset += len(buf_name)
- type_id = ExtraBuf[offset: offset + 1]
- offset += 1
- if type_id == b"\x04":
- rdata[rdata_name] = int.from_bytes(ExtraBuf[offset: offset + 4], "little")
- elif type_id == b"\x18":
- length = int.from_bytes(ExtraBuf[offset: offset + 4], "little")
- rdata[rdata_name] = ExtraBuf[offset + 4: offset + 4 + length].decode("utf-16").rstrip("\x00")
- elif type_id == b"\x17":
- length = int.from_bytes(ExtraBuf[offset: offset + 4], "little")
- rdata[rdata_name] = ExtraBuf[offset + 4: offset + 4 + length].decode("utf-8", errors="ignore").rstrip(
- "\x00")
- elif type_id == b"\x05":
- rdata[rdata_name] = f"0x{ExtraBuf[offset: offset + 8].hex()}"
- return rdata
复制代码 [code]# -*- coding: utf-8 -*-## -------------------------------------------------------------------------------# Name: MSG.py# Description: 负责处理消息数据库数据# Author: Rainbow# Date: 2024/11/08# -------------------------------------------------------------------------------import jsonimport osimport reimport lz4.blockimport blackboxprotobuffrom .dbbase import DatabaseBasefrom .utils import db_error, timestamp2str, xml2dict, match_BytesExtra, type_converterclass MsgHandler(DatabaseBase): _class_name = "MSG" MSG_required_tables = ["MSG"] def Msg_add_index(self): """ 添加索引,加速查询速率 """ # 检查是否存在索引 if not self.tables_exist("MSG"): return self.execute("CREATE INDEX IF NOT EXISTS idx_MSG_StrTalker ON MSG(StrTalker);") self.execute("CREATE INDEX IF NOT EXISTS idx_MSG_CreateTime ON MSG(CreateTime);") self.execute("CREATE INDEX IF NOT EXISTS idx_MSG_StrTalker_CreateTime ON MSG(StrTalker, CreateTime);") @db_error def get_m_msg_count(self, wxids: list = ""): """ 获取谈天记录数量,根据wxid获取单个接洽人的谈天记录数量,不传wxid则获取所有接洽人的谈天记录数量 :param wxids: wxid list :return: 谈天记录数量列表 {wxid: chat_count, total: total_count} """ if isinstance(wxids, str) and wxids: wxids = [wxids] if wxids: wxids = "('" + "','".join(wxids) + "')" sql = f"SELECT StrTalker, COUNT(*) FROM MSG WHERE StrTalker IN {wxids} GROUP BY StrTalker ORDER BY COUNT(*) DESC;" else: sql = f"SELECT StrTalker, COUNT(*) FROM MSG GROUP BY StrTalker ORDER BY COUNT(*) DESC;" sql_total = f"SELECT COUNT(*) FROM MSG;" if not self.tables_exist("MSG"): return {} result = self.execute(sql) total_ret = self.execute(sql_total) if not result: return {} total = 0 if total_ret and len(total_ret) > 0: total = total_ret[0][0] msg_count = {"total": total} msg_count.update({row[0]: row[1] for row in result}) return msg_count @db_error def get_msg_list(self, wxids: list or str = "", start_index=0, page_size=500, msg_type: str = "", msg_sub_type: str = "", start_createtime=None, end_createtime=None, my_talker="我"): """ 获取谈天记录列表 :param wxids: [wxid] :param start_index: 起始索引 :param page_size: 页大小 :param msg_type: 消息类型 :param msg_sub_type: 消息子类型 :param start_createtime: 开始时间 :param end_createtime: 结束时间 :param my_talker: 我 :return: 谈天记录列表 {"id": _id, "MsgSvrID": str(MsgSvrID), "type_name": type_name, "is_sender": IsSender, "talker": talker, "room_name": StrTalker, "msg": msg, "src": src, "extra": {}, "CreateTime": CreateTime, } """ if not self.tables_exist("MSG"): return [], [] if isinstance(wxids, str) and wxids: wxids = [wxids] param = () sql_wxid, param = (f"AND StrTalker in ({', '.join('?' for _ in wxids)}) ", param + tuple(wxids)) if wxids else ("", param) sql_type, param = ("AND Type=? ", param + (msg_type,)) if msg_type else ("", param) sql_sub_type, param = ("AND SubType=? ", param + (msg_sub_type,)) if msg_type and msg_sub_type else ("", param) sql_start_createtime, param = ("AND CreateTime>=? ", param + (start_createtime,)) if start_createtime else ( "", param) sql_end_createtime, param = ("AND CreateTime=? ", param + (start_createtime,)) if start_createtime else ( "", param) sql_end_createtime, param = ("AND CreateTime |