4. Discord 机器人附加功能

使用音乐、会说话的 Saba-chan、会朗读的 Saba-chan、状态板、Discord 服务器管理命令和游戏战绩查询。

4. Discord 机器人附加功能

除了游戏服务器命令,Saba-chan 机器人还有更多功能。这些功能运行在 Saba-chan 云端,所以只要不是操作游戏服务器,没有连接电脑的 Discord 服务器也能使用。

功能是否需要连接电脑
音乐、会朗读的 Saba-chan、表情符号放大、服务器管理命令、游戏战绩不需要
会说话的 Saba-chan不需要(要让它管理游戏服务器则需要)
服务器状态板、通知・游戏聊天频道需要

在没有连接电脑的 Discord 服务器里,由 Discord 服务器所有者或拥有管理服务器权限的人修改语言、会说话的 Saba-chan・音乐频道、会说话的 Saba-chan・会朗读的 Saba-chan 设置,以及表情符号放大。可以用 Discord 的 /saba 命令,或在 Saba-chan 网页的 Discord 标签页中进行。在已连接电脑的 Discord 服务器里,由连接电脑的人和 Discord 服务器所有者修改。


音乐

音乐由 Saba-chan 云端的音乐服务器播放。不需要在电脑上另外运行程序,电脑关着也能播放。

#音乐我们的服务器
Saba-chanAPP
♪ 等待音乐中...输入歌曲名或 YouTube 链接!
➕ 添加歌曲
  1. 先进入语音频道。
  2. 在任意频道发送 Saba-chan play 歌名(或 YouTube・SoundCloud・Spotify・Apple Music 链接),Saba-chan 就会进入语音频道开始播放。Spotify・Apple Music 的歌曲会到 YouTube 上找同一首歌来播放,专辑・播放列表最多把前 100 首放进队列。
  3. 想要音乐专用频道,就在那个频道发送 /saba assign kind:音乐(仅限上面所说的可以修改设置的人)。在音乐频道里不加前缀、只输入歌名就行,还会出现显示正在播放的歌曲和队列的播放器。这个频道里的普通消息会被删除,请只用来放音乐。如果 Saba-chan 在这个频道没有管理消息权限,就无法删除消息,播放器上会显示相关提示。
  4. 播放时用播放器的两排图标按钮操作。上排是上一首・暂停・下一首・电台(自动播放相似歌曲)・停止,下排是队列编辑・调低音量・调高音量・菜单。没有正在播放的歌曲时只显示用法,歌曲请在频道中输入标题或链接来添加。点击添加歌曲的人的名字会打开其 Discord 个人资料,电台添加的歌曲会以电台图标和“自动添加”标示。电台和音量均衡是否开启,显示在进度条下方的开关上。音量均衡会逐首测量音量,把所有歌曲调到同一基准音量(第一次听的歌曲从听完之后的下一次开始生效)。
  5. 点菜单按钮会打开只有你自己能看到的窗口。在这里开关音量均衡,并设置定时关闭(本曲结束后、15 分钟・30 分钟・1 小时・2 小时后)。定时关闭会在设定时间过后,听完当时正在播放的歌曲就停止并离开语音频道,剩余时间显示在进度条下方。只有在语音频道里收听的人才能修改。播放时,机器人所在语音频道的状态会显示当前歌曲标题。
  6. 点队列编辑按钮会打开只有你自己能看到的窗口。可以选择歌曲移到最前・上移・下移或移除,也可以打乱整个队列。自己添加的歌曲任何人都可以操作;混有他人添加的歌曲时,只有 Saba-chan 等级为管理员以上的人可以移动・移除・打乱(在未联动的 Discord 服务器里则是拥有管理服务器权限的人)。
  7. 发送 search 歌名 可以从搜索结果里挑选。
命令作用
play / search播放 / 从结果中挑选播放
pause · resume · next · prev · stop播放控制
queue · now · shuffle · repeat · radio · volume 50队列和设置

音乐功能默认开启。要关闭,请在应用中使用 Discord 服务器 → 音乐 标签页。在已开启的 Discord 服务器里还会出现 /music 斜杠命令(命令)。级别为禁止的成员也不能使用音乐。


会说话的 Saba-chan

会说话的 Saba-chan 让你在 Discord 里和 Saba-chan 对话。它会回应闲聊,你用话语拜托它时,它会挑选合适的服务器命令替你执行。

#saba-聊天我们的服务器
haru21:10
Saba-chan 今晚吃什么好?
Saba-chanAPP21:10
今天有点冷,来点热乎乎的汤怎么样?

准备

  1. 在应用的 Discord → Saba-chan 设置 界面登记 AI API 密钥(在 OpenAI、Anthropic、Google 等 AI 提供商账号中获取的一串机密字符)。Saba-chan 会自动判断这是哪家公司的密钥。只有这台电脑和 Saba-chan 云端知道这个密钥,它不会再显示在画面或 Discord 上。对话产生的费用由这个密钥支付。没有连接电脑的 Discord 服务器,请在 Saba-chan 网页的 Discord 标签页填入该服务器要用的密钥。在这个界面设置的模型、推理强度、长期记忆、插话和全部允许的工具,会同样应用到所有 Discord 服务器。
  2. 为每个 Discord 服务器开启。在 Discord 服务器界面的 会说话的 Saba-chan 标签页打开 在此服务器使用会说话的 Saba-chan,并选择这个服务器要用的工具(游戏服务器、网页搜索、英雄联盟・云顶之弈・绝地求生战绩、冒险岛角色、多款游戏搜索、生活信息、图像生成等)。新连接的 Discord 服务器是关闭的,也没有开启任何工具。在全部允许的工具里被屏蔽的工具,任何服务器都无法开启。在 Discord 里,所有者可以用 /saba settings 修改同样的内容。
  3. 在要聊天的频道发送 /saba assign kind:会说话的 Saba-chan,或在应用中 Discord 服务器 → 服务器管理 标签页的 Saba-chan 分配 中选择。会说话的 Saba-chan 只在分配的频道聊天(最多 20 个)。不过登记了 API 密钥时,在其他频道里有时也会被用到:如果前缀命令里 Saba-chan 认不出服务器名或命令,会说话的 Saba-chan 会找出合适的命令再试一次。

使用

  • 在分配的频道用前缀叫它并说话。例如:Saba-chan 服务器现在怎么样?
  • 进入语音频道后,可以像 Saba-chan 播放夜曲 这样用话语播放音乐。这和在音乐功能中输入歌曲是一回事,所以在关闭了音乐的 Discord 服务器里无法使用。
  • 执行前是否用确认按钮询问,在 Discord 服务器的 机器人设置 标签页的 确认 卡片中设置(起初对所有命令都询问,见 Discord 联动)。管理类操作不论此设置如何都会询问。只有提出请求的人能按按钮。
  • 能执行的范围取请求者级别和会说话的 Saba-chan 上限中较低的一个。修改权限、机密值、应用 Saba-chan 更新这些事,会说话的 Saba-chan 都做不了。
  • 起初会说话的 Saba-chan 上限是访客(只限安全命令),只能让它做状态、列表之类的查询。要让它开关服务器,请在 Discord 服务器 → 实例 标签页点击服务器,把 各级别命令 界面下方的上限调到用户或更高。上图是把上限调到用户之后的样子。
  • 开启 AI 审核(Discord 服务器的 会说话的 Saba-chan 标签页,或 /saba settings)后,会说话的 Saba-chan 会留意该 Discord 服务器的聊天。同一个人在短时间内刷屏,或发布看起来像推广币圈・股票荐股群・违法信息的内容时,AI 会再判断一次;如果认为有害,只会通过 Discord 私信,把提到该用户的消息和消息链接发给在此服务器连接了电脑的人当中的服务器所有者或管理员,告诉他们“这个用户有点奇怪”。不会删除消息或进行处罚。管理员和拥有管理消息权限的人发的内容不会被审查。只有可疑内容才会调用 AI(每个服务器每小时最多 20 次),费用由登记的 API 密钥支付。起初是关闭的。
  • 在 Discord 服务器的 会说话的 Saba-chan 标签页的 服务器提示词 里,可以写下这个 Discord 服务器希望它知道的语气或称呼。用 插入默认模板 可以放入要填写项目的模板。

服务器状态板

状态板频道里,会为当前已开启的每个服务器放一张卡片。卡片上显示游戏横幅、服务器名称、开启标记、在线人数和运行时间,在线人数或运行时间变化时,同一张卡片会被更新。服务器关闭后,那张卡片会消失;没有任何已开启的服务器时,只留下一行提示。

  1. 在要用作状态板的频道发送 /saba assign kind:状态板(连接电脑的人或 Discord 服务器所有者)。再次发送则取消分配。
  2. 在线人数根据服务器控制台的进入・退出记录来统计。不会向服务器发送命令去询问,所以服务器日志不会变乱。
  3. 只显示对这个 Discord 服务器开放的服务器;如果有多台电脑,卡片下方会标明是哪台电脑的服务器。
  4. 频道上也会显示当前已开启的游戏名称(不是服务器名称)。文字频道写在频道主题中,语音频道写在频道状态中。由于 Discord 的限制,文字频道主题 5 分钟内最多只能修改一次。机器人需要在该频道拥有管理频道权限(新邀请时会一并获得。如果是以前邀请的,请在该频道授予权限或重新邀请)。

会朗读的 Saba-chan

会朗读的 Saba-chan 会在语音频道里把你在聊天中写的文字念出来。在不方便使用麦克风时使用。

  1. 进入语音频道后,在要写字的频道发送 /tts。此后你在这个频道写的文字,Saba-chan 会在你所在的语音频道里朗读。再次发送 /tts 则关闭。
  2. 在游戏聊天频道开启时,发到该频道的游戏内聊天也会一并朗读。
  3. 读过的文字会被删除。如果机器人在该频道没有管理消息权限,就不会删除,并在开启时提示一次。
  4. 以前缀开头的文字以命令优先。只有不是命令时才会朗读。
  5. 你离开语音频道时就会关闭。如果音乐正在播放,会与音乐一起听到。
  • 每条文字最多读 100 字,每人每分钟最多 500 字、每小时最多 15000 字。超出的文字会保留,并只通知你自己。
  • 每个 Discord 服务器可以设置音量(10150%)、语速(0.81.5 倍)、音调(-6~+6 半音),以及在文字前加上“某某,”的时机(总是・朗读者有多人时・不加)。在应用的 Discord 服务器 → 会朗读的 Saba-chan 标签页或 Discord 的 /saba reading 中修改。
  • 如果 Saba-chan 正在其他语音频道朗读或播放音乐,则无法开启。

表情符号放大

在 /settings › 🌐 Language & commands 开启 Emoji upscale 后,如果有人只发送了一个自定义表情,Saba-chan 会把它改成大图重新发布。两个自定义表情会拼接成一张图。贴纸保持原样。起初是关闭的,机器人需要在该频道拥有管理消息・附加链接权限。详细行为见 命令。


Discord 服务器管理命令

管理 Discord 服务器的命令。拥有对应 Discord 权限的人,或在已连接电脑的服务器中 Saba-chan 等级为管理员以上的人可以使用。在应用的 Discord 服务器 → 服务器管理 标签页中也可以做同样的事。

命令作用所需 Discord 权限
/clear [count] [member] [period]从最近的开始批量删除此频道的消息(count 留空则最多 1000 条)。置顶消息和 Saba-chan 播放器・状态板等面板会保留管理消息
/autoclear keep:<期限>每 15 分钟删除此频道中超过保留期限(1 小时~7 天)的消息。用 Off 关闭管理消息
/mute member:<成员> duration:<期限> [reason]禁止成员聊天和语音(Discord 超时,也可以无限期)。用 Unmute 解除。也可以使用前缀命令 Saba-chan mute @成员 1h・Saba-chan unmute成员超时
/lock [duration]锁定此频道,使其无法发言。用 Remove 解除管理频道
/slowmode interval:<间隔>修改此频道的慢速模式管理频道

Discord 无法批量删除超过 14 天的消息,所以 /clear 对这类消息一次最多只删除 50 条。机器人也必须拥有同样的权限。


临时语音房间

在 /settings › 🔊 临时语音房间中指定一个创建房间频道(语音频道),进入该频道的人会在同一分类下获得自己的语音房间并被立即移入。房间没人时会自动删除。

  • 房主可用房间聊天中的控制面板切换公开 · 锁定 · 秘密。锁定房间在列表中可见但无法进入,秘密房间会从列表中消失(拥有 Discord 管理员权限的人仍能看到)。
  • 邀请后对方即可进入,房间聊天中会发出提及对方的提示(对方进入或 10 分钟后删除)。也可以右键成员 → 应用 → Invite to my room。不会发送私信。
  • 锁定房间外的人可以按面板上的敲门,房主在房间聊天中允许或拒绝。
  • 踢出、转让房主、修改名称和人数上限也在面板上。房主离开时,剩下的人中最早进入的人成为房主。
  • 机器人需要管理频道和移动成员权限。之前邀请过的服务器请在服务器设置中为 Saba-chan 的角色添加移动成员权限。

消息翻译

  • 右键消息 → 应用 → Translate with Saba-chan,会按你的 Discord 语言翻译并只给你看。默认开启。
  • 在 /settings › 🌐 翻译中开启国旗表情翻译后,给消息加上国旗表情(🇯🇵、🇺🇸 …)时会用该国语言翻译并回复原消息。同一消息、同一语言只回复一次。默认关闭。
  • 设置了说话的 Saba-chan API 密钥的服务器用该密钥的模型翻译,费用记在该密钥上。没有密钥的服务器也能使用共享的免费翻译,每天 3,000 字(日本时间早上 6 点重置)。

游戏战绩查询

用 /stats game:<游戏> name:<昵称> 以卡片形式查看英雄联盟、绝地求生、冒险岛、永恒轮回、守望先锋 2 等游戏的战绩。在开启了会说话的 Saba-chan 的 Discord 服务器里,会附上一句话。支持的游戏和名称格式见 命令。