微信 AI 桥接机器人（WeChat AI Bridge）

让微信里的 AI 拥有和 DeepSeek Harness 一样的能力：对话、记忆、按每个聊天区分性格与权限，还能操作你电脑上的文件（仅限大号）。

⚠️ 风险提示：个人微信自动化是微信官方禁止的行为，有封号风险。请务必使用小号测试，勿用于骚扰、诈骗等非法用途。

✅ 特殊说明 · 上手即用：本项目采用 wxauto 系（UI 自动化） 方案——不注入微信进程、不用第三方协议，只是模拟真实鼠标键盘操作，因此相比协议/注入式工具被封号概率低很多。配置好（只改一个 config.py）就能直接上手使用。当然，稳妥起见仍建议先用小号跑几天，稳定后再换大号。

✨ 项目亮点

• 🤖 真·住在微信里的 AI：不只是在网页里用 AI，它直接接进你的微信，私聊、群聊都能聊
• ⚡ 群聊秒回：直连 DeepSeek API，2-5 秒出回复，不用等 headless 冷启动
• 🧠 每个聊天独立记忆：人设、规则、记忆各自独立，互不串味
• 🛡️ 群聊安全硬约束：群聊禁用文件/命令工具，只能聊天 + 搜索；只有大号私聊有全权限
• 🔌 技能系统：加一个文件夹就能给 AI 装新技能（自然对话、日程规划、天气查询……）
• 📦 零配置一键跑：只改一个 config.py，双击 启动微信AI.bat 即可运行

🛠️ 想自己搭一个？看 AGENTS.md——专为「小白 + AI 协作」准备的分步配置指南。

功能特性

• 每个聊天独立的数据：性格（persona.md）、高等级规则（rules.md，只有你能改）、AI 记忆（memory.md）、聊天记录、群上下文——互不影响
• 群聊直连 DeepSeek API：回复秒回（2-5 秒），省掉 headless 冷启动
• 大号私聊走 Harness：全权限（可操作电脑文件、执行命令）
• 群聊硬约束：技术上禁用文件/命令工具，只能聊天 + 搜索
• 技能系统：群聊可加载专属技能（自然对话、日程规划、天气查询）
• 天气查询：问天气 → 程序用中国天气网查真实数据
• 详细调试日志：每步都有提示，写入 logs/bridge.log

工作原理

微信收到消息
   ↓
wechatauto 库（监听微信消息）← 开源项目 wechatauto-replica
   ↓
读取该聊天的：persona.md（性格）+ rules.md（规则）+ memory.md（记忆）
           + history.json（聊天记录）+ group_context.json（群上下文）
   ↓
私聊 → DeepSeek Harness headless（全权限，可操作电脑）
群聊 → DeepSeek API 直连（快，无工具）
   ↓
解析 AI 标记：【记住】（写记忆）【天气】（查天气）
   ↓
回复发回微信（wechatauto 模拟操作微信窗口）

环境要求

• Windows 10/11
• Python 3.9+（需要能运行 wechatauto）
• 微信 PC 版 4.1.12+（登录小号）
• DeepSeek Harness（可选，私聊模式用；群聊直连 API 只需要 API Key）
• DeepSeek API Key（从 ~/.dsh/.credentials.yaml 的 DEEPSEEK_API_KEY 自动读取）

安装

# 安装 wechatauto-replica（微信自动化库）
pip install wechatauto-replica

配置

所有配置都在 config.py 一个文件里：

每个聊天独立的数据目录 data/chats/<聊天标识>/：

运行

python main.py

或双击 启动微信AI.bat。

对大号的特殊指令

技能（skills）

• 通用技能：~/.dsh/skills/（GUI、大号、群聊都能用）
  • weather-zh：天气查询（程序查中国天气网真实数据）
• 群聊专属技能：group-skills/（只有群聊能看到）
  • wechat-natural-chat：自然对话指南
  • wechat-schedule：日程规划
• 想加技能：往对应目录放 <名字>/SKILL.md 文件夹即可

目录结构

wechat-bot/
├── config.py          所有配置
├── main.py            主程序
├── dsh_bridge.py      核心逻辑（记忆/规则/调用 AI）
├── gen_layout.py      微信布局配置工具（修复 OCR 问题）
├── group-lite.yml     群聊安全补丁（禁用文件工具）
├── weather.py         天气查询脚本
├── group-skills/      群聊专属技能
├── data/              运行时数据（自动生成，不提交）
└── logs/              日志（自动生成，不提交）

常见问题

Q：群聊 @ 了我但没反应？ A：① 检查 @ 的名字是不是 SELF_NICK；② 电脑微信是否打开过该群（同步消息）；③ 看 logs/bridge.log。

Q：找不到聊天框/发送失败？ A：查看 logs/bridge.log 最后几十行，通常能看出原因（窗口不可见、会话没打开等）。

Q：群聊用 API 还是 Harness？ A：默认群聊直连 API（快），GROUP_USE_API = False 可切回 Harness。大号私聊始终走 Harness。

贡献

欢迎任何人参与！不管是报 bug、提建议还是直接改代码，都感谢你的帮助。

• 贡献流程请看 CONTRIBUTING.md
• 本项目使用 MIT License

致谢

• wechatauto-replica：微信 4.x 自动化库
• woodcoal/weather-skill：天气查询数据源

免责声明

⚠️ 本项目百分百由 AI 生成，我还没来得及仔细检查。

• 如果你是大神：请自行检查代码后再使用，风险自负。
• 如果你是小白：先别急着用，等我再调试调试，稳定了再使用。