diff --git a/README.md b/README.md index 846e6c8..221a68e 100644 --- a/README.md +++ b/README.md @@ -347,6 +347,27 @@ sudo systemctl start tsmusicbot > 命令前缀默认为 `!`,可在设置页面修改。支持别名:`!p` = `!play`,`!s` = `!skip`,`!n` = `!next` +### TeamSpeak 命令权限(管理类命令限制) + +默认情况下,频道里任何人都能运行所有聊天命令。你可以把一组「管理类」命令限制为只有特定 TeamSpeak 服务器组的成员才能运行: + +- 受限命令:`stop`、`clear`、`remove`、`move`、`vol`、`mode` +- 其余命令(点歌、队列、跳过、歌词等)始终对所有人开放 +- **默认不限制**:管理服务器组列表为空时,所有命令对所有人开放(向后兼容) + +**配置方式** + +- 网页端:设置 → 命令权限,填写允许的服务器组 ID(逗号分隔),保存即时生效。 +- 或编辑 `config.json` 的 `adminGroups`(数字数组),例如 `"adminGroups": [6, 8]`。 + +填入任意服务器组 ID 后,限制立即开启:只有属于这些组之一的用户才能运行受限命令,其他人会收到「⛔ 需要管理员权限」的提示。 + +> 提示(fail-closed):当受限命令来自一个机器人当前看不到其服务器组的发送者(例如不在机器人所在频道的私聊),机器人会尝试查询其分组;若仍无法确定,则拒绝执行。 + +**如何查看服务器组 ID** + +在 TeamSpeak 客户端中打开「权限 → 服务器组」(Permissions → Server Groups)对话框,选中某个组后,其 ID 会显示在标题栏/状态栏;或在服务器组管理界面中查看每个组对应的数字 ID。把需要授权的组 ID 填入上面的设置即可。 + ### 音质等级 | 等级 | 码率 | 格式 | 说明 |