Let’s talk it through

在“音乐源”中找到对应 WebDAV 源，开启“自动刷新”，再选择刷新间隔。目录类源默认不开启，默认间隔为 6 小时，也可选 1、12 或 24 小时。首次仍需选好目录并扫描；之后按间隔增量维护已选目录，启动或回到前台时会检查，不是每隔几小时保证在后台准点扫描。

音乐源的“自动刷新”可让 Primuse 检查服务器目录变化并更新本地资料库；媒体服务器来源默认启用。它先读取服务器状态或目录变化，有变化再刷新，并不是每次打开都强制服务器全量重建。服务器仍在扫描时会等待；急需更新时也可手动刷新。文件协议来源的规则不同，通常需要手动开启。

先刷新对应音乐源，再查看该源的“服务端删掉的歌”处理方式。为了避免服务端临时漏返回导致误删，本地可能先保留待确认的条目；可按源选择确认后移除或立即移除。Apple TV 的音乐源操作菜单也有此项。若完整刷新后仍异常，请带源类型和诊断编号反馈。

当前读取规则会优先使用 Plex 的曲目艺人；Plex 没单独提供时，使用专辑艺人，服务端值不可用时才尝试文件名回退。如果仍显示“03-01”等编号，先在 Plex 核对这首歌和专辑的艺人标签，再刷新 Primuse 数据并记录受影响曲目。不要把文件名编号当成真实歌手批量改写。

Navidrome 默认使用服务器的歌曲信息和封面。普通／批量刮削只补缺失字段，即使走“重新刮削”也不覆盖已有信息或替换封面。要换成刮削结果，请在单曲刮削预览里选择候选、勾选项目并应用；成功后使用新值，后续刷新保留用户修改。歌词先显示缓存，再按条件核对服务器；确认服务器没有歌词时才在线兜底。手动应用的 Navidrome 歌词保存为本地覆盖，服务器自动刷新不会换回旧歌词。以上为 iPhone／Mac 规则；Apple TV 在服务器缺封面时允许在线补图。

不一定。Primuse 支持从飞牛歌单里的歌曲详情直接建立可播放条目，因此歌曲没有出现在 NAS 本地曲库中，也可以尝试通过飞牛服务端播放。前提是飞牛服务端能为该条目返回有效的歌曲信息和播放流；在线资源失效、权限不足或服务端无法播放时，仍可能不可用。

可从「音乐源管理」添加本地文件、WebDAV、SMB、FTP、SFTP、NFS、S3 等文件来源，也支持 Jellyfin、Emby、Plex 和 Subsonic / Navidrome 等媒体服务器。请选与服务器实际协议相符的类型，而不是只按设备品牌选择。

先确认 Primuse 登录的是创建歌单或获准访问该歌单的 Emby 用户。歌单按当前账号权限读取，同一服务器上的另一个用户不一定能看到。账号正确后再同步歌单；若仍少歌或少歌单，需要进一步检查服务器返回和同步结果，不能只凭数量认定是权限问题。

连接检查通过不等于已成功识别音乐文件。先确认选中的目录里有支持的音频文件，并且同一账号能列出它们，再重新扫描。旧版曾有 Backblaze B2 列表解析兼容问题，可以先更新后重试。仍为 0 首时，提交目录选择情况和诊断，不必反复删除音乐源或更换凭据。

不一定。在添加音乐源的本地导入区域选择「引用文件夹」或「引用文件」，就会从原位置读取；想保存独立副本时再选「复制到 Primuse」。引用文件仍需保留原文件，并允许 Primuse 访问它。

请检查添加的音乐源类型。要读取 Audio Station / DS audio 的歌单，应选择「Synology Audio Station」；普通「Synology」走的是 File Station 文件接口。当前 Audio Station 连接器会读取个人、共享及智能歌单。

这条提示指的是应用接入配置，不是 115 账号密码。若当前版本显示「需要配置开发者凭证」或尚未开放的提示，需要按连接页要求填写你自己已获授权应用的 Client ID 后再授权登录。仅输入网盘账号无法补齐这项配置；可用性以连接页当前状态为准。

如果添加音乐源页已有 pCloud，可选择它并按连接页完成授权。若页面要求开发者凭证，需要先配置你自己已获授权应用的 Client ID。是否能直接授权取决于所用版本的接入配置，请以连接页提示为准。

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

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

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

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

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

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

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

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

歌曲分享页会根据来源提供可用的链接方式，例如音乐服务器分享或 Primuse 中继；支持的专辑和歌单也有服务器分享入口。服务器分享需要服务端支持且账号有权限，有效期、密码等选项由实际能力决定，不是每个服务器都有。创建后还要确认接收方能访问对应服务。

两端都需要启用 iCloud 同步，并检查“音乐源”等对应同步项目。音乐源配置、播放记录和凭证是不同通道；关闭凭证同步时，新写入的凭证只留在本机，另一台设备可能需要重新登录。同步配置不等于把全部原始音乐和缓存复制过去，来源内容仍需要设备能访问。

公开网络上的 HTTP 不提供 HTTPS 的传输保护，当前实现要求对这类主机进行明确的信任确认。优先使用服务器提供的正确 HTTPS 地址；确实使用自己的 HTTP 服务时，按应用连接流程确认目标主机。不要把所有连接失败都归因于这个限制，也不要用关闭全局安全保护代替检查地址。

当前添加来源流程支持识别 QuickConnect ID，并按群晖 Audio Station 的登录流程连接；需要二步验证时，按提示输入验证码。请使用该来源类型的账号登录流程，不要把 QuickConnect ID 当作普通 WebDAV 路径填写。是否能访问仍取决于群晖服务和账号权限。

不一定。当前实现会区分可在本机读取的自有资料库歌曲与订阅目录内容：本地可读、非云端且不受保护的匹配项可按自有歌曲处理；只有目录标识或受保护的订阅下载不能视为自有文件。若自己的文件仍提示订阅，先确认它已同步到本机可读，再反馈来源和版本。

目录文件总数不等于歌曲数。封面图片、歌词、CUE 和其他辅助文件通常不会各自算一首歌曲；扫描会按支持的音频、流描述或音乐视频规则建立条目。先比较缺少的是音频文件还是配套文件，确认有真实音频遗漏后，再反馈其格式与目录结构。

在 FTP 音乐源的连接设置里找到数据连接方式，选择主动模式。主动模式使用 PORT / EPRT，由服务器反向连接本机；EPSV 仍然是被动模式。通常先用自动模式，只有服务器明确需要主动模式、且网络允许服务器连接本机时再切换；蜂窝网络或路由器后的环境可能不适用。

可以使用 Plex 账号授权入口：完成浏览器授权后，回到 Primuse，从账号有权访问的服务器列表中选择服务器，再选择音乐库。列表包含自有与获分享的服务器；能登录 Plex 账号不代表某台服务器当前可达。若提示只能通过 Relay，实际播放仍受该连接路径影响。

在音乐源管理中添加 Audiobookshelf，填写服务器地址后使用服务器账号登录；也可选择“API 密钥”，填入在该服务器创建的密钥。它作为有声内容来源使用，连接后按页面选择并同步书库。账号登录与 API 密钥是两种认证方式，不能把普通密码直接当 API 密钥。

支持 Ting Reader 的版本中，可以添加独立的 Ting Reader 音乐源。添加来源时选择 Ting Reader，填入该服务器的地址与账号密码，再同步内容；它默认作为有声书来源处理。服务器地址应填写你自己的可访问服务，不是把某个音频下载链接当作服务器。

可以把 STRM 文件放进已连接的目录型音乐源并扫描。STRM 是指向实际媒体的文本文件，不是音频本体；当前解析器读取第一条有效目标，支持 HTTP/HTTPS 链接或源内路径，文件上限为 64 KiB。目标必须仍可访问；网页登录页、已过期链接或需要额外登录的链接不等于可播放直链。

在音乐源页展开 Ting Reader，使用进度自动同步开关或“立即同步”按钮。进度刷新与扫描书目分开，会在启动、回到前台和手动刷新时读取，并按较新的服务端时间合并；正在播放的章节不会被后台结果突然改位置。另一端先把进度保存到同一服务器账号，Primuse 才有可读的新进度。

先查看歌曲标签里的曲号。Primuse 会读取 UPnP 服务器提供的有效曲号；服务器未提供时，反复扫描通常无法补齐。当前该来源还未读取分碟号，多碟专辑可能无法按原分碟顺序排列。请核对服务器提供的信息；特定 NAS 或 ATRAC 文件的情况，还需结合设备返回的数据确认。