Wechat Use

wechat-use

是的，logo 就长这样。鼠标在画图程序里蹭的，将就看。

把 macOS 上的微信变成给 AI agent / bot 用的**本地 API**。 不上云、不上 iPad 协议、纯本地实现,数据只在你这台 Mac 上动。

`wechat-use` 是 **`*-use` 系列**的一员——让 AI agent 直接操作你本地真实工具 / 设备: [`profile-use`](https://github.com/leeguooooo/profile-use)(本地个人资料填表) · [`iphone-use`](https://github.com/leeguooooo/iphone-use)(驱动真 iPhone) · `chrome-use`(浏览器,规划中) · **`wechat-use`**(macOS 微信)。 统一定位:**本地优先、不上云、用户完全掌控数据**。

一家四口，谁也别嫌谁画得丑。

**支持微信 4.0.x / 4.1.x 系列**。具体版本兼容矩阵以 `wechat-use doctor` 输出为准;WeChat 热更后通过 profile API 推送适配数据,**无需重发 release**。

**命令名**:主命令是 `wechat-use`;装好后 `wechat` 是它的等价别名(`wechat-use send …` ≡ `wechat send …`),老脚本无需改动。

功能

• 💬 发消息（后台零闪屏）+ @ 真红点提醒
• 📜 读消息 / 历史 + 全文搜索（FTS）+ 导出
• 👥 联系人 / 群 / 会话（群名自动解析）
• 🟢 朋友圈（只读）· ⭐ 收藏 · 🖼 图片（heap 直读 + CDN 回源）
• 🎙 语音消息转文字（whisper 本地转写）
• ↩️ 撤回消息归档恢复
• 💻 终端聊天 TUI（chat，Claude Code 风,在终端里收发,屏幕上看不出在聊微信）
• 🥷 摸鱼伪装（disguise 把微信 App 伪装成 dev 工具 + 老板键 ⌃⌥Space 一键隐藏)
• 🛰 daemon + listen 实时收消息 · 🔌 HTTP bridge（REST）· 🤖 Wechaty puppet gateway（gRPC）
• 🔀 多账号 / 多版本并存（--bundle-id 路由）

版本兼容

WeChat 版本	取 key	消息/历史	联系人/群	朋友圈	收藏	图片	语音转写	撤回归档	发消息	@ 红点
4.0.x	✅	◐	◐	◐	◐	◐	◐	◐	⚠️	⚠️
4.1.7 / 4.1.8	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
4.1.9	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
4.1.10	✅	✅	✅	✅	✅	◐	◐	◐	✅	✅

**图例**:✅ 已实测/已验证 · ◐ 取 key 后应可读(读类功能基于解密 DB,设计上版本无关),本轮未在该版本逐项实测 · ⚠️ 视具体小版本。 随版本变化的主要是「取 key 方法」和「发消息 / @」(需按版本逆向);读类功能取到 key 后基本通用。

**4.1.10 已支持**（v1.16.47+）:`init` 自动取 key + 发消息 + @ 真红点全部打通。4.1.10 首次 `init` 会请你重开一次 WeChat 并点开通讯录/几个聊天(约 25