From fa6013d22ed766d00248c3d2cf59079e3e685520 Mon Sep 17 00:00:00 2001
From: saopig1 <4x7sw862st@gmail.com>
Date: Sun, 10 May 2026 20:56:49 +0800
Subject: [PATCH] docs(commands): surface existing !remove <position> in help
 and README

Closes #59. The command was already implemented but not advertised in
!help output or the README command table, so users assumed it was missing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 README.md           | 1 +
 src/bot/instance.ts | 1 +
 2 files changed, 2 insertions(+)

diff --git a/README.md b/README.md
index 2533110..09b42f5 100644
--- a/README.md
+++ b/README.md
@@ -253,6 +253,7 @@ sudo systemctl start tsmusicbot
 | `!stop` | 停止播放并清空队列 |
 | `!vol <0-100>` | 设置音量 |
 | `!queue` | 查看播放队列 |
+| `!remove <位置>` | 从队列中删除指定位置的歌曲（位置从 1 开始，见 `!queue`） |
 | `!mode <seq\|loop\|random\|rloop>` | 切换播放模式 |
 | `!playlist <歌单名或ID>` | 加载歌单（支持名称模糊搜索和 ID） |
 | `!playlist -q <歌单名>` | 从 QQ 音乐搜索并加载歌单 |
diff --git a/src/bot/instance.ts b/src/bot/instance.ts
index fae7d6a..5547d78 100755
--- a/src/bot/instance.ts
+++ b/src/bot/instance.ts
@@ -778,6 +778,7 @@ export class BotInstance extends EventEmitter {
       `${p}stop         — Stop and clear queue`,
       `${p}vol <0-100>  — Set volume`,
       `${p}queue        — Show queue`,
+      `${p}remove <pos> — Remove song at position (see ${p}queue)`,
       `${p}mode <seq|loop|random|rloop> — Play mode`,
       `${p}playlist <name or id> — Load playlist by name or ID`,
       `${p}playlist -q <name or id> — Load playlist from QQ Music`,