From e47fc765293ceb0fcaa31f5f83674b516a00ac01 Mon Sep 17 00:00:00 2001 From: saopig1 <4x7sw862st@gmail.com> Date: Thu, 25 Jun 2026 12:25:46 +0800 Subject: [PATCH] docs: document guest mode Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index b269633..144077e 100644 --- a/README.md +++ b/README.md @@ -182,6 +182,27 @@ sudo ./scripts/install.sh - 在 **设置 → 用户管理**（仅管理员）中添加 / 删除 / 重置密码 / 切换角色。 - 至少保留一个管理员：系统会阻止删除或降级最后一位管理员。 +**游客模式 / Guest mode**： + +让访客**无需账号密码**即可进入 WebUI 点歌，同时严格限制其可用能力。该功能**默认关闭**，只有管理员能开启。 + +- **开启方式**：管理员在 **设置 → 游客模式** 打开「允许游客访问」（仅管理员可见此区块）。开启后登录页会出现 **「以游客身份进入」** 按钮，访客点击即可创建游客会话，无需任何凭据。关闭游客模式后，所有游客会话立即失效。 +- **逐项权限（7 个开关，管理员配置）**：除「添加到队列末尾」外**全部默认关闭**，按需逐项放开。 + + | 开关 | 字段 | 默认 | + |------|------|------| + | 添加到队列末尾 | `addToQueue` | **开** | + | 添加到下一首 | `playNext` | 关 | + | 立即播放（不清空队列） | `playNow` | 关 | + | 跳过当前歌曲 | `skip` | 关 | + | 暂停/继续/进度/音量 | `transport` | 关 | + | 移除/清空队列 | `removeClear` | 关 | + | 切换播放模式 / FM | `playMode` | 关 | + +- **按机器人授权（游客作用域）**：可选择「全部机器人」或指定一份机器人白名单。作用域之外的机器人对游客**不可见、不可控**。 +- **游客始终被禁止**：查看或修改任何设置、管理机器人、设置音乐平台账号 / 凭据、修改音质，以及访问用户管理与操作审计。这些限制不受上面 7 个开关影响，**永远锁死**。 +- **复现 issue #83 的「下一首 only」需求**：在 **设置 → 游客模式** 中关闭「添加到队列末尾」并打开「添加到下一首」，游客便只能把歌曲加到下一首播放。 + **如何重置忘记的管理员密码**： 如果你忘记了管理员密码，可以直接编辑 SQLite 数据库 `data/tsmusicbot.db`：