QQ 群点歌 bot：选歌菜单 + 歌曲卡片 + 回调按钮

基于 qqbotsdk 的群点歌机器人：

- 点歌 <歌名>：Markdown 选歌菜单，每行 5 个编号回调按钮 + 上下页
  （每页 MENU_PAGE_SIZE 首，默认 10，受内嵌键盘 5 行限制上限 20）
- 点编号弹歌曲卡片：[▶播放] 发语音 / [⬇下载] 发文件或直链（SEND_MODE）
- 支持不 @ 机器人也能触发（GROUP_MESSAGE_CREATE 全量模式），
  按 msg_id 排重并拦截机器人自发消息回推（self-echo）
- 直链候选源回退：tx 等源受 CDN 风控时按 kw/wy/mg 逐个换源
- 自动撤回（WITHDRAW）翻页撤旧菜单、选歌撤菜单、点击后撤卡片

.env.example

@@ -0,0 +1,22 @@
+# QQ 开放平台凭证（必填，缺失启动即报错）
+APPID=你的AppID
+APPSECRET=你的AppSecret
+CONNECTER=websocket
+
+# MusicServer（lx-music 聚合音源）
+MUSIC_SERVER_URL=http://127.0.0.1:16688
+MUSIC_QUALITY=128k
+MUSIC_SOURCE=tx                    # 默认 QQ 音乐，留空聚合全源
+
+# 选歌菜单每页候选数（1~20；受内嵌键盘 5 行限制，默认 10）
+MENU_PAGE_SIZE=10
+
+# 自动撤回：翻页撤旧菜单、选歌后撤菜单、播放/下载后撤卡片
+# on/off（也接受 true/false、1/0、yes/no），默认 on
+WITHDRAW=on
+
+# 下载按钮的发送方式：
+#   link 直接发直链（默认，避开"仅群主和管理员上传文件"的 40093005）
+#   file 先上传群文件、失败回退直链（需机器人在群里是群主/管理员）
+# 播放按钮不受影响，始终发语音。非法值按 link 处理。
+SEND_MODE=link