🧰 更多 LLM 工具
插件名称： QzoneTools / 更多 LLM 工具
当前版本： 5.0.6
为 bot 增加 QQ 空间、消息管理、定时任务、QQ 状态、群管理、记忆管理、浏览器操作和文件处理等大量工具。
这个插件主要通过 自然语言 + AI 工具调用 工作。普通用户通常不需要记住固定命令，只需把需求清楚地告诉 bot，由 AI 判断并调用相应工具。
🚀 快速开始
可以直接这样对 bot 说：
| 想做什么 | 示例 |
|---|---|
| 发表 QQ 空间说说 | @bot 帮我发条空间说说：今天天气真好 |
| 戳一戳某人 | @bot 戳一下刚才说话的人 |
| 搜索联系人 | @bot 帮我找一下通知群 |
| 向群聊主动发消息 | @bot 给通知群发消息：会议取消了 |
| 创建提醒 | @bot 30 分钟后提醒我提交作业 |
| 修改 QQ 状态 | @bot 接下来一小时把状态改成隐身 |
| 保存一条记忆 | @bot 记住我喜欢喝咖啡 |
| 查询记忆 | @bot 我以前说过自己喜欢什么？ |
| 发送语音 | @bot 用语音说“大家好” |
| 搜索网页 | @bot 帮我搜索一下今天的科技新闻 |
上述内容是自然语言示例，不是严格固定命令。
实际能否执行，取决于管理员是否启用了对应工具，以及当前用户是否拥有权限。
✨ 主要能力
QQ 与消息
| 能力 | 说明 |
|---|---|
| 发表说说 | 自动在 bot 登录的 QQ 空间发布文字动态 |
| 戳一戳 | 向指定好友或群成员发送戳一戳 |
| 搜索联系人 | 按名称或 QQ 号模糊搜索好友和群聊 |
| 主动发消息 | 向指定好友或群聊发送消息 |
| 消息撤回 | 在群聊中引用一条消息并请求撤回 |
| 点赞 | 向指定 QQ 用户发送点赞 |
| 历史消息 | 查询群聊或好友的历史消息 |
| 输入状态 | 显示“对方正在输入”等状态，提高拟人感 |
| AI 语音 | 使用 QQ 官方 TTS 角色发送语音消息 |
定时任务
| 类型 | 特点 |
|---|---|
| 普通定时消息 | 只负责到时发送消息；存储在内存中，bot 重启后会丢失 |
| 高级定时指令 | 支持发说说、切换状态、LLM 提醒等；持久化保存，重启后仍保留 |
QQ 状态与资料
可以由 AI 查询或修改：
- 在线；
- Q我吧；
- 离开；
- 忙碌；
- 隐身；
- 听歌中；
- 睡觉中；
- 机器人昵称；
- 个性签名；
- QQ 头像。
记忆管理
插件可以：
- 添加用户记忆；
- 搜索已有记忆；
- 更新记忆；
- 删除记忆；
- 查看记忆详情；
- 按标签和重要度分类；
- 在超过上限时自动清理较旧记录；
- 按配置自动把记忆注入 AI 上下文。
群管理
在权限允许时，AI 可以调用：
- 禁言或解除禁言；
- 踢出群成员；
- 开启或关闭全体禁言；
- 修改群名片；
- 发布、删除和查看群公告；
- 查看、上传、删除、移动和重命名群文件；
- 创建或删除群文件夹；
- 设置或取消群管理员；
- 修改群名称与群头像；
- 查看群荣誉、禁言列表和成员列表；
- 设置专属头衔；
- 查看
@全体成员剩余次数； - 设置加群方式；
- 群打卡；
- 设置或取消群精华消息。
群管理属于高影响操作，通常只会开放给管理员。
浏览器与网页
在管理员启用后，AI 可以：
- 搜索网页；
- 打开网址；
- 点击和输入；
- 滚动、缩放和切换标签页；
- 截取网页图片；
- 读取网页文本；
- 管理浏览器收藏夹。
浏览器支持完整、简略、极简和纯文本等渲染模式。纯文本模式适合无法直接识图的模型。
文件与工作区
插件还提供：
- 工作区文件列表；
- 读取和删除工作区文件；
- 在受控工作区执行 Python 代码；
- QQ 闪传文件；
- 在线文件与文件夹传输。
这些能力通常应限制为管理员使用，不建议向所有普通用户开放。
🗣️ 常用自然语言示例
发表说说
@bot 帮我发一条 QQ 空间说说：今天的项目终于完成了。
定时提醒
@bot 明天上午 9 点提醒我交材料。
修改状态
@bot 把 QQ 状态改成忙碌，持续 30 分钟。
引用撤回
先引用需要撤回的群消息，再发送：
@bot 撤回这条消息。
仓库说明中，撤回仅支持群聊，并且需要在消息可撤回时限内操作。
发送邮件
@bot 给 friend@qq.com 发邮件，主题是“测试”，正文是“你好”。
邮件功能只有在管理员配置发件邮箱和授权码后才可用。
记忆
@bot 记住，我不喜欢香菜。
@bot 我之前说过自己不喜欢吃什么？
🔐 工具权限
管理员可以在 WebUI 中为每个工具单独设置：
| 权限模式 | 说明 |
|---|---|
| 全局 | 所有符合会话条件的用户均可请求使用 |
| 超级管理员 | 仅 AstrBot 管理员可以调用 |
| 禁用 | 完全关闭该工具 |
因此，bot 回答“没有权限”“工具未启用”或拒绝执行，不一定是故障。
🕵️ 隐私模式
管理员可开启隐私模式，使 AI 上下文中隐藏：
- QQ 号；
- 群号；
- 其他敏感标识。
开启后，AI 主要看到群名称和用户昵称，有助于减少敏感 ID 泄露。
⚠️ 使用注意
- 插件仅支持
aiocqhttp，仓库 metadata 特别注明需要较新的 NapCat 环境。 - 发表说说、主动私聊和频繁戳一戳可能触发 QQ 风控。
- QQ 空间 Cookie 由插件尝试自动获取，但 NapCat 登录失效后仍可能失败。
- 撤回消息仅支持群聊，并受 QQ 的撤回时限限制。
- 普通定时消息在插件或 bot 重启后会丢失；需要长期保留时应使用高级定时指令。
- 发送邮件依赖管理员配置的邮箱和授权码。
- 群管理、删除好友、文件操作、浏览器自动化和执行代码都属于敏感能力，不应随意开放。
- AI 可能理解错目标。涉及退群、踢人、删除文件、修改资料和发送公开内容时，应再次确认对象和内容。
- 不要让 bot 处理密码、令牌、邮箱授权码等机密信息。
❓ 常见问题
Q：为什么我说了需求，bot 只回复文字却没有执行？
可能原因包括：
- 当前模型没有正确调用工具；
- 对应工具未启用；
- 你没有工具权限；
- 管理员没有为模型配置工具调用规范；
- NapCat 不支持对应接口。
Q：为什么定时提醒在重启后消失了？
普通定时消息只保存在内存中。高级定时指令才会持久化保存。
Q：为什么发表 QQ 空间失败？
常见原因是 NapCat 未正常登录、Cookie 失效，或当前 NapCat 不支持获取 QQ 空间凭证的接口。
Q：为什么无法撤回消息？
必须在群聊中引用目标消息，而且消息仍需处于 QQ 允许撤回的时间范围内。
Q：为什么群管理操作被拒绝？
该工具可能仅开放给超级管理员，或者管理员关闭了群管理总开关。
📎 项目信息
- 显示名称：更多 LLM 工具
- 当前版本：5.0.6
- 作者：Wyccotccy
- 支持平台：
aiocqhttp - AstrBot 要求：
>= 4.24.2 - 项目地址：https://github.com/Wyccotccy/astrbot_plugin_qzone_tools
