Agent Skills
返回列表
📊

微信聊天记录读取分析

数据分析 更新于 2026.08.30

将以下提示词粘贴到你的 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 再用精确标识拉取群聊天记录。

适合人员

  • 社群运营:需要定期统计各微信群和私聊的高频话题词,用于复盘近期讨论焦点。
  • 数据分析师:需要将本地微信聊天记录按时间段导出并过滤特定消息类型,构建离线分析数据集。
  • 多账号管理者:同时登录多个微信工作号,需要备份各账号密钥并快速切换查询历史记录。
  • 隐私敏感开发者:希望在不上传任何数据的前提下,仅在本地对个人微信聊天库进行只读分析和备份。