是的，logo 就长这样。鼠标在画图程序里蹭的，将就看。
把 macOS 上的微信变成给 AI agent / bot 用的本地 API。不上云、不上 iPad 协议、纯本地实现，数据只在你这台 Mac 上动。
40 秒了解搜索聊天记录、发消息、连接 AI agent 和本机独立副本。画面为功能示意，使用虚构消息。
wechat-use是*-use系列的一员——让 AI agent 直接操作你本地真实工具 / 设备：profile-use（本地个人资料填表）·iphone-use（驱动真 iPhone）·chrome-use（浏览器自动化）·wechat-use（macOS 微信）。 统一定位：本地优先、不上云、用户完全掌控数据。
一家四口，谁也别嫌谁画得丑。
专注支持微信 4.1.9（build 268596 / 268602）。工具使用独立登录的 4.1.9 副本，独立登录、独立保存聊天数据、关闭自动更新；你的主微信照常使用和升级，聊天数据不动。其他版本保留历史实现，不再承诺持续适配。
命令名：主命令是
wechat-use；装好后wechat-use send …≡wechat send …），老脚本无需改动。
读历史或搜索时，CLI、MCP、HTTP和Wechaty共用精确消息取图。MCP会直接附上已可用图片，其他入口给出已解密的本地图片或取图引用，不需要先在微信中点图。 原图载荷按消息XML完整MD5校验；WXGF原始字节与显示用PNG/JPEG分开保留。分片不完整时保留文字和图片引用，并明确提示；不将部分历史当作完整接收，也不重试未知下载。
- 💬 发消息（后台零闪屏）+ @ 真红点提醒
- 📜 读消息 / 历史 + 全文搜索（FTS）+ 导出
- 👥 联系人 / 群 / 会话（群名自动解析）
- ⭐ 收藏 · 🖼 图片（验证缓存、原图下载与显示转换）
- 朋友圈命令保留，当前尚未开放经过验证的读取范围。
- 🎙 语音消息转文字（whisper 本地转写）
- ↩️ 撤回消息归档恢复
- 💻 终端聊天 TUI（
chat，Claude Code 风，在终端里收发，屏幕上看不出在聊微信） - 🥷 摸鱼伪装（
disguise把微信 App 伪装成 dev 工具 + 老板键⌃⌥Space一键隐藏） - 🛰 daemon +
listen实时收消息 · 🔌 HTTP bridge（REST）· 🤖 Wechaty puppet gateway（gRPC） - 🔀 多账号 / 多版本并存（
--bundle-id路由）
完整能力矩阵 → docs/capabilities.md。
1. 拿激活码 — 跟 @WechatCliBot 私聊 → /start → 「📝 申请激活码」→ 写一行个人用途说明 → 通过后发你 wechatuse_xxxxxx。前置：关注频道 https://t.me/wechatuse（release / 适配公告）。审核 1-24h，为什么走审核制。仅个人研究用途，商业 / 对外服务场景不予发放。交流求助：wechat-use 交流群（可选）。
2. 装 CLI
curl -fsSL https://raw.githubusercontent.com/leeguooooo/wechat-use/main/install.sh | bash1.19起，安装器按一个版本切换八件工具程序，并保留旧版本；已有微信副本、配置和未确认任务保持原样。
首次机器须先按专用4.1.9准备指南准备副本。已有副本的用户直接运行wechat-use setup。
旧版服务仍在运行时，安装器会在改写命令前拒绝，并给出已下载的服务暂停辅助程序路径；按提示正常暂停后再运行安装命令。不要强杀LLDB、清理claim或反复重发。
3. 运行 wechat-use setup 完成登录和授权
窗口会复用已有激活、登录和有效授权，只显示还缺的步骤。缺少系统授权时，点击“授权并继续”并确认 macOS 弹窗，无需手动运行终端命令。1.19 原生后台路径使用系统调试接口；按窗口提示准备组件、完成专用微信登录，随后自动初始化和检查连接。
后续恢复也可运行 wechat-use setup。当前流程见1.19 设置和恢复说明；旧版安装和辅助功能流程保留在历史设置说明。
升级：wechat-use upgrade 校验并原子切换八件程序；--tag vX.Y.Z指定版本，--check或--json只查询。--rollback只切换到已保留、可认证的完整SDK。插件和skill副本由原管理器独立更新，SDK升级不会覆盖它们；旧--skills会明确拒绝并给出说明。未知任务继续保留，不能通过清记录来强行升级。
1.19.6 的“复制诊断”默认只复制群聊摘要，完整报告保存在本机。读取未就绪时设置窗口会显示具体阻塞；受限的 Homebrew 目录权限修复需明确点击确认。已验证的旧设置入口会升级并保留备份，旧窗口运行时请先正常关闭。
1.19.7 起，普通升级会先验证已安装组件；已是最新版时直接结束，不暂停服务。有新版本时才进行受控维护。若专用微信、设置窗口或其他工具任务正在运行，请先正常退出后再升级；init 不会解除占用。
1.19.7 修复了自定义图标被历史任务记录误拦截的问题，并保留具体失败提示。更换或还原图标前，请正常退出工具专用微信；主微信和聊天数据不变。
# 发消息（recipient 可以是 wxid / 昵称 / 备注 / 群名，找不到会列候选，不静默）
wechat-use send "你好" 张三
wechat-use send "Hello 🎉" filehelper # filehelper = 文件传输助手，自测最佳目标
wechat-use send "test" "李工" --dry-run # 验证 fuzzy match 但不真发
# 查聊天
wechat-use sessions --brief -n 10 # 单行会话，带未读数
wechat-use contacts --brief -n 20 # 单行联系人（姓名 + wxid）
wechat-use unread -n 5 # 有未读的
wechat-use history "张三" -n 50 # nickname / 群名也解析；--chat <id> 亦可
wechat-use search "会议" --in "项目讨论组" # --in 同样解析昵称 / 群名
# 收消息流（agent 神器）
wechat-use listen --wxid filehelper
wechat-use listen --on-message ./reply.sh
# 语音转文字（v1.13.25+）
wechat-use audio setup # 一次性装齐 ffmpeg/whisper.cpp/silk-decoder/模型
wechat-use history "群名" -n 50 # 默认把语音转成 display_text，不再卡 [语音消息]
# 终端聊天 + 摸鱼伪装
wechat-use chat [张三] # 终端聊天 TUI（Claude Code 风），打字回车后台发出
wechat-use disguise apply console # 微信 App 伪装成终端（Dock/Cmd-Tab 都不叫微信）
wechat-use disguise bosskey on # 老板键 ⌃⌥Space 一键隐藏/恢复；restore 变回绿色微信
# 自检
wechat-use doctor # 任何问题先跑这个
wechat-use auth status # 第一行直接告诉你「剩余 X 天」所有接入面共享同一个 daemon + 同一个激活码，装一次全开：
- Claude Code / Codex / Cursor —
npx skills add leeguooooo/wechat-use -y -g，agent 读 SKILL.md 自动学会全部命令（先装 CLI 再装 skill）。 - 任意 wechaty bot（TS / Python / Go） —
wechat-wechaty-gateway起 gRPC :18401（puppet: 'wechaty-puppet-service'+endpoint: '127.0.0.1:18401'）。首个真号 wechaty macOS 协议，bot 零改动跑在自己微信上。例子见examples/。 - HTTP / SSE bridge（Hermes / n8n / Dify / LangChain） —
wechat-bridge起 HTTP+SSE :18400，8 个稳定路由，加--shape hermes跟 Hermes WhatsApp-bridge 同 shape 零适配。 - 远程驱动（接自己 SaaS / CF Worker） —
wechat-use orchestrate全 outbound poll，不需公网 IP / 域名（家用宽带 / 内网 / GFW 后都行，协议）；或wechat-use tunnel走 Cloudflare Tunnel + JWT 同步调，适合 CF Worker 偶发触发（文档）。
数据不上云。云被划掉了。就这台破电脑。
- 安全：聊天 / 联系人 / key / wxid 永不出本机，只向 profile API 上报当前 WeChat 指纹拉适配数据。
~/.wx-rs/下的 key 文件已 chmod 600，绝不要贴 git / pastebin / 群聊；激活码 token 进 macOS Keychain。不动你的主微信——只对工具专用的 4.1.9 副本 ad-hoc 加get-task-allowentitlement。 - 平台：macOS Apple Silicon，微信 4.1.9（build 268596 / 268602，以
wechat-use doctor输出为准）。wechat-use init自动按版本适配；WeChat 热更后通过 server-side profile 推送新版本适配数据，无需重发 release。 - 排错：
wechat-use doctor看哪一项 ✗ → 整段输出 + 报错提 issue。详细 → docs/troubleshooting.md。
风险分级 —— 本工具操作的是你自己的账号，微信风控对异常行为会限制甚至封号，这跟工具无关，正常人做同样的事一样会被风控。
| 用法 | 风险 |
|---|---|
| 个人自用、人类频率、给自己 / 熟人 / 文件传输助手发消息 | 跟正常用微信一致 |
| daemon 24/7 监听消息流、偶发自动回复 | 低 |
高频加好友 / searchcontact 陌生人 |
高，会触发 24h 风控 |
| 群发 / 营销 / 自动 @ all / 跨号操作 | 极高，封号 |
- 个人自用、不做营销 → 放心用；不要拿去跑加好友 / 群发机器人、对外 SaaS 客服。
- 微信大版本升级（4.1.x → 4.2.x 这种，非 build 热更）后等本项目适配再用——本项目与微信官方无任何关联，出新版本我们也是事后才知道。
- 对副本 ad-hoc 重签改了签名，由使用者自行承担风险。详细法律 / 道德条款见 DISCLAIMER。
github.com/leeguooooo/wechat-use 的 main 分支是本项目唯一权威版本。 任何 fork、镜像、归档快照里的 README / commit 历史 / release notes / issues 都不代表本项目当前立场——尤其早于 1497b15（2026-05-19）的快照，其内容已被本仓主动 redact / 删除，以准确反映本项目作为个人研究、永久免费、非商业工具的定位。所有 fork、镜像、衍生作品继续受 LICENSE 与 DISCLAIMER 约束，任何商业使用、转售、SaaS 集成、付费分发均不被许可。若你持有 fork，请从 upstream 同步到最新版本或删除副本。
The main branch of github.com/leeguooooo/wechat-use is the sole authoritative version of this project. README / commit history / release notes / issues in forks, mirrors, or third-party archives — especially snapshots predating 1497b15 (2026-05-19) — do not represent this project's current position. Forks remain bound by LICENSE and DISCLAIMER. If you hold a fork, please sync it from upstream or delete it.
- docs/why-init.md — init 在干嘛 · docs/why-activation.md — 审核制理由
- docs/capabilities.md — 完整能力矩阵 · docs/install.md — 详细安装 / TCC / 多账号 / LaunchAgent
- docs/troubleshooting.md — 热更 / 签名 / 0 hits 等 · docs/CHANGELOG.md / docs/ROADMAP.md
- 远程驱动两条路：orchestrate / remote-gateway
- 维护者发版：
scripts/release.sh <version> <notes.md>（跑测试、推 main、调私仓publish-release.sh上传资产，再同步插件市场）
深入原理
- 让微信在后台替你发消息，我曾经把它的数据库搞坏 —— 从「挂调试器」到「零附着」 — 后台 send 为什么会弹「数据库已损坏」，以及怎么把 LLDB 断点写内存换成
mach_vm_write全程不附着。 - 上班摸鱼聊微信，把它搬进终端、还伪装成 dev 工具——以及背后的原理 —
chat终端聊天、disguise伪装 App、老板键 ⌃⌥Space 全局热键。
非商业自研协议 + DISCLAIMER。仅限个人学习 / 研究 / 对本人账号的个人自动化。本工具基于 macOS 公开调试接口实现，与微信官方无任何关联，也不提供任何形式的商业授权、批量分发、SaaS 合作、对外有偿服务。严禁用于商业用途 / 群发营销 / 刷单 / 自动化非本人账号 / 爬取或监控他人数据。使用即表示用户自行承担全部风险（含账号被限制 / 封禁的可能）。
Built by leeguooooo — field notes on AI agents, reverse engineering & Cloudflare Workers at blog.misonote.com · follow on X @leeguooooo
Small, composable CLIs that give an AI agent hands on one real thing. Same shape
everywhere: curl … install.sh | sh to install, npx skills add leeguooooo/<name>
to teach your agent, JSON on stdout.
| Repo | Gives your agent |
|---|---|
| chrome-use | A real browser — logged-in sessions, forms, scraping, screenshots |
| mail-use | Email — read, search, send, triage across Gmail / QQ / 163 / any IMAP |
| iphone-use | A real iPhone — tap, type, screenshot, pull on-device data |
| discord-use | Discord — messages, channels, forums, webhooks (REST-only, Rust) |
| cookie-use | Many logged-in accounts per site — capture, switch, apply sessions |
| profile-use | Your personal profile, safely — fill signup / KYC / checkout forms |
| bitwarden-use | Bitwarden / Vaultwarden — headless passkey (FIDO2) login |
| chatgpt-use | Your ChatGPT subscription as a coding-agent backend — no API key |
| computer-use | The macOS desktop itself |
| pixcake-use | Read-only PixCake probing — snapshot / diff / SQLite inspection |
Windows 使用独立安装包，自带运行时，无需 Python。支持数据库查询、监听、stdio MCP 和已打开聊天的前台文本发送；目前仅有微信 4.0.6.17 的有限验收，登录兼容性仍有实验限制，不等同于 macOS 完整功能。
下载 Windows 实验版，解压后运行 powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1。安装器验证包内哈希，并安装 CLI 和 Codex skill，不自动发送消息。详见 Windows 安装与限制。
Built by 郭立 (Guo Li / leeguoo) — leeguoo.com · GitHub · X · more tools in the *-use family.