base on 一个基于✨HOOK机制的微信机器人，支持🌱安全新闻定时推送【FreeBuf，先知，安全客，奇安信攻防社区】，👯Kfc文案，⚡备案查询，⚡手机号归属地查询，⚡WHOIS信息查询，🎉星座查询，⚡天气查询，🌱摸鱼日历，⚡微步威胁情报查询， 🐛美女视频，⚡美女图片，👯帮助菜单。📫 支持积分功能，⚡支持自动拉人，⚡检测广告，🌱自动群发，👯Ai回复，😄自定义程度丰富，小白也可轻松上手！ <h3 align="center"> NGCBot V2.2 </h3>  <h5 align="center"> 一个基于✨HOOK机制的微信机器人，支持🌱安全新闻定时推送【FreeBuf，先知，安全客，奇安信攻防社区】，👯Kfc文案，⚡漏洞查询，⚡手机号归属地查询，⚡知识库查询，🎉星座查询，⚡天气查询，🌱摸鱼日历，⚡微步威胁情报查询， 🐛视频，⚡图片，👯帮助菜单。📫 支持积分功能，⚡支持自动拉人，，🌱自动群发，👯Ai回复，😄自定义程度丰富，小白也可轻松上手！ </h5> <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，星火，千帆，混元)，关键词拉人进群，自动群发，入群欢迎。如果你有更好的想法，请进群交流。转载此项目请勿标记原创，否则后果自负！！使用此项目人员请勿做违法犯罪行为，否则后果自负！！** **注意⚠️注意⚠️：此项目完全开源，如果你是给钱了才用上本项目的，请注意，不要被坑了** **作者：云山/eXM** **项目版本：NGCBot V2.2** **官方公众号：NGC660安全实验室** **如果你觉得此项目不错，可以给个Star或给个赞赏 关注一下公众号** <div style="display: flex;"> <img src="./README.assets/赞赏码.jpg" alt="Image 1" style="width: 400px; height: auto; margin: 5px;"> <img src="./README.assets/公众号.jpg" alt="Image 2" style="width: 400px; height: auto; margin: 5px;"> </div> ## 📖 二、项目结构 ```css . ├── 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 git clone https://github.com/ngc660sec/NGCBot.git ``` 也可以直接Download  下载`Python`，使用`Python 3.8.10`版本 [点我下载](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe) 使用`pip`安装项目包（不懂就按顺序运行） ```bash 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.exe](https://github.com/ngc660sec/NGCBot/releases/download/V2.0-龙年贺岁版/WeChatSetup-3.9.2.23.exe) - `wcferry==39.2.4.0`：[WeChatSetup-3.9.10.27.exe](https://github.com/lich0821/WeChatFerry/releases/download/v39.2.4/WeChatSetup-3.9.10.27.exe) - `wcferry==39.3.3`：[WeChatSetup-3.9.11.25](https://github.com/lich0821/WeChatFerry/releases/download/v39.3.3/WeChatSetup-3.9.11.25.exe) 安装完毕后，启动`main.py`文件 ``` python main.py ``` 出现以下界面，说明启动成功  进入微信之后，会自动初始化必备文件 ## 3.2、视频教程 视频已经上传至B站，Github放不了，要看的话大家去B站看即可 https://www.bilibili.com/video/BV1voqwYAEWs/ ### 3.3、配置文件快速配置 如果启动成功，下一步配置所需的`Key`，**Ai 对话**等功能都需要用到 `Key`  这些`Key`按需配置，如不配置则无法使用以下功能 ``` 1、MD5查询 2、微步IP查询 3、溯源定位 4、舔狗日记 ``` 以下 `Key`按需配置，如果只使用星火 Ai，那么配置星火Key 即可  #### 3.3.1、各种 Key 配置 这里介绍几个比较难找的 **天行 Key（舔狗日记需要使用，如不使用舔狗日记可以不配置）** 进到[官网](https://www.tianapi.com/)，并登录  拿到此 Key，并配置权限  没有开通请前去开通   **星火 Key 配置** 这里的模型版本采用的是`4.0Ultra`，如果要使用其它的，请自己修改此参数 进入[官网](https://xinghuo.xfyun.cn/)   没有应用请先创建应用  在 [我的应用](https://console.xfyun.cn/app/myapp) 中，点击你新建的应用，找到`Spark4.0 Ultra`  填入到配置文件中即可 **千帆 Key 配置** 进入到 [千帆官网](https://qianfan.cloud.baidu.com/) ，后台找到应用接入，点击创建应用  记下你的配置，填入到配置文件中即可，千帆模型没有免费额度，请充值使用！！ **Ai 作画(千帆)** 点击此 [链接](https://console.bce.baidu.com/ai/#/ai/intelligentwriting/app/detail~appId=5507940) 创建应用即可  全选即可  在应用列表中 找到你的应用，记下配置，填入到配置文件中，此功能也需要充值使用  **腾讯混元配置** 这个要到腾讯控制台开通，点击[此处](https://console.cloud.tencent.com/hunyuan/start)跳转，开通后会自动赠送额度  点击创建密钥  记下你所有的配置，然后填入到配置文件中即可 ## 🧐 4、使用帮助 ### 4.1、第一次使用看这里 在运行成功后，你需要设置你的权限为超级管理员，当然你也可以设置多个超级管理员，拿到你的`wxid`即可。 给机器人发一条消息  拿到此`wxid`，放到配置文件当中即可  若添加多个超级管理员，请按格式添加！ ### 4.2、功能介绍 #### 4.2.1、超级管理员功能（向下支持管理员功能） 1. 添加管理员 2. 删除管理员 3. 关键词进群 4. 进群欢迎 5. 好友消息自动转发给超管 6. 自动转发消息 **1、添加管理**  **2、删除管理**  **3、关键词进群** 需要先拿到`roomid`，再在配置文件中设置即可   可设置多个群聊，当某个群聊人数满了之后自动邀请下一个群聊。给机器人发送进群关键词即可触发 **4、关键词回复** 在配置文件中设置即可  关键词可设置多个，回复内容只限文本。群聊或好友都可触发  **5、加好友后自动回复** 添加好友后自动回复一条消息，在配置文件中设置  **6、进群欢迎** 当有人加入群聊后，自动回复一条消息，在配置文件中设置（群聊需开启推送服务）  **卡片类进群欢迎，自定义文字类进群欢迎**  卡片类，需要先拿到卡片的各种信息，在终端中会输出 `title `字段，不能太长，其中 `{}` 代表进入群聊的好友名称 ---  自定义文字类进群欢迎，前面加群聊 ID，后面为需要发送的文字 `\n`为换行 **7、自动转发消息** 首先你需要添加几个推送群聊，才能使用此功能。添加完推送群聊后，可以愉快使用，如下！ 给机器人发送公众号消息  机器人会自动推送消息到推送群聊  #### 4.2.2、管理员功能 **注意：管理员功能超级管理员也能用！！管理员以及超级管理员使用积分功能不消耗积分！！** 1. 开启推送服务 2. 开启白名单 3. 添加黑名单 4. 添加积分、删除积分 5. 踢人 这里不对开启或者关闭做任何介绍，使用方法也很简单，在群内发送你在配置文件里面设置的关键词即可，比如：  发送开启推送即可在此群开启推送服务，关键词可以设置多个，代表这两个关键词都可以触发这个功能  踢人功能使用也很简单，需要@罢了  **添加积分：需要@用户，可@多个用户，注意空格。使用如下【@群友1加空格[积分]】**  其它功能不做介绍。介绍一下黑名单群聊，白名单群聊，普通群聊，推送群聊的功能划分 **黑名单群聊：所有功能无法使用** **白名单群聊：积分功能无限制** **普通群聊：可正常使用积分功能，娱乐功能** **推送群聊：定时推送安全新闻，等等其它推送服务，进群欢迎** #### 4.2.3、娱乐功能 1. 图片 2. 视频 7. KFC文案 10. 舔狗日记 13. 早报 14. 晚报 15. Help功能菜单 演示几个用法，基本都是这样用的，查询类功能注意空格⚠️ **图片功能**  出现此类问题一般是接口不稳定，或者网络不稳定，重新发送即可  **视频**  **舔狗日记**  **表情包功能** 此功能需要你的 `WCF` 版本在大于等于`39.2.4.0` 才可以使用，其它版本无法使用 使用前请在终端输入以下命令否则会报错，在使用随机表情时有概率出现报错（不用惯） ``` meme download ``` 使用效果如下     #### 4.2.4、积分功能（管理或超管不需要积分） 1. 签到（签到获得的积分可在配置文件中设置） 2. 赠送积分 3. Md5查询 4. 微步IP查询 5. 积分查询 6. Ai 对话 7. Ai 画图 一样的，演示几个功能  **积分查询**  **画图功能**  **注意：与好友对话只触发 Ai 功能和关键词回复功能** #### 4.2.5、推送群聊功能 推送群聊，支持定时推送摸鱼日历，早报，晚报，入群欢迎，消息转发，下班推送 推送时间可在配置文件中设置  #### 4.2.6、白名单群聊功能 群内使用积分功能不需要积分，其它一样 #### 4.2.7、黑名单群聊功能 群内只能使用积分功能 #### 4.2.8、漏洞查询功能 对接的飞书知识库，自己配置即可，如果不需要此功能可以不用配置  配置完毕后即可使用  如果出现接口错误的提示，请重新输入关键词即可 ### 4.3、其它配置 其它配置请查看配置文件，请自行理解，这里不做介绍  ## ❓ 5、一些常见的问题 **有问题！看配置文件！看配置文件！看配置文件！有些人配置文件不配置，在这问为什么用不了？那我问问你你不拿碗不拿筷子怎么吃饭？** 其它问题，若是Bug请提供给群主即可，配置文件空着的都要自行配置，这里并不提供 ``` 1、启动失败问题 - 在任务管理器中关闭微信，重新打开即可 ``` ``` 2、使用的Ai画图关键词，但是触发的是 Ai 对话功能 - 机器配置不太够，导致去除@人的名字时 没有去除成功 ``` ``` 3、机器配置多少才够 - 按理说 4h8g 即可，主要是不要调用的太频繁 ``` ``` 4、为什么我的表情包功能使用不了? - 没输入下载命令，或者版本过低 ``` ``` 5、为什么我自动通过好友失败 - wcf 版本为 39.2.4.0 时，无法使用自动通过好友功能以及自动接收转账功能 ``` ``` 6、为什么我好友 Ai 对话没用 - Ai 对话开关没开，或者 Key 未配置 ``` ``` 7、提示注入失败 - 检查wcf版本和微信版本是否一致 ``` ### ❌ 5.1、Bug提交处 关注微信公众号，后台留言（不做回复，请进群交流），或者添加机器人回复 `Bot交流群` 拉你进群！（机器人不常开，看到会拉群） <div style="display: flex;"> <img src="./README.assets/%E5%85%B3%E6%B3%A8-4177997.gif" alt="Image 1" style="width: 800px; height: auto; margin: 5px;"> <img src="./README.assets/113191704454837_.pic.jpg" alt="Image 1" style="width: 400px; height: auto; margin: 5px;"> </div> ### 💰 5.2、会员群聊处 **前言**：在项目更新的过程中发现许许多多的同学不会配置项目，也有许多的同学想要接入自己的API但又没学过 `Python` 。所以今天（2024,12,04）宣布建立会员交流群，主要解决以下几个问题： 1. 不会配置项目，不会启动项目 2. 接入API问题，不会接入自己的API 3. 想要实现自己的功能，比如（客服） 4. 等等... ... 进入付费群聊后会在群内进行指导必要时可提供远程协助，另外会开设特定课程如：Python基础课程，机器人使用教程（视屏），API接入课程（指南），等等(还没想好) 另外还会发布机器人+其它大模型的结合使用教程 价格暂定：（**99**） 付费时效：**终生** 联系方式： <div style="display: flex;"> <img src="./README.assets/img_v3_02h8_a1c2e430-6fe2-4af9-a0fc-22a0af86c41g.jpg" alt="Image 1" style="width: 400px; height: auto; margin: 5px;"> </div> ### ❗️ 5.3、谨防诈骗 如下： 首先此项目启动不需要VPN，另外跟有没有公网IP也没有关系，只需要你电脑配置能登微信，能联网即可 <div style="display: flex;"> <img src="./README.assets/img_v3_02h8_7ea23767-38c1-41e9-8b06-3a0743a5559g.jpg" alt="Image 1" style="width: 400px; height: auto; margin: 5px;"> <img src="./README.assets/img_v3_02h8_1f93bcd8-0880-40b0-aeef-c21c77e7910g.jpg" alt="Image 1" style="width: 400px; height: auto; margin: 5px;"> </div> ## 📝 6、更新日志 ```css - 【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 如果无法访问 `Github` 也可以访问 `GitCode` <div style="display: flex;"> <img src="./README.assets/img_v3_02h8_bae897a8-e165-4051-9a52-f0187c5c236g.png" alt="Image 1" style="width: 100%; height: auto; margin: 5px;" onclick="https://gitcode.com/ngc660sec/NGCBot"> </div> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ngc660sec/NGCBot&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ngc660sec/NGCBot&type=Date" /> <img style="width:100%" src="https://api.star-history.com/svg?repos=ngc660sec/NGCBot&type=Date" /> </picture> ", Assign "at most 3 tags" to the expected json: {"id":"10227","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"