Wechat-Bot
Hi~ o(￣ ▽ ￣)ブ！喵呜，欢迎使用 Wechat-Bot！
🔝 介绍
WeChat-Bot是由iwyxdxl开发dy阿文睡不醒整理更新的，将deepseek、gpt、gemini等AI大语言模型接入微信实现角色扮演自动聊天的聊天机器人。
本 fork 版本由 fanyuantaier 维护更新：哔哩哔哩 @fanyuantaier · GitHub @fanyuantaier。项目地址：github.com/fanyuantaier/wechatbot-new（PyPI：wechatbot-new）。
⚠ 注意
为了正常与WeChat通讯，WeChatBot现已支持微信 4.1.12 及以上版本运行（底层 wechatauto-replica 已适配 4.1.15.13）
🍦 下载
WechatBot Beta-2.2.6
系统兼容性
- 支持运行的Windows版本：Windows10，Windows11
- 不支持的Windows版本：WindowsXP，Windows7，Windows8，Windows8.1
网吧可能无法保存聊天记忆或无法支持运行网吧有一定记录运行会报错等。
本项目已发布到 PyPI（pip install wechatbot-new），源码、更新日志与问题反馈见 GitHub 仓库：
以后更新都会发布到 PyPI 与 GitHub 仓库。
🚀 注意事项
💰 赞助
哔哩哔哩关注 阿文睡不醒i ，谢谢喵~你的免费关注就是我们最大的动力！
本工具Github开源，但原作者已经停止维护，现由阿文睡不醒i维护更新WeChatBot更有动力！
本 fork 版本由 fanyuantaier 维护更新：哔哩哔哩关注 fanyuantaier ，项目地址 github.com/fanyuantaier/wechatbot-new，谢谢喵~你的免费关注就是我们最大的动力！
♾️ 功能介绍
本工具可以实现WeChat接入AI，实现你的Ai女友功能WeChatBot可以让你在虚拟与现实交织处，予永恒的温柔羁绊，质疑痞老板，理解痞老板，成为痞老板，让你找到记忆中的那个她。
🎨 搭配使用可实现效果
让你的WeChat功能更加强大实现了：👤 角色扮演，🧠 记忆整理，📥 导入配置，💬 主动消息，😊 表情识别，👋 拍一拍，🛡️ 防撤回，🌈 朋友圈查询，🧬 模仿我的说话风格，📖 按需读上下文等。
☑️ 主动消息
还担心他/她消息不回，她/他回消息很慢，语气太差？
此功能可以让AI主动给你发消息，让你感受到爱
⚠ 注意
要提前设置好喔
- 可以主动发送各类消息
- 可以主动关心你的情况，给你最好的陪伴
- 也可以在你休息的时候不去打扰你，在你醒来第一时间发送消息给你
注意：如果你没有设置，你的AI女友是不会给你主动发送消息，只能被动回，这样是不对的。
☑️ 主动发送表情包
该功能可以让他/她主动发送表情包，她/他回消息宛若真人一般。
注：在安装目录下emojis文件夹内，可以自行添加表情包
☑️ 记忆体
该功能可以使他/她有记忆功能，她/他可以记住和你的每次聊天
可以有记忆功能，不过记忆不建议太长
⚠ 注意
config.py和记忆体文件chat_contexts.json在根目录下，请自行替换到新版本内☑️ 模仿我的说话风格
让 AI 用你自己的说话方式回消息，而不是照 Prompt 演一个角色。
配置页「用户列表」里勾上那一行的 读聊天记录，再点 读取聊天记录；程序会读该会话在本机的聊天记录，让模型提炼出「我」这一方的说话风格与最近聊的事，存成风格档案。
生效规则
- 启用后该用户不再使用他原来选的 Prompt 文件（改用风格档案），记忆功能照旧。
- 档案存在
HistoryProfiles/<昵称>.md，可以自己在 Prompt 区之外手动改，改完立刻生效。 - 聊了一阵觉得档案旧了，再点一次「读取聊天记录」重新生成即可。
- 生成即启用：档案写成功的同时会把该昵称记入启用名单，不用再手动勾选+保存；机器人正在跑的话，下一条消息起就改用这份档案。要换回 prompt，取消勾选再保存配置即可。
- 读多少条、档案最长多少字，在同一面板里可调（默认 60 条 / 3000 字）。
⚠ 注意
- 只读本地微信数据库，不操作微信界面；但聊天记录内容会进入模型上下文（含发给 API 服务商的部分），介意隐私就别开。
- 昵称要和微信里显示的完全一致，否则找不到会话；找不到会直接提示，不会瞎编。
☑️ 按需读取聊天上下文
没有启用风格档案的用户，也可以让机器人「记得你们之前聊过什么」。
在「用户列表」面板底部打开 按需读取聊天上下文（默认关闭）。
它是怎么省 token 的
- 启动时先给每个监听用户预读一次聊天记录做背景。
- 之后每条消息先让模型判断「这条需不需要更多上下文」，判要的时候才重新读库（拿到的是此刻最新的记录）。
- 判不需要就一次库都不多读；开了风格档案的用户自动跳过，不会叠两份。
- 群聊也读得到：监听列表里填群名即可（以前按群名搜不到会话，群的上下文一直是空的）。读不到时日志会点名说「读不到聊天记录」并附上解析到的会话，不会再静默。
- 每次判断会多一次模型调用（有配辅助模型时用辅助模型），注入的背景也占 token，所以默认关。
☑️ 自定义模型与获取可用模型
Chat / 辅助 / 识图 / 联网四个模型区都加了 获取可用模型 按钮：按你填的 API 地址和 Key 直接问接口有哪些模型，填进下拉框选就行。
注意
- 消息类型的识别已重整：表情、视频号卡片、红包、位置、合并转发都折成一行可读文本，不再把整段 XML 交给模型；卡片里的微信资源地址（
stodownload一类）不会被当成网页链接去抓。 - 有些服务商的
/models接口不提供鉴权后的完整列表，拉不到就直接提示返回内容，此时手填模型名即可（选「其它」）。 - 拉取失败不会影响已保存的配置；拉取列表也不会自动改配置，需要你点保存。
☑️ 防撤回
对方撤回消息后，机器人仍然能看到被撤回的原文。
能做什么
- 在聊天里发
/撤回（或/rc）：当前会话最近 5 条撤回记录，带被撤回的原文。 /撤回 10：临时指定条数（最多 50）。/撤回统计（或/rcs）：本会话一共被撤回多少次、谁最常撤回、最近一次是什么时候。- 撤回提醒（配置页可开，默认关）：发现新的撤回时，机器人主动往那个会话发一条提醒并把原文带上。
- 配置页还能调：启动时回填的历史条数、撤回扫描间隔、每轮重读条数。
⚠ 注意
- 只覆盖「用户列表」里正在监听的会话；开启之前已经被撤回的救不回来（指令里会写明「原文没救回来」）。
- 镜像与媒体备份放在
~/Documents/wechatauto_recall/，媒体备份不会自动清理。 - 「撤回提醒」会真的往会话里发消息，介意就别开。
☑️ 朋友圈查询
聊天里的人可以让机器人念朋友圈，也能知道谁赞了、评论了自己。
能做什么
/朋友圈（或/pyq）：发指令者最近 N 条动态 —— 时间、正文摘要、图/视频/赞/评论数量。/朋友圈 老王：看指定昵称或备注的人最近动态；/朋友圈 10：临时指定条数。/朋友圈互动（或/pyqi）：谁赞了、谁评论了你的朋友圈（配置页可开，默认关）。- 朋友圈监听（配置页可开，默认关）：监听对象发了新动态时，机器人下次跟对方聊天会知道这件事。
⚠ 注意
- 这些都只读本机
sns.db、不打开朋友圈界面；只能读到已经同步到本机的动态。 - 可见范围以本机微信权限为准：三天可见、分组可见、屏蔽都不会被绕过。
- 点赞和评论只给数量、不给文字（微信画在自绘区域里，抓不到文本）。
❓ 常见问题
WeChatBot启动报错
- 尝试
不以管理员身份运行桌面快捷方式《启动机器人》- 你的系统版本过低或精简阉割了
支持的环境- 更换网络环境或者重启之后后再次启动
WeChatBot
Python未安装或启动报错
完全卸载
Python重新安装。- 安装时将
python添加进系统path网吧可能无法安装Python更换网吧或者在家使用。安装
Python重新选择其他盘符安装。- 启动器已不再限制 Python 版本（3.9–3.12 的旧限制已移除），但部分定制依赖包是按 Python 3.9–3.12 提供的，建议仍用这个范围。
⚠️ 免责声明
⚠ 注意
凡本软件提供的所有资源的版权，均归其版权所有人所有。用户若因本软件导致的任何法律争议及后果，均由用户自己负责，本软件不负任何责任。使用此软件即代表用户已知晓以上内容。