微信聊天记录读取分析
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_814dbe54/wechat-chat-reader
技能介绍
微信的聊天数据存在本地 SQLite 库里,但要用上它得先跨过两道坎:密钥没落到磁盘上、微信版本分叉导致提取方法完全不同。这个技能用 wechat-cli 命令行工具读取本地聊天记录,把「能查、能搜、能统计、能导出」这件事做到可复用。
核心能力
- 会话浏览与历史查询:
sessions列会话列表,关键词搜索用search,按时间段拉历史用history。--type能过滤text、image、voice、video、sticker等消息类型,方便把表情包噪音排除掉。 - 词频分析:把指定时间段内跨群、跨私聊(含公众号)的消息汇总起来跑中文分词,输出 Top N 高频词,直接存成 JSON。
- 导出与备份:按会话或时间范围把聊天记录导成文本/JSON,用于离线分析或留档。
密钥提取是整个链条的脖子
微信 4.0.x 在进程内存里缓存了明文密钥,方案是「内存扫描直接提」;4.1.12 之后不再缓存明文密钥,init 扫不到属于正常表现,改用 Config.Cipher 提取。技能按版本分叉给出两套方案,并把原理写在 references/key-extraction.md 里。
适用边界
- 读操作不需要微信在线,只有密钥提取这一环要求微信正在运行。
- 默认条数限制很紧:
history默认 50 条、search最大 500 条、sessions默认 20 个。要拿全量数据必须显式写--limit 100000这种量级的数。 brandsessionholder、@placeholder_foldgroup这类系统占位会话导出会失败,属预期行为,不是 bug。- 密钥与登录账号强绑定:想查哪个账号,微信就得先登录那个账号。多账号场景靠
~/.wechat-cli/all_keys_accountN.json备份加scripts/switch_account.py切换。 - 所有处理都在本地完成,只读,不向微信发送或写入任何内容。
使用场景
- 汇总过去一个月各群和私聊记录,用词频分析找出高频关键词,完成社群话题趋势复盘。
- 把指定联系人某天的聊天记录按纯文本格式导出备份,同时用消息类型过滤掉图片和语音消息。
- 管理多个微信工作账号,需要通过脚本备份各账号密钥,一键切换并查询指定账号的历史消息。
- 遇到群名为纯数字导致名称匹配失败,需要先获取会话 username 再用精确标识拉取群聊天记录。
适合人员
- 社群运营:需要定期统计各微信群和私聊的高频话题词,用于复盘近期讨论焦点。
- 数据分析师:需要将本地微信聊天记录按时间段导出并过滤特定消息类型,构建离线分析数据集。
- 多账号管理者:同时登录多个微信工作号,需要备份各账号密钥并快速切换查询历史记录。
- 隐私敏感开发者:希望在不上传任何数据的前提下,仅在本地对个人微信聊天库进行只读分析和备份。