在命令行里查询你自己电脑上的微信聊天记录。
本地解密、本地查询、只读不改，装好之后断网也能用。
curl -fsSL https://wechat-cli.com/install.sh | sh
macOS / Linux 一行安装 · Windows 与手动下载 ↓
# 初始化一次（需要 sudo，用来提取本地数据库密钥） $ sudo wechat-cli-rs init 初始化完成 配置: ~/.wechat-cli/config.json 提取到 26 个数据库密钥条目 # 看最近会话 $ wechat-cli-rs sessions --limit 3 --format text 最近 3 个会话: 产品讨论组 [群聊] 3条未读 张三: 明天的评审推迟到下午 李四 好的，收到 王五 文件已经发你邮箱了 # 搜索聊天记录 $ wechat-cli-rs search "报销" --format text 在 全部消息 中搜索 "报销" 找到 2 条结果: [2026-08-12 14:22] [财务群] 赵六: 本月报销单截止到 25 号 [2026-08-20 09:41] [李四] 李四: 报销流程走完了吗？
以上为示意输出
聊天记录在你自己的电脑上解密和查询，程序不会把任何聊天内容发到外部服务器。
不发消息、不改数据、不删记录，也不做任何自动化操作，纯粹是一个查询工具。
装好并初始化之后，所有查询都在本地完成。拔了网线照样能查。
默认 JSON 输出、稳定的退出码，方便管道处理，也方便交给 AI Agent 调用。
单个可执行文件，没有运行时依赖，下载即用，启动快、占用小。
macOS（Apple 芯片 / Intel）、Windows、Linux 都有预编译版本。
先确保微信已经登录，然后初始化一次。之所以需要 sudo，是因为要读取微信进程内存来提取数据库密钥。
$ sudo wechat-cli-rs init # 之后就可以随便查了 $ wechat-cli-rs sessions --format text # 最近会话 $ wechat-cli-rs contacts --query "张" --format text # 找联系人 $ wechat-cli-rs history "张三" --format text # 看聊天记录 $ wechat-cli-rs search "报销" --format text # 全局搜索 $ wechat-cli-rs export "张三" --format markdown --output chat.md
浏览类命令永久免费；读取聊天正文和分析类命令需要 Pro 授权。
| 命令 | 说明 | 授权 |
|---|---|---|
| init | 初始化、提取数据库密钥 | 免费 |
| sessions | 最近会话列表 | 免费 |
| contacts | 联系人查询与详情 | 免费 |
| members | 群聊成员列表 | 免费 |
| unread | 未读会话 | 免费 |
| history | 读取聊天记录（支持时间/类型过滤） | Pro |
| search | 搜索消息内容 | Pro |
| stats | 消息统计、发送者排行、活跃时段 | Pro |
| export | 导出聊天记录为 Markdown / 文本 | Pro |
| favorites | 微信收藏查询 | Pro |
| new-messages | 自上次调用以来的新消息 | Pro |
拿到激活码之后：
$ wechat-cli-rs license activate --name "你的姓名" --code "激活码" 激活成功：你的姓名（pro） $ wechat-cli-rs license status
版本 0.1.1，发布于 2026-08-24。也可以用上面的一行命令自动安装。
~/.wechat-cli/，你随时可以删掉命令面是按脚本和 AI 调用设计的：默认 JSON 输出，退出码稳定，不需要去解析中文提示语。
| 退出码 | 含义 |
|---|---|
| 0 | 成功 |
| 1 | 找不到目标 / 一般错误 |
| 2 | 参数用法错误 |
| 3 | 本地数据打不开（解密失败等） |
| 4 | 需要 Pro 授权 |
把这份纯文本说明交给 agent，它就知道该怎么调用、哪些命令要授权、什么时候该停下来问用户：
$ curl -fsSL https://wechat-cli.com/SKILL.md