koishi-plugin-music-pick 基于 MET + 网易云 API 的点歌插件。 ## 主要功能 ### 核心点歌 - 点歌 关键词 搜索并点播歌曲 - 支持 点歌 -n <序号> 直接指定序号点歌，跳过选择步骤 - 同群支持多用户并发点歌，互不阻塞 - 同一用户重复发起会自动覆盖上一条待选歌单 ### 双源搜索 - 默认并行搜索 MET + 网易云，两源各取前 5 首并合并去重 - 同名同歌手歌曲保留 MET 结果，优先选择 - 使用 -163 或 -wyy 可显式切换为网易云单源搜索 ### 自动解析 - 音乐卡片：自动解析聊天中的音乐卡片，QQ 卡片走 MET 源，网易云卡片走网易云源 - 文本链接：自动识别并解析 music.163.com / y.qq.com 链接，直接返回音频（需开启 enableTextLinkParse） ### 歌曲列表展示 - 支持生成美观的图片形式歌曲列表（需 puppeteer 服务） - 可选暗黑模式，自定义卡片边框颜色 - 也可使用纯文本列表展示 ### 发送与音质 - 将歌曲信息以合并转发形式发送，提供更佳展示效果 - 支持配置音质级别：HQ（高清）/ SQ（无损）/ RS（Hi-Res）/ DA（Dolby Atmos）/ QAI（AI音质） - 音频文件过大时自动降级为文本+下载链接 ## 安装与配置 ### 依赖 - Koishi 4.18.7+ - 可选：puppeteer（用于生成图片列表）、server（用于媒体缓存） ### 配置参数 ts { // 基础设置 commandName: "点歌", // 指令名称 apilink: "", // 【必需】MET API 地址 neteaseApiLink: "", // 网易云 API 地址（可选） neteaseCookie: "", // 网易云 Cookie（可选，用于账号态请求） proxyUrl: "", // 代理地址，如 http://127.0.0.1:7890 waitTimeout: 60, // 选择歌曲超时时间（秒） searchLimit: 10, // 搜索返回数量 musicLevel: "RS", // 音质：HQ/SQ/RS/DA/QAI // 列表外观 imageMode: true, // 使用图片列表（需 puppeteer） darkMode: false, // 暗黑模式 cardBorderColor: "#4CAF50", // 卡片边框颜色 // 高级功能 enableMiddleware: true, // 自动解析音乐卡片 enableTextLinkParse: false, // 自动解析文本音乐链接 isFigure: true, // 合并转发形式发送（仅 OneBot） // OneBot 专属 onebotResponseTimeout: 180000, // OneBot 请求超时 onebotDirectUploadThresholdMB: 40, // 大文件远程上传阈值 inlineMediaMaxSizeMB: 8, // 内联发送最大体积 } ## 使用示例 点歌 周杰伦晴天 # 双源搜索，选歌后点播 点歌 -n 1 周杰伦晴天 # 直接选第1首，无需选择 点歌 -163 周杰伦晴天 # 仅用网易云搜索 算了 / 退出 / 不听了 # 退出当前选歌 ## 常见问题 Q: 点歌提示"API 链接未配置"？ > 请在插件配置中填写 apilink（MET API 地址），这是必填项。 Q: 网易云源搜索失败或无版权？ > 确保已配置 neteaseApiLink。部分歌曲网易云可能无版权，可尝试不加 -163 使用双源搜索。 Q: 音频发送提示"需配置国内代理"？ > 音乐直链通常需要国内代理访问，请在配置中填写 proxyUrl（如 http://127.0.0.1:7890）。 Q: 图片列表无法生成？ > 确保已启用 puppeteer 服务。也可关闭 imageMode 使用纯文本列表。 Q: 大文件无法发送？ > 可调大 inlineMediaMaxSizeMB，或配置 OneBot 可访问的 selfUrl / onebotRemoteUploadBaseUrl 实现远程上传。 Q: 如何携带网易云账号态请求？ > 在 neteaseCookie 中填写你的 Cookie（可只填 MUSIC_U=...）。 ## 更新日志 ### v1.6.2 - 下载代理改为共享懒加载，并在初始化失败时自动降级直连，避免下载链路崩溃。 - 完善 fileCache / fileCacheTimers 生命周期管理，补充 dispose 统一清理，避免残留缓存与计时器。 - 修复下载重定向链路的单次结算问题，并新增重定向上限保护，避免异常重定向导致资源耗尽。 - 为下载与待选流程的 timeout 增加 unref 优化，降低进程退出阻塞风险。 - 修复 puppeteer 页面创建失败场景下的 page 判空 close，避免二次异常。 - 增加 retryableSend 边界保护，并对 normalizeMessageIds 做 trim/filter 清洗，提升跨平台消息发送/撤回稳定性。 ### v1.6.1 - 优化大文件上传逻辑 ### v1.6.0 - 新增文本音乐链接解析功能（enableTextLinkParse） - 支持直接解析 music.163.com 和 y.qq.com 链接并返回音频 ### v1.5.0 - 新增 onebotRemoteUploadBaseUrl 配置项 - 优化 OneBot 大文件远程上传策略 ### v1.4.0 - 支持 QAI（AI音质）级别 - 优化合并转发消息格式 ### v1.3.0 - 新增暗黑模式支持 - 支持自定义图片列表边框颜色 ### v1.2.0 - 新增 isFigure 配置，支持以合并转发形式发送歌曲信息 ### v1.1.0 - 支持同群并发点歌 - 同一用户重复点歌自动覆盖待选歌单 ### v1.0.0 - 初始版本 - 支持 MET + 网易云双源搜索 - 支持音乐卡片自动解析 ## 协议 MIT License