Skip to content

一个基于✨HOOK机制的微信机器人,支持🌱安全新闻定时推送【FreeBuf,先知,安全客,奇安信攻防社区】,👯Kfc文案,⚡备案查询,⚡手机号归属地查询,⚡WHOIS信息查询,🎉星座查询,⚡天气查询,🌱摸鱼日历,⚡微步威胁情报查询, 🐛美女视频,⚡美女图片,👯帮助菜单。📫 支持积分功能,⚡支持自动拉人,⚡检测广告,🌱自动群发,👯Ai回复,😄自定义程度丰富,小白也可轻松上手!

Notifications You must be signed in to change notification settings

ngc660sec/NGCBot

Repository files navigation

NGCBot V2.2

Logo2

一个基于✨HOOK机制的微信机器人,支持🌱安全新闻定时推送【FreeBuf,先知,安全客,奇安信攻防社区】,👯Kfc文案,⚡漏洞查询,⚡手机号归属地查询,⚡知识库查询,🎉星座查询,⚡天气查询,🌱摸鱼日历,⚡微步威胁情报查询, 🐛视频,⚡图片,👯帮助菜单。📫 支持积分功能,⚡支持自动拉人,,🌱自动群发,👯Ai回复,😄自定义程度丰富,小白也可轻松上手!

💫 一、项目概述

本Bot是一款基于Hook机制的微信机器人,经过两年的更新迭代,目前功能更加面向大众,此项目会不定期维护,当然如果你有代码能力,也可以自己维护。目前支持功能(请看使用帮助),最新支持功能:Ai(Gpt,星火,千帆,混元),关键词拉人进群,自动群发,入群欢迎。如果你有更好的想法,请进群交流。转载此项目请勿标记原创,否则后果自负!!使用此项目人员请勿做违法犯罪行为,否则后果自负!!

注意⚠️注意⚠️:此项目完全开源,如果你是给钱了才用上本项目的,请注意,不要被坑了

作者:云山/eXM

项目版本:NGCBot V2.2

官方公众号:NGC660安全实验室

如果你觉得此项目不错,可以给个Star或给个赞赏 关注一下公众号

Image 1 Image 2

📖 二、项目结构

.
├── ApiServer																	# 接口服务文件夹
│   ├── AiServer															# Ai接口服务文件夹
│   │   ├── AiDialogue.py											# Ai接口主文件
│   │   └── sparkPicApi.py										# 星火 Ai 接口文件
│   ├── ApiMainServer.py											# 接口服务主文件
│   └── pluginServer													# 插件接口文件夹
│       ├── HappyApi.py												# 娱乐插件接口文件
│       ├── NewsApi.py												# 新闻插件接口文件
│       ├── PointApi.py												# 积分插件接口文件
│       ├── __init__.py												# 初始化接口服务文件
├── BotServer																	# 机器人服务文件夹
│   ├── BotFunction														# 机器人功能服务文件夹
│   │   ├── AdminFunction.py									# 管理员功能文件
│   │   ├── AdministratorFunction.py					# 超级管理员功能文件
│   │   ├── HappyFunction.py									# 娱乐功能文件
│   │   ├── InterfaceFunction.py							# 机器人接口功能文件
│   │   ├── JudgeFuncion.py										# 判断逻辑功能文件
│   │   ├── PointFunction.py									# 积分功能文件
│   ├── MainServer.py													# 机器人主服务文件
│   ├── MsgHandleServer												# 机器人消息处理文件夹
│   │   ├── FriendMsgHandle.py								# 好友消息处理文件
│   │   ├── GhMsgHandle.py										# 公众号消息处理文件
│   │   ├── RoomMsgHandle.py									# 群消息处理文件
├── Config																		# 配置文件夹
│   ├── Config.yaml														# 主配置文件
│   ├── ConfigServer.py												# 配置服务文件
│   ├── Feishu.yaml														# 飞书接口配置文件
│   ├── Finger.yaml														# 指纹配置文件(欢迎补充)
├── DbServer																	# 数据库服务文件夹
│   ├── DbDomServer.py												# 数据库操作文件
│   ├── DbGhServer.py													# 公众号数据库文件
│   ├── DbInitServer.py												# 数据库初始文件
│   ├── DbMainServer.py												# 数据库主服务文件
│   ├── DbPointServer.py											# 积分数据库服务文件
│   ├── DbRoomServer.py												# 群聊数据库服务文件
│   ├── DbSignServer.py												# 签到数据库服务文件
│   ├── DbUserServer.py												# 用户数据库服务文件
├── FileCache																	# 缓存文件夹
│   ├── FileCacheServer.py										# 缓存服务文件
├── OutPut																		# 消息输出文件夹
│   └── outPut.py															# 消息输出文件
├── PushServer																# 推送服务文件夹
│   ├── PushMainServer.py											# 主推送服务文件
├── logs																			# WCF日志文件夹
│   └── wcf.1.txt															# WCF日志文件
├── main.py																		# 启动文件
└── requirements.txt													# 依赖包文件

⚡️ 3、快速启动

3.1、Bot 快速启动

注意:此Bot只能在Windowns系统上运行!!!无法在Linux上运行安装

首先请克隆代码到本地,使用命令如下

git clone https://github.com/ngc660sec/NGCBot.git

也可以直接Download

image-20240919091732039

下载Python,使用Python 3.8.10版本 点我下载

使用pip安装项目包(不懂就按顺序运行)

pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple
python -m pip install --upgrade pip
pip install -r requirements.txt

安装完毕后你的 WCF版本应该是 39.2.4.0,请选择对应的微信进行下载

安装完毕后,启动main.py文件

python main.py

出现以下界面,说明启动成功

image-20240919093307952

进入微信之后,会自动初始化必备文件

3.2、配置文件快速配置

如果启动成功,下一步配置所需的KeyAi 对话等功能都需要用到 Key

image-20240919094856316

这些Key按需配置,如不配置则无法使用以下功能

1、MD5查询
2、微步IP查询
3、溯源定位
4、舔狗日记

以下 Key按需配置,如果只使用星火 Ai,那么配置星火Key 即可

image-20240919094938902

3.2.1、各种 Key 配置

这里介绍几个比较难找的

天行 Key(舔狗日记需要使用,如不使用舔狗日记可以不配置)

进到官网,并登录

image-20240919094632915

拿到此 Key,并配置权限

image-20240919094709356

没有开通请前去开通

image-20240919094745641

image-20240919094820523

星火 Key 配置

这里的模型版本采用的是4.0Ultra,如果要使用其它的,请自己修改此参数

进入官网

image-20240919095140758

image-20240919095157747

没有应用请先创建应用

image-20240919095238379

我的应用 中,点击你新建的应用,找到Spark4.0 Ultra

image-20240919095435318

填入到配置文件中即可

千帆 Key 配置

进入到 千帆官网 ,后台找到应用接入,点击创建应用

image-20240919095708879

记下你的配置,填入到配置文件中即可,千帆模型没有免费额度,请充值使用!!

Ai 作画(千帆)

点击此 链接

创建应用即可

image-20240919095908708

全选即可

image-20240919095930300

在应用列表中 找到你的应用,记下配置,填入到配置文件中,此功能也需要充值使用

image-20240919100032259

腾讯混元配置

这个要到腾讯控制台开通,点击此处跳转,开通后会自动赠送额度

image-20240919100543493

点击创建密钥

image-20240919100610338

记下你所有的配置,然后填入到配置文件中即可

🧐 4、使用帮助

4.1、第一次使用看这里

在运行成功后,你需要设置你的权限为超级管理员,当然你也可以设置多个超级管理员,拿到你的wxid即可。

给机器人发一条消息

image-20240102114003272

拿到此wxid,放到配置文件当中即可

image-20240102114040738

若添加多个超级管理员,请按格式添加!

4.2、功能介绍

4.2.1、超级管理员功能(向下支持管理员功能)

  1. 添加管理员
  2. 删除管理员
  3. 关键词进群
  4. 进群欢迎
  5. 好友消息自动转发给超管
  6. 自动转发消息

1、添加管理

image-20240102141225140

2、删除管理

image-20240102141248781

3、关键词进群

需要先拿到roomid,再在配置文件中设置即可

image-20240102141340027

image-20240102141359101

可设置多个群聊,当某个群聊人数满了之后自动邀请下一个群聊。给机器人发送进群关键词即可触发

4、关键词回复

在配置文件中设置即可

image-20240102141454885

关键词可设置多个,回复内容只限文本。群聊或好友都可触发

image-20240102141826989

5、加好友后自动回复 添加好友后自动回复一条消息,在配置文件中设置

image-20240102141926511

6、进群欢迎 当有人加入群聊后,自动回复一条消息,在配置文件中设置(群聊需开启推送服务)

image-20240102142025194

卡片类进群欢迎,自定义文字类进群欢迎

image-20240919101647499

卡片类,需要先拿到卡片的各种信息,在终端中会输出

title 字段,不能太长,其中 {} 代表进入群聊的好友名称


image-20240919101826912

自定义文字类进群欢迎,前面加群聊 ID,后面为需要发送的文字 \n为换行

7、自动转发消息

首先你需要添加几个推送群聊,才能使用此功能。添加完推送群聊后,可以愉快使用,如下!

给机器人发送公众号消息

image-20240102142615234

机器人会自动推送消息到推送群聊

image-20240102142632603

4.2.2、管理员功能

注意:管理员功能超级管理员也能用!!管理员以及超级管理员使用积分功能不消耗积分!!

  1. 开启推送服务
  2. 开启白名单
  3. 添加黑名单
  4. 添加积分、删除积分
  5. 踢人

这里不对开启或者关闭做任何介绍,使用方法也很简单,在群内发送你在配置文件里面设置的关键词即可,比如:

image-20240102142326296

发送开启推送即可在此群开启推送服务,关键词可以设置多个,代表这两个关键词都可以触发这个功能

image-20240102142405384

踢人功能使用也很简单,需要@罢了

image-20240102142435128

添加积分:需要@用户,可@多个用户,注意空格。使用如下【@群友1加空格[积分]】

image-20240102143144061

其它功能不做介绍。介绍一下黑名单群聊,白名单群聊,普通群聊,推送群聊的功能划分

黑名单群聊:所有功能无法使用

白名单群聊:积分功能无限制

普通群聊:可正常使用积分功能,娱乐功能

推送群聊:定时推送安全新闻,等等其它推送服务,进群欢迎

4.2.3、娱乐功能

  1. 图片
  2. 视频
  3. KFC文案
  4. 舔狗日记
  5. 早报
  6. 晚报
  7. Help功能菜单

演示几个用法,基本都是这样用的,查询类功能注意空格⚠️

图片功能

image-20240102143451823

出现此类问题一般是接口不稳定,或者网络不稳定,重新发送即可

image-20240102143552170

视频

image-20240102143657189

舔狗日记

image-20240919102350300

表情包功能

此功能需要你的 WCF 版本在 39.2.4.0 才可以使用,其它版本无法使用

使用前请在终端输入以下命令

meme download

使用效果如下

image-20240919102545023

image-20240919102630363

image-20240919102650476

image-20240919102709479

4.2.4、积分功能(管理或超管不需要积分)

  1. 签到(签到获得的积分可在配置文件中设置)
  2. 赠送积分
  3. Md5查询
  4. 微步IP查询
  5. 积分查询
  6. Ai 对话
  7. Ai 画图

一样的,演示几个功能

image-20240102143903435

积分查询

image-20240102143921467

画图功能

image-20240919103102289

注意:与好友对话只触发 Ai 功能和关键词回复功能

4.2.5、推送群聊功能

推送群聊,支持定时推送摸鱼日历,早报,晚报,入群欢迎,消息转发,下班推送

推送时间可在配置文件中设置

image-20240919105126694

4.2.6、白名单群聊功能

群内使用积分功能不需要积分,其它一样

4.2.7、黑名单群聊功能

群内只能使用积分功能

4.2.8、漏洞查询功能

对接的飞书知识库,自己配置即可,如果不需要此功能可以不用配置

image-20240919110218001

配置完毕后即可使用

image-20240919110254482

如果出现接口错误的提示,请重新输入关键词即可

4.3、其它配置

其它配置请查看配置文件,请自行理解,这里不做介绍

image-20240919105653096

❓ 5、一些常见的问题

有问题!看配置文件!看配置文件!看配置文件!有些人配置文件不配置,在这问为什么用不了?那我问问你你不拿碗不拿筷子怎么吃饭?

其它问题,若是Bug请提供给群主即可,配置文件空着的都要自行配置,这里并不提供

1、启动失败问题

- 在任务管理器中关闭微信,重新打开即可
2、使用的Ai画图关键词,但是触发的是 Ai 对话功能

- 机器配置不太够,导致去除@人的名字时 没有去除成功
3、机器配置多少才够

- 按理说 4h8g 即可,主要是不要调用的太频繁
4、为什么我的表情包功能使用不了?

- 没输入下载命令,或者版本过低
- 有的表情是会报错的,属于正常现象
5、为什么我自动通过好友失败

- wcf 版本为 39.2.4.0 时,无法使用自动通过好友功能以及自动接收转账功能
6、为什么我好友 Ai 对话没用

- Ai 对话开关没开,或者 Key 未配置
其它问题待补充~~~~

5.1、Bug提交处

关注微信公众号,后台留言,或者添加机器人回复 Bot交流群 拉你进群!

添加机器人回复 开发者 进入开发者交流群

公众号:

关注

机器人微信:

113191704454837_.pic

📝 6、更新日志

- 【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.1.2】  推送Bot V2.0龙年贺岁版,框架重写!逻辑重构!更快!更稳!更多功能!
- 【2024.07.15】推送Bot V2.1版本 框架再次重写,逻辑再次重构,更快!更稳!删减一些不必要功能,新增Ai画图功能
- 【2024 09.10】推送Bot V2.2版本 新增飞书WIki查询,需要手动对接飞书知识库,修复一些存在的Bug,新增一些功能,请查看配置文件

🙏🏻 7、鸣谢:

https://github.com/lich0821/WeChatFerry

感谢查克大佬提供的微信Python库!!!大家可以使用此框架进行开发!

😘 8、支持

感谢以下团队的大力支持

  • NGC660安全实验室
  • CKCSec安全研究院
  • 渊龙Sec安全团队

👈 9、感谢国产社区GitCode

假装更新

About

一个基于✨HOOK机制的微信机器人,支持🌱安全新闻定时推送【FreeBuf,先知,安全客,奇安信攻防社区】,👯Kfc文案,⚡备案查询,⚡手机号归属地查询,⚡WHOIS信息查询,🎉星座查询,⚡天气查询,🌱摸鱼日历,⚡微步威胁情报查询, 🐛美女视频,⚡美女图片,👯帮助菜单。📫 支持积分功能,⚡支持自动拉人,⚡检测广告,🌱自动群发,👯Ai回复,😄自定义程度丰富,小白也可轻松上手!

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages