访问官网
GithubNGCBot V2.1
一个基于✨HOOK机制的微信机器人，支持🌱安全新闻定时推送【FreeBuf，先知，安全客，奇安信攻防社区】，👯Kfc文案，⚡备案查询，⚡手机号归属地查询，⚡WHOIS信息查询，🎉星座查询，⚡天气查询，🌱摸鱼日历，⚡微步威胁情报查询， 🐛美女视频，⚡美女图片，👯帮助菜单。📫 支持积分功能，⚡支持自动拉人，🌱自动群发，👯Ai回复，⚡Ai画图，😄自定义程度丰富，小白也可轻松上手！
💌一、项目概述
本Bot是一款基于Hook机制的微信机器人，经过一年的更新迭代，目前功能更加面向大众，此项目会不定期维护，当然如果你有代码能力，也可以自己维护。目前支持功能(请看使用帮助)，最新支持功能：Ai(Gpt，星火，千帆)，关键词拉人进群，自动群发，入群欢迎。如果你有更好的想法，请进群交流。转载此项目请勿标记原创，否则后果自负！！使用此项目人员请勿做违法犯罪行为，否则后果自负！！
出现微信版本过低不能登陆如何解决？点击此处：https://mp.weixin.qq.com/s/g9AjM3A04sAylP-Q-17fAg
💞特别感谢CKCSec安全研究院的赞助支持以及各大群友的支持， 你们的支持就是我的动力😎
注意⚠️注意⚠️：此项目完全开源，如果你是给钱了才用上本项目的，请注意，你就是那个傻逼
作者：云山/eXM
项目版本：NGCBot V2.1
官方公众号：NGC660安全实验室
如果你觉得此项目不错，可以给个Star或给个赞赏 关注一下公众号
二、项目结构
│ main.py # 入口文件
│ README.md # 说明文件
│ requirements.txt # 依赖包列表
├─ApiServer # API服务目录
│ │ ApiMainServer.py # 所有API主服务模块
│ ├─AiServer # AI API服务目录
│ │ │ AiDialogue.py # AI对话调用主服务
│ │ │ sparkPicApi.py # 星火图像生成API模块
│ ├─pluginServer # 插件API服务目录
│ │ │ HappyApi.py # 娱乐功能API模块
│ │ │ NewsApi.py # 新闻API模块
│ │ │ PointApi.py # 积分API模块
│ │ │ __init__.py # 功能API初始化模块
├─BotServer # 机器人服务目录
│ │ MainServer.py # 机器人启动主服务模块
│ ├─BotFunction # 机器人所有功能目录
│ │ │ AdminFunction.py # 管理员功能模块
│ │ │ AdministratorFunction.py # 超级管理员功能模块
│ │ │ HappyFunction.py # 娱乐功能模块
│ │ │ InterfaceFunction.py # 消息处理接口
│ │ │ JudgeFuncion.py # 关键词判断模块
│ │ │ PointFunction.py # 积分功能模块
│ ├─MsgHandleServer # 消息处理目录
│ │ │ FriendMsgHandle.py # 好友消息处理模块
│ │ │ GhMsgHandle.py # 公众号消息处理模块
│ │ │ RoomMsgHandle.py # 群聊消息处理模块
├─Config # 配置文件服务目录
│ │ Config.yaml # 配置文件
│ │ ConfigServer.py # 配置文件服务模块
│ │ Gh.db # 公众号数据库
│ │ Point.db # 积分数据库
│ │ Room.db # 群聊数据库
│ │ User.db # 用户数据库
├─DbServer # 数据库服务目录
│ │ DbDomServer.py # 数据库操作模块
│ │ DbGhServer.py # 公众号数据库模块(暂未使用)
│ │ DbInitServer.py # 数据库初始化模块
│ │ DbMainServer.py # 数据库主服务模块
│ │ DbPointServer.py # 积分操作模块
│ │ DbRoomServer.py # 群聊数据库操作模块
│ │ DbSignServer.py # 签到服务模块
│ │ DbUserServer.py # 用户数据库操作模块
├─FileCache # 缓存文件服务目录
│ │ FileCacheServer.py # 文件服务模块
│ ├─aiPicCacheFolder # AI生成图片缓存目录
│ ├─FishCacheFolder # 摸鱼日记缓存目录
│ ├─gaodeCacheFolder # 高德地图缓存目录
│ ├─picCacheFolder # 美女图片缓存目录
│ ├─videoCacheFolder # 美女视频缓存目录
├─logs # wcf日志目录
│ wcf.txt # wcf日志
├─NGCBot.assets # README静态资源文件
├─OutPut # 日志输出模块目录
│ │ outPut.py # 日志输出模块
├─PushServer # 定时推送服务目录
│ │ PushMainServer.py # 定时推送服务
└─README.assets # README静态资源文件
三、快速启动
注意：此机器人只能在Windows系统上运行！！！无法在Linux上安装运行
首先请将代码克隆到本地，使用以下命令
git clone git@github.com:ngc660sec/NGCBot.git
也可以直接下载
下载我提供的微信版本，注意不能更新微信⚠️
使用pip安装项目依赖包
pip install -r .\requirements.txt
如果安装速度慢，请自行更换源
安装完成后，启动main.py文件
如果出现此问题，请使用任务管理器关闭微信后重新运行此文件
进入微信后，会自动初始化必要文件
至此，恭喜🎉，项目启动成功！使用帮助请查看使用帮助章节！
四、使用帮助
4.1、第一次使用看这里🤌
运行成功后，你需要将你的权限设置为超级管理员，当然你也可以设置多个超级管理员，只需要获取wxid即可。
给机器人发送一条消息
获取到此wxid后，将其放入配置文件中即可
如需添加多位超级管理员，请按格式添加！
【使用表情包功能请完成上述操作后执行以下命令】
meme download
首次安装时，请等待进度条走完即可使用。如遇报错，请参考下方娱乐功能介绍。
4.2、功能介绍
4.2.1、超级管理员功能
- 添加管理员
- 删除管理员
- 关键词进群（在配置文件中设置）
- 关键词回复（在配置文件中设置）
- 加好友后自动回复（在配置文件中设置）
- 进群欢迎（在配置文件中设置）
- 自动转发公众号消息到推送群聊
- 自动同意好友请求（无需配置）
- 查看白名单群聊
- 查看黑名单群聊
- 查看推送群聊
1、添加管理员
添加管理@你要添加的人
也可以添加多个管理员
2、删除管理员
删除管理@你要删除的人
3、关键词进群
首先需要获取roomid，然后在配置文件中设置即可
在你想邀请人加入的群里发送一条消息
将其添加到配置文件中
可以设置多个群聊，当某个群聊人数满了之后会自动邀请到下一个群聊。向机器人发送进群关键词即可触发。
4、关键词回复
在配置文件中设置即可
可以设置多个关键词，回复内容仅限文本。只有好友可以触发。
5、加好友后自动回复 添加好友后自动回复一条消息，在配置文件中设置
6、进群欢迎 当有人加入群聊后，自动回复一条消息，在配置文件中设置。只在推送群聊中有效。
可以单独设置卡片消息，上面的效果是单独设置的卡片消息
7、自动转发消息
首先你需要添加几个推送群聊才能使用此功能。添加完推送群聊后，即可使用，如下所示！
向机器人发送公众号消息
机器人会自动将消息推送到推送群聊
4.2.2、管理员功能
注意：超级管理员也可以使用管理员功能！！管理员和超级管理员使用积分功能不消耗积分！！
- 开启推送服务
- 开启白名单
- 添加黑名单
- 添加积分、删除积分
- 踢人
- 除超级管理员之外的任何功能
这里不对开启或关闭功能做详细介绍，使用方法很简单，在群内发送你在配置文件中设置的关键词即可，例如：
发送"开启推送"即可在此群开启推送服务，可以设置多个关键词，这两个关键词都可以触发该功能
踢人功能使用也很简单，只需@要踢的人即可，可以@多个人
添加积分：需要@用户，可以@多个用户，注意空格。使用方法如下【@群友1 加空格 [积分]】
不再介绍其他功能。下面介绍一下黑名单群聊、白名单群聊、普通群聊和推送群聊的功能划分。
黑名单群聊：所有功能无法使用
白名单群聊：积分功能无限制
普通群聊：可正常使用积分功能和娱乐功能
推送群聊：定时推送安全新闻等其他推送服务（具体查看配置文件）
4.2.3、娱乐功能
- 美女图片
- 美女视频
- KFC文案
- 舔狗日记
- 早报
- 晚报
- Help功能菜单
- 表情包功能
下面演示几个用法，基本都是这样使用的，查询类功能注意空格⚠️
图片功能
如果发现不显示图片，此类问题一般是接口不稳定或网络不稳定，重新发送即可
视频
舔狗日记
表情包功能，参考示例使用
注意须知：表情包功能【随机表情】有一定几率发送失败，报错属于正常情况。
**只有 **wcferry==39.0.12.0 才可以使用表情包功能，其他版本无法使用
如果表情包过大，则会直接发送图片原图
4.2.4、积分功能（管理员或超级管理员不需要积分）
- 签到（签到获得的积分可在配置文件中设置）
- Md5查询
- 微步IP查询
- 端口查询
- 积分查询
- AI对话
- AI画图
同样，演示几个功能
积分查询
AI对话
AI画图
更多功能请查看配置文件
五、微信版本选择
兼容旧版本微信，即使用NGCBotV2.0 龙年贺岁版的用户，但不要更新软件包
如果3.9.2.23版本的微信无法使用怎么办？
选择更新软件包，或查看提示微信版本过低的解决方法
5.1、如何更新
pip install --upgrade wcferry
5.2、wcferry==39.0.12.0 使用哪个版本的微信？
5.3、wcferry==39.2.4.0 使用哪个版本的微信
此版本目前(2024.07.15)存在一些问题
- 自动接收转账无法使用
六、一些常见问题
有问题！看配置文件！看配置文件！看配置文件！有些人不配置配置文件，在这里问为什么用不了？那我问问你不拿碗不拿筷子怎么吃饭？
其他问题，如果是Bug请提供给群主即可，配置文件中空着的部分都需要自行配置，这里不提供！
如需定制开发，请进群联系群主！！！！
6.1、Bug提交处
关注微信公众号，后台留言，或者添加机器人回复Bot交流群拉你进群！
公众号：
机器人微信：
6.2、开发者交流群
请添加机器人好友并回复"开发者"以加入开发者交流群
七、更新日志
- 【2022.12.8】 发布Bot 1.0版本，为初始版本
- 【2022.12.17】发布Bot 1.2版本，新增部分接口，重写部分代码，新增积分功能
- 【2023.1.1】 发布Bot 1.3版本，重写部分代码，优化代码逻辑，优化积分功能，优化定时推送功能
- 【2023.3.6】 发布Bot 1.4版本，全面优化代码，优化定时推送，优化积分功能，新增消息转发，维护API服务调用
- 【2023.3.29】 发布Bot 1.4.1版本，增加多线程处理消息，重写AI接口。可能会出现消息串群、@错人的问题，等待后续优化更新
- 【2023.3.31】 发布Bot 18岁生日版，修复1.4.1版本的消息乱串问题，支持AI上下文检索，优化消息处理代码，实现功能分区分块处理。由于使用了代理，调用AI对话接口时出现ERROR报错是正常现象，如果能使用国外服务器就不要用国内的
- 【2023.5.4】 发布Bot v18.1生日版，修复AI上下文消息过多无法回复的问题，修复天气查询小BUG
- 【2023.9.10】 发布Bot v1.5版本，优化AI回复、积分功能、代码逻辑，新增MD5解密功能
- 【2024.01.2】 发布Bot V2.0龙年贺岁版，框架重写！逻辑重构！更快！更稳！更多功能！
- 【2024.07.15】发布Bot V2.1版本，框架再次重写，逻辑再次重构，更快！更稳！删减一些不必要功能，新增AI绘图功能
八、鸣谢：
https://github.com/lich0821/WeChatFerry
感谢查克大佬提供的微信Python库！！！大家可以使用此框架进行开发！
九、支持
感谢以下团队的大力支持
- NGC660安全实验室
- CKCSec安全研究院
- 渊龙Sec安全团队
