Profile
Back to NewsBack
GitHub Trending 1 min
Reader Mode
Prometheus-first/helper: 一个微信机器人框架,目前稳定可用

Prometheus-first/helper: 一个微信机器人框架,目前稳定可用

helper

Windows 微信机器人 Python 插件框架,提供本地网页管理台和控制台入口。

交流

交流群二维码 image

致谢

感谢群友Ls对本项目的贡献与支持

在线文档 · 快速开始 · 插件开发

使用许可:允许个人自用,禁止商业使用。 允许个人学习研究及非商业修改、免费分享,分享时须保留协议和版权声明。完整条款见 LICENSE,第三方组件继续适用各自的许可证。

功能

  • 多账号管理:发现已登录微信,按账号启停,独立保存插件配置与数据。
  • 微信版本保护:启动前检查已启用的保护,封锁更新器和下载缓存原路径、清除升级包,支持恢复;详见微信更新保护。
  • 联系人:扫描后按账号保存,重启自动读取;搜索及按标签筛选,查看昵称、备注、微信号、地区和签名。
  • 朋友圈:发布文字和图片;微信 4.2.0.12 实时读取服务端首页、点赞人和评论,支持手动评论及按指定作者自动发送固定评论,跨重启去重。旧版微信的读取与互动范围见朋友圈说明。
  • 公众号文章:自动获取当前账号的关注公众号,点击公众号自动分页同步它的文章,点击文章自动加载正文和图片,按账号保存并导出 Markdown;目前支持已核对的微信 4.2.0.12
  • 消息收发:文本自动分段,图片、文件、表情包、语音条和视频,支持真实群艾特与群成员身份查询;接收图片时优先下载可用原图,微信 4.2.0.12 支持视频 CDN 下载,普通文件按块处理。
  • 原生引用回复:Windows 微信 4.2.0.12 支持插件在原会话引用普通文字。见文本与引用回复。
  • 消息监控:显示时间、会话 ID、发送者及正文,展开合并转发记录,保留撤回标记。
  • 聊天归档和 CSV 导出:按账号开启本地 SQLite 归档,按会话和日期导出,重连重投按原始消息 ID 去重。
  • 定时任务:按间隔或每天指定时间执行文字发送和插件提供的动作,支持多账号独立管理。
  • 群聊管理:按账号保存已发现群及备注,支持进退群通知、成员昵称绑定、聊天总结、人格切换、成语游戏和图库取图。
  • 模型与语音:支持 OpenAI 兼容的 Chat Completions API、图片生成与随机抽卡插件、Fish Audio 合成和按群切换音色。
  • 插件管理:防撤回插件默认折叠,展开后可分别操作;支持在网页修改业务函数与配置、保存生效及恢复默认。
  • 指令分发:斜杠指令按插件注册顺序处理,首个接手的插件可停止向后分发。详见指令优先级。
  • 小程序:微信 4.2.0.12 原生唤起、组件读取、引擎内点击、文字输入和截图,见通用开发接口。
自用版另有原生红包自动领取功能,不包含在此公开仓库;需要可联系交流群群主。

防撤回可选择默认关闭的“本机防撤回”,在当前账号的电脑微信保留原消息,并立即显示微信灰色撤回提示;也可使用默认开启的文本(含表情包)、图片、文件、语音补发插件。两种方式独立开关,可同时使用。详见防撤回。好友自动通过默认关闭。完整指令见群聊功能和控制台命令。

快速开始

运行条件:Windows 10/11 x64、64 位 Python(已验证 3.13)、Microsoft Visual C++ x64 运行库。

当前适配微信 4.2.0.12 的指定构建。

4.2.0.12 已实测账号与二维码识别、文本及群艾特、图片、文件和语音收发、撤回补发、好友申请接收、通过及从共同群主动发起、进退群事件、朋友圈读取与仅自己可见的发布,以及公众号目录、分页和正文读取。MP4 视频发送已在文件传输助手和群聊验证,好友私聊尚未单独实测;公众号图片显示尚未单独实测。

微信 4.2.0.12 的联系人资料、备注与标签读取已验证。联系人和已发现群按账号保存,重启后自动恢复,见扫描联系人。

各版本的详细范围见 native/README.md。

python -m pip install -r requirements.txt

登录电脑微信后,双击 start_web.bat,打开 http://127.0.0.1:8765,点击账号行的“启动”;也可以勾选多个账号批量启动。首次使用无需手填 wxid。顶部账号选择用于切换正在编辑的配置。

需要控制台操作时运行:

python main.py --check
python main.py

缺失的本地配置会自动补齐,已有配置保留。--check 检查配置与插件语法,不连接微信或调用模型。发送 WAV 语音和使用语音合成时,还需安装 requirements-voice.txt。

正常退出:网页先停止机器人,再在管理台窗口按 Ctrl+C;控制台入口输入 quit。关闭浏览器不会停止机器人。同一微信进程只能由一个项目副本连接。

配置与数据

| 文件 | 用途 | | --- | --- | | bot_config.json | 后端、会话范围、插件开关与选项 | | members_config.json | 各群成员称呼与功能范围 | | llm_config.json | 模型地址、密钥及模型名称 | | tts_config.json | Fish Audio 密钥及语音选项 | | .runtime/image_generation.json | 可选图片生成插件的渠道、密钥和模型 |

网页可编辑主要配置。图片生成与抽卡插件使用本地私有配置,设置方法见AI 生图和随机抽卡。多账号工作区位于 .runtime/robots/;聊天记录、媒体缓存和日志均为本地数据,已被 Git 忽略,请勿提交。具体字段见配置参考。

文档

| 需要做什么 | 文档 | | --- | --- | | 安装、选择账号、添加群 | 快速开始 · 账号与群聊 | | 启停账号、监控消息、修改插件 | 网页管理台 | | 扫描好友、查看资料和标签 | 扫描联系人 | | 删除单个好友并保留聊天记录(仅微信 4.2.0.12) | 调用方式与实测结果 | | 关注公众号、自动同步文章和站内阅读 | 公众号文章 | | 图片、文件、视频、表情和语音 | 图片 · 文件 · 视频 · 表情 · 语音 | | 视频通话画面替换 | 本地视频与程序帧(Windows 4.2.0.11 / 4.2.0.12,实验功能) | | 合并转发与防撤回 | 合并转发 · 防撤回 | | 好友申请、群成员与群管理 | 好友申请与群管理 | | 开发小程序业务 | 小程序通用接口 | | 开发和维护 | 插件开发 · 代码结构与验证 |

目录

main.py / web.py      控制台 / 网页入口
wxbot_framework/      连接生命周期、消息、插件、模型和管理台
plugins/              独立功能与业务函数
native/               原生桥接、版本指纹与必要 DLL
webui/                管理台静态页面
docs/                 使用与开发文档
tests/                离线回归测试
tools/                配置初始化、测试与发布检查

linux.do 项目讨论

Chat with me