👁️ 天使之眼
插件名称： AngelEye
当前版本： 1.0.6
允许大语言模型自动查询当前群聊的聊天记录。
天使之眼不是传统的“命令插件”。用户不需要记住固定指令，只要在群聊中向 bot 提出与聊天历史有关的问题，bot 就会在需要时自动查询记录，再根据查询结果回答。
🚀 快速开始
在群聊中直接艾特 bot，并用自然语言说明你想查什么。
| 想做什么 | 示例说法 |
|---|---|
| 查找某个话题 | @bot 帮我找一下昨天大家聊到 AstrBot 的内容 |
| 查询近期提及 | @bot 最近 24 小时有人提到天气吗？ |
| 总结一段时间的讨论 | @bot 总结一下今天上午群里聊了什么 |
| 查询某人的发言 | @bot 帮我看看某某最近在群里说了什么 |
| 按关键词查找 | @bot 查一下最近关于服务器维护的聊天记录 |
上述内容不是固定命令，可以按正常说话方式表达。
✨ 功能特点
| 功能 | 说明 |
|---|---|
| 自动判断是否查询 | bot 会根据问题内容自行判断是否需要查聊天记录 |
| 关键词筛选 | 可按一个或多个关键词查找相关消息 |
| 时间范围筛选 | 可查询指定时间段或最近若干小时的内容 |
| 用户筛选 | 可只查询指定 QQ 用户发送的消息 |
| 数量限制 | 单次最多可返回 500 条消息供模型整理 |
| 自然语言回答 | 查询完成后，由大模型总结、归纳或直接回答问题 |
🔍 它是怎么工作的？
- 用户在群聊中提出与历史消息有关的问题。
- 大模型判断需要查询群聊记录。
- 插件根据关键词、时间、用户或数量等条件筛选消息。
- 查询结果返回给大模型。
- 大模型根据记录生成总结或回答。
⚠️ 使用限制
- 仅适用于群聊。 私聊中无法查询群聊聊天记录。
- 查询结果取决于 bot 当前能够访问到的聊天记录范围。
- 问题越明确，查询效果通常越好。
- 如果时间范围、关键词或目标用户描述过于模糊，结果可能不够准确。
- 大量记录会增加模型处理时间，建议尽量限定范围。
💡 提问建议
推荐写法
@bot 总结今天 8:00 到 12:00 关于比赛报名的讨论
@bot 查一下最近两天有没有人提到服务器掉线
@bot 帮我找某某今天发过的与作业有关的消息
不推荐写法
@bot 查一下
这种说法没有给出时间、关键词或目标，bot 很难判断你具体想查什么。
❓ 常见问题
Q：为什么 bot 没有调用聊天记录查询？
可能是问题看起来不需要查询历史消息，或者表达得过于模糊。可以明确加入“最近”“昨天”“群里之前聊过的”等信息。
Q：为什么私聊里不能用？
插件专门查询当前群聊的聊天记录，私聊环境中没有对应的群聊上下文。
Q：能查询所有历史消息吗？
不一定。可查询范围取决于 QQ 接口、bot 当前保存或能够取得的记录，以及管理员配置。
Q：查询结果会不会很慢？
时间范围越大、消息越多，查询和模型整理所需时间通常越长。
📎 项目信息
- 显示名称：天使之眼
- 项目作者：kawayiYokami
- 当前版本：1.0.6
- 项目地址：https://github.com/kawayiYokami/astrbot_plugin_angel_eye
