综合介绍
NGCBot 是一个基于 HOOK 机制开发的微信机器人开源项目,由开发者 ngc660sec(云山/eXM)创建并托管于 GitHub。经过两年迭代,目前版本为 V2.3,功能从最初的简单推送扩展到涵盖安全新闻定时推送、AI 智能对话、群聊自动化管理以及丰富的娱乐工具。该项目专为 Windows 系统设计,完全免费开源,用户可通过 Python 轻松部署并自定义配置。NGCBot 不仅适合关注网络安全资讯的用户,还能满足群聊管理、日常娱乐和技术开发的多样化需求,小白用户也能快速上手,技术爱好者则可深入定制,实用性与灵活性兼具。
功能列表
- 安全新闻推送:定时从 FreeBuf、先知、安全客、奇安信攻防社区抓取并推送最新资讯。
- AI 对话与作画:对接 GPT、星火、千帆、混元、DeepSeek 等模型,支持智能回复和图像生成。
- 群聊管理:提供关键词拉人进群、入群欢迎、自动群发消息等自动化功能。
- 娱乐工具:包括 KFC 文案、舔狗日记、摸鱼日历、随机图片/视频、表情包生成等。
- 实用查询:支持漏洞查询、手机号归属地、天气预报、星座运势、微步威胁情报等。
- 积分系统:用户签到或互动积累积分,解锁高级功能如 AI 服务。
- 视频号解析:解析并下载微信视频号内容,提供便捷链接。
- 高度自定义:支持调整推送时间、关键词触发、功能开关等,代码开放可二次开发。
使用帮助
安装流程
NGCBot 需在 Windows 系统上运行,以下是详细部署步骤:
1. 准备环境
- 安装 Git:从 git-scm.com 下载,用于获取代码。
- 安装 Python:推荐版本 3.8.10(范围 3.8.10-3.12),从 python.org 下载并添加至 PATH。
- 下载微信客户端:推荐 WeChatSetup-3.9.10.27(对应 wcferry==39.2.4.0),从 GitHub Releases 获取。
2. 获取项目代码
- 在命令行输入以下命令克隆代码:
git clone https://github.com/ngc660sec/NGCBot.git
- 或从 GitHub 页面点击“Download ZIP”下载并解压。
3. 安装依赖
- 进入项目目录:
cd NGCBot
- 使用国内镜像加速安装依赖:
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 版本与微信版本匹配(如 wcferry==39.2.4.0 对应 WeChatSetup-3.9.10.27)。
4. 启动机器人
- 关闭微信客户端,运行启动命令:
python main.py
- 程序自动打开微信,使用手机扫码登录,命令行显示“初始化必备文件完成”即成功。
5. 配置功能
- 打开
Config/config.yaml
文件,进行必要配置: - 超级管理员:给机器人发送消息获取 wxid,填入
SuperAdmin
(支持多个,用逗号分隔)。 - AI 密钥:
- 星火:访问 官网 创建应用,填入 APPID、APISecret、APIKey。
- 千帆:从 百度千帆 获取 Access Key 和 Secret Key。
- 其他模型(如混元、DeepSeek)类似,参考官方指引。
- 推送设置:在
PushTime
设置新闻推送时间(如 "08:00")。 - 群聊管理:配置
RoomKey
(关键词拉群)、WelcomeMsg
(入群欢迎)等。
操作主要功能
安全新闻推送
- 在
config.yaml
中设置推送时间(如 "08:00")和来源。 - 将机器人加入群聊,发送“开启推送”激活。
- 机器人每日定时推送,如“【FreeBuf】最新漏洞预警:XXX”。
AI 对话与作画
- 对话:
- 配置 AI 密钥并开启
AiSwitch
。 - 发送消息(如“北京天气”),机器人回复“北京晴,5-15°C”。
- 作画:
- 配置千帆画图密钥。
- 发送“画一只猫”,机器人生成并返回图片。
- 若失败,检查积分是否足够(普通用户需消耗积分)。
群聊管理
- 关键词拉群:
- 发送“获取群聊id”获取 roomid。
- 在
RoomKey
设置关键词(如“进群”)和 roomid。 - 用户发送“进群”,自动被拉入指定群。
- 入群欢迎:
- 在
WelcomeMsg
设置文本(如“欢迎加入,请勿刷屏”)。 - 支持卡片形式,需填入 title、url 等参数。
- 自动群发:
- 在
AutoMsg
设置内容(如“每日安全提醒”)和时间。 - 机器人按时发送至指定群聊。
娱乐功能
- 摸鱼日历:发送“摸鱼日历”,返回当月摸鱼日历图片。
- KFC 文案:发送“KFC”,返回随机搞笑文案(如“周四了,吃块鸡翅冷静一下”)。
- 表情包:
- 运行
meme download
下载资源。 - 发送“随机表情”,获取动态表情(需 WCF≥39.2.4.0)。
- 视频号解析:发送视频号链接,机器人返回下载地址。
积分系统
- 签到:发送“签到”,每日获积分(默认 10 分,可调整)。
- 查询:发送“积分查询”,查看剩余积分。
- 使用:AI 对话/作画等需消耗积分,管理员免消耗。
查询工具
- 天气:发送“北京天气”,返回当天预报。
- 漏洞查询:发送“CVE-2023-1234”,返回漏洞详情。
- 威胁情报:发送 IP 地址,查询微步情报。
注意事项
- 版本兼容:微信和 WCF 版本需一致,否则启动失败。
- 硬件要求:建议 4 核 8GB 内存,避免高频调用卡顿。
- 问题排查:
- 启动失败:检查
logs/wcf.txt
日志,关闭微信重试。 - 功能失效:确认配置文件是否填写完整(如 AI 密钥)。
- 视频教程:官方提供 B 站教程,涵盖安装与开发。
NGCBot 的部署和使用简单直观,配置文件调整后即可实现个性化功能。无论是推送新闻、管理群聊还是娱乐互动,用户都能快速上手,技术爱好者还可通过开源代码深入开发。