#Provider 能力清单(QQ 音乐 / 网易云)

两个 provider 库的可用接口，按功能类目对照。用于规划 P3+ 差异化功能。

• QQ：QQMusicApi-rs（Python 版 QQMusicApi 的 Rust 实现，模块与方法同名），按 client.<module>().<method> 列。
• NCM：ncm-api-rs，按 endpoint 名列。
• “已实现”表示当前 provider/bridge 已经暴露给前端可用；“provider 已实现”表示 provider 协议命令已接好，UI/Plugin callable 可后续接入；“待暴露”表示底层库有能力，但还需要 provider/bridge/api/UI 胶水。

QQ 播放 URL 调用 client.song().playable_url(...)（bypass 音质阶梯，一次请求问全部档位）；NCM 播放 URL 调用 client.song_url_v1(&query)。两库都是“一个方法 / endpoint = 一个官方 API”，provider 只负责包协议。

#搜索 Search

#歌曲 / 播放 URL Song

• QQ (song)：get_song_urls（已实现）、get_detail、query_song、get_similar_song、get_other_version、get_related_mv、get_related_songlist、get_producer、get_labels、get_sheet / has_sheet、get_fav_num、get_cdn_dispatch。
• NCM：song_url_v1（已实现）、song_url / song_url_v1_302、song_detail、song_music_detail、song_download_url / song_download_url_v1、song_dynamic_cover、song_chorus、song_wiki_summary、song_like / song_like_check、check_music、song_purchased。

#歌词 Lyric

• QQ (lyric)：get_lyric（已实现逐行 + 翻译；罗马音、QRC 逐字待接）。
• NCM：lyric_new（已实现逐字 YRC / 逐行 LRC + 翻译；罗马音待接）、lyric、cloud_lyric_get。
• 两端归一化规则一致（时间标签变体、间奏标记与 end_ms、译文就近对齐、内嵌译文合并），两个后端共用 provider/src/lyric/parse.rs，规则见其文件头。

#歌单 Playlist

• QQ (songlist)：get_detail（已实现）、create、delete、add_songs（provider 已实现）、del_songs（provider 已实现）。
• NCM (playlist_*)：playlist_detail（已实现）、playlist_track_all / playlist_tracks、playlist_create / playlist_delete / playlist_update、playlist_track_add（provider 已实现）、playlist_track_delete、playlist_subscribe、playlist_catlist、playlist_hot、playlist_highquality_tags、playlist_mylike 等。

#专辑 Album

• QQ (album)：get_detail / get_song（provider 已实现）。
• NCM (album_*)：album / album_detail（provider 已实现）、album_detail_dynamic、album_list / album_list_style、album_new / album_newest、album_sub / album_sublist、album_privilege、数字专辑相关接口。

#歌手 Artist

• QQ (singer)：get_info / get_tab_detail（provider 已实现）、get_desc、get_songs_list、get_album_list、get_mv_list、get_similar、get_singer_list。
• NCM (artist_*)：artist_detail（provider 已实现）、artist_desc、artist_songs / artist_top_song、artist_album、artist_mv、artist_video、artist_sub、artist_list、simi_artist 等。

#榜单 Top / Toplist

• QQ (top)：get_category、get_detail。
• NCM：toplist / toplist_detail、top_song、top_album、top_artists、top_mv、top_playlist 等。

#推荐 / 个性化 Recommend

• QQ (recommend)：get_recommend_songlist / get_recommend_newsong（已实现）、get_guess_recommend / get_radar_recommend（provider 已实现）、get_home_feed。
• NCM：recommend_songs（已实现）、recommend_resource、personalized（已实现发现页歌单）、personalized_newsong、personal_fm（provider 已实现）、personal_fm_mode、history_recommend_songs、aidj_content_rcmd。

#登录 Login

• QQ (login)：get_qrcode（已实现）、check_qrcode（已实现）、checking_mobile_qrcode、refresh_credential、check_expired、logout、手机号相关接口。
• NCM：login_qr_key（已实现）、login_qr_create（已实现）、login_qr_check（已实现）、login_refresh、login_status、logout、手机号 / captcha 相关接口。

#用户 User

• QQ (user)：get_homepage / get_vip_info（已实现）、get_created_songlist / get_fav_song / get_fav_songlist（provider 已实现）、get_fav_album / get_fav_mv、fav_songlist / unfav_songlist、get_follow_singers、get_music_gene、add_dislike。
• NCM (user_*)：user_account / user_detail（已实现账号信息）、user_subcount / likelist / user_playlist / user_record / user_cloud（provider 已实现）、like / fm_trash（provider 已实现）等。

#评论 Comment

• QQ (comment)：get_hot_comments、get_new_comments、get_recommend_comments、get_comment_count、add_comment / delete_comment。
• NCM (comment_*)：comment_music / comment_album / comment_playlist / comment_like（provider 已实现）、comment_hot、comment_new 等。

#P3 UI 数据覆盖

#QQ

#NCM

#当前用到 vs 可扩展

能力不强求对齐。两个 provider 各按自身 API 铺特色；bridge 只要求它们对同一套协议应答。