SuperAPI AI 工具集

hifi-download-skill

通用与其它

查看项目

更新于 10-16 14:54

技能介绍

MusicMaster 是一套面向音乐发现与高保真音频下载的命令行技能,来源为 psylch/media-master。它把音乐发现服务(Spotify、Last.fm)与高保真下载服务(Qobuz、TIDAL)整合到统一的 CLI 中,便于在终端或自动化流程里检索音乐并下载高质量音频。

用途 音乐发现:搜索曲目、专辑、艺人,获取相似艺人、相似曲目以及基于听歌历史的品味画像,并可将发现结果与下载流程衔接。 音频下载:在 Qobuz 或 TIDAL 平台目录中检索目标专辑或曲目,并按配置的音质下载(Qobuz 27=Hi-Res 24-bit 为最高,TIDAL HiFi=无损)。

主要能力 所有命令均通过 bash ${SKILL_PATH}/run.sh <script> [args...] 执行,该入口会激活虚拟环境并运行对应的 Python 脚本。输出默认为人类可读格式;在支持的脚本上可使用 --json 获取结构化输出。 发现命令包括:lastfm_artists(返回带匹配分的相似艺人)、lastfm_tracks(参数为曲目名与艺人名)、lastfm_taste(返回听歌历史中的热门艺人与曲目)、spotify_search(搜索 Spotify 目录中的曲目、专辑与艺人)、spotify_user(获取已保存曲目或关注艺人,需要 OAuth)、spotify_info(通过 Spotify URI 或 ID 查询曲目/专辑信息)。 下载命令包括:platform_search(在指定平台目录中搜索并返回供下载使用的 ID,用 -p 指定 qobuz 或 tidal)、platform_download(通过 ID 下载音频,用 -t 指定 album 或 track)。 服务管理命令包括 disable_service 与 enable_service,用于禁用或重新启用某项服务。

使用方式 首次设置分四步。第一步检查依赖:bash ${SKILL_PATH}/scripts/setup.sh check,输出为 key=value 形式,若 VENV=missing 需先安装。第二步安装:bash ${SKILL_PATH}/scripts/setup.sh install [--with-qobuz] [--with-tidal],会创建 .venv、安装核心依赖(spotipy、pylast、requests、python-dotenv),并可选择性安装下载后端。第三步配置凭证:不要在聊天中向用户索要凭证,而是从模板创建 .env(cp ${SKILL_PATH}/.env.example ${SKILL_PATH}/.env),让用户自行填写凭证,确认后再验证;也可使用配置脚本 bash ${SKILL_PATH}/run.sh setup_config --lastfm-key=KEY [--spotify-id=ID --spotify-secret=SECRET] [--qobuz-email=EMAIL --qobuz-password=PASS]。凭证获取地址:Spotify 为 https://developer.spotify.com/dashboard(免费),Last.fm 为 https://www.last.fm/api/account/create(免费),Qobuz 需要 Studio/Sublime 订阅,TIDAL 则需在 venv 中运行 tiddl auth login 进行 OAuth。第四步验证:bash ${SKILL_PATH}/run.sh status,查看各服务处于 READY、DISABLED 还是需要设置,仅使用标记为 READY 的服务。 典型工作流一是音乐发现:先运行 status 确认可用服务,再用 lastfm_artists 或 lastfm_tracks 寻找相似音乐,用 spotify_search 查询具体曲目/专辑,以清晰的表格向用户展示结果;如需下载,则按 platform_search → platform_download 的顺序执行。工作流二是下载高保真音频:先运行 status 确认下载服务为 READY,用 platform_search "Album Name" -p qobuz 搜索并展示含音质信息的结果,再用 platform_download ID -p qobuz -t album 下载,最后向用户报告下载路径与文件大小。

适用场景 适合希望在命令行中完成音乐检索、推荐与高保真下载的用户,例如按听歌历史发现新音乐、查找相似艺人,或从 Qobuz/TIDAL 获取无损与 Hi-Res 音频。也可作为自动化脚本中的一环,利用 --json 输出对接其他流程。

限制与注意事项 Spotify 首次使用需要 OAuth 浏览器流程,由 spotify_auth 脚本处理;OAuth 过期时运行 bash ${SKILL_PATH}/run.sh spotify_auth 重新授权。TIDAL 的认证由 tiddl CLI 工具管理,不存储在 .env 中,token 过期可运行 tiddl auth refresh 或 tiddl auth login。Qobuz 凭证存储在 .env 中,属于敏感信息,需确保该文件被加入 .gitignore。下载路径默认分别为 ~/Music/Qobuz 与 ~/Music/TIDAL。若虚拟环境缺失,run.sh 会以 venv_missing 退出,需运行 setup.sh install;若某服务显示 NOT CONFIGURED,需引导用户编辑 .env 或运行 setup_config;搜索无结果时可尝试不同关键词或检查服务可用性。关于价格、具体文件规格细节、支持平台以外的服务或更多未在资料中说明的功能,本资料暂未提供。