NGCBot

<h1 align="center"> NGCBot V2.1 </h1>

Logo2

<h4 align="center"> 一个基于✨HOOK机制的微信机器人，支持🌱安全新闻定时推送【FreeBuf，先知，安全客，奇安信攻防社区】，👯Kfc文案，⚡备案查询，⚡手机号归属地查询，⚡WHOIS信息查询，🎉星座查询，⚡天气查询，🌱摸鱼日历，⚡微步威胁情报查询， 🐛美女视频，⚡美女图片，👯帮助菜单。📫 支持积分功能，⚡支持自动拉人，🌱自动群发，👯Ai回复，⚡Ai画图，😄自定义程度丰富，小白也可轻松上手！ </h4> <div style="text-align: center"> <a href="http://ngc660.cn"> <img src="https://img.shields.io/badge/NGCBot-NGC660%E5%AE%89%E5%85%A8%E5%AE%9E%E9%AA%8C%E5%AE%A4-da282a"> </a> <a href="http://jiuansec.com"> <img src="https://img.shields.io/badge/NGC660%E5%AE%89%E5%85%A8%E5%AE%9E%E9%AA%8C%E5%AE%A4-%E4%B9%85%E5%AE%89%E4%BF%A1%E6%81%AF%E6%8A%80%E6%9C%AF%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8-C925D1"> </a> <img alt="GitHub Star" src="https://img.shields.io/github/stars/ngc660sec/NGCBot?color=pink&style=plastic"> <img alt="GitHub forks" src="https://img.shields.io/github/forks/ngc660sec/NGCBot?color=orange&style=plastic"> <img src="https://img.shields.io/badge/license-GPL--3.0-orange"> <img alt="GitHub release (latest by date including pre-releases)" src="https://img.shields.io/github/v/release/ngc660sec/NGCBot?color=blueviolet&display_name=tag&include_prereleases&label=Release"> </div>

💌一、项目概述

本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 使用哪个版本的微信？

WeChatSetup-3.9.2.23.exe

5.3、wcferry==39.2.4.0 使用哪个版本的微信

WeChatSetup-3.9.10.27.exe

此版本目前(2024.07.15)存在一些问题

自动接收转账无法使用

六、一些常见问题

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

其他问题，如果是Bug请提供给群主即可，配置文件中空着的部分都需要自行配置，这里不提供！

如需定制开发，请进群联系群主！！！！

6.1、Bug提交处

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

公众号：

机器人微信：

113191704454837_.pic

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绘图功能