A premium UX overlay for Roon Display that provides context for music using DeepSeek, OpenAI, or Gemini.
中文介绍
Roon Display Companion (全能 AI 版) 是一款专为 Roon Display 显示界面（端口 9330）打造的高级增强插件。
Roon 虽然拥有强大的音乐库管理功能，但在“显示（Display）”模式下往往缺乏对乐曲深度的文字介绍。本脚本通过集成顶尖的 AI 模型（DeepSeek、OpenAI 或 Google Gemini），为您当前播放的古典音乐提供实时的深度导赏（注意：您需使用您自己的AI提供商API Key）。
核心功能：
🎵 音乐专属导赏： 自动抓取当前的曲目与艺术家信息，并使用专为古典音乐优化的提示词（Prompt）。AI 将为您深度解析创作背景、历史时期、音乐结构、作曲家生平以及当前演奏版本的特色。
🧠 多模型支持： 您可以自由选择喜欢的 AI 服务商，脚本完美支持：
DeepSeek（深度求索 - 高性价比）
OpenAI (GPT-4o)
Google Gemini (Flash 2.5)
✨ 极致 UI 设计： 采用现代化的“毛玻璃（Glassmorphism）”视觉风格，配以翡翠绿主题色与丝滑的动画效果。悬浮按钮（FAB）设计，既方便唤起又不遮挡封面。
⚡ 智能缓存： 为了节省您的 API 用量并提高加载速度，生成过的乐曲介绍会自动在本地缓存 24 小时。
⚙️ 便捷配置： 内置可视化的设置面板，无需修改代码即可在界面中直接切换 AI 模型或输入 API Key。
使用方法：
在 Tampermonkey 中安装本脚本。
打开您的 Roon Display 网页（例如 http://192.168.1.x:9330/display/）。
点击右下角的悬浮按钮，在弹出的设置框中填入对应的 API Key，即可开启您的古典音乐探索之旅。
English Introduction
Roon Display Companion (Universal AI Edition) is a premium user experience overlay designed specifically for the Roon Display web interface (running on port 9330).
While Roon is excellent at managing libraries, its "Display" mode often lacks deep context for the music playing. This script solves that by integrating powerful AI models (DeepSeek, OpenAI, or Google Gemini) to act as your real-time musicologist.（Your own API Key is needed）
Key Features:
🎵 Classical Music Specialist: Automatically detects the current track and artist, sending a prompt specifically optimized for classical music. It provides insights on the historical background, musical structure, composer details, and performance characteristics.
🧠 Universal AI Support: Choose your preferred AI provider. Full support included for:
DeepSeek AI (Cost-effective and smart)
OpenAI (GPT-4o)
Google Gemini (Flash 2.5)
✨ Premium UI/UX: Features a beautiful "Glassmorphism" design with smooth animations, emerald green accents, and a non-intrusive Floating Action Button (FAB).
⚡ Smart Caching: To save on API costs and reduce loading times, generated content is cached locally for 24 hours.
⚙️ Easy Configuration: Built-in settings menu allows you to switch providers and input API keys directly within the interface without editing code.
How to use:
Install the script in Tampermonkey.
Open your Roon Display URL (e.g., http://192.168.1.x:9330/display/).
Click the floating button on the bottom right to configure your API key and start learning about your music.
