音搜音乐播放器V2.5.10 手机版

编辑点评：专为统信UOS优化的音乐播放器

音搜app音乐播放器是基于PyQt5和python-vlc开发的跨平台音乐播放器，针对统信UOS系统做专项优化，集成在线音乐检索、本地音频播放、界面主题切换等功能，开源项目托管在Gitee平台。

音搜app使用说明

1、在顶部搜索框输入歌曲名、歌手或专辑。

2、点击 “搜索” 按钮，下方列表显示结果。

3、双击任意歌曲即可播放。

4、也可点击 “明星” 按钮，从预置列表中选择歌手一键搜索（需先切换到33ve源）。

操作说明

底部控制栏：上一首、播放/暂停、下一首、音量滑块。

播放列表：双击播放列表中的歌曲直接播放；右键菜单可删除选中或清空列表。

播放模式：当前仅支持顺序播放，循环/随机模式计划中。

本地文件播放

点击“文件”→“打开本地文件”，选择音频文件后自动添加到播放列表并播放。

自定义API地址

若自行部署了 NeteaseCloudMusicApi，可在“工具”→“设置 API 地址”中填写 http://your-server:port。

常见问题

1.搜索无结果或提示“网络连接错误”

原因：API 服务未启动或地址错误。

解决：启动本地 API（node app.js &），或在“工具”中修改 API 地址为 http://localhost:3000。

2.无法播放某些歌曲（无声音或报错）

原因：部分歌曲版权限制或 API 返回的 URL 无效。

解决：尝试播放其他歌曲；自部署最新版 NeteaseCloudMusicApi 可提高成功率。

3.搜索框打不出中文 / 中文关键词搜不到

原因：Qt 程序能不能打中文，取决于「运行时的 Qt 版本」和「输入法前端插件的 Qt 版本」是否一致。 例如 pip 安装的 PyQt5 自带 Qt 5.15，而系统里的 fcitx 前端（libfcitxplatforminputcontextplugin.so） 是按系统 Qt 5.11 编译的 —— 两者版本不一致时，插件要么加载不上（打不出中文）， 要么强行加载后 Qt 直接报 Cannot mix incompatible Qt library (5.11.3) with this library (5.15.19) 并崩溃。

解决：程序启动时会自动比对版本并处理（见 common/im_env.py）： 若当前 PyQt5 与系统输入法前端版本不匹配，会自动把 PyQt5/sip 定向切换到 deb 依赖的那份系统 PyQt5（只动这两个包，不影响 requests / vlc 等依赖）， 并设置好 QT_IM_MODULE / XMODIFIERS。 自查命令：python3 main.py --check-ime

输出里会写明运行时 Qt 版本、检测到的输入法前端及其 Qt 版本、最终选用的 QT_IM_MODULE。 如果显示「没有与运行时 Qt 兼容的输入法前端」，按提示安装对应前端包 （如 sudo apt install fcitx-frontend-qt5）。

补充：另外两点也已处理 —— 输入法组合中按回车不会被当成「搜索」提前触发； 关键词里的全角空格（U+3000）、全角字母数字和零宽字符会自动规范化。

临时关闭自动配置：export NETMUSICPLAYER_NO_IME=1

4.点击歌手后提示「爬取失败: No module named 'cloudscraper'」或「获取 0 首歌曲」

原因：这个现象背后叠了三层问题，任何一层没处理都拿不到数据：

依赖缺失：cloudscraper 以前既没装在环境里、也没写进 requirements.txt， 导入爬虫模块时直接抛 ModuleNotFoundError；同类漏装的还有 fake-useragent、tqdm。

站点加了人机验证：33ve 在页面之前插了一层「安全人机验证」（带 csrf_token 的复选框表单）。 它不是 Cloudflare，没有 JS 挑战，所以 cloudscraper 的绕过能力对它完全无效； 真正需要的是「同一个 Session 先 GET 拿 token、再 POST 提交」。

解析函数是空实现：crawler/crawl_songs.py 里的 parse_songs_from_singer_page() 与 find_max_page_for_singer() 原本只有占位注释和 return 1，即使前两层都过了也只会返回 0 首。

解决：三点已一并修复，并新增 crawler/site_session.py 作为统一会话网关：

自动识别并提交人机验证，验证状态按 Cookie 缓存（约 1 小时），后续点击不再重复验证；

cloudscraper 缺失时自动降级为 requests.Session，不会再让 ModuleNotFoundError 冒到状态栏；

分页改为「逐页抓取 + 遇到空页即停 + 按 id 去重」（站点分页区会显示比实际更大的页码，不可信）；

爬取结果自动并入本地歌曲库（~/.music_search_data/songs_33ve.json）， 否则爬到的歌只在当次列表里，回到搜索框依然搜不到；

只有真抓到歌曲才写 last_crawl，避免一次失败在 28 天缓存期内被当成「已爬过」而永久跳过。

装依赖：

pip3 install --user -r requirements.txt

5.歌曲能列出来，但点播放没声音 / 提示「无法获取播放地址」

原因：库里存的是下载入口 https://www.33ve.com/plug/down.php?ac=music&id=...。 该入口同样受人机验证保护——裸请求返回 403；通过验证后才会 302 跳到酷狗的真实音频直链 （sharefs.tx.kugou.com/...）。直接把入口 URL 交给 VLC 是拿不到声音的。

解决：播放/下载前会用已验证的会话实时换取直链（见 CrawlerSource.resolve_play_url()）。 目标直链带时效签名、数小时后失效，因此只用于播放、不写回数据库；但会做 5 分钟的短时复用 （见 CrawlerSource.DIRECT_URL_TTL_SECONDS），暂停后继续、切回上一首都不会再请求站点。

5b.提示「站点下载次数已达上限，请稍后重试」

原因：33ve 对 down.php 有按 IP 的下载限次。实测（2026-09-22）：

连续解析 3~4 条不同歌曲就会触发；

超限时站点不返回 403/429，而是回 HTTP 200 + 一段 JS： alert('您的下载次数已用完！') —— 只看状态码完全识别不出来；

限次按 IP 计，与 Cookie 无关（清空 Cookie 换新会话照样被拦）；

恢复窗口很长且反复请求会续期：连续探测 8 分钟仍未恢复， 完全静默约 13 分钟后才解除。

解决：

程序会准确识别这类页面（site_session.is_quota_page()）并单独上报 DownloadQuotaExceeded，提示你「稍后重试」——而不再是一句与真实原因无关的 「无法获取播放地址」；

判定顺序上配额优先于 403，避免被当成「未验证」白跑一轮验证；

配合上面的 5 分钟直链复用，重复播放不会消耗配额。

建议：出现该提示后停手十几分钟再试（实测：静默 7 分钟仍被限， 且限次只锁 down.php 这一个接口——同一时间站点首页仍可正常访问，说明不是整站封 IP）。 越是反复点击，恢复得越慢。

6.桌面歌词窗口关闭后无法再打开

说明：桌面歌词功能尚未实现，此按钮仅为预留占位。

7.单实例检测导致无法启动第二个窗口

说明：本程序设计为单实例，如需多开，请注释 main.py 中的 single_instance_check() 调用。

8.高 DPI 下界面文字模糊

解决：main.py 已启用高 DPI 支持 (AA_EnableHighDpiScaling)。如果仍模糊，请调整系统缩放设置。

音搜app使用技巧

在统信UOS系统使用时，优先确认系统依赖库是否完整，缺失依赖会导致播放器无法启动。

批量导入本地音乐时，可以直接选择整个音乐文件夹，一次性添加多首曲目。

更换主题后若界面显示异常，重启软件即可生效。

在线搜歌时尽量使用准确歌名，提升检索匹配成功率。

音搜app核心功能

1、在线音乐搜索，输入歌名检索对应音频资源，支持在线试听播放。

2、本地音频播放，加载本地文件夹内音乐，支持常见音频格式解码。

3、界面主题切换，更换播放器外观主题，自定义视觉显示效果。

4、播放列表管理，新增、删除歌曲，调整播放顺序，循环播放控制。

音搜app无法播放音乐怎么解决

1、检查系统是否安装vlc相关依赖，缺少解码组件会造成音频无法播放。

2、在线播放确认网络正常，网络中断会导致在线音频加载失败。

3、本地音乐确认文件没有损坏，更换音频文件测试播放器解码能力。

适用人群/使用场景

1、统信UOS国产系统用户，需要一款可用的音乐播放软件。

2、开源爱好者、Python开发者，需要查看播放器源码学习PyQt5开发。

3、电脑音乐爱好者，同时需要在线搜歌与本地音乐播放工具。

4、追求轻量播放器，不想安装体积庞大音乐客户端的电脑用户。