Skip to content

Releases: vpcoderli/wxq

Release list

v1.0.0 — 首个公开版本

v1.0.0 — 首个公开版本 Latest
Latest

Choose a tag to compare

View all tags
@vpcoderli vpcoderli released this 09 Oct 05:48
v1.0.0
7328849

首个公开版本。查询本机微信聊天记录 —— 命令行工具 + MCP 服务,数据全程不出本机。

First public release. Query your local WeChat data from the command line or through an MCP server
for AI agents. Everything runs locally; nothing is uploaded.

pip install wxq          # CLI
pip install "wxq[mcp]"   # 含 MCP 服务 / with MCP server

功能 / Features

  • SQLCipher 4 解密 — AES-256-CBC + HMAC-SHA512 校验,支持 WAL 回填
  • 自动提取密钥 — 扫描微信进程内存,支持 macOS / Windows / Linux
  • 11 个命令行子命令 — 会话、历史、搜索、联系人、群成员、统计、导出等
  • MCP 服务 — 向 AI Agent 暴露 8 个只读工具
  • 增量消息 — new-messages 只返回上次查询之后的新消息
  • 时间与类型过滤 — 所有查询命令均支持日期区间和消息类型筛选
  • 群聊支持 — 成员列表、发言人排行、24 小时活跃度分布
  • 类型完备 — 随包提供 py.typed

用法 / Quick start

wxq init                                 # 首次:提取数据库密钥(macOS/Linux 需 sudo)
wxq sessions                             # 最近会话
wxq history "Alice" --limit 50           # 某人的聊天记录
wxq search "会议" --chat "工作群"         # 在指定群内搜索
wxq stats "工作群" --start-time 2026-09-01  # 统计

所有命令默认输出 JSON,--format text 输出给人读的格式。

配 MCP 服务到 Claude Desktop:

{ "mcpServers": { "wxq": { "command": "wxq-mcp" } } }

仓库根目录另有 SKILL.md,可直接作为 Claude skill 安装使用。

环境要求 / Requirements

  • Python 3.10+
  • 微信桌面版(macOS / Windows / Linux),且至少登录过一次
  • wxq init 需要扫描微信进程内存,在 macOS 和 Linux 上需要 sudo;macOS 上可能需要对
    WeChat.app 重新签名

说明 / Notes

只读。 所有命令只读取数据库,不写入、不修改、不删除微信的任何数据。解密出的副本放在系统临时
目录,按源文件 mtime 失效。

数据敏感性。 这个工具读取的是真实私人对话,其中包含其他人写下的消息。如果你把它接给 AI
Agent,请注意上下文里会出现第三方的私人内容。

密钥过期。 微信更新数据库后密钥可能失效,表现为命令以退出码 3 失败,此时重新运行
wxq init --force。

验证 / Verified

  • 266 个测试,Python 3.10 / 3.11 / 3.12 / 3.13 全绿
  • Linux、macOS、Windows 三平台 CI 通过
  • mypy --strict 零错误
  • wheel 与 sdist 均通过 twine check,并经净室安装验证

Full Changelog: https://github.com/vpcoderli/wxq/commits/v1.0.0

Assets 2
Loading