常见问题

风琳Player 是一款面向 HarmonyOS 的 NAS 音乐播放器，主要用于连接您自己的群晖 NAS / Audio Station，播放您自己 NAS 中的音乐文件。

它更像一个「连接和播放工具」，不是音乐内容平台。

不提供。风琳Player 不内置、不分发、不售卖任何音乐内容，也不提供在线曲库搜索。

所有音乐均来自用户自行拥有或管理的 NAS。请确保您对相关音频文件拥有合法使用权限。

• 一台可以访问的群晖 NAS；
• DSM 中已安装并启用 Audio Station；
• 一个可以访问 Audio Station 的 DSM 本机账号；
• 手机 / 平板可以通过局域网、域名或 QuickConnect 访问 NAS。

风琳Player 面向 HarmonyOS 6 设计，建议使用 HarmonyOS 6.0.2 及以上版本。

系统版本较低时，不影响主要播放、收藏、队列、歌词、缓存、离线下载等核心功能，但部分系统级视觉效果可能无法完全呈现。

宣传图中的「沉浸光感播控」依赖 HarmonyOS 6.1.0 及以上系统能力。较低系统版本会自动回退为普通磨砂胶囊样式。

这只是视觉效果差异，不影响播放、切歌、收藏、队列、歌词等功能。

支持。风琳Player 会根据窗口宽度自动切换布局：

• 手机 / 折叠屏合上时：使用底部 Tab + 顶部标题栏 + 浮动 MiniPlayer；
• 平板 / 折叠屏展开时：自动切换为左右分栏布局，左侧为导航，右侧为内容区。

折叠手机开合、平板拖窗、旋屏时，布局会跟随窗口宽度变化。

建议使用 DSM 7.x 及以上版本。当前开发与兼容性验证主要以 DSM 7.2 为准。

DSM 6.x 未做专门兼容性验证，套件和接口可能与 DSM 7.x 存在差异；如果遇到异常，建议优先升级 DSM 后再试。

风琳Player 支持局域网 IP、自定义域名和 QuickConnect ID 三种方式。

用户名请填写 DSM 本机账号，不是 Synology Account 邮箱。如果该账号开启了二步验证，登录时会要求输入动态验证码。

登录失败通常分为两类：一类是网络层问题，另一类是 DSM 认证或权限问题。

仍解决不了时，请截图错误提示，并按本页面底部的反馈格式提交。

不会。清理缓存只会删除手机 / 平板本机应用目录中的缓存文件，不会修改或删除群晖 NAS 上的音乐源文件和图片源文件。

应用会合计封面缓存、临时播放流和离线下载的占用。超过设置的缓存上限时，会按文件修改时间从旧到新删除，离线下载也可能被清理。需要保留文件时，请留意剩余空间和缓存上限。

如果您选择「无限制」，应用不会因为缓存上限自动删除缓存文件。

「本地歌曲」来自完整临时播放流的索引，不会直接扫描手机文件夹，也不包含独立离线下载目录中的文件。播放过但尚未完整缓存的歌曲不会出现在这里。

如果缓存被自动清理，或您手动清空缓存，对应条目也可能从本地歌曲中消失。

如果该音频文件属于您自己拥有版权或已获得合法授权的内容，可以通过系统分享面板导出或分享。

请勿通过本功能传播未经授权的音乐内容。风琳Player 不提供音乐资源，也不会判断或授予任何音乐文件的版权许可；用户需自行确保分享行为合法合规。

「开启无损音质」控制的是：在普通非整轨歌曲上，尽量让 NAS 按原始或较高码率方式取流，而不是先统一转成 MP3。

整碟 / 多轨连播类曲目可能由群晖服务器规则固定为转码，与该开关无关。

不会。会员和非会员共用同一套「开启无损音质」规则。您在设置里手动选择后，会以您的选择为准。

如果您从未手动改过这一项，首次默认值可能会根据当时是否为有效会员略有不同：非会员默认偏省流量，会员默认偏音质。

会员主要面向更完整、更省心的使用体验，例如：

• 非 Wi‑Fi 自动转码：在蜂窝网络下无本地缓存时，可自动让 NAS 转码以节省流量；
• Wi‑Fi 下自动缓存常听歌曲：在合适时机自动缓存常听歌曲，减少重复拉流；
• 睡眠模式等增强功能。

基础连接 NAS 和播放能力不受影响。

这是会员增强功能，默认关闭。开启后，当设备使用蜂窝数据等非 Wi‑Fi 网络，且本机没有该歌曲的原始缓存时，应用会尽量让 NAS 转码为更省流量的音频再播放。

如果本机已有可用缓存，会优先使用本地缓存，不会因为网络切换就重复下载。

这是会员增强功能。开启后，应用会在 Wi‑Fi 或有线网络下，根据本机播放统计，选择您更常听的歌曲进行缓存。

该任务会尽量避开正在播放、等待首帧或网络缓冲等时机，降低对当前播放体验和 NAS 的影响。

首页的「最常播放」和「最近播放」来自本机记录，按 NAS 地址与账号分别保存。可在设置里调整有效播放门槛，或清除历史。

「与 NAS 同步播放历史」为可选开关。开启后会合并 NAS 记录并上传本机历史；需保存 DSM 密码，供会话过期后自动重新登录。历史同步不等同于跨设备实时接续播放。

「获取在线歌词」是总开关。关闭后，不再走在线歌词或在线歌词缓存链路。

当「获取在线歌词」打开时，如果「优先使用内嵌歌词」也打开，应用会优先尝试从本地音频文件中读取内嵌歌词；没有内嵌歌词时，再尝试本机歌词缓存或 NAS 拉取。

用于微调歌词高亮和实际听感不一致的问题。负值会让歌词略微提前高亮，正值会让歌词略微延后高亮。

适合处理部分歌词文件整体快了或慢了的情况。

不会。NAS 地址、账号和加密后的密码只保存在您的设备本机，用于下次自动登录或会话续期。风琳Player 不会把您的 NAS 密码上传到开发者服务器。

技术上，应用会调用系统提供的设备级密钥能力对密码进行加密保存，明文密码不会直接落盘。

在登录页点击 NAS 地址行右侧的下拉菜单，进入「管理已保存账号」后，可以单独删除某条历史账号，也可以一次性清空。

退出登录会清除当前登录态，但可能保留已保存账号列表，方便下次切换。要彻底移除历史账号，请在「管理已保存账号」中删除。

通常情况下，卸载应用会清除应用本机数据，包括登录信息、缓存和本地索引等。若系统或设备厂商提供了额外备份 / 恢复机制，请以系统实际行为为准。

为了更快定位问题，请尽量提供以下信息。截图、录屏和错误提示非常有帮助。

QQ 群号：611936182。QQ 群主要用于 App 使用交流、问题反馈和功能建议。

请不要在群内发送音乐资源、网盘资源、广告或无关链接。

本群不提供音乐资源，只交流风琳Player 使用问题、功能建议和 NAS 音乐播放器相关内容。

不保证实时回复，但有效反馈会尽量查看和处理。描述越完整、复现步骤越清楚，问题越容易被定位。