https://github.com/henryxiaoyang/xybotv2
🤖 功能丰富的微信机器人框架 | AI对话、对接Dify、积分系统、游戏互动、每日新闻、天气查询 | 非Hook非Web实现 | 支持 Windows✅ Linux✅ MacOS✅ | 全新架构解决XYBot第一代痛点！
https://github.com/henryxiaoyang/xybotv2
ai bot chatbot chatgpt deepseek dify python wechat wechat-bot wechat-bot-skeleton wechat-sdk wei-xin weixin xybot
Last synced: 22 days ago
JSON representation
🤖 功能丰富的微信机器人框架 | AI对话、对接Dify、积分系统、游戏互动、每日新闻、天气查询 | 非Hook非Web实现 | 支持 Windows✅ Linux✅ MacOS✅ | 全新架构解决XYBot第一代痛点！
- Host: GitHub
- URL: https://github.com/henryxiaoyang/xybotv2
- Owner: HenryXiaoYang
- License: gpl-3.0
- Created: 2025-01-13T15:21:14.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-03-26T23:25:05.000Z (about 1 month ago)
- Last Synced: 2025-04-11T23:19:15.132Z (22 days ago)
- Topics: ai, bot, chatbot, chatgpt, deepseek, dify, python, wechat, wechat-bot, wechat-bot-skeleton, wechat-sdk, wei-xin, weixin, xybot
- Language: Python
- Homepage: https://henryxiaoyang.github.io/XYBotV2/
- Size: 77.7 MB
- Stars: 433
- Watchers: 6
- Forks: 102
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🤖 XYBot V2
XYBot V2 是一个功能丰富的微信机器人框架,支持多种互动功能和游戏玩法。
# 免责声明
- 这个项目免费开源，不存在收费。
- 本工具仅供学习和技术研究使用，不得用于任何商业或非法行为。
- 本工具的作者不对本工具的安全性、完整性、可靠性、有效性、正确性或适用性做任何明示或暗示的保证，也不对本工具的使用或滥用造成的任何直接或间接的损失、责任、索赔、要求或诉讼承担任何责任。
- 本工具的作者保留随时修改、更新、删除或终止本工具的权利，无需事先通知或承担任何义务。
- 本工具的使用者应遵守相关法律法规，尊重微信的版权和隐私，不得侵犯微信或其他第三方的合法权益，不得从事任何违法或不道德的行为。
- 本工具的使用者在下载、安装、运行或使用本工具时，即表示已阅读并同意本免责声明。如有异议，请立即停止使用本工具，并删除所有相关文件。
# 公告
## 项目还在开发中，有些commit有bug，更新叠代会非常迅速。如果你部署好的能用，在正式发布前，可以不用更新了。
## 统一回复ISSUE内的问题：我敢承诺项目内不会有任何形式的后门程序、病毒程序、木马程序，最多只有一个防滥用倒卖的框架检测。
# 📄 文档
## https://henryxiaoyang.github.io/XYBotV2
# 💬 微信交流群
# 🙏 赞助
开源不易，请作者喝杯奶茶吧🙏
# ✨ 主要功能
## 🛠️ 基础功能
- 🤖 AI聊天 - 支持文字、图片、语音等多模态交互
- 📰 每日新闻 - 自动推送每日新闻
- 🎵 点歌系统 - 支持在线点歌
- 🌤️ 天气查询 - 查询全国各地天气
- 🎮 游戏功能 - 五子棋、战争雷霆玩家查询等
## 💎 积分系统
- 📝 每日签到 - 支持连续签到奖励
- 🎲 抽奖系统 - 多种抽奖玩法
- 🧧 红包系统 - 群内发积分红包
- 💰 积分交易 - 用户间积分转账
- 📊 积分排行 - 查看积分排名
## 👮 管理功能
- ⚙️ 插件管理 - 动态加载/卸载插件
- 👥 白名单管理 - 控制机器人使用权限
- 📊 积分管理 - 管理员可调整用户积分
- 🔄 签到重置 - 重置所有用户签到状态
# 🔌 插件系统
XYBot V2 采用插件化设计,所有功能都以插件形式实现。主要插件包括:
- 👨💼 AdminPoint - 积分管理
- 🔄 AdminSignInReset - 签到重置
- 🛡️ AdminWhitelist - 白名单管理
- 🤖 Ai - AI聊天
- 📊 BotStatus - 机器人状态
- 📱 GetContact - 获取通讯录
- 🌤️ GetWeather - 天气查询
- 🎮 Gomoku - 五子棋游戏
- 🌅 GoodMorning - 早安问候
- 📈 Leaderboard - 积分排行
- 🎲 LuckyDraw - 幸运抽奖
- 📋 Menu - 菜单系统
- 🎵 Music - 点歌系统
- 📰 News - 新闻推送
- 💱 PointTrade - 积分交易
- 💰 QueryPoint - 积分查询
- 🎯 RandomMember - 随机群成员
- 🖼️ RandomPicture - 随机图片
- 🧧 RedPacket - 红包系统
- ✍️ SignIn - 每日签到
- ✈️ Warthunder - 战争雷霆查询
# 🚀 部署说明
## 💻 Python部署
### 🪟 Windows部署
#### 1. 环境准备
- 安装 Python 3.11: https://www.python.org/downloads/release/python-3119/
- 安装 ffmpeg: 从[ffmpeg官网](https://www.ffmpeg.org/download.html)下载并添加到环境变量
- 安装 Redis: 从[Redis](https://github.com/tporadowski/redis/releases/tag/v5.0.14.1)下载并启动服务
#### 2. 安装项目
```bash
git clone https://github.com/HenryXiaoYang/XYBotV2.git
cd XYBotV2
python -m venv venv
.\venv\Scripts\activate
pip install -r requirements.txt
```
#### 3. 启动机器人
```bash
start redis-server
python app.py
```
### 🐧 Linux部署
#### 1. 环境准备
```bash
sudo apt update
sudo apt install python3.11 python3.11-venv redis-server ffmpeg
sudo systemctl start redis
sudo systemctl enable redis
```
#### 2. 安装项目
```bash
git clone https://github.com/HenryXiaoYang/XYBotV2.git
cd XYBotV2
python3.11 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
#### 3. 启动机器人
```bash
python app.py
```
### 🌌 无WebUI简单启动
如果你不需要WebUI界面，可以直接使用bot.py：
```bash
python bot.py
```
## ⚙️ 配置说明
- 主配置: main_config.toml
- 插件配置: plugins/all_in_one_config.toml
这几个插件需要配置API密钥:
- 🤖 Ai
- 🌤️ GetWeather
## ❓ 常见问题
1. 与网络相关的报错
- 检查网络连接
- 关闭代理软件
- 重启XYBot和Redis
2. `正在运行`相关的报错
- 将占用9000端口的进程结束
3. 无法访问Web界面
- 确保9999端口已开放
- 配置防火墙允许9999端口
# 💻 代码提交
提交代码时请使用 `feat: something` 作为说明，支持的标识如下:
- `feat` 新功能(feature)
- `fix` 修复bug
- `docs` 文档(documentation)
- `style` 格式(不影响代码运行的变动)
- `ref` 重构(即不是新增功能，也不是修改bug的代码变动)
- `perf` 性能优化(performance)
- `test` 增加测试
- `chore` 构建过程或辅助工具的变动
- `revert` 撤销