HuoNiu QQNotif 是一款专为 XenForo 2.3.x 设计的 QQ 消息通知插件，支持站点事件自动推送到 QQ 群/用户，助力站长实现高效的社区消息联动与自动化管理。插件采用原生 XF 后台风格，支持日志批量管理，操作便捷，安全可靠。
NapCat 机器人依赖说明 / 关于电报群组 创建 Telegram Bot
本插件基于 NapCat QQ 机器人实现消息推送功能。使用前请确保已在服务器正确安装并配置 NapCat。
安装与对接流程
下载 NapCat
前往 NapCat 官方网站或开源仓库，获取最新版本的 NapCat QQ 机器人程序。服务器部署
将 NapCat 解压并部署到你的服务器，推荐使用 Windows 或 Linux 环境，确保服务器网络畅通。配置 QQ 账号
按照 NapCat 文档，配置 QQ 账号、群号、监听事件等参数，保证机器人可正常登录并接收消息。开放 API 接口
启用 NapCat 的 HTTP API 服务，设置好端口与访问权限，确保 XenForo 插件可以通过接口与 NapCat 通信。插件后台对接
在 XenForo 后台 QQNotif 插件设置中，填写 NapCat 的 API 地址、Token 等信息，保存并测试连接。测试与验证
使用插件内置的“测试消息”功能，验证 NapCat 对接是否成功，确保消息能正常推送到 QQ。
重要的是确保：
✅ HTTP/HTTPS Server 已启用
✅ Host 设置为 0.0.0.0（允许外部访问，如果与程序插件在同一服务器，可设置 127.0.0.1 ）
✅ Port 正确（如 3001）
✅ 内网穿透正确映射到这个端口
关于电报群组 创建 Telegram Bot
1. 在 Telegram 搜索 @BotFather
2. 发送命令
/newbot3. 按提示设置机器人名称和用户名
4. 获得 Bot Token（格式类似
123456789:ABCdefGHIjklMNOpqrsTUVwxyz）5. 保存此 Token，稍后配置时需要
获取群组/频道 ID
#### 方法 A：群组 ID（推荐用于私密群）
1. 将你的 Bot 添加到群组
2. 在群组中随便发一条消息（如："test"）
3. 在浏览器访问以下网址（替换
YOUR_BOT_TOKEN）：
```
https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates
```
4. 找到类似这样的内容：
```json
"chat": {
"id": -1001234567890,
"title": "My Group"
}
```
5. 记录这个 ID（包括负号）-1001234567890
#### 方法 B：频道用户名（用于公开频道）
1. 将你的 Bot 设为频道管理员
2. 如果频道是公开的，可以直接使用频道用户名@yourchannel
HuoNiu QQNotif 是一款专为 XenForo 2.3.x 设计的 QQ/TG 消息通知插件，支持站点事件自动推送到 QQ/TG 群/用户，助力站长实现高效的社区消息联动与自动化管理。插件采用原生 XF 后台风格，支持日志批量管理，操作便捷，安全可靠。
本插件基于 NapCat QQ 机器人实现消息推送功能。使用前请确保已在服务器正确安装并配置 NapCat。请查看安装帮助。
📢 多平台支持
QQ 群通知：基于 NapCat（OneBot 11），完美适配国内社区
Telegram 通知：官方 Bot API，全球访问无障碍
独立开关：可单独启用 QQ、Telegram，或同时双平台推送
🔔 全方位消息监控
✅ 新主题发布通知
✅ 帖子回复通知
✅ 用户注册通知
✅ 资源发布通知（XFRM）
✅ 资源更新通知
✅ 版块/资源分类过滤（精准推送）
🎨 灵活的消息定制
📝 可自定义消息模板
🏷️ 支持变量：{title} {username} {url} {snippet} {date} 等
🎯 选择性监控版块和资源分类
🛡️ 企业级安全保障
✅ XSS 防护（所有输出 HTML 转义）
✅ CSRF 防护（删除操作验证 Token）
✅ SQL 注入防护（参数化查询）
✅ 输入长度限制（消息4000字符，摘要200字符）
✅ Token 信息脱敏（日志中隐藏敏感信息）
✅ URL 白名单验证（防止开放重定向）
📊 完整的日志系统
📋 记录所有通知发送记录
🔍 发送状态追踪（成功/失败/错误信息）
🗑️ 批量删除和清空日志
⏰ 自动日志清理（可配置保留天数）
🧪 便捷的测试功能
🎯 QQ 和 Telegram 独立测试按钮
✅ 实时配置验证（格式检查）
📝 详细的错误提示和配置状态显示
💡 技术亮点
零性能损耗
异步通知机制
超时保护（连接5秒，响应3秒）
可选的日志系统
开箱即用
QQ：部署 NapCat → 填地址和群号 → 完成
Telegram：创建 Bot → 获取 Chat ID → 完成
无需 Webhook、反向代理等复杂配置
生产就绪
通过 XenForo 官方安全标准审计
修复所有已知漏洞
完整的错误处理和日志记录
📋 使用场景
企业内部社区：同时覆盖国内外团队（QQ + Telegram 双推送）
游戏社区：新资源/更新瞬间通知到 QQ 群
开源项目：Telegram 频道实时同步论坛动态
电商资源站：新品上架、会员注册全自动推送
📦 技术规格
XenForo：2.3.0+
PHP：8.0+
扩展：cURL
协议：OneBot 11 (QQ) / Telegram Bot API
有什么新消息在版本 1.2.5
发布
新增功能
1. 私信通知 (Conversation Notification)
- ✅ 监听用户发送私信消息
- ✅ 支持显示发送者、接收者、标题和内容摘要
- ✅ 可独立开关控制
- ⚠️ 建议：由于可能包含敏感内容，建议仅在管理监控需要时启用
**配置路径**：
- 选项：`qqnotif_notify_conversation` - 通知私信
- 模板：`qqnotif_template_conversation` - 私信消息模板
**可用变量**：
- `{username}` - 发送者用户名
- `{recipients}` - 接收者列表
- `{title}` - 对话标题
- `{snippet}` - 消息内容摘要
- `{date}` - 发送时间
2. 资源审核通知 (Resource Moderation Notification)
- ✅ 监听资源提交审核状态
- ✅ 及时通知管理员处理待审核资源
- ✅ 支持资源分类过滤
- ✅ 显示资源详情和审核链接
**配置路径**：
- 选项：`qqnotif_notify_resource_moderation` - 通知资源审核
- 模板：`qqnotif_template_resource_moderation` - 资源审核消息模板
**可用变量**：
- `{title}` - 资源标题
- `{username}` - 提交者用户名
- `{category}` - 资源分类
- `{version}` - 版本号
- `{date}` - 提交时间
- `{url}` - 管理后台审核链接
新增文件
1. `Listener/Conversation.php` - 私信监听器
2. `Listener/ResourceModeration.php` - 资源审核监听器
修改文件
1. `Service/AstrBot/Notifier.php`
- 新增 `formatConversationMessage()` 方法
- 新增 `formatResourceModerationMessage()` 方法
2. `_data/options.xml`
- 新增私信通知开关
- 新增资源审核通知开关
- 新增两个消息模板配置
3. `_data/phrases.xml`
- 新增相关选项说明文本
4. `_data/code_event_listeners.xml`
- 注册私信监听器
- 注册资源审核监听器
### 启用私信通知
1. 进入 `管理后台 -> 选项 -> 消息通知设置`
2. 找到 **通知私信** 选项并启用
3. 可自定义 **私信消息模板**
4. 保存设置
启用资源审核通知
1. 进入 `管理后台 -> 选项 -> 消息通知设置`
2. 找到 **通知资源审核** 选项并启用
3. 可自定义 **资源审核消息模板**
4. 配置 **监控的资源分类**（可选）
5. 保存设置
# 注意事项
1. **私信通知**：
- 默认关闭，需手动启用
- 可能包含用户隐私信息，请谨慎使用
- 建议仅在管理监控需要时启用
- 跳过对话的首条消息（创建对话时的消息）
2. **资源审核通知**：
- 默认开启
- 仅在资源状态为 `moderated` 时触发
- 支持按分类过滤
- 审核链接指向管理后台
3. **性能影响**：
- 所有通知均使用异步任务队列
- 不影响用户操作响应速度
参与讨论
你可立刻发布并稍后注册。 如果你有帐户，立刻登录发布帖子。