🎧 人工客服
插件名称： astrbot_plugin_human_service
当前版本： v1.7.2
用户可以申请转接人工客服，客服接入后，插件负责在双方之间转发消息。
插件支持单客服、多客服选择、自动排队、对话超时、黑名单、聊天记录导出和中英日智能翻译。
🚀 用户快速开始
| 命令 | 说明 |
|---|---|
@bot 转人工 | 请求转接人工客服 |
@bot 转人机 | 取消请求，或主动结束当前人工对话 |
@bot 取消排队 | 退出当前等待队列 |
@bot 排队状态 | 查看自己的排队位置 |
@bot kfhelp | 查看人工客服帮助 |
🧭 转人工流程
单客服模式
- 用户发送
@bot 转人工。 - 客服空闲时，系统通知客服。
- 客服忙碌时，用户自动进入等待队列。
- 客服回复用户的请求消息，并发送
@bot 接入对话。 - 接入后，用户和客服的消息会自动双向转发。
- 客服发送
@bot 结束对话，或用户发送@bot 转人机，结束人工服务。 - 如果队列中还有用户，系统会准备接入下一位。
多客服选择模式
- 用户发送
@bot 转人工。 - 系统显示可用客服列表和忙碌状态。
- 用户回复客服序号；回复
0可取消。 - 客服空闲则等待接入，客服忙碌则进入该客服的专属队列。
- 后续流程与单客服模式相同。
👤 用户命令详解
| 命令 | 使用时机 | 结果 |
|---|---|---|
@bot 转人工 | 需要真人帮助时 | 请求客服接入或进入队列 |
@bot 转人机 | 不再需要人工服务时 | 取消请求、退出人工对话并恢复机器人 |
@bot 取消排队 | 等待过程中不想继续排队 | 从队列中移除 |
@bot 排队状态 | 想确认等待情况 | 显示当前排队位置 |
@bot kfhelp | 不清楚如何使用时 | 显示帮助信息 |
🧑💼 客服命令
以下命令仅供被管理员配置为客服的账号使用。
| 命令 | 说明 |
|---|---|
@bot 接入对话 | 接入指定用户的人工对话；通常需要先回复用户的请求消息 |
@bot 拒绝接入 | 拒绝当前接入请求；通常需要先回复用户消息 |
@bot 结束对话 | 结束当前正在服务的对话 |
@bot 拉黑 QQ号 | 将指定用户加入黑名单 |
@bot 取消拉黑 QQ号 | 解除指定用户的黑名单 |
@bot 查看黑名单 | 查看黑名单列表 |
@bot 导出记录 | 导出当前人工客服聊天记录 |
@bot 翻译测试 | 测试智能翻译配置 |
@bot kfhelp | 查看完整客服帮助 |
接入示例
客服先回复用户的转人工请求消息，再发送：
@bot 接入对话
拉黑示例
@bot 拉黑 123456789
被拉黑的用户将无法继续使用人工客服；如果正在对话，系统可能立即结束该会话。
⏳ 排队和超时
| 功能 | 说明 |
|---|---|
| 自动排队 | 客服忙碌时，用户自动进入等待队列 |
| 排队位置 | 用户可以查看自己当前排在第几位 |
| 自动轮转 | 当前对话结束后，队列第一位会被准备接入 |
| 对话限时 | 管理员可限制单次人工对话时长 |
| 排队限时 | 管理员可限制最大等待时间 |
| 超时提醒 | 对话结束前，系统可提前提醒双方 |
| 自动结束 | 超时后，系统会结束当前对话并处理下一位 |
管理员将限制设置为 0 时，代表不限制时间。
🌍 智能翻译
管理员启用后，插件可以在中文、英文和日文之间进行辅助翻译。
例如：
- 用户发送英文，客服可同时看到英文原文和中文翻译；
- 客服发送中文，用户可同时看到中文原文和英文翻译。
翻译功能是否可用取决于管理员的模型、接口和语言配置。翻译结果可能存在误差，重要信息应再次确认。
🔇 活动沉默模式
管理员开启沉默模式后：
- 普通 AI 回复和其他插件响应可能被关闭；
@bot 转人工等人工客服命令仍可使用；- 客服账号仍可以正常与 bot 交互；
- 可避免 AI 与人工客服同时回应造成混乱。
⚠️ 使用注意
- 客服忙碌时不要重复发送
@bot 转人工，可使用@bot 排队状态查看进度。 - 不需要继续等待时，请发送
@bot 取消排队。 - 人工对话可能有时间限制，请在提醒后尽快完成沟通。
- 人工聊天内容可能被导出保存，请勿发送密码、令牌等敏感信息。
- 客服黑名单可能是全局共享，也可能由每位客服独立维护，以管理员配置为准。
- 消息前后缀和翻译内容由系统自动添加，不代表用户原始消息被修改。
- 答非所问模式属于管理员可选的娱乐配置，开启时客服回复可能被替换为随机文字。
❓ 常见问题
Q：为什么我发送转人工后没有立即接入？
客服可能正在服务其他用户。系统会将你加入队列，并显示排队人数和位置。
Q：怎样取消人工客服？
等待阶段发送：
@bot 取消排队
已经接入后发送：
@bot 转人机
Q：为什么我看不到客服选择列表？
管理员可能只配置了一位客服，或关闭了多客服选择功能。
Q：为什么提示我无法使用人工客服？
你的账号可能在黑名单中，或当前服务已经关闭。请联系管理员确认。
Q：客服为什么接入不了我？
客服通常需要先回复你的转人工请求消息，再发送 @bot 接入对话。
📎 项目信息
- 显示名称：人工客服
- 当前版本：v1.7.2
- 作者：Zhalslar & Dongyue
- 开源协议：MIT
- 项目地址：https://github.com/Zhalslar/astrbot_plugin_human_service
