🤝 人际关系管理器
插件名称： astrbot_plugin_relationship
当前版本： v3.0.4
用于集中管理 bot 的 QQ 好友、群聊、好友申请、群邀请以及部分群聊风险事件。
该插件仅支持 aiocqhttp 平台，主要面向 bot 管理员和审核员。普通群成员通常不需要使用本页中的命令。
✨ 主要功能
| 功能 | 说明 |
|---|---|
| 好友列表 | 查看 bot 当前的全部 QQ 好友 |
| 群列表 | 查看 bot 当前加入的全部群聊 |
| 批量退群 | 按序号、群号或区间退出一个或多个群 |
| 批量删好友 | 按序号、QQ 号、区间或 @ 删除好友 |
| 申请审核 | 手动同意或拒绝好友申请与群邀请 |
| 自动审核 | 按黑名单、自动同意、自动拒绝等规则处理申请 |
| 群事件通知 | 处理管理员变动、禁言、被踢和邀请入群等事件 |
| 风险控制 | 对异常群规模、群容量、被踢事件和互斥成员进行处理 |
| 聊天抽查 | 抽查指定群或用户的近期聊天记录 |
| 推荐卡片 | 发送指定群或用户的推荐卡片 |
好友列表与群列表默认以纯文本返回。
👑 管理员命令
| 命令 | 说明 |
|---|---|
@bot 群列表 | 查看 bot 当前加入的所有群 |
@bot 好友列表 | 查看 bot 的所有好友 |
@bot 退群 目标 | 退出一个或多个群，支持序号、群号和区间 |
@bot 删好友 目标 | 删除一个或多个好友，支持 @、序号和区间 |
@bot 加审核员 @某人 | 将指定用户添加为申请审核员 |
@bot 减审核员 @某人 | 移除指定审核员 |
@bot 抽查 | 随机抽查一个群的聊天记录 |
@bot 抽查 群号 数量 | 抽查指定群最近若干条消息 |
@bot 抽查 @群友 数量 | 根据群友定位目标并抽查记录 |
@bot 推荐 群号 | 发送指定群的推荐卡片 |
@bot 推荐 @某人 | 发送指定用户的推荐卡片 |
🧑⚖️ 审核员命令
| 命令 | 说明 |
|---|---|
@bot 同意 | 同意被引用的好友申请或群邀请 |
@bot 同意 备注 | 同意申请，并附加备注 |
@bot 拒绝 | 拒绝被引用的好友申请或群邀请 |
@bot 拒绝 理由 | 拒绝申请，并填写理由 |
重要操作方式
同意 和 拒绝 必须引用插件发送的申请通知消息。
正确流程：
- 插件将好友申请或群邀请发送到审核群或管理员私聊；
- 审核员引用该申请消息；
- 发送
@bot 同意或@bot 拒绝 理由； - 插件处理对应申请。
如果没有引用申请消息，插件无法判断要处理哪一条申请。
📦 批量目标写法
退出指定群
@bot 退群 123456789
按列表序号退出多个群
@bot 退群 1 3 5
使用区间
@bot 退群 1-5
也可以使用：
@bot 退群 1~5
删除好友
@bot 删好友 @某人
@bot 删好友 1-3
执行退群或删除好友前，请先通过 @bot 群列表 或 @bot 好友列表 确认序号，避免误操作。
🔎 聊天记录抽查
| 写法 | 效果 |
|---|---|
@bot 抽查 | 随机选择一个群进行抽查 |
@bot 抽查 123456789 50 | 抽查指定群最近 50 条消息 |
@bot 抽查 @某人 30 | 根据指定用户抽查相关群聊记录 |
插件还可以在 bot 新加入群聊后延迟执行自动抽查，并把近期消息发送到审核群或管理员。
实际抽查数量、延迟时间和通知目标由管理员配置。
🛡️ 自动审核与风险控制
申请或邀请到达后，插件会先检查管理员配置的自动规则：
- 黑名单规则；
- 自动同意规则；
- 自动拒绝规则；
- 未被自动处理时，再通知审核群或管理员进行人工审核。
插件还可以根据配置处理：
- 人数过少或过多的群；
- bot 加群数量超过上限；
- bot 被踢出群聊；
- 指定互斥成员同时存在；
- 管理员变动或禁言事件。
这些规则由站点管理员设置，普通用户无法修改。
🧪 仓库中标注的扩展命令
仓库 README 还列出了：
@bot 加好友 QQ号 验证消息 备注 答案
@bot 加群 群号 答案
但 README 同时说明，这两个功能所需的部分源码未包含在公开仓库中。因此，公开版本通常无法直接使用这两个命令，本站是否可用以实际部署情况为准。
⚠️ 使用注意
- 该插件只支持
aiocqhttp。 - 退群、删好友和审核申请都属于高影响操作，发送前必须确认目标。
- 批量操作支持空格和区间，输错范围可能一次处理多个目标。
- 好友申请和群邀请的通知目标必须由管理员正确配置。
- 未配置审核群且没有管理员 ID 时，审核通知可能无法送达。
- 聊天记录抽查会读取并转发群聊消息，使用时应注意群成员隐私。
- 黑名单、自动退群和自动拒绝规则可能导致操作自动执行。
❓ 常见问题
Q：为什么 @bot 同意 没反应？
必须先引用插件发送的申请通知消息，再发送命令。
Q：为什么群列表和好友列表不是图片？
仓库 README 明确说明这两项默认以纯文本输出。是否转为图片取决于站点是否安装输出增强插件。
Q：为什么退群或删好友处理了多个目标？
你可能使用了区间或空格分隔的批量写法。操作前应先确认列表序号。
Q：为什么审核群收不到新申请？
可能没有配置审核群，也没有设置可接收通知的管理员 ID，需要站点管理员检查插件配置。
Q：普通群成员能使用这些命令吗？
主要命令面向管理员和审核员。实际权限由 AstrBot 管理员配置决定。
📎 项目信息
- 显示名称：人际关系管理器
- 当前版本：v3.0.4
- 作者：Zhalslar
- 支持平台：
aiocqhttp - 开源协议：AGPL-3.0
- 项目地址：https://github.com/Zhalslar/astrbot_plugin_relationship
