有問題，聊聊看

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

在歌曲、专辑或多选菜单里选择“标记为有声书”，即可按有声内容浏览和播放，不必重新导入。误分后同一菜单可改回“音乐”或“播客”。分类和文件标签是两件事；若章节被拆成多本，还应检查书名、专辑等用于归组的信息，不能靠分类开关自动合并错误标签。

从书架或书籍详情的继续播放入口进入，会按这本书保存的章节和位置继续，章节结束后接下一章。手动指定某一章则从该章进入。已听完的内容再次播放仍可保存这次重听的位置，同时保留已完成标记；不要把“已完成”理解为禁止重听。

已有文稿时，长按播放页的文字稿按钮可进入全屏阅读，也可点文稿区域的全屏阅读按钮。阅读页的“主题与设置”可调整字号、字体、间距、主题和高亮方式。没有可显示的文稿时不会打开，需先取得或生成文稿。

进入播客资料库的“喜欢的单集”。这里会汇集订阅播客与本地标为播客后收藏的单集，和音乐的“我喜欢”入口分开。找不到时先确认当前进入的是播客区域，并检查该单集的喜欢状态。

在首页编辑中打开“顶部切换”，可分别开关各分类，并拖动调整顺序。第一次自定义后，顶部入口的显示和首页内容区块可以分别设置；想恢复联动可选择“跟随首页区块”。该入口适用于普通导航模式，极简导航的页面组织不同。

Top Shelf 读取的是 Primuse 保存的内容快照。先进入 TV App 完成资料库同步，并产生可显示的最近播放、专辑、电台或有声内容，再返回主屏幕查看；空资料库不会凭空显示条目。若仍为空，应记录 TV App 版本和诊断。

多碟专辑应先按碟号，再按碟内曲号播放：先 Disc 1 的各曲，再 Disc 2。请检查文件或服务器提供的 DISCNUMBER 与 TRACKNUMBER，不能只看文件名前缀。碟号缺失时会按第一碟处理；曲号缺失还会使用可用的回退信息，因此标签不完整可能造成顺序不符预期。

可以在播放设置的“传输音质”里分别选择 Wi-Fi 和移动网络的音质。默认原始音质，不强制把网盘 FLAC 转成 MP3；低码率需来源服务器支持转码，CUE 等特定播放路径仍可能保持原始流。个人热点或低数据模式也可能按移动网络配置处理，网络切换通常从下一首生效。

播放页会把带和声标记的背景声部放在主歌词旁的对应区域，用较小字号和较低透明度区分，并保留自身时间轴。只有文件里实际包含且被解析出的和声才会显示；普通 LRC 没有相关内容时不会自动生成和声。遇到缺行可提供原歌词格式与诊断，不能只靠截图判断文件有无该声部。

在全屏效果设置中找到“画面帧率”，可选省电、30 帧、60 帧或跟随屏幕。跟随屏幕更流畅但更耗电，实际帧率还受显示器和设备状态约束；受省电或温度等设备状态限制时可能暂降到 30 帧，恢复后再按原设置运行。这个选项不会改变音乐采样率或音质。

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

在播放页的更多菜单中选择“全屏播放”。当前全屏效果为原生时会展开沉浸式歌词；选择其他全屏效果时则进入相应效果页面，可按页面控制切换封面与歌词。如果入口被隐藏，先到播放页样式与按钮中检查对应布局。歌词是否逐字显示仍取决于歌词文件的时间信息。

可以在歌曲列表的排序菜单选择标题等排序维度。目录浏览还有“曲目顺序”这一模式；使用列表排序后，目录中的歌曲按选定规则显示。Mac 点击表头也会切换到对应列表排序。这里调整的是歌曲显示顺序，不会修改文件名、远端目录或歌曲标签。

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

Primuse 会读取节目 RSS 中提供的 podcast:transcript 文字稿地址；Apple Podcasts 里能看到文字稿，并不代表 RSS 也提供了同一份。先确认节目源是否发布文字稿。没有可读文字稿时，可以在 Primuse 对该单集使用“生成文字稿”，不能直接把 Apple Podcasts 的展示结果当成已可导入。

文字稿有译文时，在全屏阅读的“主题与设置”中选择原文、双语或只看译文。双语模式下可以关闭译文字号跟随原文，再单独调整大小。没有译文时，先生成或加载翻译；切换显示方式不会自动产生缺失的译文。

在设置中搜索“升降调”，按半音调整，选择原调可恢复。升降调保持歌曲速度，但要使用“音效处理”输出；高保真直通、Apple Music 和投放播放不应用这项本地变调。有声书和电台不提供音乐升降调入口。卡拉 OK 舞台的变调还会与这里叠加。

支持收藏写回的音乐源会把红心同步到该源账号的“收藏/喜欢”，服务器收藏也会同步回来。它对应服务器的收藏标记，不是创建一个同名普通歌单。先确认两端连接的是同一服务和账号；写入失败或账号变化时不能把本机红心当作服务器已保存的证明。持续不同步请附上来源、操作时间和诊断。

当前音乐排行榜、音乐统计汇总和音乐推荐种子会排除识别为有声书的内容，以及订阅播客和电台；这些收听记录仍保留，不会因为排除音乐榜单而被删除。有声内容按分类区分，误当音乐的文件应先纠正分类；修正会影响既有记录如何归类。

在播客订阅列表打开节目菜单，可把节目放进文件夹或添加标签，再通过文件夹和标签筛选。文件夹用于分组，标签可同时添加多个；修改的是订阅的组织方式，不会把节目音频移动成磁盘文件夹。

在对应播客的节目菜单选择“全部标为已播放”，可以把当前已有单集统一标记为已播放；以后发布的新单集仍会按未播处理。这个动作更新播放状态，不会删除单集、取消订阅或清理已下载音频。

支持上报 Apple Music 的实际收听记录。先在“听歌记录”连接并启用 Last.fm 或 ListenBrainz；歌曲时长至少 30 秒，实际听够半首或 4 分钟中的较短值才上报，拖进度条不算已听时长。未达门槛就切歌不会补报，失败记录可在待上报队列查看。

可以在“歌词设置 → 不翻译的语言”勾选希望保留原文的语言。目标语言本来就会跳过，不需要重复选择；这个设置控制自动翻译，不会删掉歌词文件原来带的双语内容。要隐藏已有译文，可另关“显示歌词自带的译文”。

可以在歌词设置选择百度翻译，填入自己的 APP ID 和密钥，保存后用“测试”确认配置，再设为当前翻译方式。百度翻译使用独立配置，不等于填一个通用 AI Key；具体可用性和额度由你的百度翻译账号决定。

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

在设置中搜索“小组件颜色”，选择“单色”。进度条和底色等会使用黑白灰，封面仍保留原图颜色。选择“取自封面”可恢复随内容和主题变化的配色；它与手机系统对小组件的整体着色设置是不同层级。

在颜色/主题色设置里分别选择音乐、电台、有声书或播客。电台、有声书和播客可用默认色、跟随主题、跟随封面或固定颜色；音乐使用自己的主题色设置。改的是该类内容的界面颜色，不会修改封面图片。

先确认两端登录同一 iCloud，并开启 iCloud 同步总开关和“歌单”同步项，再使用“立即同步”。歌单同步传的是歌单记录，不会把设备里的音频文件一起搬过去；另一端仍需要可访问、可匹配的歌曲。已有音频不等于歌曲身份一定相同，持续缺失时保留歌单和诊断检查，不建议先删除重建。

从资料库的“播客”进入，使用添加按钮可按节目链接订阅。找不到入口时，在设置搜索“播客”，检查资料库显示和首页播客区块是否开启。把本地文件夹归类为播客与订阅 RSS 是两种入口，想添加在线节目应使用播客页的添加功能。

设置中搜索“进度条”可选默认、波浪或细线圆点；搜索“进度条发光”可单独开关光晕。波浪在播放时流动，暂停或拖动时变平；有声书竖屏对非波浪样式另有应用开关，因此不一定立即变成音乐页同样的外观。

在设置搜索“全屏效果”，选择效果；还可搜索“动效强度”“帧率”或“自动切换”调整展示。效果预览可帮助确认样式，但依赖实时频谱的效果是否跟音乐动，还取决于播放来源和音频路径。它不是播放音质或音效强度设置。

连接成功不等于模型能完成推荐或翻译请求；模型的推理输出、响应格式和耗时仍可能导致测试失败。当前客户端对识别为自托管的 Chat Completions 服务尝试减少推理，遇到不支持该参数的 400/422 会去掉参数重试一次。仍失败时请提供服务类型、模型名和具体错误，不能只凭“连接成功”判断配置全部正确。

Primuse 会按专辑名和专辑艺术家组合整理资料库，未提供专辑艺术家时再回退到曲目艺术家；分组身份不带音乐源 ID。因此多个源里的同一专辑可能合并，合辑标签不同也可能拆开，不能把全部资料库的数量直接等同于单台服务器。排查时先比较同一来源、同一范围，再检查专辑艺术家标签。

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

不需要先在手机上手动打开 Primuse：在车机上点 Primuse，iOS（iPhone 的操作系统）可以直接启动手机里的 App，并显示 CarPlay 界面，手机端页面无需打开。

但这不等于“只要连上车机，Primuse 就一定自动启用”。对于手机和车机都不操作、仅连接 CarPlay 的情况，目前不能保证每次都会自动启动，也不能仅凭未自动启动就认定是 Primuse 的故障。