wechat-cli 微信聊天记录分析

要解决什么问题

微信聊天记录锁在本机加密数据库里，官方客户端没有「按关键词搜全库」「批量导出 Markdown」「跨会话统计」这类面向分析的操作。做复盘、归档或合规留档时，往往只能手工翻聊天窗口，成本高且难自动化。

本技能把 wechat-cli 接到 Agent 工作流里：在本地解密并查询 db_storage 下的 WCDB，不经过云端上传。

技能如何工作

核心能力包括：

• 会话与未读：sessions、unread 浏览最近会话和未读列表
• 按人/群读历史：history 支持时间范围、--type 过滤文本/图片/文件等
• 搜索：search 按关键词检索消息（有默认条数上限）
• 导出：export 输出 Markdown 或纯文本，便于后续总结
• 统计与收藏：stats 做活跃度等统计；favorites 读微信收藏
• 增量：new-messages 基于 last_check.json 做断点续读

关键步骤（首次必做）：

1. 使用 微信 4.0+（4.0 起进程与目录架构变更，3.x 不兼容）
2. 微信已登录且运行中时执行 init，从进程内存或（4.1.12+）Config.Cipher 等路径提取密钥，写入 ~/.wechat-cli/config.json 与 all_keys.json
3. 之后 Agent 可按「sessions → history/search → 分类总结」的分析流调用命令；输出可用 --format text 便于阅读

适用边界与注意点

• 版本强绑定：附带的指定安装包与密钥逻辑针对特定 4.0 架构；随意换版本可能导致 init 失败；4.1+ 密钥策略与早期内存扫描不同，需按文档适配
• macOS：需对微信副本做 ad-hoc 重签名才能读进程内存；更新微信后可能要重新签名
• 多账号：内存中的密钥对应当前登录账号，切换账号需对应 db_dir 与密钥配置
• 查询限制：如 history 默认 50 条、search 有上限；大批量导出需显式调大 --limit
• 系统占位会话（如 brandsessionholder）导出失败属正常现象
• 数据仅在本地处理；但读取本地库仍涉及隐私与合规，使用方需自行把握授权范围