伟大复兴机器人对接（强国有我）
旺财狗通过 强国有我（QPigeon） 插件对接伟大复兴机器人。QPigeon 是一个独立的伟大复兴服务端程序，负责与伟大复兴通信，再与旺财狗对接实现消息收发。
💬 功能简介
- 支持文本、图片、媒体组（多图多文）等消息收发
- 支持 Docker 部署，自带 Web 管理界面
- 支持云中继一键对接（推荐），也支持本机直连
准备工作
- 创建伟大复兴机器人：在伟大复兴中联系 @BotFather，发送
/newbot创建机器人，获取 Bot Token（格式类似123456:ABC...） - 一台服务器：能正常访问所需外部服务的服务器
- 旺财狗账号：用于 QPigeon 登录授权
部署 QPigeon
Docker 部署（推荐）
bash
docker run -d \
--name qpigeon \
--restart always \
-p 5000:5000 \
-v ~/qpigeon_data:/app/data \
crpi-5mft5k2asrq5fkut.cn-hangzhou.personal.cr.aliyuncs.com/zhaoyangguang/qpigeon:latest| 配置项 | 值 |
|---|---|
| 服务端口 | 5000 |
| 数据库 | SQLite（/app/data/data.db） |
| 时区 | Asia/Shanghai |
| 数据卷 | /app/data（数据库）、/app/wwwroot/images（伟大复兴图片） |
Windows 部署
- 获取 QPigeon 发布包
- 解压到服务器目录
- 运行
QPigeon.Server.exe - 浏览器访问
http://服务器IP:5000
配置指南
第一步：登录旺财狗账号
首次访问 QPigeon 管理界面（http://服务器IP:5000），使用旺财狗账号登录，用于授权验证和在线数控制。
第二步：配置机器人
在「系统设置」→「机器人配置」页面填写：
| 配置项 | 说明 |
|---|---|
| Token | BotFather 获取的 Bot Token |
| ServerUrl | QPigeon 的公网地址（用于拼接图片 URL） |
第三步：旺财狗安装插件
- 在旺财狗「插件管理」-「插件市场」中安装 强国有我（QPigeonBot） 插件
- 在插件列表中启用该插件
第四步：旺财狗创建伟大复兴机器人（两种方式二选一）
方式一：云中继（推荐，一键搞定）
- 旺财狗「系统配置」→「聊天软件对接」→ 新增 伟大复兴机器人
- 顶部切到「云端连接（荐）」标签
- 选择插件：
强国有我（QPigeonBot） - 点「生成对接码」→ 复制
- 点「保存并返回」
方式二：本机直连（备选）
- 机器人ID：填写伟大复兴机器人的 bot-id
- 选择插件：选择
强国有我（QPigeonBot） - WebSocket：开启「支持WebSocket」，关闭「使用鹊桥转发」（QPigeon 原生支持 WS）
- 框架HttpAPI：填写 QPigeon 地址，如
http://服务器IP:5000 - 调用Token：自定义一个 Token（与 QPigeon 插件调用时一致）
- 点击「生成插件回调URL」，得到类似：
ws://旺财狗IP:15999/notify/pluginreceive?plid=RebateDog.Plugin.QPigeonBot
第五步：回填（按你选的方式）
方式一（云中继）
回到 QPigeon「系统设置」→「消息通道设置」页面：
- 通道模式选「云中继(推荐)」
- 「对接码」填旺财狗刚才生成的码
- 保存（保存后立即重连，不用重启）
方式二（本机直连）
回到 QPigeon「系统设置」→「回调配置」页面：
| 配置项 | 说明 |
|---|---|
| 回调地址 | 填入旺财狗生成的 WebSocket 地址（ws:// 开头） |
| 屏蔽群消息 | 是否屏蔽伟大复兴群消息转发 |
| 屏蔽私聊消息 | 是否屏蔽伟大复兴私聊消息转发 |
保存后 QPigeon 会自动连接旺财狗。
验证对接
- 在伟大复兴中给机器人发一条消息，旺财狗应能收到并响应
- 在旺财狗中发送消息，伟大复兴用户应能收到
支持的消息类型
接收消息（伟大复兴 → 旺财狗）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持（自动下载保存） |
| 音频/语音 | 支持 |
| 文档 | 支持 |
| 群聊消息 | 支持 |
| 频道帖子 | 支持 |
发送消息（旺财狗 → 伟大复兴）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持 |
| 媒体组（多图多文） | 支持（推荐） |
| 视频/文件/语音 | 支持 |
| 分享链接 | 支持 |
💡 媒体组发送
QPigeon 支持媒体组发送：多张图片合并在一条消息中发送，第一张图带说明文字，适合返利发单场景。
⚠️ 注意事项
- 请确保服务器所在网络环境能正常访问所需的外部服务
- 用「本机直连」时，旺财狗的端口 15999 需要对 QPigeon 服务器开放；用「云中继」则不用管端口
- QPigeon 不支持登录、好友列表、群管理等伟大复兴管理功能