一个基于✨HOOK机制的微信机器人，支持🌱安全新闻定时推送【FreeBuf，先知，安全客，奇安信攻防社区】，👯Kfc文案，⚡漏洞查询，⚡手机号归属地查询，⚡知识库查询，🎉星座查询，⚡天气查询，🌱摸鱼日历，⚡微步威胁情报查询， 🐛视频，⚡图片，👯帮助菜单。📫 支持积分功能，⚡支持自动拉人，，🌱自动群发，👯Ai回复，😄自定义程度丰富，小白也可轻松上手！
本Bot是一款基于Hook机制的微信机器人，经过两年的更新迭代，目前功能更加面向大众，此项目会不定期维护，当然如果你有代码能力，也可以自己维护。目前支持功能(请看使用帮助)，最新支持功能：Ai(Gpt，星火，千帆，混元)，关键词拉人进群，自动群发，入群欢迎。如果你有更好的想法，请进群交流。转载此项目请勿标记原创，否则后果自负！！使用此项目人员请勿做违法犯罪行为，否则后果自负！！
注意
作者：云山/eXM
项目版本：NGCBot V2.2
官方公众号：NGC660安全实验室
如果你觉得此项目不错，可以给个Star或给个赞赏 关注一下公众号
.
├── 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 # 依赖包文件注意：此Bot只能在Windowns系统上运行！！！无法在Linux上运行安装
首先请克隆代码到本地，使用命令如下
git clone https://github.com/ngc660sec/NGCBot.git
也可以直接Download
下载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，请选择对应的微信进行下载
wcferry==39.0.12.0：WeChatSetup-3.9.2.23.exewcferry==39.2.4.0：WeChatSetup-3.9.10.27.exewcferry==39.3.3：WeChatSetup-3.9.11.25
安装完毕后，启动main.py文件
python main.py
出现以下界面，说明启动成功
进入微信之后，会自动初始化必备文件
视频已经上传至B站，Github放不了，要看的话大家去B站看即可
https://www.bilibili.com/video/BV1voqwYAEWs/
如果启动成功，下一步配置所需的Key，Ai 对话等功能都需要用到 Key
这些Key按需配置，如不配置则无法使用以下功能
1、MD5查询
2、微步IP查询
3、溯源定位
4、舔狗日记
以下 Key按需配置，如果只使用星火 Ai，那么配置星火Key 即可
这里介绍几个比较难找的
天行 Key（舔狗日记需要使用，如不使用舔狗日记可以不配置）
进到官网，并登录
拿到此 Key，并配置权限
没有开通请前去开通
星火 Key 配置
这里的模型版本采用的是4.0Ultra，如果要使用其它的，请自己修改此参数
进入官网
没有应用请先创建应用
在 我的应用 中，点击你新建的应用，找到Spark4.0 Ultra
填入到配置文件中即可
千帆 Key 配置
进入到 千帆官网 ，后台找到应用接入，点击创建应用
记下你的配置，填入到配置文件中即可，千帆模型没有免费额度，请充值使用！！
Ai 作画(千帆)
点击此 链接
创建应用即可
全选即可
在应用列表中 找到你的应用，记下配置，填入到配置文件中，此功能也需要充值使用
腾讯混元配置
这个要到腾讯控制台开通，点击此处跳转，开通后会自动赠送额度
点击创建密钥
记下你所有的配置，然后填入到配置文件中即可
在运行成功后，你需要设置你的权限为超级管理员，当然你也可以设置多个超级管理员，拿到你的wxid即可。
给机器人发一条消息
拿到此wxid，放到配置文件当中即可
若添加多个超级管理员，请按格式添加！
- 添加管理员
- 删除管理员
- 关键词进群
- 进群欢迎
- 好友消息自动转发给超管
- 自动转发消息
1、添加管理
2、删除管理
3、关键词进群
需要先拿到roomid，再在配置文件中设置即可
可设置多个群聊，当某个群聊人数满了之后自动邀请下一个群聊。给机器人发送进群关键词即可触发
4、关键词回复
在配置文件中设置即可
关键词可设置多个，回复内容只限文本。群聊或好友都可触发
5、加好友后自动回复 添加好友后自动回复一条消息，在配置文件中设置
6、进群欢迎 当有人加入群聊后，自动回复一条消息，在配置文件中设置（群聊需开启推送服务）
卡片类进群欢迎，自定义文字类进群欢迎
卡片类，需要先拿到卡片的各种信息，在终端中会输出
title 字段，不能太长，其中 {} 代表进入群聊的好友名称
自定义文字类进群欢迎，前面加群聊 ID，后面为需要发送的文字 \n为换行
7、自动转发消息
首先你需要添加几个推送群聊，才能使用此功能。添加完推送群聊后，可以愉快使用，如下！
给机器人发送公众号消息
机器人会自动推送消息到推送群聊
注意：管理员功能超级管理员也能用！！管理员以及超级管理员使用积分功能不消耗积分！！
- 开启推送服务
- 开启白名单
- 添加黑名单
- 添加积分、删除积分
- 踢人
这里不对开启或者关闭做任何介绍，使用方法也很简单，在群内发送你在配置文件里面设置的关键词即可，比如：
发送开启推送即可在此群开启推送服务，关键词可以设置多个，代表这两个关键词都可以触发这个功能
踢人功能使用也很简单，需要@罢了
添加积分：需要@用户，可@多个用户，注意空格。使用如下【@群友1加空格[积分]】
其它功能不做介绍。介绍一下黑名单群聊，白名单群聊，普通群聊，推送群聊的功能划分
黑名单群聊：所有功能无法使用
白名单群聊：积分功能无限制
普通群聊：可正常使用积分功能，娱乐功能
推送群聊：定时推送安全新闻，等等其它推送服务，进群欢迎
- 图片
- 视频
- KFC文案
- 舔狗日记
- 早报
- 晚报
- Help功能菜单
演示几个用法，基本都是这样用的，查询类功能注意空格
图片功能
出现此类问题一般是接口不稳定，或者网络不稳定，重新发送即可
视频
舔狗日记
表情包功能
此功能需要你的 WCF 版本在大于等于39.2.4.0 才可以使用，其它版本无法使用
使用前请在终端输入以下命令否则会报错，在使用随机表情时有概率出现报错（不用惯）
meme download
使用效果如下
- 签到（签到获得的积分可在配置文件中设置）
- 赠送积分
- Md5查询
- 微步IP查询
- 积分查询
- Ai 对话
- Ai 画图
一样的，演示几个功能
积分查询
画图功能
注意：与好友对话只触发 Ai 功能和关键词回复功能
推送群聊，支持定时推送摸鱼日历，早报，晚报，入群欢迎，消息转发，下班推送
推送时间可在配置文件中设置
群内使用积分功能不需要积分，其它一样
群内只能使用积分功能
对接的飞书知识库，自己配置即可，如果不需要此功能可以不用配置
配置完毕后即可使用
如果出现接口错误的提示，请重新输入关键词即可
其它配置请查看配置文件，请自行理解，这里不做介绍
有问题！看配置文件！看配置文件！看配置文件！有些人配置文件不配置，在这问为什么用不了？那我问问你你不拿碗不拿筷子怎么吃饭？
其它问题，若是Bug请提供给群主即可，配置文件空着的都要自行配置，这里并不提供
1、启动失败问题
- 在任务管理器中关闭微信，重新打开即可
2、使用的Ai画图关键词，但是触发的是 Ai 对话功能
- 机器配置不太够，导致去除@人的名字时 没有去除成功
3、机器配置多少才够
- 按理说 4h8g 即可，主要是不要调用的太频繁
4、为什么我的表情包功能使用不了?
- 没输入下载命令，或者版本过低
5、为什么我自动通过好友失败
- wcf 版本为 39.2.4.0 时，无法使用自动通过好友功能以及自动接收转账功能
6、为什么我好友 Ai 对话没用
- Ai 对话开关没开，或者 Key 未配置
7、提示注入失败
- 检查wcf版本和微信版本是否一致
关注微信公众号，后台留言（不做回复，请进群交流），或者添加机器人回复 Bot交流群 拉你进群！（机器人不常开，看到会拉群）
前言：在项目更新的过程中发现许许多多的同学不会配置项目，也有许多的同学想要接入自己的API但又没学过 Python 。所以今天（2024,12,04）宣布建立会员交流群，主要解决以下几个问题：
- 不会配置项目，不会启动项目
- 接入API问题，不会接入自己的API
- 想要实现自己的功能，比如（客服）
- 等等... ...
进入付费群聊后会在群内进行指导必要时可提供远程协助，另外会开设特定课程如：Python基础课程，机器人使用教程（视屏），API接入课程（指南），等等(还没想好)
另外还会发布机器人+其它大模型的结合使用教程
价格暂定：（99）
付费时效：终生
联系方式：
如下：
首先此项目启动不需要VPN，另外跟有没有公网IP也没有关系，只需要你电脑配置能登微信，能联网即可
- 【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，新增一些功能，请查看配置文件https://github.com/lich0821/WeChatFerry
感谢查克大佬提供的微信Python库！！！大家可以使用此框架进行开发！
感谢以下团队的大力支持
- NGC660安全实验室
- CKCSec安全研究院
- 渊龙Sec安全团队
如果无法访问 Github 也可以访问 GitCode
