NGCBot
一个基于✨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安全实验室
二、项目结构
│ README.md # Readme文件
│ requirements.txt # 环境依赖包
├─ApiServer # 接口服务文件夹
│ │ ApiMainServer.py # 所有接口主服务模块
│ ├─AiServer # Ai接口服务文件夹
│ │ │ AiDialogue.py # Ai接口调用主服务
│ │ │ sparkPicApi.py # 星火图像生成接口模块
│ ├─pluginServer # 插件接口服务文件夹
│ │ │ HappyApi.py # 娱乐功能接口模块
│ │ │ NewsApi.py # 新闻接口模块
│ │ │ PointApi.py # 积分接口模块
│ │ │ __init__.py # 功能接口初始化模块
├─BotServer # Bot服务文件夹
│ │ MainServer.py # Bot启动主服务模块
│ ├─BotFunction # Bot所有功能文件夹
│ │ │ 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静态资源文件
# 入口文件
三、快速启动
注意：此Bot只能在Windowns系统上运行！！！无法在Linux上运行安装
首先请克隆代码到本地，使用命令如下
git clone [email protected]:ngc660sec/NGCBot.git
也可以直接Download
图片加载中…
下载我提供的微信版本，注意不能更新微信⚠️
图片加载中…
使用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 用什么版本的微信？
WeChatSetup-3.9.2.23.exe
5.3、wcferry==39.2.4.0 用什么版本的微信
WeChatSetup-3.9.10.27.exe
此版本目前(2024.07.15)存在一些问题
- 自动接收转账无法使用
六、一些常见的问题
有问题！看配置文件！看配置文件！看配置文件！有些人配置文件不配置，在这问为什么用不了？那我问问你你不拿碗不拿筷子怎么吃饭？
其它问题，若是Bug请提供给群主即可，配置文件空着的都要自行配置，这里并不提供！
谢谢你读我的文章。
如果觉得不错，随手点个赞、在看、转发三连吧🙂
如果想第一时间收到推送，也可以给我个星标⭐～谢谢你看我的文章。
每次我都想提醒一下，这不是凡尔赛，是希望有想法的人勇敢冲。
我不会代码，我英语也不好，但是我做出来了很多东西，在文末的开源知识库可见。
我真心希望能影响更多的人来尝试新的技巧，迎接新的时代。
Github主页：https://github.com/KimYx0207
我的小破站：https://www.aiking.dev
这里先讲，如果自学能力强，看老金的开源知识库足矣，不要浪费钱来报名。
陪伴群 - 目前的群越来越多，因此开了陪伴群，将会优先进行答疑。群众的小伙伴们也更积极热爱AI，动手能力较强，学习氛围较好。
第一期评价：
第二期课程（已完结） - 3月8日已开启，约1个季度，每周日19-21点直播上课。案例以我的个人主页和小龙虾为主。更重要的是，我将在课中教学“元”的概念，是我创建的一套方法论，可大幅提升复杂问题处理的质量与效率。
第二期評價：
第三期课程 - 6月21日开启，第二期课讲框架，被反馈太难了。。老金痛定思痛，第三期课将围绕着解决问题应该怎么想，怎么做判断为核心，做一套高频场景，结合本地和飞书的资料、数据处理。
开源知识库地址：https://tffyvtlai4.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf
图片加载中…
