AstrBot Discogs 音乐与黑胶查询插件

基于 Discogs 庞大数据库的 AstrBot 插件，支持快速检索全球音乐发行信息，并实时查询黑胶唱片的二手市场底价。

✨ 核心功能

• 音乐元数据检索：快速获取专辑的发行年份、流派、艺术家信息及 Discogs 详情链接。
• 黑胶市场查价：精准锁定黑胶唱片版本，实时获取 Discogs 市场上的在售数量与最低起售价（USD）。
• 高级维度过滤：支持基于艺术家、发行年份、流派等维度的精准条件筛选。

---

⚙️ 安装与配置

本插件依赖 Discogs 官方的 API Token。如果不配置 Token，核心的搜索与查价功能将无法使用。

获取 Discogs Token

1. 注册并登录 Discogs 官网。
2. 点击右上角头像进入 Settings (设置) -> 左侧菜单选择 Developers (开发者)。
3. 点击 Generate new token 生成 Personal Access Token。
4. 复制生成的那串字符备用。

配置到 AstrBot

1. 在 AstrBot 的 WebUI 管理面板中找到本插件。
2. 在插件设置中找到 discogs_token 配置项。
3. 将刚才复制的 Token 粘贴进去并保存设置。
4. 重启 AstrBot 或重载插件即可生效。

---

💬 指令用法

1. 音乐查询

• 指令: /音乐 <关键词>
• 说明: 搜索音乐核心库，返回最匹配的专辑或单曲信息。
• 示例:
  • /音乐 狂人日记
  • /音乐 Nevermind

2. 黑胶价格查询

• 指令: /黑胶价格 <关键词>
• 说明: 强制检索黑胶格式 (Vinyl)，并返回当前 Discogs 交易市场的在售库存和最低美元报价。
• 示例:
  • /黑胶价格 愿爱无忧
  • /黑胶价格 The Dark Side Of The Moon

---

🔍 高级搜索语法

本插件支持 Discogs 的高级搜索维度过滤。你可以通过 维度:值 的格式来缩小搜索范围，精确定位目标。

支持的常用维度：

• artist: 艺术家名称
• year: 发行年份
• genre: 流派 (如 rock, electronic)
• style: 风格 (如 synth-pop)
• label: 发行厂牌

高级搜索示例：

• /音乐 artist:Nirvana year:1991 （查找 Nirvana 在 1991 年发行的作品）
• /黑胶价格 genre:jazz year:1959 （查找 1959 年发行的爵士乐黑胶）

💡 小贴士：如何处理带空格的词？

如果你的搜索词或维度值包含空格，请务必使用双引号将其包裹，否则解析器会将其截断。

• ✅ 正确: /音乐 artist:"Pink Floyd" year:1973
• ❌ 错误: /音乐 artist:Pink Floyd year:1973

---

📄 许可证

本项目采用 AGPL-3.0 License 开源协议 - 详见 LICENSE 文件。

---

如果您发现这个插件对您有所帮助，请给一个 ⭐ Star 以示支持！