是的，logo 就长这样。鼠标在画图程序里蹭的，将就看。
把 macOS 上的微信变成给 AI agent / bot 用的本地 API。不上云、不上 iPad 协议、纯本地实现，数据只在你这台 Mac 上动。
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 …），老脚本无需改动。
- 💬 发消息（后台零闪屏）+ @ 真红点提醒
- 📜 读消息 / 历史 + 全文搜索（FTS）+ 导出
- 👥 联系人 / 群 / 会话（群名自动解析）
- 🟢 朋友圈（只读）· ⭐ 收藏 · 🖼 图片（heap 直读 + CDN 回源）
- 🎙 语音消息转文字（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 | bash安装器自动准备并安装独立微信 4.1.9 副本（本地已有支持版本就复用，否则从腾讯官方固定地址下载并校验 SHA-256），并把工具绑定到它——不再询问。装完打开 ~/Applications/WeChat-4.1.9-wechat-use.app 扫码登录。确认 ~/.local/bin 在 PATH 里（zsh：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc）。
3. 按顺序跑（install.sh 输出末尾也会重述）
wechat-use auth activate wechatuse_xxxxxx # 1) 输入激活码（务必先做）
wechat-use doctor # 2) 体检，出问题先跑这个
wechat-use init # 3) 抽数据库 key（自动按版本适配）
wechat-use send "Hello 🎉" filehelper # 4) 后台发送测试，无需手动选聊天或预热首次发送需给 wechatd / wechat-bridge「辅助功能」权限：安装器会提示，交互设置跑
wechat-use doctor --fix-tcc（详情 docs/install.md#tcc）。 ❗ 顺序别反：init不需激活码也能跑，但 send / sessions 等查询命令都要激活，反了会在发送时才发现没激活。
# 发消息（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
深入原理
- 让微信在后台替你发消息，我曾经把它的数据库搞坏 —— 从「挂调试器」到「零附着」 — 后台 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 |