WeChat Bot 🤖

一个基于 PC 微信 (Windows) 和 Google Gemini 3.0 Pro 的智能自动回复机器人

---

它能够监听指定的微信好友或群聊，利用 Gemini 3.0 Pro 强大的语言理解能力进行回复，并且集成了 Google Search 功能，可以回答实时的联网问题。

✨ 特性

• 非注入式安全连接：使用 wxauto 基于 UI 自动化控制微信，不注入内存，相对安全。
• Gemini 3.0 Pro 模型：接入 Google 最新旗舰模型，支持更强的推理能力、长文本和复杂逻辑。
• 联网搜索能力：内置 Google Search Tool，模型可以自主决定是否搜索最新信息。
• 上下文感知：基于 Google GenAI SDK 的流式对话。
• 智能防抖：内置消息去重、自我回复过滤机制，防止死循环。
• 高度可配置：支持环境变量配置触发词、模型版本、系统提示词等。

🛠️ 依赖环境

• 系统：Windows 10/11
• 微信：PC 版微信 (务必使用 3.9 版本。如遇“版本过低”无法登录，请参考 兼容性修复)
• Python：3.9+
• API Key：Google AI Studio (Gemini 3.0 Pro)

🚀 快速开始

1. 安装依赖

本项目依赖 wxauto (需从官方 Repo 安装)、google-genai 和 python-dotenv。

pip install -r requirements.txt

2. 配置环境

本项目支持通过 .env 文件配置环境变量（推荐）。

1. 复制 env.example 为 .env：

   cp env.example .env
   # Windows PowerShell:
   # copy env.example .env

2. 编辑 .env 文件，填入你的配置：

   GEMINI_API_KEY=AIzaSy...
   WECHAT_TARGET=文件传输助手
   BOT_TRIGGER=@Bot

当然，你也可以直接设置系统环境变量，优先级高于 .env 文件。

3. 运行

确保微信已登录并在桌面上可见（不要最小化到托盘）。

python wechat.py
# 或者指定聊天对象
python wechat.py "某某群聊"

⚙️ 配置项说明

环境变量	默认值	说明
GEMINI_API_KEY	(无)	Google AI Studio 获取的 API Key
WECHAT_TARGET	文件传输助手	机器人监听的窗口名称
BOT_TRIGGER	@HunterBot	触发回复的关键词，私聊建议设为空
GEMINI_MODEL	gemini-3-pro-preview	使用的模型版本 (默认 3.0 Pro)
WECHAT_POLL_SEC	2.0	轮询新消息的间隔（秒）
WECHAT_DEBUG	False	设置为 true 开启详细调试日志

🚧 踩坑记录

这里记录开发和使用过程中的一些坑和解决方案，欢迎补充。

1. (待补充...)

🤝 贡献与合作

非常欢迎提交 Issue 或 Pull Request！无论是新功能建议、代码优化还是文档改进，都十分感谢。

如果你有合作意向，也可以直接联系我。

⚠️ 免责声明

1. 封号风险：本项目基于 UI 自动化 (wxauto)，虽然比协议挂安全，但高频发送消息仍可能触发微信风控。建议仅用于测试或个人辅助，请勿用于大规模群发。
2. 数据隐私：消息内容会发送至 Google 服务器处理，请遵守相关隐私政策，不要处理敏感个人信息。
3. API 费用：请关注 Google GenAI 的计费规则。

License

MIT License