功能说明
什么时候需要
当 Primuse 崩溃、卡住不动、扫描不全、某个音乐源连不上或播放中断，作者往往需要看到出问题那一刻的记录。诊断信息只保存在你的设备上，不会自动发出，只有你亲手发送时才会离开设备。
开始之前
- 先确认 App 版本：设置 → 关于，可以看到版本号与构建号。反馈时请一并说明。
- 想上传给作者，设备需要能联网；每台设备每天最多上传 5 次，一次打包不超过 8 MB。
第 1 步：打开诊断模式（建议）
- 打开 设置 → 关于 → 「诊断报告」。
- Mac：设置 → 关于 → 「诊断日志…」，在打开的窗口里点「诊断报告」。
- Apple TV：在 设置 里打开「诊断报告」。
- 打开「记录详细日志」。接下来 24 小时，App 会多记录一些排查用的细节，到时间自动关闭。
- 让问题再发生一次（例如重新扫描、重新播放那首歌、重新连接那个音乐源），记下大概时间。
打开诊断模式之前发生的事情，只有普通日志，细节可能不够；所以最好开着它复现一次。
第 2 步：上传给作者
- 回到「诊断报告」页，点页面上方工具栏里的「发送给作者」。
- 在「附件（可选）」里选择要带上的内容：「诊断报告」（崩溃与卡顿报告、运行指标报告）和「日志」。
- 需要的话，在「图片（可选）」里添加截图（最多 6 张，会自动缩小），并在「需求或建议」里写下：你做了什么、期望什么、实际发生了什么、大概几点。
- 点底部的「上传给作者」。会依次显示「正在打包…」「正在上传 …%」「正在确认…」。
- 看到「已上传给作者」后，点「复制编号」，在 GitHub 或邮件里反馈时附上这个编号。
预期结果： 页面显示一个报告编号。上传成功后，已上传的本机报告和日志会被清理。
Apple TV 上没有系统的崩溃报告，上传的只有日志和留言；完成后会显示编号，可以用「再传一份」再传一份。
不能上传时：改用邮件或分享
- 上传按钮下方有「改用邮件发送」或「改用系统分享」。邮件会附上你选择的报告或日志，由你确认后发送。
- 如果上传服务不可用，页面不会显示上传按钮，工具栏按钮会变成「打开邮件」或「分享」，并显示作者的邮箱地址。
- 1.12.2 之前的版本没有上传功能，直接用「发送给作者」走邮件或分享即可。
只想单独分享某一份报告
在「诊断报告」页点一份报告即可单独分享。Mac 上还可以用「导出日志」在访达中找到日志文件。
选项说明
| 选项 | 含义 |
|---|---|
| 崩溃与卡顿报告 | 系统在 App 崩溃或长时间卡住后留下的报告，通常要到下次打开 App 后才会出现 |
| 运行指标报告 | 系统定期提供的运行数据（例如内存峰值、退出原因） |
| 日志 | App 自己记录的最近播放、扫描和同步过程；上传或分享时只带最近的一段 |
| 记录详细日志 | 24 小时内记录更多细节，之后自动关闭 |
| 清空日志 | 删除本机日志，删除后无法找回 |
隐私
日志里会有歌名、文件路径，以及折成短标记的音乐源地址和账号；密码、令牌等凭据在写入前就会去掉。上传的内容只用于排查问题，在作者的服务器上保存 30 天后删除（服务器空间不足时可能更早删除）。发送前你可以取消勾选「日志」或不添加截图。
限制
- 一次上传打包后不超过 8 MB；每台设备每天 5 次，未完成的尝试也会占用次数。
- 本机的报告和日志大约保留 7 天。
- Apple TV 没有崩溃与卡顿报告；Apple Watch 没有诊断入口，请在配对的 iPhone 上反馈。