这是一个让AI助手帮你发微信消息的小工具！
- 🤖 AI助手的好帮手：让Claude、ChatGPT等AI助手能直接发微信消息
- 🔌 即插即用：像USB一样简单连接AI和微信
- 💻 纯模拟操作：就像你亲手操作一样，只是让电脑帮你点鼠标按键盘
- 🕒 节省时间：不用手动复制粘贴消息
- 🤝 自动化工作：定时发送、批量处理都交给AI
- 🎮 智能助手：让AI帮你处理微信沟通
本项目采用全程模拟键盘快捷键和鼠标操作的方式实现微信消息发送，绝无任何逆向工程或侵害行为：
flowchart TD
A[接收消息请求] --> B[快捷键唤醒微信]
B --> C[搜索联系人/群聊]
C --> E[剪贴板输入文本]
E --> F[快捷键发送消息]
F --> G[返回发送结果]
- 快捷键唤醒 - 使用全局快捷键激活微信窗口
- 剪贴板输入 - 使用系统剪贴板API输入文本，避免输入法干扰
- 快捷键发送 - 模拟系统键盘快捷键发送消息
- 无逆向工程：本项目不涉及微信客户端逆向、内存读取、协议分析等行为
- 无数据窃取：不读取微信聊天记录、联系人信息等任何用户数据
- 无协议破解：不分析或破解微信通信协议
- 纯GUI操作：所有操作均在用户界面层面完成，与人工操作完全一致
- 用户隐私保护：所有操作均在本地完成，消息内容不经过任何第三方服务器
- 剪贴板保护：自动备份和恢复用户原始剪贴板内容
- 权限最小化：不请求网络或文件系统权限
| 平台 | 支持 | 微信版本 | 技术方案 |
|---|---|---|---|
| 🪟 Windows | ✅ 完整支持 | 微信 4.0+ | win32gui + win32clipboard |
| 🍎 macOS | ✅ 完整支持 | 微信 4.0+ | NSWorkspace + NSPasteboard (pyobjc) |
| 🐧 Linux | ✅ 完整支持 | WeChat4Linux / Wine 微信 | xdotool + xclip |
| 操作 | Windows | macOS | Linux |
|---|---|---|---|
| 搜索联系人 | Ctrl+F |
Cmd+F |
Ctrl+F |
| 发送消息 | Alt+S / Enter |
Cmd+Enter |
Alt+S / Enter |
| 全选 | Ctrl+A |
Cmd+A |
Ctrl+A |
| 粘贴 | Ctrl+V |
Cmd+V |
Ctrl+V |
flowchart LR
subgraph 抽象层
FAC["platform/__init__.py<br/>工厂函数"]
BASE["platform/base.py<br/>抽象接口"]
CLIP["platform/clipboard.py<br/>剪贴板代理"]
end
subgraph WIN["Windows 实现"]
WIN_F["win/window_finder.py<br/>win32gui"]
WIN_G["win/gui_ops.py<br/>win32clipboard"]
end
subgraph MAC["macOS 实现"]
MAC_F["mac/window_finder.py<br/>NSWorkspace"]
MAC_G["mac/gui_ops.py<br/>NSPasteboard"]
end
subgraph LIN["Linux 实现"]
LIN_F["linux/window_finder.py<br/>xdotool"]
LIN_G["linux/gui_ops.py<br/>xclip"]
end
FAC --> BASE & CLIP
FAC -.-> WIN & MAC & LIN
- 📤 发消息：给微信好友或群聊发消息
- ⏰ 定时发送：设置时间自动发送
- 📊 消息队列：排队发送，不怕消息太多
- 🔄 自动重试：发送失败会自动重试
- 🚫 绝不偷数据：不读取你的聊天记录
- 🔒 本地运行：所有操作都在你电脑上完成
- ⚡ 模拟操作：就像你自己操作微信一样
- 🤖 AI集成：直接让AI助手帮你发消息
- 🌐 网页管理：浏览器里查看发送状态
- 📱 后台运行：最小化到系统托盘不打扰
pip install -r requirements.txt依赖会自动根据当前操作系统安装对应平台的包（Windows 安装 pywin32，macOS 安装 pyobjc，Linux 安装 pyperclip）。
如果使用 Linux，还需安装：
# Ubuntu / Debian
sudo apt install xdotool wmctrl xclip
# Arch Linux
sudo pacman -S xdotool wmctrl xclip- 打开微信并登录你的账号
- 建议先向"文件传输助手"测试发送
- 给谁发：好友名字或群聊名称
- 发什么：要发送的消息内容
- 怎么发：立即发送或排队发送
- 设置时间：延迟多少秒后发送
- 自动排队：时间到了自动发送
- 查看队列：有哪些消息在排队
- 查看详情：每条消息的发送状态
- 管理消息：取消或重试发送
- 配置AI助手连接本工具
- 告诉AI助手："给张三发消息说你好"
- AI助手会自动帮你发送
# 启动 HTTP 服务器
python src/mcp_server.py --transport streamable-http --port 8765
# 发送测试消息
curl -X POST http://localhost:8765/api/v1/messages/send \
-H "Content-Type: application/json" \
-d '{"contact_name": "文件传输助手", "message": "你好！"}'- 首页：
http://localhost:8765- 简单测试页面 - 队列管理：
http://localhost:8765/queue- 查看和管理消息队列
⚠️ 重要提醒
- 使用期间请勿手动操作微信窗口
- 确保微信窗口没有被完全遮挡
- 建议先向"文件传输助手"测试
- 不要用于发送垃圾信息
- 本工具仅用于个人自动化操作
- 请遵守微信使用条款
- 不建议用于大量消息发送
- ✅ 确保微信已启动并登录
- ✅ 检查微信窗口是否可见
- ✅ Linux 用户确保已安装 xdotool
- ✅ 尝试重启微信
- ✅ 检查网络连接
- ✅ 确认联系人名称正确
- ✅ 微信窗口是否被遮挡
- ✅ 查看日志文件了解详细错误
- ✅ 查看日志文件了解详细错误
- ✅ 重启工具和微信
- ✅ 检查配置是否正确
如果您觉得这个工具对您有帮助，请考虑：
- ⭐ 给项目点个Star
- 🔄 分享给您的朋友
- 💬 提出建议和反馈
QQ群
您的每一份支持都是我们持续改进的动力！❤️
🚨 严重警告
使用本工具存在风险，请仔细阅读以下内容：
- 个人工具：仅为个人自动化需求设计
- 非官方工具：与微信官方无任何关联
- 学习用途：主要用于技术学习和研究
- 账号风险：可能导致微信账号被限制
- 功能失效：微信更新可能导致工具失效
- 自行承担：所有使用风险由使用者自行承担
使用本工具即表示您：
- 已理解并接受所有风险
- 同意自行承担所有后果
- 不会用于违法或不当用途
严禁用于：
- 发送垃圾广告
- 骚扰他人
- 违法活动
- 违反微信条款的行为
如果您不同意上述条款，请立即停止使用。
本项目采用 MIT License 开源许可证。
允许：
- ✅ 个人使用
- ✅ 修改代码
- ✅ 分享代码
需要：
- 📋 保留版权声明
- 📋 保留许可证声明
欢迎大家一起改进这个工具！
发现bug？请告诉我们！
有好想法？欢迎提出！
会编程？欢迎提交代码！
- 版本：1.2.0
- 更新：持续维护中
- 状态：稳定可用
- 支持平台：Windows / macOS / Linux
想了解更多技术细节？查看我们的技术文档：
温馨提示： 本工具仅为技术演示，请合理使用。如有疑问，请先阅读文档或加入QQ群交流。
祝您使用愉快！🎉