Let’s talk it through

自动离线队列会等待合适的网络和设备状态。切到后台、蜂窝或低数据网络、低电量模式、设备过热、可用空间不足，都可能暂停队列；播放时也可能优先保证播放。可先连接 Wi-Fi、打开 App、关闭低电量模式并留出空间，再观察。

支持相关播放路径，但能否成功还取决于音乐源交付的音频。Navidrome/Subsonic 的 WMA 会使用服务器转出的 MP3；只有这类歌曲失败时，应一并检查服务器转码是否正常，不能只看文件扩展名判断。反馈时请说明音乐源和格式，并附诊断编号。

可以先确认原始文件在音乐源或其他播放器中能正常播放，再停止播放，到设置的存储页面清理“音频缓存”，然后联网重试。普通缓存清理会保留固定离线的文件；若问题文件已固定离线，需要到离线管理处理。这样可以排除缓存问题，但不保证所有解码失败都能解决。

不一定。系统回收后台进程、资源压力和真正的崩溃，都可能表现为重新启动。仅看这个现象或一条磁盘报告，无法确定原因。反馈时请写明切后台前的操作、间隔多久、是否播放或下载，并一起提交诊断报告和相关日志。

上传的诊断可以包含设备之前保存的系统报告。上传时的 App 版本和某份报告发生时的版本，不一定相同。排查时要同时看报告时间、版本和你实际遇到问题的时间；旧报告本身并不说明升级没有成功。

打开歌曲的歌词编辑页，点“⋯”中的“听歌识词”；已有歌词时会先确认是否替换。如果入口没有出现，先在设置中搜索“听歌识词”，启用可用服务并完成音频上传确认。入口还取决于服务开放情况、歌曲格式和时长；Apple Music 订阅歌曲及 CUE 虚拟分轨不适用。

这是写入保护：App 记录的文件版本与远端当前版本不一致时，会停止写入，避免覆盖其他修改。先暂停其他工具对该文件的编辑，重新扫描对应音乐源，再重新打开歌曲编辑。若仍反复提示，保留提示截图和诊断编号反馈，不要把“再扫一次一定好”当成保证。

两类来源的工作不同。WebDAV、网盘需要遍历目录，并读取音频文件中的标签；音乐服务器通常已经整理好曲库，App 主要读取它提供的目录。首次大曲库读取可能较久，还受网络和服务端限制影响。界面中看到歌曲数量更新，不代表封面、歌词等详情补读已经结束。

可能只是被 Primuse 隐藏了。先到设置的“最近删除”查看“已隐藏的来源歌单”，对目标歌单执行“恢复显示”，再刷新对应音乐源。如果这里没有目标歌单，还需检查登录账号、服务端权限和同步结果，不能一概认为是隐藏导致。

先进入该歌单，再打开搜索，查看“搜索范围”，选择当前歌单名称。想查整个资料库时切回“全局搜索”。其他页面也可能提供各自的搜索范围，查不到时先确认没有停留在一个过小的范围里。

在“设置 → 资料库”开启“默认平铺显示歌曲”，再进入资料库的歌曲页面。关闭时默认按来源和文件夹层级浏览。这个开关改变歌曲资料库的浏览方式，不会自动把首页改成全部歌曲列表。

先看当前来源和输出模式。Apple Music 订阅歌曲由系统播放，Primuse 的均衡器、混响等不适用；“高保真直通”也会绕过音效处理。可以用自己的本地或 NAS 音频，在音效模式下对比。若这种情况仍完全无变化，再带上来源、输出设备和日志反馈。

Apple Music 订阅歌曲不能当成普通音频文件由 Primuse 下载到网盘或导出。歌单可以保存歌曲条目，但保存歌单不等于取得音频文件；Primuse 的“始终保持离线”也不会下载这些订阅歌曲。自己的本地、NAS 或云盘文件按对应音乐源管理。

有些歌词只有文字，没有每句的时间戳，因此不能按播放进度定位。可换一份带时间轴的歌词，或进入歌词编辑页使用“边听边打轴”。如果歌词整体早了或晚了才用偏移调整；偏移不能给纯文本自动生成时间轴。

先核对歌手、专辑和版本，再比较时长；现场版、翻唱版、重制版可能同名但时间轴不同。优先选择信息与当前歌曲一致的候选，试听开头和中间几句确认。时长接近只是线索，不代表一定正确，也不要只因为排在第一就直接覆盖。

当前本机听歌历史以实际收听达到 30 秒为最低记录门槛，通常在切歌、停止或播完后结算；拖动进度跳过的部分不算实际收听。外部 ListenBrainz/Last.fm 上报有自己的规则，不能用本机排行的门槛推断它们什么时候上传。

可以。在播放页打开睡眠定时器，选择预设时长，或进入自定义设置指定持续时长、停止时刻。音乐、有声书、播客会按内容提供不同的结束选项；直播电台没有“播完这一首”这种固定结束点。

可以在歌单页面使用“导入歌单”，粘贴支持的分享链接，也可以导入歌单文件或“歌名 - 歌手”文本。导入会先匹配你资料库中的歌曲并给出预览；外部平台可能只返回公开预览或限制数量，所以先核对匹配数和缺失数，再确认保存。

灰色条目通常是尚未匹配到你曲库音频的占位。导入歌单并不会下载这些歌曲。把你已有的对应音频加入可用音乐源并扫描后，可以重新匹配；支持的条目也可手动选择曲库中的正确歌曲。先核对歌名、歌手和版本，避免配到同名的另一首。

可以使用“缓存同步”。两端先同步相同音乐源和曲库，连接同一局域网并打开 Primuse；一端选“发送缓存”，另一端选“接收缓存”。它只补齐已完整缓存的音频，不是通过 USB 传输，也不等于同步所有标签、封面或整个资料库。

在“设置 → 播放器”找到“播放页背景”，选择“流动色彩”，再调整颜色强度。不同封面取色会不同；如果已经选对背景但某张封面颜色明显异常，最好提供封面示例和平台版本，不要仅反复拉高强度。

写入方式取决于来源和格式。受支持的目录类来源可把标签写回 MP3、FLAC、M4A 等音频；部分音乐服务器使用自己的编辑接口，其他情况可能只能保存本机修改或旁文件。先看编辑页的写入能力提示和服务器账号权限，不能认为换一个协议后写入方式仍相同。

在对应歌曲的菜单里选择“标记为音乐”即可。多首歌可以先多选，再使用分类操作；专辑菜单也提供同类入口。此操作改变资料库中的分类，不需要重新导入文件。

可以同步 Navidrome 和群晖 Audio Station 的歌曲评分，专辑评分写回目前限定 Navidrome。在设置打开“评分与评论”，再刷新同一账号的音乐源或修改评分。服务端须支持并返回评分字段；待同步的本机修改会参与冲突判断，不保证每次都被服务器覆盖。

在电台页添加电台，填写名称和直播流 URL。地址使用 HTTP 或 HTTPS，不要求以 .mp3 结尾；应填写实际音频流地址，电台介绍页或需要网页登录的页面通常不能直接播放。链接格式有效只表示可以加入列表，实际能否播放还取决于流本身。

支持批量添加：可粘贴文本、选择清单文件、输入清单地址或使用在线目录。解析支持 M3U、PLS 和一行一个 URL 的纯文本；纯文本也可写“名称, URL”。M3U 中的 tvg-logo 可作为台标，group-title 或 EXTGRP 可作为分组信息。导入前查看候选列表，确认重复、无效项和需要导入的电台。

可以。电台菜单中可移动到文件夹、添加标签，也能新建或重命名分类。列表支持按分类筛选，并有“封面”和“列表”两种版式。删除文件夹只会把其中电台移回未分组；删除标签会移除标记，不等于删除电台。

编辑电台时可填写台标 URL，批量导入的 M3U 也可以携带 tvg-logo。使用可直接访问的图片地址；把电台网页地址填进台标栏不等于图片地址。若图片不显示，先检查链接可达性和实际图片内容。

固定模式按设置的时长衔接前后两首；智能模式会在可用的音频分析基础上选择过渡位置，滑块表示最长过渡时长，实际衔接可能更短。到设置的“淡入淡出”中选择模式和时长。使用该功能需要音效输出模式。

可以在歌曲菜单的编辑区域选择“重新读取文件标签”，无需先重扫整库。它会重新检查原文件可用的标签；如果源不提供原文件或文件本身没有可用标签，重读也不会凭空补全信息。“恢复文件标签”是另一项针对手动编辑内容的操作，执行前要看清名称。

进入歌单详情，使用顶部的随机播放按钮即可直接开始随机播放，不需要先按普通播放再切换模式。它会以当前可播放的歌曲建立随机队列；不可播放或被过滤的条目不会因此自动变得可用。

到音乐源列表打开 Apple Music 的菜单，选择禁用即可暂停使用这个来源。当前实现也提供移除来源，但移除会停止其授权同步并清理本机同步产生的资料；如果只是暂时不想显示或参与资料库，优先使用禁用。

可以通过首页编辑调整模块顺序和显示状态；部分模块还提供横向浏览或网格等布局。可在设置中搜索“首页”定位相关入口，隐藏不常用模块，把常用内容排在前面。各模块可选布局不同，并非整页统一只有一种布局。

要看确认框中的具体动作。正常的重复清理会尝试删除来源文件，成功后移除本机记录，不能当作单纯隐藏。来源不支持删除或被明确拒绝删除时，部分流程会提供“仅从本机移除”；它保留源文件。超时、登录失效等未知结果不能一概按本机移除处理。清理前逐项检查保留与删除选择。

当前检测主要比较规范化后的标题、艺术家和接近的时长；艺术家缺失时可尝试专辑艺术家，专辑名并不是必须相同的条件。因此跨专辑的同名曲目可能被归在一起，现场版、重录版或不同音质也需要你自行确认。结果是疑似重复，不是文件字节完全相同的证明。

打开艺术家详情的更多菜单，选择“更换封面”，从照片或图片文件选取即可。这里修改的是艺术家页面的图片；把歌手照片嵌入某首歌曲封面，并不等于设置艺术家头像。若上传后仍不显示，请记录图片格式和复现步骤反馈。

播放和扫描是不同任务。后台执行会按扫描阶段、播放状态和系统授予时间调整，必要时保存进度并暂停；播放音乐不能保证整库扫描一直完成。首次扫描或大批量补全时，建议保持 Primuse 在前台；返回后查看扫描状态，必要时继续扫描。不要因暂停就删除音乐源重建。

当前实现会处理媒体服务器给出的音频跳转，包括 STRM 相关播放路径。能否播放仍取决于最终地址是否可访问、是否返回受支持的音频，以及鉴权是否有效。跨域跳转不会直接携带原服务器的敏感凭证，因此需要原账号凭证才能访问的第三方目标可能失败；不能把能在浏览器打开网页当作音频可播放。

在手机的 Wi-Fi 传输中选择接收并开启“浏览器访问”，电脑浏览器打开手机显示的地址，按提示输入访问码即可上传。支持音乐及配套歌词、CUE、封面，也可保留文件夹结构。传输时保持接收页面和网络可用；这里的文件传输与设备间缓存同步是不同入口。

不需要为了搜索音箱而开启 Primuse 的 DLNA 接收。当前投放发现可以独立运行，在播放页的投放设备选择页搜索即可。让设备处于同一可互通的局域网，并检查 Primuse 的本地网络权限和音箱的 DLNA 功能。能发现设备与能连续播放是两件事；下一首失败需要单独反馈。