wechat-bot

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

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

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

✨ 项目亮点

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

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

功能特性

模式	触发条件	行为
私聊模式（大号）	MASTER_CHAT 发来消息	全部自动处理，可发命令操作电脑文件
群聊模式（群）	群里有人 @小号	抓取上下文，只回复 @ 的消息

• 每个聊天独立的数据：性格（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 一个文件里：

配置	默认	说明
MASTER_CHAT	"主人"	大号昵称：此号消息全部自动处理
GROUP_CHATS	["我的群"]	群名列表：群里只有 @我 才回复
SELF_NICK	"bot"	小号昵称（群里 @ 时显示的名字）
GROUP_USE_API	True	群聊是否直连 DeepSeek API
WORK_DIR	你的路径	AI 工作目录（headless 从这里启动）

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

文件	谁改	作用
persona.md	你手动编辑	AI 在这个聊天的性格（没有则用默认）
rules.md	只有你（#规则 指令）	高等级规则，AI 只读
memory.md	AI 自己（#记住 标记）	AI 记忆
history.json	程序	聊天记录
group_context.json	程序	群聊上下文（所有消息）

运行

python main.py

或双击 启动微信AI.bat。

对大号的特殊指令

指令	作用
#记住 内容	添加一条 AI 记忆
#查看记忆	查看记忆
#清空长期记忆	清空记忆
#规则 内容	添加高等级规则
#查看规则	查看规则
#清空规则	清空规则
#清空记忆	清空对话历史

技能（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 生成，我还没来得及仔细检查。

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