Z-BlogPHP 老李QQ机器人插件

🚀 概述

Z-BlogPHP 老李QQ机器人插件是基于OneBot 11协议的智能机器人插件，为Z-Blog网站提供强大的QQ机器人功能，支持多种AI服务和丰富的群管理功能。

功能特性

🤖 核心机器人功能

• 多协议支持：基于OneBot 11协议

• 双向通信：支持消息接收和主动推送

• 多场景应用：支持群聊和私聊场景

🧠 AI智能服务

• 多模型文本生成：支持8种主流AI语言模型

• 高质量图像生成：支持5种图像生成模型

• 智能对话：可自定义AI角色和回复风格

🎨 内容功能

• 站内搜索：基于Z-Blog文章系统的智能搜索

• 资源分享：图片、壁纸等内容分享

• 多媒体支持：丰富的媒体内容交互

• 娱乐功能：大转盘

⚙️ 管理功能

• 群管工具：禁言管理、消息撤回

• 定时任务：早报推送、自动提醒

• 权限控制：多人协作管理

安装配置

环境要求

• Z-Blog PHP 1.7.3+

• PHP 7.4+

• 支持OneBot 11协议的QQ机器人框架

安装步骤

1. 配置QQ客户端

2. 下载插件并上传至Z-Blog插件目录

3. 在后台启用插件

4. 配置机器人基本参数

5. 设置API密钥和服务选项

详细配置说明

基础配置

功能开关配置

• 群图片机器人：开启群内图片分享功能

• 群国漫机器人：开启基于Z-Blog文章的智能搜索（不限于国漫）

• 群壁纸搜索：启用壁纸搜索功能

• 群AI机器人：启用AI文本对话功能

• 群AI图片机器人：启用AI图片生成功能

• 群禁言机器人：启用禁言管理功能

• 早报机器人：启用定时早报推送

文本生成服务配置

支持8种先进的文本生成模型：

图像生成服务配置

支持5种高质量的图像生成模型：

API密钥配置

AI角色定义

你是一个乐于解答各种问题的助手，名字叫隔壁小李，你的任务是为用户提供专业、准确、有见地的建议。请返回小于600个字的纯文本内容

高级功能配置

使用指南

群功能使用

AI对话功能

1. 在群内@机器人提问

2. 系统会根据选择的文本模型生成回复

3. 支持连续对话和上下文理解

图像生成功能

1. 使用特定指令描述想要生成的图片

2. 系统调用选择的图像模型生成图片

3. 支持多种风格和尺寸

@机器人 生成一张3D写实风格美女图片

内容搜索功能（国漫机器人）

本质：基于Z-Blog文章系统的智能搜索

应用场景：

• 搜索博客内的技术文章

• 查找产品介绍内容

• 检索教程和文档

• 任何基于站内内容的查询

使用方法：

@机器人 搜索 [关键词]
@机器人 查找 [文章标题]
@机器人 命令 [关键词]

管理功能

• 禁言管理：多人@机器人+@目标用户执行禁言

• @机器人 大封印术 @被禁言用户

• 消息管理：支持消息撤回和管理

• 定时推送：自动推送早报和其他定时内容

娱乐功能

大转盘

@机器人 大转盘

效果：按照大转盘时间结果禁言发言人

API接口说明

站外消息推送API

用于外站使用机器人推送服务

端点: http://***/zb_users/plugin/JzQrobot/msg.php

支持参数:

• act: 操作类型（get）

• qq: 接收类型（私聊/群聊）

• token: 验证Token（支持post和get）

• msg: 消息内容（支持post和get）

• qq: QQ号或群号（支持post和get）

使用示例:

# 私聊消息推送
curl "http://***/zb_users/plugin/JzQrobot/msg.php?act=get&qq=私聊&token=***&msg=你好&qq=123456"

# 群聊消息推送  
curl "http://***/zb_users/plugin/JzQrobot/msg.php?act=get&qq=群聊&token=***&msg=群公告&qq=123456789"

模型选择建议

文本模型选择指南

• 日常对话：GPT-4o-mini（性价比高）

• 复杂推理：OpenAI o3-mini 或 DeepSeek R1

• 中文优化：智谱模型或DeepSeek-V3

• 创意写作：Gemini 2.0 Flash系列

图像模型选择指南

• 快速生成：FLUX.1-schnell

• 高质量需求：FLUX.1-dev（收费）

• 平衡选择：Stable Diffusion 3.5 Large

注意事项

成本控制

1. 收费模型注意：FLUX.1-dev和SD 3.5 Turbo为收费模型（可以使用赠费）

2. API用量监控：定期检查各服务商的API使用量

3. 备用方案：配置多个服务商以防额度用尽

性能优化

1. 模型匹配：根据使用场景选择合适的模型

2. 缓存策略：对常用查询结果进行缓存

3. 频率限制：合理设置请求频率避免超限

故障排除

常见问题解决方案

机器人无响应

1. 检查机器人端地址和端口是否可达

2. 验证Token配置是否正确

3. 确认QQ机器人框架运行状态

AI服务异常

1. 检查API密钥是否有效且未过期

2. 确认服务商配额和余额状态

3. 查看网络连接和防火墙设置

搜索功能不准确

1. 确保Z-Blog文章内容完整

2. 检查搜索关键词匹配逻辑

3. 验证文章发布状态和权限

日志查看路径

• Z-Blog系统日志：zb_users/logs/

• 插件运行日志：插件设置界面查看

• API调用记录：各服务商控制台

兼容的QQ机器人客户端

🎯 推荐客户端

1. NapCatQQ (强烈推荐)

• 类型: 基于Node.js的OneBot 11实现

• 特点:

• 高性能，资源占用低

• 支持最新QQ协议

• 丰富的插件生态系统

• 活跃的社区支持

• 适用场景: 生产环境、高并发场景

2. llonebot

• 类型: 轻量级OneBot 11实现

• 特点:

• 配置简单，易于部署

• 内存占用小

• 支持基础消息收发

• 适用场景: 小型项目、测试环境

🔄 其他兼容客户端

3. go-cqhttp (经典选择)

• 类型: Go语言编写的OneBot 11实现

• 特点:

• 功能全面，稳定性高

• 支持文件传输、语音等高级功能

• 丰富的配置选项

• 跨平台支持

• 状态: 已停止更新，但依然可用

4. OneBot Mirai

• 类型: 基于Mirai框架的OneBot实现

• 特点:

• 基于成熟的Mirai生态

• 支持Android协议

• 插件系统丰富

• 适用场景: 需要高级功能的用户

5. SignBot

• 类型: 签名服务的OneBot实现

• 特点:

• 解决签名问题

• 支持新版QQ协议

• 商业级稳定性

• 适用场景: 商业项目、稳定性要求高的环境

6. KomoriBot

• 类型: 新型OneBot 11实现

• 特点:

• 支持多种协议

• 模块化设计

• 持续更新维护

7. Chronocat

• 类型: 基于Red协议的OneBot实现

• 特点:

• 支持新版QQ

• 功能丰富

• 活跃开发

8. OICQ-OneBot

• 类型: 基于oicq的OneBot实现

• 特点:

• 协议支持全面

• 配置灵活

• 社区支持良好

客户端选择指南

按需求选择

性能对比

安装和部署

通用部署步骤

1. 下载客户端

   # NapCatQQ 示例
   git clone https://github.com/NapNeko/NapCatQQ.git
   cd NapCatQQ
   npm install

2. 配置客户端

• 修改配置文件中的QQ号、端口和Token

• 确保与Z-Blog插件配置一致

3. 启动客户端

   # NapCatQQ
   npm start
   
   # llonebot
   ./llonebot

4. 验证连接

• 检查客户端日志无报错

• 在Z-Blog后台测试机器人状态

版本更新日志

• v1.0: 基础机器人功能

• v1.1: 增加多模型AI服务

• v1.2: 优化搜索功能和API接口

• v1.3: 支持更多图像生成模型

技术支持与反馈

• 文档更新：请关注插件发布页面

• 问题反馈：通过Z-Blog应用中心联系开发者

• 功能建议：欢迎提出宝贵建议