功能说明
先了解
- 网盘来源只能读取你授权给 Primuse 的账号里的文件。授权信息保存在设备的钥匙串中。
- 每个连接源会独立保存登录凭据；取消或授权失败不会更改已有连接。
- 扫描网盘时先只读取文件名，歌曲详情在后台分批补全（见下文「省流量」）。
入口
设置 › 音乐源管理（「资料库」分组）› +，在「云盘」中选择网盘类型。Mac 上也可以在侧边栏的「音乐源」中添加。
三种登录方式
| 方式 | 适用网盘 | 你需要准备 |
|---|---|---|
| 浏览器授权 | 百度网盘、阿里云盘、Google Drive、OneDrive、Dropbox、123 云盘、光鸭云盘、pCloud | 网盘账号；部分版本还需要你自己的开发者凭证（见下文） |
| API 访问令牌 | Drime | 在 Drime 网页设置中创建的令牌 |
| 应用密码 | InfiniCLOUD | InfiniCLOUD 账号和应用密码 |
115 网盘 在添加后会显示「… 暂未开放」：Primuse 正在向 … 开放平台申请官方接入资质，审核通过后即可直接登录使用，敬请期待。若你已自有该平台的开发者应用，也可按下方步骤填入凭证先行试用。
浏览器授权的步骤
- 选择网盘类型并保存后，进入连接页面。页面先显示「正在检查授权状态…」。
- 如果显示「授权连接」：
- iPhone / iPad：点击下方按钮，将在浏览器中打开授权页面。 登录并同意授权后，Primuse 即可访问您的文件。
- Mac：点击「授权连接」，将在系统浏览器中打开授权页。 登录并同意授权后会自动返回 Primuse。
- 在浏览器中登录网盘账号并同意授权。等待期间显示「等待系统浏览器返回授权码…」。Mac 上会列出「授权步骤」，授权完成后此窗口会自动进入目录浏览器。请不要关闭系统浏览器中的回调页。
- 授权成功后自动进入目录浏览，勾选存放音乐的文件夹并开始扫描。
如果设备上已经有一个登录过的同类网盘，会出现「使用已登录账号」和「登录其他账号」两个选项。
出现「需要配置开发者凭证」时
如果连接页显示「需要配置开发者凭证」，说明当前版本没有为这个网盘内置接入凭证，需要你自己去该网盘的开放平台申请。页面会给出四步：
- 平台指引，例如：前往 pan.baidu.com/union 注册开发者应用；前往 alipan.com/developer 申请接入；前往 console.cloud.google.com 创建 OAuth 凭证；前往 entra.microsoft.com 注册应用；前往 dropbox.com/developers/apps 创建应用；前往 123pan.cn/developer 申请开发者应用；前往 app.guangyapan.com/pan/docs/open-api 申请开发者应用；前往 docs.pcloud.com/my_apps 创建应用，并允许隐式授权（Implicit Grant）
- 创建应用，获取 Client ID（和 Client Secret）
- 回到 Primuse，编辑此源，填入凭证（字段为「客户端 ID / App Key」和「客户端密钥」或「客户端密钥（可选）」）
- 再次点击「连接」即可授权
哪些网盘在正式版中内置了凭证，源码无法确定（取决于发布构建的配置）。以连接页实际显示为准。
授权失败
失败页标题为「连接失败」，下方是具体原因。可以点「重试授权」重新走一遍授权，或点「重新检查」重新检查已保存的授权。常见原因：
- 「未配置 Client ID」：按上一节填写开发者凭证。
- 「密码暂时无法读取，请解锁设备后重试。」：解锁设备后点「重新检查」。
- 「无法安全读取已保存的密码，请重试或更新凭据。」：重新授权。
- 「授权令牌保存失败」：重试授权；仍失败时收集诊断信息，见 收集并发送诊断信息给作者。
- pCloud 显示「pCloud 授权已失效，请重新授权」：重新授权。
- 光鸭云盘显示「此版本未配置光鸭开放平台接入凭据(client_id / project_id / 签名密钥)」：当前版本无法连接光鸭云盘，需要等待新版本。
Drime：使用 API 访问令牌
- 选择 Drime，连接页显示「连接 Drime」：粘贴在 Drime 设置 → Developer 中创建的 API 访问令牌。Primuse 验证成功后会打开网盘目录。
- 在「API 访问令牌」中粘贴令牌，点「连接 Drime」。
- 请在 Drime 设置 → Developer 中创建令牌并粘贴到这里。令牌会安全存入钥匙串。
权限说明：全部权限可播放、写入和删除；Read Only 可浏览和播放；Restricted 至少需要“文件：读取”，写入封面/歌词及删除还需要“文件：写入”。 编辑来源时，留空会保留现有 Drime 令牌；输入新令牌则会替换。
如果提示「当前 Drime 令牌无法读取文件。」或「当前 Drime 令牌为只读，或没有写入及删除文件的权限。」，到 Drime 调整令牌权限后重新连接。
InfiniCLOUD：使用应用密码
填写 InfiniCLOUD 用户名和应用密码。请在 InfiniCLOUD「我的页面」启用外部应用连接，并填写生成的应用密码。 如果提示「此版本尚未配置 InfiniCLOUD 接入密钥。」，说明当前版本无法连接 InfiniCLOUD。
省流量：仅在 Wi-Fi 下加载详情
入口：设置 › 存储管理（「资料库」分组）›「仅在 Wi-Fi 下加载云盘详情」。
扫描云盘时只读取文件名，详情（歌手/专辑/封面/时长）会在后台分批加载。一首歌大约消耗 256KB 流量。开启此项后，遇到蜂窝网络会自动暂停，连上 Wi-Fi 自动继续。
在 Apple TV 上登录网盘
Apple TV 没有浏览器，网盘改用扫码登录：
- 多数网盘：电视上显示二维码，提示（以百度网盘为例）：「用 iPhone 或 iPad 的相机扫码，在 Primuse 里登录 …，登录结果会经局域网直接交给这台 Apple TV。」手机上需要装有 Primuse，并和 Apple TV 连在同一个局域网。
- 手机上会显示「在 Apple TV 上登录 …」：在这台设备上登录后，授权会加密后经局域网交给 Apple TV。这台设备上不会新增音乐源，也不会保存这份授权。 请确认 Apple TV 上显示的确认码与下面一致
- 完成后：已完成。Apple TV 会接着让你选择要扫描的文件夹。
- 如果手机提示「当前版本的 Primuse 还不能在手机上代 Apple TV 登录这项服务。」，说明这个网盘暂不支持由手机代为登录。
常见失败：「Apple TV 没有连上局域网，无法显示二维码。」「没能连上 Apple TV。请确认两台设备在同一个局域网，并且 Apple TV 上的二维码还在显示。」「Apple TV 没有接受这次登录，二维码可能已经换过。请在 Apple TV 上重新扫码。」。
限制
- 首次扫描只读取文件名，歌手、专辑、封面、时长等详情在后台分批补全，曲库很大时需要一段时间；开启「仅在 Wi-Fi 下加载云盘详情」后，蜂窝网络下会暂停补全。
- 在网盘网页端撤销授权或授权过期后，需要在 Primuse 中重新授权。
- 播放、缓存和离线下载的设置见 离线下载、音频缓存与存储空间管理。