koishi-plugin-vocaloid-guess

术力口猜歌插件，支持：

• 听音频片段猜
• 看封面局部猜
• 选择题选项作答（A/B/C/D）
• 多人同时猜
• 抢答玩法
• 联动 monetary 插件发币

指令

• v猜歌 开始 [audio|cover|mixed]
• v猜歌 抢答开始 [audio|cover|mixed]
• v猜歌 停止
• v猜歌 跳过
• v猜歌 排行 [本群|全局]
• v猜歌 配置 [key] [value]（管理员）
• v猜歌 猜 <答案>
• v猜歌 选 <A|B|C|D...>
• v猜歌 抢
• v猜歌 状态

超时规则：任意题目超时会自动结束整局并结算。

缓存机制

• 榜单缓存：按 board + part + issue + page 缓存
• 封面缓存：下载原图到 cacheDir/covers
• 封面裁剪：不复用裁剪结果，每题实时随机裁剪（会自动避开过于单调的区域）
• 音频源缓存：cacheDir/audio
• 音频切片缓存：cacheDir/audio-clips
• 定时清理：按 cacheTtlHours 自动删除过期缓存
• 题面发送：统一以 base64 data URL 发送（不走外链 URL）

B站音频解析

• 已支持 bvid -> cid -> wbi/playurl 获取 DASH 音频流地址
• 内置 WBI 签名流程（wts + w_rid）
• 建议配置 bilibiliSessdata 以提升稳定性与可用音质

质量优化

• 封面：随机裁剪后会做单调度检测，过于单调会自动重试
• 音频：切片后会做静音检测，若片段过于安静会自动重试

monetary 联动

启用 monetaryEnabled=true 后，答对玩家会执行：

ctx.monetary.gain(uid, monetaryRewardPerCorrect, monetaryCurrencyName)

兼容说明：若 B站接口临时不可用，仍可手动放置 cache/audio/<bvid>.mp3 作为兜底。