feat: add xcvts_api

Co-authored-by: Copilot <copilot@github.com>

Author: xxynet

.gitignore

@@ -6,4 +6,6 @@ build/
 venv/
 Thumbs.db
 .env
-main.spec
+main.spec
+cookie.txt
+/music/

api.py

@@ -143,6 +143,102 @@ def get_song_info(self, song_id, quality=4):
             return None
 
 
+class XcvtsApi:
+    """小尘API - 波点音乐点歌接口，作为备用音源"""
+
+    def __init__(self):
+        self.desc = "小尘API(波点音乐)"
+        self.base_url = "https://api.xcvts.cn/api/music/bdyy"
+        self.default_quality = "320kmp3"
+
+    def search_and_get_url(self, keyword, quality=None):
+        """
+        通过关键词搜索歌曲并获取音频URL
+
+        参数:
+            keyword: 搜索关键词（歌名/歌手名）
+            quality: 音质，可选值: 20201kmflac, 2000kflac, 320kmp3, 128kmp3, 48kaac, 192kogg, 100kogg
+        返回:
+            dict: {'name', 'artist', 'cover', 'play_url', 'lrc'} 或 None
+        """
+        params = {
+            'msg': keyword,
+            'n': 1,
+            'type': 'json',
+        }
+        if quality:
+            params['br'] = quality
+        else:
+            params['br'] = self.default_quality
+
+        try:
+            response = requests.get(self.base_url, params=params, timeout=15)
+            response.raise_for_status()
+            data = response.json()
+
+            if data.get('code') != 200:
+                print(f"小尘API错误: {data}")
+                return None
+
+            song_data = data.get('data')
+            if not song_data or not song_data.get('play_url'):
+                print("小尘API: 未获取到有效的音频URL")
+                return None
+
+            return song_data
+
+        except requests.exceptions.RequestException as e:
+            print(f"小尘API请求失败: {e}")
+            return None
+
+    def get_lyrics(self, keyword):
+        """
+        通过关键词获取歌词
+
+        参数:
+            keyword: 搜索关键词
+        返回:
+            str: 歌词文本，失败返回 None
+        """
+        params = {
+            'msg': keyword,
+            'n': 1,
+            'type': 'lyric',
+        }
+        try:
+            response = requests.get(self.base_url, params=params, timeout=15)
+            response.raise_for_status()
+            return response.text
+        except requests.exceptions.RequestException as e:
+            print(f"小尘API歌词请求失败: {e}")
+            return None
+
+    def get_mp3_data(self, keyword, quality=None):
+        """
+        通过关键词搜索并下载音频数据
+
+        参数:
+            keyword: 搜索关键词
+            quality: 音质
+        返回:
+            tuple: (is_success, audio_response, song_data_or_none)
+        """
+        song_data = self.search_and_get_url(keyword, quality)
+        if not song_data:
+            return False, None, None
+
+        audio_url = song_data.get('play_url')
+        try:
+            audio_response = requests.get(audio_url, timeout=30)
+            content_type = audio_response.headers.get('Content-Type', '')
+            if 'text/html' in content_type or audio_response.status_code != 200:
+                return False, None, None
+            return True, audio_response, song_data
+        except requests.exceptions.RequestException as e:
+            print(f"小尘API下载失败: {e}")
+            return False, None, None
+
+
 if __name__ == '__main__':
     api = NCMApi()
     # playlist_id = input("Playlist id: ")

config.ini

@@ -1,6 +1,6 @@
 [output]
 
-#设置歌单输出路径，如果为空则默认为程序所在目录（路径无需引号包裹）
+#设置歌单输出路径，如果为空则默认为程序所在目录的music目录下（路径无需引号包裹）
 path = 
 
 #默认ncm文件查找路径
@@ -10,7 +10,7 @@ ncm_path = E:/CloudMusic/VipSongsDownload
 filename = 0
 
 #是否下载歌词 1 -> 下载LRC歌词文件  2 -> 内嵌歌词  0 -> False
-lrc = 0
+lrc = 1
 
 [settings]
 
@@ -20,4 +20,11 @@ detect-update = 1
 [v_key_api]
 
 # 是否在下载歌曲失败时尝试使用第三方API下载，设置为 true 启用
-enabled = false
+enabled = true
+
+[xcvts_api]
+
+# 是否在下载歌曲失败时尝试使用小尘API(波点音乐)下载，设置为 true 启用
+# 音质选项: 20201kmflac, 2000kflac, 320kmp3, 128kmp3, 48kaac, 192kogg, 100kogg
+enabled = true
+quality = 320kmp3

config.py

@@ -1,10 +1,10 @@
 import configparser
 
-VERSION = 'v2.6.0'
+VERSION = 'v2.7.0'
 
 config_file = '''[output]
 
-#设置歌单输出路径，如果为空则默认为程序所在目录（路径无需引号包裹）
+#设置歌单输出路径，如果为空则默认为程序所在目录的music目录下（路径无需引号包裹）
 path = 
 
 #默认ncm文件查找路径
@@ -25,4 +25,11 @@
 
 # 是否在下载歌曲失败时尝试使用第三方API下载，设置为 true 启用
 enabled = false
+
+[xcvts_api]
+
+# 是否在下载歌曲失败时尝试使用小尘API(波点音乐)下载，设置为 true 启用
+# 音质选项: 20201kmflac, 2000kflac, 320kmp3, 128kmp3, 48kaac, 192kogg, 100kogg
+enabled = false
+quality = 320kmp3
 '''

cookie.txt

@@ -3,7 +3,7 @@
 
 # 请打开config.ini配置文件配置相应信息
 
-# pyinstaller -F main.py -i music.ico
+# pyinstaller main.spec
 
 from rich.panel import Panel
 from rich.table import Table
@@ -12,7 +12,7 @@
 import metadata
 
 from utils import *
-from api import NCMApi, VKeyApi
+from api import NCMApi, VKeyApi, XcvtsApi
 from ncmdump import dump as dump_ncm
 
 proj_logo = r"""
@@ -79,7 +79,7 @@ def _download_audio(self):
 
             # vkey api
             if global_config.v_key_enabled:
-                formatted_print('i', "尝试使用第三方API解析...")
+                formatted_print('i', "尝试使用落月API解析...")
                 song_info = v_key_api.get_song_info(self.song_id)
                 if song_info:
                     audio_url = song_info.get('url')
@@ -91,6 +91,25 @@ def _download_audio(self):
                     # download lyrics
                     self._download_lyrics()
 
+            # xcvts api (小尘API - 波点音乐)
+            if not self.success and global_config.xcvts_enabled:
+                formatted_print('i', "尝试使用小尘API(波点音乐)解析...")
+                keyword = f"{self.name} - {self.artists_str}"
+                success, audio_resp, song_data = xcvts_api.get_mp3_data(keyword, global_config.xcvts_quality)
+                if success and audio_resp:
+                    with open(f"{self.full_path}.mp3", "wb") as file:
+                        file.write(audio_resp.content)
+                    self.success = True
+                    # 尝试从 xcvts 获取歌词（如果官方歌词未获取到）
+                    if global_config.lrc_enabled != "0" and (not self.olrc or self.olrc.strip() == ''):
+                        try:
+                            xcvts_lrc = xcvts_api.get_lyrics(keyword)
+                            if xcvts_lrc:
+                                self.olrc = xcvts_lrc
+                        except Exception:
+                            pass
+                    self._download_lyrics()
+
     def _download_lyrics(self):
         if global_config.lrc_enabled == '1':
             merged_lrc = metadata.merge_lrc(self.olrc, self.tlrc)
@@ -119,7 +138,7 @@ def download(self):
 
 class Playlist:
 
-    def __init__(self, playlist_id, download_path):
+    def __init__(self, playlist_id: int, download_path: str):
         self.playlist_id: int = playlist_id
         self.download_path: str = download_path
         self.playlist_name: str
@@ -331,6 +350,7 @@ def main():
 
     api = NCMApi(global_config.cookie)
     v_key_api = VKeyApi()
+    xcvts_api = XcvtsApi()
 
     try:
         main()

main.py

@@ -95,6 +95,9 @@ def __init__(self):
 
         self.v_key_enabled: Union[bool, None] = None
 
+        self.xcvts_enabled: Union[bool, None] = None
+        self.xcvts_quality: Union[str, None] = None
+
         self._check_config_file()
         self._get_config()
 
@@ -126,7 +129,7 @@ def _get_config(self):
             config.read('config.ini', encoding='utf-8')
             path = config.get('output', 'path')
             if path == '':
-                self.music_path = os.getcwd()
+                self.music_path = f"{os.getcwd()}/music"
 
             self.ncm_path = config.get('output', 'ncm_path')
 
@@ -138,6 +141,9 @@ def _get_config(self):
 
             self.v_key_enabled = True if config.get('v_key_api', 'enabled') == "true" else False
 
+            self.xcvts_enabled = True if config.get('xcvts_api', 'enabled') == "true" else False
+            self.xcvts_quality = config.get('xcvts_api', 'quality')
+
             with open("cookie.txt", "r") as cookie_file:
                 self.cookie = cookie_file.read().strip()