QQ群文章推送插件

功能说明

当站点发布新文章时，自动推送通知到指定的 QQ 群。

支持的机器人类型

1. go-cqhttp - 最常用的 QQ 机器人框架
2. NapCat - 新一代 QQ 机器人框架
3. OneBot 协议 - 标准化的聊天机器人协议
4. 自定义 Webhook - 支持自定义接口

使用步骤

1. 部署 QQ 机器人

方案 A：使用 go-cqhttp（推荐新手）

1. 下载 go-cqhttp：https://github.com/Mrs4s/go-cqhttp/releases
2. 运行程序，选择通信方式为 HTTP

3. 配置 config.yml：

   servers:
     - http:
      host: 127.0.0.1
      port: 5700

4. 启动机器人并扫码登录

方案 B：使用 NapCat（推荐进阶用户）

1. 安装 NapCat：https://github.com/NapNeko/NapCatQQ
2. 配置 HTTP 服务
3. 启动并登录 QQ

2. 安装插件

1. 将 QQPush 文件夹上传到 usr/plugins/ 目录
2. 在 Typecho 后台「控制台」->「插件」中启用插件

3. 配置插件

在插件配置页面填写：

• 机器人类型：选择你使用的机器人类型
• API 地址：机器人的 HTTP API 地址（如 http://127.0.0.1:5700）
• Access Token：如果设置了认证，填写 token
• QQ 群号：要推送的群号，每行一个，支持多个群
• 更新文章时推送：是否在更新文章时也推送
• 消息模板：自定义推送消息的格式

4. 测试

发布一篇新文章，检查 QQ 群是否收到推送消息。

消息模板变量

• {title} - 文章标题
• {author} - 作者名称
• {category} - 文章分类
• {excerpt} - 文章摘要（前100字）
• {url} - 文章链接

常见问题

Q: 推送失败怎么办？

1. 检查机器人是否正常运行
2. 确认 API 地址是否正确
3. 检查机器人是否在目标群内
4. 查看服务器错误日志

Q: 支持私聊推送吗？

当前版本仅支持群消息，如需私聊功能可自行修改代码。

Q: 可以推送到多个群吗？

可以，在「QQ 群号」配置中每行填写一个群号即可。

Q: 如何自定义消息格式？

在插件配置的「消息模板」中修改，支持使用变量和换行。

注意事项

1. 确保服务器可以访问机器人的 API 地址
2. 机器人需要在目标群内才能发送消息
3. 注意 QQ 的消息频率限制，避免被风控
4. 建议在测试环境先测试后再正式使用

技术支持

如有问题，请检查：

• PHP curl 扩展是否已安装
• 机器人日志输出
• Typecho 错误日志

更新日志

v1.0.0

• 初始版本
• 支持文章发布推送
• 支持多群推送
• 支持自定义消息模板