功能说明
入口
- iPhone、iPad： 设置 › 音乐源管理（「资料库」分组），点右上角的 +（「添加音乐源」）。还没有任何来源时页面显示「没有音乐源」。
- Mac： 左侧边栏「音乐源」一节中添加和管理。
进入「选择音乐源类型」后，最上方是局域网里自动发现的设备（「正在扫描局域网设备...」），点一下会预填地址；接着是 Apple Music，然后按分类列出全部类型。
支持的类型
| 分类 | 类型 |
|---|---|
| NAS | Synology（DSM 6/7，支持两步验证与 QuickConnect）、QNAP（QTS/QuTS） |
| 协议 | WebDAV、SMB/CIFS（SMB2/3）、FTP/FTPS/FTPES、SFTP、NFS（v3/v4）、UPnP/DLNA、S3（AWS S3 / MinIO / R2） |
| 媒体服务器 | Jellyfin、Emby、Plex、Subsonic / OpenSubsonic、Navidrome、Airsonic、gonic、飞牛音乐、道理鱼、Songloft、Audiobookshelf、Synology Audio Station、Ting Reader |
| 云盘 | 百度网盘、阿里云盘、Google Drive、OneDrive、Dropbox、Drime、InfiniCLOUD、115 网盘、123 云盘、光鸭云盘、pCloud |
| Apple | Apple Music（同步 Apple Music 订阅资料库）；Mac 另有 Apple Music 资料库（本机 Apple Music / iTunes） |
| 本地 | 本机文件（引用文件夹、引用文件、复制到 Primuse）、设备传输 |
说明：
- 绿联 Ugreen 与 飞牛 fnOS 在当前版本不在添加列表中（源码中标记为「等待官方公开 API · 暂未开放」）。飞牛 NAS 上的音乐可以通过「飞牛音乐」或 SMB、WebDAV 等通用协议接入。
- 115 网盘 的副标题为「115 开放平台 · 暂未开放」：需要你自己有 115 开放平台的开发者应用凭据才能试用。
- 可以添加任意多个来源，它们会合并成一个资料库。
添加步骤（通用）
- 选择类型，填写「名称」和服务器地址。端口留空，保存时 Primuse 会自己试出来。
- 填写「凭据」：用户名、密码、API Key 或令牌，按类型而定。需要时在「高级」中设置端口、路径、加密等。
- 保存时 Primuse 会先测试连接。如果失败，会显示原因（例如「等不到回应」「加密握手没成功」），可以「修改地址」或「仍然保存」。
- 文件型来源（NAS、协议、云盘）接着选择要扫描的目录（「扫描目录」：连接后选择要扫描音乐文件的目录），点「完成」后开始扫描。媒体服务器登录后直接同步曲库。
各类来源的详细字段见下方相关文章。
音乐源列表里的操作
| 操作 | 作用 |
|---|---|
| 扫描 / 继续扫描 | 读取目录变化；上次中断时可以接着扫 |
| 连接并选择目录 / 管理目录 | 连接并选择或修改要扫描的目录 |
| 体检 | 逐项检查地址、凭据、路径和网络，给出修复建议 |
| 重新登录 | 登录过期时重新登录 |
| 编辑音乐源 | 修改名称、地址、凭据和高级选项 |
删除的音乐源会先进入 设置 › 最近删除（「资料库」分组），可以在那里恢复。
有声书和播客内容
- Jellyfin、Emby、Plex、Navidrome、Audiobookshelf、Ting Reader： 添加后再「编辑音乐源」，在「资料库」中把每个库设为「音乐」「有声书」或「不同步」。选择服务器上每个资料库装的是什么。有声书库会进书架、用听书播放页；不同步的库下次扫描就不再读。
- 其他来源： 在歌曲菜单里选「标记为有声书」「标记为播客」或「标记为音乐」，可以一次选多首。
- 早期版本里开启过「整个来源都是有声内容」的来源，编辑时仍会显示这个开关：这个来源的所有歌曲都进有声书书架、用听书播放页。单首仍可以标回音乐。