snowy-yang
7a8adb4571
基于 qqbotsdk 的群点歌机器人： - 点歌 <歌名>：Markdown 选歌菜单，每行 5 个编号回调按钮 + 上下页 （每页 MENU_PAGE_SIZE 首，默认 10，受内嵌键盘 5 行限制上限 20） - 点编号弹歌曲卡片：[▶播放] 发语音 / [⬇下载] 发文件或直链（SEND_MODE） - 支持不 @ 机器人也能触发（GROUP_MESSAGE_CREATE 全量模式）， 按 msg_id 排重并拦截机器人自发消息回推（self-echo） - 直链候选源回退：tx 等源受 CDN 风控时按 kw/wy/mg 逐个换源 - 自动撤回（WITHDRAW）翻页撤旧菜单、选歌撤菜单、点击后撤卡片
musicbot
QQ 群点歌 bot，基于 qqbotsdk，两步点歌：
- 选歌菜单——
点歌 <歌名 [歌手]>只负责选歌：Markdown 歌单（编号 + 歌名/歌手/来源，默认 QQ 音乐源，搜不到自动聚合兜底），下方每行 5 个编号回调按钮 +[上一页][下一页]（每页MENU_PAGE_SIZE首，默认 10，上限 20） - 歌曲卡片——点编号弹出卡片：歌名/歌手/来源 +
[▶ 播放][⬇ 下载]回调按钮，再点才执行
- 回调按钮（type=1）点一下直接生效，无需再按发送；播放发语音、下载发文件或直链（见
SEND_MODE），失败回退直链文本；无 Markdown 权限自动回退文本 - 下载发送方式（
SEND_MODE，默认link）：群文件上传仅限群主/管理员（40093005），故默认直接发直链；file则先尝试上传群文件、失败（含无权限）回退直链。播放始终发语音 - 直链候选源回退：tx 等源直链常受 CDN 风控抓不动（bot 抓不动时 QQ 服务器侧上传同样报 40093007），上传前先探测直链可抓性，不可抓则按 kw/wy/mg 逐个搜索换源
- 自动撤回（
WITHDRAW，默认开）：翻页撤旧菜单、选歌后撤菜单、下载/播放点击后撤卡片（无论发送成败都撤，卡片是一次性 UI）；关闭后所有消息都保留 - 按钮回调需
intents.toml开启INTERACTION（本仓库已开启）
配置
复制 .env.example 为 .env，填入开放平台 APPID/APPSECRET。intents.toml 控制事件订阅。MusicServer（lx-music 聚合音源）需在本机或 MUSIC_SERVER_URL 指向处运行。
点歌相关开关：
| 变量 | 默认 | 说明 |
|---|---|---|
MENU_PAGE_SIZE |
10 |
选歌菜单每页候选数，1~20（内嵌键盘 5 行所限） |
WITHDRAW |
on |
自动撤回旧菜单/卡片；off 则全部保留 |
SEND_MODE |
link |
下载按钮：link 直接发直链 / file 先传群文件（需群主/管理员） |
不 @ 机器人也能点歌
- 群侧开关：群主/管理员在 QQ 里打开机器人资料页，把消息接收切换为「接收群内全部消息」——三种取值为
all（全量）/only_mention（仅@）/mention_and_context（@+上下文），切换时平台会推GROUP_MSG_RECEIVE/GROUP_MSG_REJECT事件。未开启时网关不推送非 @ 消息，bot 行为与现在完全一致。当前群设置可用GET /v2/groups/{group_openid}/bot_state查（字段recv_msg_setting）。 intents.toml订阅GROUP_AND_C2C_EVENT（本仓库已开启）——@消息（GROUP_AT_MESSAGE_CREATE）与全量消息（GROUP_MESSAGE_CREATE）同属这一个分组，无需额外配置。
两个事件共用同一个 dataclass 与 handler，被动回复都用该消息的 msg_id（群聊 5 分钟内有效、每条最多回复 5 次）。全量事件不支持 event_id——官方 event_id 支持列表只有 INTERACTION_CREATE、GROUP_ADD_ROBOT、GROUP_MSG_RECEIVE。
运行
uv sync
uv run musicbot
开发
uv run pytest
uv run ruff check musicbot tests conftest.py && uv run pyright