常见问题

从没有声音、找不到文件到歌词与连接排查。

Windows · WinUI 预览版

从没有声音、找不到文件到歌词与连接排查。

页面说明

常见问题 是 OFPlayer 本地优先音乐工作流的一部分。这个页面会先说明功能边界、适用场景和下一步入口，再交给网页播放器或工具页面完成具体操作。

OFPlayer 面向有个人音乐收藏的用户，重点放在本地文件播放、WebDAV 与 Subsonic/Navidrome 音乐库连接、歌词和音频工具、隐私优先的数据处理，以及足够克制的桌面式界面。

如果你只是想试用，可以从网页版开始导入本地音频；如果已经有 NAS、服务器或远程曲库，可以继续阅读教程，把 OpenList、WebDAV 或 Navidrome 接到同一套播放体验里。

页面内容会尽量说明真实可用的能力，不把尚未完成的方向包装成已经上线的功能。遇到部署、连接或格式问题时，可以顺着相关文档和工具逐步检查，而不是在播放器里反复猜配置。

对于搜索、分享或禁用脚本的访问场景，这份静态内容也会保留核心信息：页面主题、产品边界、相关入口和下一步操作都能被直接读取，不依赖前端应用完成后才出现。

每个入口都会尽量连接到相邻的说明页，避免只留下单点页面，内容也会随着产品发布持续更新。

从这里可以继续访问 OFPlayer 文档、下载与版本、GitHub。这些内部入口覆盖产品介绍、教程、文档、下载和实际工具，方便从了解能力一路走到部署、整理曲库和开始播放。

常见问题

先确认版本、当前来源和错误提示。不要在没有备份的情况下用重置全部数据处理局部问题。

导入后找不到歌曲

确认左上角选中的是目标曲库，在 全部歌曲或 最近导入中查找，清除搜索和格式筛选。导入仍在运行时，等待进度结束并查看失败提示。

曲目还在，但提示文件缺失

封面和曲目记录存在，不代表原音频仍在原位置。检查移动硬盘、网络目录及文件名；文件已移动时，从新位置重新导入并核对。

播放没有声音

先看进度是否前进，再检查播放器音量、Windows 音量和播放栏中的输出设备。换一首已确认存在的本地歌曲；若只有远端歌曲失败，再检查远端连接。设备拔出、蓝牙切换和睡眠恢复后，也需要重新核对输出。

专辑分组不符合预期

专辑、艺术家和封面来自音乐元数据。先在曲目详情核对标签；同一张专辑名称拼写不同，可能产生不同分组。当前没有在专辑网格中编辑自定义分组封面的操作。

歌词或胶囊不显示

确认当前曲目及歌词绑定，使用 重新解析歌词，或检查歌词查找目录。胶囊从底部播放栏的 更多操作 → 歌词胶囊开关。无歌词的音频只显示曲目信息是正常情况。

手机已连接但不能点歌

配对后还需要成功同步曲库。同步完成后重新选择歌曲；若电脑重启或切换预览目录，核对服务是否运行以及设备记录是否属于同一个桌面数据目录。详见手机接力。

远端只能看到部分歌曲

先确认服务返回的曲库和目录，再尝试 加载更多。当前实现存在 5000 条的上限，不能靠重复点击突破；详见远端音乐来源。

界面和文档不同

查看窗口和 设置 → 关于的版本信息。WinUI 预览版、Tauri 桌面版与网页版的入口不同；下载到旧版不代表文档中的原生功能已经在该版本提供。

反馈问题时提供什么

记录版本、Windows 版本、操作步骤、预期结果、实际结果以及是否稳定复现。截图保留错误文字，避免包含配对码、服务器密码或个人目录。诊断入口在 设置 → 隐私，上传前会单独确认。