Overview
适用设备与系统
| 设备 | 最低系统版本（源码配置） | 说明 |
|---|---|---|
| iPhone、iPad | iOS / iPadOS 18.0 | 主要 App，可添加全部类型的音乐源 |
| Mac | macOS 15.0 | 原生 Mac App，有侧边栏、菜单栏和桌面歌词 |
| Apple TV | tvOS 17.0 | 独立的电视界面，可通过 iCloud 接收 iPhone 上的音乐源 |
| Apple Watch | watchOS 10.0 | 控制 iPhone 播放，或播放传到手表上的离线歌曲 |
部分功能需要更新的系统，例如卡拉 OK 人声分离所需的模型下载组件只在 iOS、macOS、tvOS 26 及以上提供。App Store 上的实际最低版本请以商店页面为准。
Primuse 本身不提供音乐内容，也不需要注册 Primuse 账号。它播放的是你自己的 NAS、媒体服务器、云盘、本机文件，以及（可选的）Apple Music 订阅资料库。
首次打开
第一次打开时会看到几页介绍：
- 「你的音乐，存在你的服务器」：说明音乐从你自己的设备和服务播放。
- 「把音乐聚合到一处」：列出可接入的来源类型。
- 「让资料库更完整」：封面、歌词和专辑信息的补全，在“设置 > 元数据与刮削”中按需启用和排序。
- 「不只是在手机上听歌」与「让首页更像你的」：播放、投放和首页个性化。
- 「完全属于你」：音频文件永远不会离开你的音乐源；资料库设置仅通过你自己的 iCloud 同步。
最后可以点「添加第一个音乐源」直接去添加，也可以点「稍后再说」先进入 App。Mac 上的引导分 3 步，可点「跳过引导」跳过。
认识主界面
iPhone 底部有四个标签：首页、资料库、搜索、设置。在任意页面点底部的播放条可以打开播放页。
Mac 使用左侧边栏，「音乐源」一节里可以添加和管理音乐源；设置在菜单栏 Primuse →「设置…」（⌘,）。
添加第一个音乐源
App 内引导「三步添加音乐源」概括了流程，展开如下：
- 打开 设置 › 音乐源管理（「资料库」分组），点右上角的 +（「添加音乐源」）。
- 在「选择音乐源类型」中选择类型。同一局域网内能发现的设备会显示在最上方（「正在扫描局域网设备...」）。
- 填写服务器地址和账号。只填服务器地址，端口和加密方式会自动确认。
- 勾选放音乐的文件夹，点「完成」，扫描会自动开始。可以离开此页继续使用，扫描会在后台进行。
云盘按提示授权登录即可；Navidrome、Jellyfin 等媒体服务器登录后会同步整个曲库，不需要选择文件夹。
预期结果： 扫描时资料库会分批出现歌曲；扫描结束后，可以在 资料库 中按歌曲、专辑、艺术家等浏览，在 搜索 中搜索。封面、歌词等信息会在后台继续补读。
只想先试试本机文件
在「选择音乐源类型」的「本地」一节里：
- 「引用文件夹」/「引用文件」：从原位置播放所选音频，不额外复制。
- 「复制到 Primuse」：保存由 App 管理的副本，便于离线播放。
- 「设备传输」：在同一局域网内，将音乐、歌词和文件夹发送到另一台 Primuse 设备。
常见问题
- 找不到某种来源？ 绿联 Ugreen 与 飞牛 fnOS 当前版本不在添加列表中；局域网里发现的这两类设备即使出现也不能选择（「等待官方公开 API · 暂未开放」）。完整类型见 添加和管理音乐源：类型总览、入口与日常操作。
- 连不上？ 见 音乐源连不上、登录失败或扫描不到歌曲怎么办。
- 扫描后歌曲不全？ 见 资料库里少了歌曲或找不到某首歌怎么办。