用途：在 macOS 上通过命令行统一操作微信，既能纯后台发送消息（无界面闪烁），也能读取本地加密数据库中的会话、联系人、聊天记录、群成员、朋友圈与收藏等信息，并可通过本地 HTTP 桥接接入智能体平台。安装后先确认命令可用：command -v wechat；缺失时执行 curl -fsSL https://raw.githubusercontent.com/leeguooooo/wechat-skill/main/install.sh | bash，并确保 ~/.local/bin 在 PATH 中。
主要能力：发送消息 wechat send "早上好" Lisa（支持昵称、备注、别名模糊匹配，也支持 wxid、群 wxid、filehelper 等）。接收方为 wxid 形态时直接发送；否则查本地联系人库，单一匹配或仅一个近 30 天活跃时发送，多个匹配返回 JSON status=ambiguous 与 candidates，需改用明确 wxid 重试。查询命令包括 sessions、unread、new-messages、contacts、history、search、members、stats、export、image、favorites、digest 等。send 默认零界面闪烁；查询默认 YAML 输出，加 --json 输出 JSON。实时能力包括 wechat listen，可监听新消息、按 wxid 过滤或通过 --on-message 回调脚本。
使用方式：任何查询命令前需先执行 wechat init（会重启微信以在登录瞬间抓取数据库解密密钥，须在约 5 分钟内点击进入微信；过期可用 wechat init --force）。发送需先在 wechat doctor 中授予终端辅助功能权限并重启终端；每次微信重启后的首次发送需用户在微信中手动发一条消息预热约 5 秒。HTTP 桥接为独立二进制 wechat-bridge，默认绑定 127.0.0.1:18400，提供 /health、/send、/chats、/unread、/contacts、/chat/:wxid、/resolve、/messages/stream?since=<epoch> 等端点；订阅消息流必须传 since，否则会回放全部历史。
限制：仅支持 macOS arm64，Linux、Windows、Intel Mac 不支持；不支持发送图片与文件（路线图中），禁止群发；必须通过激活令牌才能发送；未验证的微信版本可能出现适配漂移。需注意发送循环、群内 @ 判定等安全要点，具体见官方文档。