设置教程

这份教程按 github.com/moekotori/echo 当前代码里的设置页来写，面向第一次用 ECHO NEXT 的用户。

先记住一句话：不懂就保持默认；听不见、卡顿、报错时先撤回刚改的设置，不要连续乱开高级项。

先看这里

情况	建议
只是想正常听歌	只改语言、关闭到托盘、输出设备、主题、曲库文件夹。
听歌时卡顿	开低负载播放模式，关实时频谱、视频背景、后台批量任务。
没声音	先切回系统输出或共享输出，关 EQ、ReplayGain、变速、DSD。
歌词不准	先手动换候选，再调单曲偏移，最后才改全局偏移。
MV 不准	手动选候选或填自定义 URL，不要怪音频输出。
曲库乱了	先查标签、合并策略、扫描状态，不要先删数据库。
数据库坏了	去危险操作里的恢复助手，先快照/恢复，再重建。

被追问时怎么答

先按这个口径回答，基本不会错：

用户问法	直接回答
我不知道这个要不要开	不懂就先别开。ECHO 的默认值是偏安全、偏稳定的；高级项是给明确知道自己要什么的人用的。
为什么我这里没有某个选项	有些设置会按平台、输出模式、账号状态、功能解锁、插件或当前页面状态显示。比如 ASIO/DSD 偏 Windows 和设备，下载动作要解锁，HQPlayer 要先启用集成。
改设置会不会删歌	普通设置不会删音乐文件。只有危险操作里写了清理、删除、重建、删除所有本地内容的按钮才是高风险；重复歌曲清理会把低优先级重复文件移到回收站。
哪些设置最容易把播放搞坏	输出模式、独占/ASIO/DSD、EQ、ReplayGain、变速、Automix、HQPlayer、代理、低延迟/重采样类选项。出问题先一个个关回默认。
歌词/MV 自动匹配不准怎么办	先手动选候选或填自定义 URL，再调单曲偏移；不要一上来改全局偏移、清库或删缓存。
卡顿是不是软件坏了	先关实时频谱、MV 沉浸背景、视频壁纸、后台补全，并把远程后台并发降下来。远程源、网络代理和机械硬盘也会让体验变慢。
我想恢复正常	播放输出切回 System/共享输出，关 EQ、ReplayGain、变速、DSD、HQPlayer，主题和歌词恢复默认，曲库问题先重扫，不要先删数据库。

设置入口

打开 ECHO NEXT，点左侧 设置。设置页分成这些页签：

页签	主要用途
通用	语言、窗口、启动、首页显示、备份、隐藏功能。
播放	输出模式、设备、低负载、音频高级项、ReplayGain、无缝播放。
快捷键	应用内快捷键和全局快捷键。
歌词	歌词显示、来源、偏移、桌面歌词、背景。
MV	MV 来源、质量、自动匹配、沉浸背景。
集成	代理、账号、Spotify/TIDAL、Discord、Last.fm、Windows 控制。
插件	本地插件目录、示例插件、插件页面入口。
远程	WebDAV、Jellyfin、Emby、Subsonic 等远程来源。
EQ	DSP 工作台入口和当前 DSP 状态。
外观	主题、侧栏、壁纸、字体、封面形状。
曲库	文件夹、实时更新、歌词补全、体检、重复歌曲、缓存、扫描。
关于	版本、更新、安全模式、诊断。
危险操作	数据库恢复、重复清理、清缓存、重置、删除本地数据。

通用

通用页主要管语言、窗口、入口显示、基础性能开关和数据备份。下面四张图来自 photos/Settings/通用，教程按截图从上到下讲。

图 1：语言、引导、Pro 与窗口启动

设置	怎么用	新手建议
显示语言	切换简体中文、繁體中文、日本語、English。	选自己看得懂的语言即可，一般不需要重启。
新手教程	重新打开第一次启动时的引导，里面会快速介绍本地曲库、输出模式、歌词、外观和账号入口。	不知道从哪里导入音乐、怎么选 WASAPI Shared / Exclusive / ASIO 时，先打开它。
用户须知	重新阅读使用 ECHO 前必须同意的用户须知，包含社区边界、DMCA、反馈和 AI 代码说明。	出现版权、下载、远程协助、反馈边界相关问题时先看这里。
Pro 激活	打开解锁 Pro、插件启用、网页解绑/备用、展开详情等入口。	购买或拿到 Pro Key 后再用；没有 Pro 需求时不用管。
ECHO Pro 账号	查看当前 Pro 账号/插件解锁状态，可显示 HWID 或展开更多信息。	反馈 Pro 激活问题时可以截图状态，但不要公开发自己的密钥。
关闭时隐藏到托盘	点击窗口关闭按钮时，把 ECHO 隐藏到托盘继续运行，而不是退出。	想后台听歌就开；希望点关闭就真正退出，就保持关闭。
开机自启动	登录 Windows 后自动启动 ECHO。默认关闭。	每天都用 ECHO 可以开；不想拖慢开机就关。
歌词/MV 图形内存保护	当歌词页或 MV 页面触发 renderer 图形内存压力时，自动关闭部分背景视频和高成本效果。	低配电脑、核显、长时间播放 MV 或歌词背景时建议开；正常机器可先保持默认。
启用屏幕键盘	输入字段聚焦时自动显示屏幕上的 Windows 键盘。	触摸屏、平板模式用户可开；普通键鼠用户不用开。

图 2：侧栏、功能入口与基础提示

设置	怎么用	新手建议
隐藏侧栏	让左侧栏自动贴边隐藏，鼠标移到边缘时再抽出。	小屏幕可开；如果经常找不到页面，先关掉。
侧栏仅显示图标	左侧栏保留图标，但隐藏文字名称，鼠标悬停仍可查看名称。	熟悉各页面图标后再开；新手建议先保留文字。
流媒体入口	控制左侧是否显示流媒体页面。关闭后会隐藏入口，进入在线音乐搜索和收藏前仍需同意流媒体功能须知。	只听本地曲库可以关；需要在线搜索或收藏就开。
osu downloader 入口	在左侧显示 osu downloader，用于搜索 osu! beatmap 并提取音频到下载流程。	不玩 osu! 或不需要提取 beatmap 音频就关。
显示插件 / 网盘 / EQ 设置栏目	在设置栏目中显示插件、网盘/远程和 EQ；功能入口仍保留在左侧。	想让设置页更短可以关；需要调整插件、远程源或 DSP 时再开。
关闭功能注释	收起设置、抽屉和导航里的解释性说明，只保留标题、控件与状态。	熟悉 ECHO 后可开；新手不要急着关，否则很多说明会消失。
关闭所有通知	禁用 ECHO 内的提醒卡片、左上角通知和播放栏通知。	日常不建议开，除非你明确不想看到任何提示。
下一首预告	当前歌曲快播完时，在左上角显示下一首的时间、歌曲名、艺术家和专辑。	随机播放、歌单播放建议开；不想被打扰就关。
右键菜单扩展动作	在曲目右键菜单中显示 osu! Timing、用系统默认应用打开、复制/保存歌曲卡片图片等动作。	默认隐藏可保持菜单清爽；需要这些高级动作时打开。
记住窗口尺寸	记住上次使用后的窗口宽高，下次启动自动恢复。	建议开。
快速启动	启动时只做轻量快速曲库验证，完整数据保护快照会在窗口打开后后台完成。默认关闭。	大曲库用户可开；如果正在排查数据库或启动异常，先关掉。

图 3：扫描、显示效果、搜索与在线资料

设置	怎么用	新手建议
扫描写入性能模式	曲库数据库使用更激进的同步策略，减少大批量扫描时的写入压力，但断电或系统崩溃时保护弱一些。	只有大批量导入且电脑稳定时再开；移动硬盘、容易断电或正在修库时别开。
关闭数据保护	不再执行启动、后台、扫描完成和更新前的数据保护快照。	高风险。除非你明确知道快照拖慢了工作流，否则不要打开。
波形进度条	底部播放栏用粗波形样式显示进度。	喜欢可视化可以开；低配电脑卡顿时先关。
信号路径	在底部播放栏显示 Signal Path 入口。歌词页可能会隐藏。	想看当前输出链路、DSP、重采样路径时打开。
主页波形图	首页显示“今日回声”的实时波形图。关闭后不渲染波形，也会跳过主页波形相关频谱分析。	默认开即可；如果首页卡顿、风扇明显变吵，可以关。
实时频谱分析	让主页波形请求主进程计算频谱。低负载播放模式会强制关闭它。	默认关更稳；只有想看实时 FFT 频谱时再开。
首页随机标题	首页标题从文案池随机抽取，显示一点随机风格。	纯外观选项，随喜好。
简繁互搜	输入繁体可搜到简体结果，输入简体也可搜到繁体结果。	中文、日文汉字、ACG 曲库建议开。
流媒体专辑	在艺人详情页的本地专辑下方按需搜索并显示流媒体专辑，可选网易云或 QQ 音乐。	想补全艺人在线专辑可开；只想看本地曲库、怕页面变慢就关。
艺人信息源	选择刷新艺人简介时使用的百科来源，例如百度百科或 Wikipedia。	中文网络环境可优先百度百科；国际艺人、英文资料可选 Wikipedia。
开发控制台	打开运行期 stdout/stderr、主进程日志和渲染器 console。	只有反馈问题、复现报错、开发调试时使用，日常不用开。

图 4：设置备份、自动备份与数据包迁移

设置	怎么用	新手建议
设置参数备份	导出设置 会导出 ECHO Next 设置参数；导入设置 用于迁移到新设备或恢复配置。	大改设置前先导出一份，出问题时能快速回滚。
自动数据备份	备份设置、曲库索引、播放记忆、账号本地状态、壁纸、封面缓存和元数据；备份前会校验曲库数据库，坏数据会被拒绝。	大曲库用户建议配置，但先选一个稳定目录，不要选会随时断开的盘。
自动备份开关	控制自动备份是否启用。截图里显示“自动备份未开启”。	没选目录前先别开；目录设置好后再启用。
备份目录	指定备份 zip 文件保存位置。	选空间足够、路径稳定的位置；不要放到临时目录。
备份周期	可选 3 天、7 天、每月。	普通用户选 7 天；频繁整理曲库可以选 3 天。
立即备份	不等周期，立刻生成一次备份。	升级、重扫曲库、大量改标签或清理前先点一次。
导入备份	从已有备份恢复设置和数据。	恢复前确认备份来自你自己的 ECHO，避免覆盖当前状态。
打开目录	打开当前备份目录。	用来确认备份文件是否真的生成。
一键导出 / 迁移 ECHO 数据包	导出设置、曲库索引、歌单快照、封面缓存路径和账号状态说明；不会复制音乐文件，也不会导出登录密钥。	迁移电脑、反馈复杂问题、修数据库前使用。
恢复入口	打开数据包恢复入口。页面提示：恢复前请先在危险区创建健康快照，迁移包里的 RESTORE.md 会说明每个文件用途。	真要恢复前先读 RESTORE.md，不要直接覆盖不明文件。

播放

先保证普通歌曲能播放，再碰高级播放设置。

图 1：先把声音放出来

这页最上面先告诉你一件事：音频设置以右上角播放器抽屉为准。如果底部播放器旁边的音频抽屉和设置页显示不一致，先信播放器抽屉，因为它离真实播放链路最近。

照着做就行：

1. 没声音时，先点 没声音就点我，不要一上来乱改 ASIO。
2. 输出模式 不懂就选 WASAPI Shared（推荐） 或安全模式；Exclusive 和 ASIO 是给会排查声卡的人用的。
3. 共享后端 日常用 WASAPI Shared；老设备或兼容性问题再试 DirectSound 兼容。
4. 输出设备 选你正在听的耳机、音箱、DAC 或声卡。选错设备就是最常见的“没声音”。
5. 播放时鼠标卡、界面卡、风扇吵，再开 低负载播放模式；还不够再开 低负载增强保护。
6. 高级播放设置 平时收起来。你没有 HiFi/排障需求，就别展开乱点。

图 2：高级输出和故障按钮

这一段是给“声音坏了、设备列表不对、想玩 ASIO/DSD”的人用的。

看见什么	应该怎么做
重启音频引擎	ECHO 自己的音频链路卡住时先点它，风险低。
重启 Windows 音频服务	会影响其它软件声音，确认其它播放器/浏览器不重要时再点。
音频问题诊断窗口	反馈播放异常时打开，给开发者看状态、进度、duration、backend、underrun 等信息。
JUCE 主输出	需要原生音频输出链路时再开；普通听歌不需要。
长驻原生解码	WAV/FLAC/MP3 想走原生解码时用；失败会回退。
DSD DoP 直出试验	只有本地 DSF、ASIO、DAC 都支持 DSD 时再开。
ASIO 原生 DSD 实验	高风险实验项，不懂就关。
ASIO 不可用保护	ASIO 找不到设备时自动回到安全输出，建议开。
独占不稳定自动切共享	WASAPI 独占 underrun 或设备异常时回到共享输出，建议开。
SOXR 回退保护	重采样出问题时回退到 FFmpeg 默认重采样，建议开。

图 3：变速、导出、小窗和音量标准化

这一屏管的是播放体验，不是“有没有声音”的第一入口。

功能	傻瓜解释	建议
变速模式	Nightcore 会偏快偏高，Daycore 会偏慢偏低，普通变速更朴素。	听正常音乐就用普通或别动；排查问题先回 1.0x。
音频导出格式	底栏导出按钮用什么格式保存。	不懂选 MP3；要无损再选 FLAC/WAV。
固定音量	把 ECHO 音量锁到 100%。	接外部 DAC/前级时可开；耳机直插慎开。
播放暂停淡入淡出	播放/暂停时慢慢进出声音。	有爆音就开一点；追求原始输出就关。
迷你播放器	小窗显示封面、歌名和进度。	想边工作边听就点 显示，找不到小窗点 重置位置。
A-B 循环	标记 A 点和 B 点，循环这一段。	练歌、扒谱、听细节时用。
Automix	让队列歌曲之间自动衔接。	随机听歌可试；听专辑别乱开。
专辑无缝播放	专辑曲目间尽量不插空。	现场、古典、连续专辑建议开。
随机播放模式	控制随机从全曲库、避免最近重复、伪随机等范围取歌。	大多数人选避免最近重复即可。
音量标准化	ReplayGain，让不同歌响度接近。	随机播放建议开；bit-perfect 测试要关。

设置	怎么用	新手建议
输出模式	选择 System、Shared、Exclusive、ASIO 等输出链路。	不懂就用 System；Windows 日常可用共享输出。
共享后端	共享输出下选择系统后端。	默认自动即可。
输出设备	选择耳机、音箱、DAC、声卡。	选你正在听的设备；选错会没声音。
低负载播放模式	降低播放时的后台和可视化压力。	播放中鼠标卡、界面卡、风扇吵时打开。
低负载增强保护	进一步降低轮询、桌面歌词、诊断和后台曲库任务影响。	大曲库或低配电脑建议开。
播放高级面板	展开高级音频设置。	没问题别展开乱改。
软重启音频引擎	重置 ECHO 音频引擎。	没声音、设备切换失败时先试这个。
重启 Windows Audio 服务	重启系统音频服务。	风险较高，会影响其它应用声音；确认再点。
音频问题诊断窗口	打开额外诊断窗口。	复现音频问题时开。
使用 JUCE 输出	用原生音频输出链路。	需要 WASAPI/ASIO 等高级输出时再开。
使用原生解码	使用原生解码链路。	特殊格式或高阶输出测试时再开。
DSD DoP	ASIO 下以 DoP 方式输出 DSD。	只有 DAC 和驱动明确支持才开。
ASIO Native DSD	实验性 ASIO 原生 DSD。	高风险实验项，不懂别开。
ASIO 不可用回退	ASIO 设备不可用时自动回退。	建议开，避免直接无声。
Exclusive 不稳定回退	独占输出不稳定时回退。	建议开。
SoXR 回退	重采样失败时回退到 SoXR。	建议保持开启。
变速模式	选择变速时的音调策略，例如 Nightcore/Daycore 类效果。	平时保持默认；排查播放问题先恢复 1.0x。
音频导出格式	选择导出音频格式。	不懂选 MP3；要无损再选 FLAC/WAV。
固定音量	开启后播放器音量锁到 100%。	接 DAC、前级或外部音控时可开；耳机直推慎开。
播放/暂停淡入淡出	设置播放、暂停时的淡入淡出时长。	轻微淡入淡出能减少爆音；追求原始输出则关。
迷你播放器	显示/隐藏小窗，重置位置，设置是否自动隐藏主窗口。	适合边工作边听；找不到窗口时重置位置。
片段循环	在当前歌曲内循环一小段。	练歌、扒谱、听细节时用。
Automix	智能过渡、交叉淡入淡出。	随机听歌可开；专辑连续听建议关。
无缝播放	连续播放专辑曲目时减少间隙。	听现场、古典、无缝专辑建议开。
ReplayGain 开关	让不同歌曲响度接近。	随机播放建议开；bit-perfect 测试要关。
ReplayGain 预设	标准/安静目标响度。	普通用户选标准，夜间听可选安静。
ReplayGain 模式	Track、Album、Off。	随机听选 Track，整专辑选 Album。
防削波	降低过载爆音风险。	建议开。
播放时分析响度	播放没有响度数据的歌时补分析。	建议开。
扫描时分析缺失响度	扫描曲库时批量分析缺失 ReplayGain。	大曲库会耗时；空闲时再开。
目标 LUFS	ReplayGain 目标响度。	常用 -14 LUFS，越低越安静。
前级增益	在 ReplayGain 后整体加减音量。	不懂保持 0 dB；爆音就降低。
单声道	左右声道合并。	单耳听、检查相位时用，平时关。
音频状态	查看采样率、设备、DSP、警告并复制诊断。	出问题时截图或复制给开发者。
设备列表	展开后看设备名、索引、采样率和当前输出模式。	选错设备、采样率异常时看。

播放器音频抽屉

底部播放器也能打开音频抽屉。它和 设置 -> 播放 用的是同一批设置，但更偏“立刻切设备、立刻排查”。

设置	怎么用	新手建议
当前输出摘要	显示当前编码、设备、采样率、重采样、延迟等信息。	没声音或采样率异常时先看这里。
高采样率警告	输出采样率过高时提示。	出现警告时先切回普通 44.1/48/96 kHz 路径。
低负载播放模式	同设置页的低负载模式。	播放时卡顿可直接在这里开。
低负载增强保护	同设置页的增强保护。	大曲库边播边扫时可开。
HQPlayer 接管	让播放、上一首、下一首优先交给 HQPlayer。	只有已配置并测试 HQPlayer 后再点；退出接管后才能重新选本机输出。
系统音频	使用系统默认音频链路。	排查时最稳，没声音先点它。
系统默认输出	使用 WASAPI 跟随系统默认设备。	想让 Windows 决定输出设备时用。
具体 WASAPI 设备	直接选择某个耳机、音箱或 DAC。	设备名能认出来再选。
WASAPI 独占	独占当前设备。	可能抢占设备导致其它应用没声，不懂别开。
ASIO 设备	选择 ASIO 驱动和输出通道。	只给专业声卡、原厂驱动用户用。
打开 ASIO 控制面板	打开声卡厂商 ASIO 面板。	只有需要改声卡缓冲/通道时用。
ASIO 输出路由	多输出声卡选择 1/2、3/4 等通道。	选错通道会没声音。
高级输出	展开 JUCE、DSD、回退、缓冲等高级项。	没问题别展开乱改。
JUCE 输出	同播放高级里的原生输出。	高级输出需要时再开。
JUCE 解码	同播放高级里的原生解码。	特殊格式测试时再开。
DSD DoP	用 DoP 输出 DSD。	必须 ASIO 和 DAC 支持。
ASIO Native DSD	实验性原生 DSD。	高风险，不懂别开。
DSD 自动音量锁	播放 DSD 时锁定音量，避免误调。	真玩 DSD 可开；普通 PCM 不需要。
ASIO 不可用回退	ASIO 失败时回退。	建议开。
Exclusive 不稳定回退	独占输出不稳时回退。	建议开。
SoXR 回退	重采样失败时回退。	建议保持开启。
暂停时释放独占	暂停后释放 WASAPI 独占设备。	实验项；需要让其它应用临时发声时再试。
共享后端	Auto、WASAPI Shared、DirectSound、ALSA 等。	Windows 默认 Auto 或 WASAPI Shared。
缓冲/延迟档位	低延迟、均衡、稳定等。	爆音就选更稳定；打游戏/录音才追低延迟。
ASIO Buffer	给 ASIO 选择缓冲大小。	爆音加大，延迟高再减小。
记住输出	下次启动记住输出模式和设备。	常用固定 DAC/声卡建议开。
固定音量	同播放页固定音量。	外部前级/DAC 控音量时才开。
重置音频引擎	软重启音频引擎。	切设备失败、无声时先点。
隐藏设备	右键设备隐藏后在这里恢复。	设备列表太乱可隐藏；误藏了就恢复。
显示 ASIO 面板设置	控制是否显示“打开 ASIO 控制面板”。	没 ASIO 需求就关。

HQPlayer 连接配置

HQPlayer 主要在 局域网播放 / Connect 页面配置，设置存储里对应 hqPlayer。

设置	怎么用	新手建议
启用 HQPlayer 集成	让 ECHO 显示 HQPlayer 外部输出入口。	不用 HQPlayer 就关。
连接模式	本机 HQPlayer Desktop 或远程 HQPlayer。	HQPlayer 在本机运行就选本机。
Host	HQPlayer 控制端地址。	本机一般是 127.0.0.1。
Port	HQPlayer 控制端口。	默认常见为 4321，以你的 HQPlayer 设置为准。
可执行文件路径	HQPlayer 程序路径。	需要 ECHO 找到本机程序时再填。
允许启动	允许 ECHO 尝试启动 HQPlayer。	不想被自动拉起就关。
媒体服务器	给远程 HQPlayer 暴露本地媒体。	远程播放本地文件时才需要。
媒体服务器端口	本地媒体服务端口。	冲突时换端口。
默认播放后端	ECHO Native、HQPlayer、询问。	新手选询问或 ECHO Native，确认稳定后再优先 HQPlayer。
Profile 名称	交给 HQPlayer 时指定配置档。	不懂留空。
检测 HQPlayer	测试 TCP 连通性和状态。	配完必须先测。
HQPlayer 状态	disabled、not configured、checking、available、unavailable。	只有 available 才说明可用。
播放交接预演	检查当前曲目能否交给 HQPlayer。	外部输出失败时看原因。

HQPlayer 是外部渲染器。ECHO 能控制和交接，不代表 ECHO 决定最终滤波、升采样、DSD、NAA、DAC 输出。HQPlayer 自己播不响时，先修 HQPlayer，不要在 ECHO 里乱改输出设备。

快捷键

每个动作都有两列：应用内快捷键 和 全局快捷键。

动作	用途	新手建议
播放/暂停	控制当前播放。	应用内 Space 默认可用。
上一首 / 下一首	切歌。	全局快捷键容易冲突，录制后测试。
停止	停止播放。	不常用可留空。
音量加 / 音量减	调播放器音量。	开固定音量时意义不大。
快退 / 快进	跳转进度。	听长音频可设置。
显示主窗口	把 ECHO 拉回前台。	经常托盘后台听歌可设置全局键。
老板键	快速隐藏窗口。	需要时设置，不需要留空。
加速 / 减速	调播放速度。	听播客或练习时用。
打开音频设置	快速打开播放设置抽屉。	排查设备时有用。
打开 MV 设置	快速打开 MV 设置。	MV 用户可设置。
打开歌词设置	快速打开歌词设置。	歌词用户可设置。
定位当前歌曲	跳到当前播放歌曲。	大曲库常用。
切换桌面歌词	显示/隐藏桌面歌词。	桌面歌词用户建议设置。
锁定桌面歌词	防止误拖动桌面歌词。	调好位置后再锁。

录制失败通常是快捷键被系统或其它软件占用。换一个组合，不要硬抢系统快捷键。

歌词

歌词设置也会出现在歌词抽屉里，设置页直接复用同一套面板。

图 1：先决定要不要显示歌词

先别管高级来源，第一屏只回答一个问题：你要不要看歌词，以及歌词挡不挡你。

1. 启用歌词 关掉后，歌词页不会加载，也不会搜索或匹配歌词。
2. 歌词匹配度设置 是自动应用歌词的门槛。数值越高越保守，数值越低越容易自动套错歌词。新手别调太低。
3. 隐藏歌曲信息 会隐藏歌词页里的歌曲信息，想画面干净再开。
4. 自动弹出歌词选择栏 会在需要你选歌词候选时弹出来。歌词不准的人建议开。
5. 迷你底栏 是歌词页底部的小播放控制条。想少挡画面可以开自动隐藏。
6. 播放 MV 时自动启用 适合边看 MV 边看歌词。
7. 底栏透明度 和 底栏颜色 只影响看起来，不影响播放。
8. 显示罗马音、假名和翻译，都是辅助文本。你看不懂日文、韩文或外文歌词时再开。

图 2：歌词字体、字号和桌面歌词

这一屏就是“字怎么看得舒服”。

设置	怎么理解	新手建议
优先 UtaTen 假名注音	日文歌词优先显示 UtaTen 的假名注音。	日文歌多就开；匹配不到会自动回退。
显示中文翻译	有翻译时显示中文，没有翻译就不会凭空生成。	想看意思就开。
逐字歌词高亮	真正有逐字时间轴时才有意义。	没有逐字歌词时别纠结它不动。
歌词字体	可用系统字体、导入字体文件、恢复默认。	不知道选什么就系统字体；花体字看久会累。
辅歌词字号 / 歌词字号	分别控制翻译/罗马音和主歌词大小。	主歌词先调到能看清，再调辅歌词。
歌词行距	行与行之间的距离。	太挤就加，太散就减。
每行字数	一行最多显示多少字。	自动即可；竖排或超宽屏再调。
上下文透明度	前后歌词有多淡。	想专注当前句就调低。
歌词颜色	手动选歌词颜色。	看不清时先换颜色，不要先改一堆来源。
桌面歌词	在桌面上显示独立歌词窗口。	想切到别的软件也看歌词再开。
桌面歌词显示罗马音/翻译	控制桌面歌词里的辅助文本。	屏幕小就少开，别把桌面堆满。

图 3：桌面歌词排版和歌词背景

这一屏大多是“显示效果”，不是修歌词不准。

1. 无歌词时隐藏桌面歌词 开了以后，没有歌词的歌不会显示占位文字。
2. 桌面歌词排版 可选横排或竖排。横排适合日常，竖排适合特定审美。
3. 桌面歌词主字号 / 翻译字号 / 透明度 调的是桌面小窗，不是歌词页主体。
4. 沉浸式专辑封面样式 会让歌词背景更像沉浸封面，不改变歌词来源。
5. 沉浸封面毛玻璃 增加模糊玻璃效果。低配电脑卡顿就关。
6. 智能可读颜色 会根据封面、壁纸或 MV 画面自动挑更容易看的文字色。
7. 歌词可读性增强 会加描边/投影，适合背景复杂时开。
8. 显示歌词背景设置 可选跟随主题、封面或自定义壁纸。
9. 请求网络元数据的高清封面 只是在跟随封面时临时请求高清图，关掉就用本地封面底图。

图 4：歌词来源、自动匹配和延迟

歌词不准时，按这个顺序来，别反过来：

1. 先开 启用在线歌词匹配，否则只能用本地歌词。
2. 再看 歌词源，本地歌词会优先；没勾选的在线源不会参与自动匹配。
3. 深度优先搜索 会多个平台一起找，找得更全，但也更慢。
4. 自动匹配歌词 是让 ECHO 自己应用结果；如果经常套错，降低自动化，手动选候选。
5. 自动保存本地歌词文件 会把在线手动应用的歌词保存成歌曲同名旁挂文件，不覆盖已有 .lrc/.ttml/.txt。
6. 新歌词默认延迟 只影响新匹配歌词。
7. 全局延迟 会影响所有歌曲。只有所有歌都统一早/晚，才动它。
8. 应用歌词时间轴校准 会把校准写进当前歌曲记忆；别拿它修所有歌。
9. 显示本歌曲延迟校准 只是把单曲校准显示出来，方便你知道这首歌有没有被单独调过。
10. 智能歌词校准 适合少数高置信自动保存的情况；异常歌源很多时别乱开。

设置	怎么用	新手建议
歌词显示总开关	控制歌词页是否显示歌词。	想看歌词就开。
隐藏歌词页标题	减少顶部信息占用。	喜欢沉浸显示再开。
MV 自动显示曲目信息	MV 场景是否自动显示曲目信息。	看 MV 时信息挡画面就关。
候选面板自动打开	找到候选歌词后自动展开候选列表。	经常手选歌词可开。
空状态隐藏	没歌词时减少空提示。	新手建议保持默认。
播放栏歌词抽屉	底部播放栏显示歌词小抽屉。	想随时看歌词可开。
MV 自动启用播放栏歌词	进 MV 时自动启用歌词抽屉。	看 MV 还想看歌词就开。
播放栏歌词自动隐藏	不需要时自动收起。	小屏幕可开。
播放栏歌词透明度	调整底栏歌词不透明度。	看不清就调高。
播放栏歌词颜色模式	默认、自定义、跟封面。	不懂用默认。
播放栏歌词颜色	自定义颜色模式下使用。	背景复杂时选高对比色。
罗马音	显示读音辅助。	日文、韩文、外语跟唱可开。
Utaten 假名增强	获取日文假名辅助。	日文歌可开；网络不稳可关。
翻译	显示翻译行。	想理解歌词就开；嫌乱就关。
逐词高亮	同步歌词时突出当前词。	喜欢卡拉 OK 效果可开。
高亮清晰度	调逐词高亮强度。	看不清就提高。
主歌词字号	调主歌词大小。	远看调大，窗口小调小。
副歌词字号	调翻译/罗马音大小。	副歌词抢戏就调小。
歌词字体	选择字体或字体文件。	先用系统中文字体。
文字方向	横排或竖排。	大多数用户用横排。
行距	调歌词行间距。	太挤就加大。
每行最大字符数	控制长句换行。	0 表示不强制；长句撑屏幕时设置。
上下文透明度	非当前行的透明度。	想突出当前行就降低。
歌词颜色	主歌词颜色。	背景暗用浅色，背景亮用深色。
智能可读颜色	自动根据背景增强可读性。	背景复杂时开。
背景模式	主题、封面、封面取色、自定义壁纸。	新手用主题或封面。
高分辨率网络封面	背景为封面时尝试高清网络封面。	网络好可开，加载慢就关。
自定义歌词壁纸	给歌词页选择壁纸。	只影响歌词背景，不改应用壁纸。
背景缩放	调整歌词背景大小。	背景边缘露出就加大。
封面透明度	背景封面可见程度。	字看不清就降低。
封面模糊	背景模糊半径。	字看不清就加大。
封面亮度	背景明暗。	亮背景影响阅读就调暗。
在线歌词	是否使用网络找歌词。	想自动匹配就开。
深度搜索	扩大搜索来源和候选。	找不到歌词时开；卡顿或网络差时关。
歌词来源	LRCLIB、AMLL TTML、网易、QQ、酷狗、酷我等。	保留本地和常用中文源即可。
来源顺序	拖动决定优先级。	哪个更准放前面。
自动搜索	播放时自动找歌词。	建议开。
自动保存 sidecar	自动把歌词保存到旁路文件。	想把歌词沉淀到本地可开。
默认偏移	每首歌默认时间偏移。	不要乱改；只在全库普遍早晚时用。
全局同步偏移	全局微调歌词显示延迟。	只调小范围，别拿它修单首歌。
时间轴修正	自动修正部分时间轴问题。	建议开。
显示单曲偏移控件	在歌词界面显示单曲偏移入口。	常手动校准歌词可开。
智能对齐	尝试更聪明地对齐歌词。	建议开。
还原歌词时序默认值	重置自动接受分数、默认偏移和全局偏移。	调乱了就点。
桌面歌词字体	桌面歌词单独字体。	不影响主界面字体。
桌面歌词透明度	桌面歌词整体透明度。	看不清调高，挡画面调低。
桌面歌词方向	横排或竖排。	大多数用户横排。
桌面歌词罗马音/翻译	桌面歌词是否显示辅助行。	觉得占空间就关。

MV

图 1：MV 来源、质量和沉浸背景

MV 页就三件事：开不开 MV、从哪里找、背景要不要花。

1. 启用 MV 是总开关。关了就别问为什么没有 MV。
2. 最高画质 是上限，不是保证每个 MV 都有 4K。网络源没有就不会凭空变出来。
3. 自动搜索网络 MV 会自动找 MV；关掉后你需要手动搜索或应用。
4. 是否预加载 MV 会提前准备视频，切歌体验更顺，但会吃网络和缓存。
5. 只用歌曲名搜 MV 会减少艺人名干扰，适合标题比较准但艺人字段乱的曲库。
6. 按播放量匹配 倾向播放量高的结果，适合热门歌；冷门歌可能不准。
7. MV 跟随音乐进度 让视频尽量跟音频同步。
8. 稳定 / 均衡 / 精准 是匹配和播放策略。默认用均衡；视频模糊或 GPU 弱就别追精准。
9. 切换 MV 后自动重播音乐 适合你希望音频和新 MV 从头对齐。
10. 自动应用匹配度 是自动套用 MV 的门槛。数值越高越不容易乱套。
11. Bilibili / YouTube 可以调顺序和开关。哪个源不通或结果差，就关掉或下移。
12. 沉浸式 MV 背景 会把 MV 当背景，调缩放、模糊、亮度、暗色遮罩。低配电脑卡顿就关。

设置	怎么用	新手建议
MV 总开关	控制是否启用 MV 功能。	不看 MV 可关。
最高质量	限制 720p、1080p、4K、最高等。	电脑一般选 1080p；显卡好再最高。
自动匹配	自动搜索并应用高分候选。	想省事可开；匹配错就关或提高阈值。
自动预加载	提前准备 MV 候选。	网络好可开，网络差可关。
优先播放量最高	候选里偏向高播放量。	流行歌可开，冷门/翻唱容易误匹配。
加载 MV 时重启音频	为了同步重新启动音频。	不懂别开；可能打断播放。
同步模式	stable、balanced、precise。	开重启音频后用 balanced。
切换 MV 重播音频	换 MV 时重播音频。	需要重新对齐时开。
自动应用阈值	候选分数达到多少才自动使用。	匹配错就调高。
MV 来源	Bilibili、YouTube 可开关、排序。	哪个更准放前面。
沉浸背景	用 MV 画面做背景。	好看但吃 GPU；卡顿就关。
沉浸背景缩放	调整背景放大。	露边就放大。
沉浸背景模糊	模糊背景。	字看不清就加大。
沉浸背景亮度	调暗或调亮背景。	字看不清就调暗。
背景遮罩透明度	加遮罩让文字更清楚。	背景太花就提高。

集成

图 1：账号、外部展示和系统联动

联动页不是播放音质页，它管的是“ECHO 和别的软件怎么互相知道状态”。

功能	干什么	新手建议
账号登录	保存平台登录状态，供歌词、元数据、MV、下载和流媒体接入使用。	需要哪个平台再登录哪个，不要乱登一堆。
刷新全部	重新刷新账号状态和联动状态。	状态不对时点一次。
开发者 / API 配置	Spotify、TIDAL、Discogs、在线歌手和 Last.fm 等密钥配置。	不知道 API 是什么就别展开。
Discord 状态	把正在播放同步到 Discord Rich Presence。	显示 Error 时先确认 Discord 正在运行。
OBS 浏览器源	复制链接给 OBS 显示当前歌词和曲目信息，不播放音频。	直播展示用；普通用户不用开。
Stage API	开本机 HTTP/SSE 接口给 Stage 客户端读取播放状态。	需要外部控制面板才开。
Windows 媒体控件	把播放信息发布到 Windows 音量浮层和锁屏媒体控件。	Windows 用户建议开。
SMTC 歌词显示	把歌词也写进 Windows 媒体信息。	怕隐私或不想污染系统字段就关。
任务栏音乐控制	在任务栏缩略图里显示播放按钮。	想在任务栏切歌可开。

图 2：启动检查、Spotify、手机遥控和代理

这一屏主要是“启动时要不要自动查”和“网络请求怎么走”。

1. 启动时刷新账号登录状态 只检查以前登录过的账号，没有登录过的平台会保持静默。
2. 关闭账号失效通知 开了以后，账号失效不会弹左上角提醒，但状态还在这里看得到。
3. Spotify 自动启动官方播放器 是给 Spotify 播放用的：如果内置 SDK 因 DRM 不可用，会尝试启动 Spotify 桌面端或网页版并接管 Connect 设备。
4. 手机遥控 还没外部设备能力时会变成受控 IPC，不让 renderer 直接占系统资源；普通用户不用碰。
5. 网络代理 给网页登录、网络封面、歌词、MV 搜索和元数据补全使用。
6. 第一版只建议代理联网能力，不建议让远程曲库和播放字节流走代理，避免影响正在播放的稳定性。
7. 如果你不知道自己有没有代理，就保持 关闭。填错代理地址，网络歌词/MV/元数据会更容易失败。
8. 改完代理后点 保存并应用，再点 测试连接。不要只填了地址就以为生效。

设置	怎么用	新手建议
网络代理模式	关闭、系统代理、手动代理、PAC。	本地听歌不需要代理；网络歌词/MV失败再看。
手动代理地址	填 http://、socks5:// 等代理地址。	不懂别填。
PAC 地址	填 PAC 配置 URL。	只有你知道 PAC 是什么才用。
代理绕过规则	哪些地址不走代理。	默认会绕过本机和局域网，别随便清空。
保存/测试代理	保存代理并测试网络。	改代理后先测试。
Discogs 专辑评分 token	给专辑评分兜底。	可留空；想更稳定再填 token。
在线歌手信息 API	Bandsintown、Ticketmaster、SeatGeek、地区等。	不看演出信息可不填。
Discord Rich Presence	在 Discord 显示播放状态。	想展示就开，不想暴露听歌状态就关。
Windows SMTC	系统媒体控制、状态栏媒体信息。	Windows 用户建议开。
SMTC 歌词	SMTC 里带歌词。	不需要系统层歌词就关。
任务栏播放控制	Windows 任务栏缩略图按钮/进度。	Windows 用户可开。
Last.fm	登录并 scrobble。	用 Last.fm 才开。
Last.fm scrobble	记录播放历史到 Last.fm。	不想上传记录就关。
Last.fm Now Playing	上报当前正在播放。	不想实时暴露就关。
Last.fm 最短记录秒数	播放超过多少秒才 scrobble。	默认即可。
启动检查账号状态	启动时检查 YouTube、Bilibili、Spotify 等账号是否失效。	建议开。
关闭账号失效通知	登录失效时不弹左上角提醒。	不想被打扰可开，但别忘了手动查状态。
Spotify 自动打开官方播放器	Spotify 相关操作时尝试拉起官方播放器。	Spotify 用户建议开。
Spotify OAuth 配置	填自己的 Client ID 和 Redirect URI。	要 Spotify 登录才填。
TIDAL Developer 配置	填 Client ID、Secret、回调地址、国家码。	只用于 catalog 元数据，不接入播放流。
账号登录面板	Bilibili、YouTube、Spotify、TIDAL 等登录/检查/清除。	网络功能失败时先检查账号状态。
移动端集成	预留入口。	当前不用管。

插件

设置	怎么用	新手建议
打开插件页面	进入插件管理页。	管插件时从这里进。
打开插件目录	打开 userData/plugins。	手动安装插件时用。
创建示例插件	生成播放状态面板示例。	学插件开发时用。
打开插件文档	打开插件教程。	不确定权限时先看文档。

插件权限里看到 settings:write、library:write、network 要谨慎。来源不明的高权限插件不要启用。

远程

远程页复用远程来源面板。常见设置包括来源类型、名称、服务器地址、账号、密码或 token、连接测试、同步/索引策略。

设置	怎么用	新手建议
来源类型	WebDAV、Jellyfin、Emby、Subsonic 等。	选你真实使用的服务。
显示名称	给远程库起名字。	用能看懂的名字，例如 NAS 音乐。
地址	服务器 URL。	复制完整地址，注意 http/https。
凭据	用户名、密码、token。	不确定就先在浏览器验证。
测试连接	保存前检查能不能连上。	必做。
索引/同步	是否把远程曲目写入索引。	先浏览，稳定后再索引。

大远程库不要一上来全量重任务。先测试连接、浏览、播放，再建索引。

EQ

设置页里的 EQ 页只保留 DSP 工作台摘要。

图 1：ECHO SRC / 升频先选倍率和质量策略

ECHO SRC / 升频 是 DSP 里的采样率转换，不是音量增强，也不是“自动变好听”。开了以后会进入 DSP 路径，并且不再标记为 bit-perfect。

最傻瓜的用法：

1. 不知道自己要什么，点 关闭。
2. 想试试升频，先用 2x PCM，不要一上来 8x Ultra。
3. 电脑性能不错再试 4x PCM；8x Ultra 更吃 CPU/GPU。
4. Transparent 偏透明低失真，Balanced 偏稳定开销平衡，Low latency 偏低延迟。
5. A/B 原生 用来对比开升频和不开升频的差异。听不出差异就别硬开。
6. 右上角 Bit-perfect 路径 可以帮你看当前是不是还保持原始输出。

图 2：高级滤波器和性能档位

高级模式里会出现 Filter / HQ-style、Filter 1x、Filter Nx、GPU Compute/CUDA 和一堆滤波器卡片。这里别慌：

区域	怎么看	新手建议
Realtime Safe	优先不卡、可控，适合实时播放。	第一次用高级模式先选它。
HiFi	听感更柔和，实时压力适中。	电脑还行可以试。
Reference	更重，偏参考级。	建议有较强显卡再试。
Insane / Offline-like	超吃配置，偏冲极限体验。	新手别碰，卡顿正常。
Filter 1x	原始采样率附近用的滤波器。	不懂选默认。
Filter Nx	高采样率来源用的滤波器。	不懂选默认。
GPU Compute / CUDA	用 NVIDIA CUDA 算滤波。	没装驱动或没有 NVIDIA 显卡就别开。

如果开了升频后爆音、卡顿、切歌慢，先降倍率，再换 Low latency 或 Realtime Safe，最后再关掉升频。不要同时改十个滤波器。

设置	怎么用	新手建议
Signal path	看当前是 Native direct 还是 DSP path。	想验证原始输出时应是 Native direct。
EQ 状态	看 EQ 是 Enabled 还是 Bypassed。	不调音就保持 Bypassed。
Preset	当前 EQ 预设名。	不懂就 Flat。
Safety	看是否有 Headroom risk。	有风险就降前级增益。
打开 DSP 工作台	去侧栏 DSP 做具体调音。	只在那里调 EQ、余量、声道。
刷新状态	重新读取当前音频状态。	状态不准时点。

外观

图 1：主题、定时深浅色和左侧栏

外观页只管“看起来和布局”，不会改变音乐文件。

1. 主题 可选浅色、深色、跟随系统、Ambient。新手选浅色或跟随系统。
2. 定时切换深色模式 会按时间自动切深色/浅色。先打开定时，再填切换时间。
3. 左侧栏 用来调整入口顺序和显示状态。误隐藏入口时点 恢复默认。
4. 主题预设 是整套颜色模板。先选一个预设，再在下面细调颜色。
5. 自定义当前主题 可以改亮/暗模式、主色、强调色和文字样式。改动会实时预览，保存后才写入设置。
6. 窗口亚克力 是实验性透明材质。Windows 11 22H2 及以上效果最好；如果窗口透明异常，重启 ECHO 或关掉它。

图 2：播放界面、右下角按钮和背景

这一屏适合把界面调顺眼，但别为了好看把电脑拖卡。

设置	怎么用	新手建议
播放界面封面取色	播放页从小封面抽色生成轻量背景。	低负载模式会跳过；卡顿就关。
右下角按钮	决定右下角显示哪些快捷按钮，如睡眠定时、桌面歌词、迷你播放器、音量、速度、下载、导出。	常用的留下，不用的隐藏，界面会清爽很多。
自定义背景	分别选择横屏背景和竖屏背景。	支持图片和本地视频；视频背景更吃性能。
展开字体与排版	调字体、字号、行距、文字深浅等。	字太小先调字号，不要先换奇怪字体。
专辑封面形状	圆角或方角。	纯外观，随喜好。
外观默认值	恢复 Outfit、Microsoft YaHei、Noto Sans SC、字号、行距、文字深浅和圆角封面。	调乱了直接恢复默认。

设置	怎么用	新手建议
主题	浅色、深色、跟随系统。	不懂选跟随系统或浅色。
主题定时	到点自动切深色/浅色。	晚上刺眼可开。
深色时间/浅色时间	设置自动切换时间。	例如 19:00 深色，07:00 浅色。
左侧栏	调整侧栏项目顺序、显示/隐藏。	找不到页面就点重置。
主题预设	选择内置主题。	先选预设，不要直接改一堆颜色。
自定义主题	新建、重命名、复制、导入、导出、保存、重置主题参数。	会折腾主题再用；低对比警告别忽略。
插件主题	导入已启用插件贡献的主题。	只用可信插件主题。
常用颜色	调背景、强调色、文字等主要颜色。	改完看文字是否还能读。
背景渐变	调 appBg、appBg2、appBg3 等渐变色。	别把背景调得影响阅读。
Surface	调标题栏、侧栏、播放器、列表层颜色。	UI 看不清就撤回。
状态色	success、warning、danger、focus。	不懂别改，改错会看不出警告。
Motion	动效开关、速度、强度。	晕动或卡顿就关或减弱。
高级细节	muted、border、buttonText 等细项。	只在主题成型后微调。
界面密度	紧凑/标准。	当前代码里紧凑为默认展示。
当前播放封面取色	正在播放界面跟随封面主色。	好看但可能影响可读性。
自定义背景	选择横屏图片/视频背景。	图片优先，视频卡顿就关。
竖屏背景	给窄窗口或竖屏场景单独选背景。	有竖屏使用需求再选。
视频背景暂停模式	智能、最小化暂停、从不暂停。	默认智能最稳。
背景缩放	调背景大小。	有黑边就放大。
背景模糊	调背景模糊。	字看不清就加大。
背景亮度	调背景明暗。	背景太亮就调低。
UI 透明度	调界面面板透明度。	看不清就调高。
视觉保护	给背景上的 UI 加保护层。	建议开。
统一透明度	统一部分 UI 透明表现。	追求一致观感再开。
主字体	设置界面主字体。	先用默认。
中文字体	中文字形优先字体。	中文显示怪就改这里。
兜底字体	缺字时使用的字体。	缺符号、缺日文假名时调整。
基础字号	改界面字号。	眼睛累就调大。
行高	改界面文字行距。	太挤调大，太松调小。
文本深度	调文字深浅。	看不清就调高。
专辑封面形状	圆角或方角。	喜欢实体唱片感可选方角。
外观默认值	恢复字体、字号、行高、文本深度和封面形状。	外观调乱了就点。

曲库

先把话说在前面：媒体库里的很多按钮都会读硬盘、扫文件、查网络、写数据库，播放时可能让界面卡、切歌慢、歌词/MV 延迟，严重时还会让声音短暂停顿。
尤其是机械硬盘、移动硬盘、网盘映射盘、NAS、超大曲库、同时播放 DSD/升频/MV 的情况下，更容易卡。最稳的做法是：先暂停播放或等一首歌播完，再跑扫描、补全、头像、重复分析、BPM、封面缓存迁移这些任务。

如果你正在听歌，媒体库操作按这个优先级处理：

1. 想马上稳定播放：先别扫库，先别补歌词，先别分析重复歌曲。
2. 必须边听边整理：把 扫描性能 设成 低占用，暂停头像获取，关完整歌词补全，只做小范围操作。
3. 已经开始卡：暂停正在跑的头像/歌词/BPM/扫描任务，关实时更新曲库，等播放稳定后再继续。
4. 大批量导入音乐：先导入并扫描完，再开始听歌；不要一边扫几万首一边开 MV、升频和实时频谱。
5. 用机械硬盘或网络盘：一次只做一件事。扫库、补封面、补歌词、分析 BPM 不要叠着跑。

图 1：导入扫描、资料质量和歌词补全

媒体库页管的是“ECHO 怎么认识你的音乐文件”。第一屏先别急着点重建，先看这些：

1. 文件夹 是音乐入口。点展开后添加你的音乐目录，不要扫整个系统盘，也不要把下载目录、桌面、游戏目录一起丢进去。
2. 添加文件夹后，ECHO 会读取文件名、标签、封面、时长并写入数据库。曲库越大越耗时，扫描时播放卡一点不奇怪。
3. 实时更新曲库 会监听已添加的本地曲库文件夹，新歌或修改文件会自动入库。机械硬盘、移动硬盘、网络盘不稳时，播放中建议先关。
4. Native File Scanner 是实验扫描器，只发现音频文件，不读元数据、不提封面、不写曲库。普通用户保持默认，不要因为名字像“更快”就乱开。
5. Native Metadata Reader 是实验元数据读取器，失败会回退 TypeScript。它会碰音频标签读取，曲库大时也可能带来后台压力。
6. 资料质量整理 是看封面、回退元数据、网络候选等问题，不是直接修所有问题。先看报告，再决定要不要补。
7. 一键歌词补全 会批量找缺失歌词，会访问网络、匹配候选、写入记录。播放中如果卡，先停它。
8. 快速补全缺失歌词 比完整补全轻一点；完整补全 更慢，适合睡觉前或离开电脑时跑。
9. 曲库体检报告 汇总数据库、扫描、缓存、资料质量和远程源状态。它是排查入口，不是清理按钮，先看它比乱重建安全。

图 2：头像、歌单备份、重复歌曲和合并策略

这一屏会动到整理结果，但大多数不会直接删除音乐文件。它们真正容易带来的问题是：后台任务太多时，播放和界面会变慢。

功能	怎么理解	新手建议
艺术家墙封面	没有歌手头像时，用艺术家的一张专辑封面顶上。	想让艺术家页好看可开。
歌手头像	自动获取、刷新缺失头像、继续获取、清除头像缓存。	这是网络 + 缓存任务，播放卡顿时先暂停。
歌单自动备份	刷新、清空或删除歌单前保存 JSON 备份。	建议开，歌单误删更好救。
重复歌曲	隐藏低质量重复版本，不会删除文件。	分析重复歌曲 会扫库，播放中别频繁点。
专辑/艺人合并策略	决定专辑和艺人别名怎么归并。	新手用标准/普通艺人合并；宽松合并可能误合并。
应用并重新整理分组	把合并策略应用到曲库分组。	会重整分组，曲库大时等空闲再点。
扫描曲库	重新扫描音乐目录。	改了标签、移动文件、换策略后再扫；正在播放时慎用。

图 3：嵌入标签、封面缓存和扫描性能

这一屏更偏维护和性能。看到“重扫、缓存、分析、性能”这几个词，默认都当成会占资源的操作。

1. 嵌入标签重扫 会重新读取音频文件里的标题、艺人、专辑、音轨号和封面。它会读很多文件，播放中可能卡。
2. 全部重扫 会无视缓存，适合大改标签后用；耗时最长，尽量别边听歌边跑。
3. 缺失封面 只重扫没有封面或只有默认封面的歌曲，比全部重扫轻，但大曲库仍然可能占硬盘。
4. 封面缓存目录 只是迁移或指定封面缓存位置，不会移动或删除音乐文件；迁移目录时也会有磁盘压力。
5. 不要把封面缓存目录设到 ECHO 程序目录、项目目录、同步盘临时目录或会断开的移动盘里。
6. 扫描性能 有低占用、均衡、高性能。高性能更快，但读盘和 CPU 压力更大，播放中建议用低占用。
7. 曲库性能诊断 只读最近扫描、并发、IPC 和卡顿指标，用来判断哪里慢。它适合拿来判断“是不是媒体库任务拖慢了播放”。
8. BPM / Offset 分析 会分析歌曲 BPM 和偏移，缺失时可点 分析缺失 BPM；大曲库会耗时，空闲时做。
9. 如果你听歌时突然卡，而这页显示最近扫描、元数据并发、封面并发、慢 IPC 或 event-loop 卡顿，就先停媒体库任务，不要先怀疑声卡坏了。

设置	怎么用	新手建议
曲库文件夹	添加、移除、扫描本地音乐目录。	只添加音乐目录，不要扫整个系统盘；第一次扫描时别急着播放。
实时更新曲库	监听本地文件夹新增或修改，自动入库。	曲库稳定后再开；导入大批文件或播放卡顿时先关。
资料质量整理	查看缺封面、回退元数据、未知艺人/专辑、网络候选。	先看报告，再手动补；不要和扫库、BPM、头像一起跑。
一键歌词补全	批量给缺歌词歌曲找歌词。	先快速模式；完整模式空闲时跑，播放中卡顿就停。
歌词补全命中率	自动接受候选的分数门槛。	匹配错就调高。
曲库体检报告	汇总数据库、扫描、缓存、资料质量、远程源，只读导出。	报错前先导出。
曲库实验/诊断面板	更细的曲库诊断入口。	开发排查时用。
艺术家墙封面	用艺人专辑封面替代字母占位。	想让艺人页好看可开。
艺术家头像自动获取	网络后台抓艺人头像。	网络好可开；大曲库会慢慢跑，播放卡顿时暂停。
艺人缺头像用专辑封面	没抓到头像时用专辑封面。	建议开。
刷新缺失头像	只给缺头像艺人排队。	开启自动获取后再点；这是后台网络任务。
暂停/继续头像获取	暂停后台头像任务。	播放卡顿时暂停。
清理头像缓存	删除头像缓存记录和文件。	头像明显错乱再用；清完后重新获取会再次占网络。
下载路径	选择下载音频保存目录。	只在解锁下载能力后出现。
流媒体下载按钮	在流媒体页显示支持平台的下载按钮。	默认隐藏；需要下载再开。
歌单自动备份	刷新、清空、删除歌单前保存 JSON 备份。	建议开。
重复歌曲隐藏	在歌曲列表隐藏低音质重复版本，不删除文件。	大曲库建议开。
分析重复歌曲	重新计算重复组。	导入大量新歌后点；大库播放中不要反复分析。
专辑合并策略	标准模式或同名同封面宽松合并。	标准模式最稳。
艺人合并策略	保守或普通艺人合并。	普通模式推荐；误合并就改保守。
应用并重新整理分组	应用合并策略并重建分组。	改策略后才点；曲库大时等空闲。
扫描曲库	重新扫描已添加文件夹。	改文件后点，不要反复狂点；播放中卡顿就停。
嵌入标签重扫	重读标题、艺人、专辑、曲号、封面等内嵌标签。	标签修过后用；这是重读文件，空闲时跑。
重扫缺失封面	只处理没有封面的歌曲。	比全量重扫轻，但大曲库仍会占硬盘。
封面缓存目录	迁移或切换封面缓存目录。	磁盘空间不够再改；迁移时别播放高负载内容。
扫描性能	低占用、均衡、高性能。	普通用均衡；边听边扫必须用低占用。
BPM / Offset 分析	播放或手动批量分析缺失 BPM。	默认开；播放卡顿时关，批量分析放空闲。
网络元数据	是否用网络补全元数据。	想补封面/信息就开；只信本地标签或播放中卡顿就关。
网络元数据来源	网易、QQ、酷狗、MusicBrainz 等。	中文曲库优先网易/QQ。

关于

图 1：版本、更新和 Safe mode

关于 / 高级 页先看版本，再看更新，最后才看诊断。

1. 版本号 是你反馈问题时必须带的东西。只说“最新版”没用，直接说 v26.x.x。
2. ECHO Pro 显示是否已解锁。这里显示解锁，不代表网络账号永远不会过期。
3. 自动更新 会启动后自动检查 GitHub Release，发现更新会在左上角提醒。
4. 下载源 可以选镜像源。哪个源下载快用哪个，下载失败再换。
5. 检查更新 是手动检查。
6. ECHO NEXT / 官方网站 / 使用文档 / 百度网盘 / 哔哩哔哩 / 爱发电 / 更新日志 / QQ 群 / Discord 都是外部入口。
7. Safe mode 是诊断模式：只显示异常、渲染器错误、音频错误和启动阶段，不混入普通播放日志。
8. Safe mode 开着会记录诊断，适合复现问题，不是日常音质提升开关。

图 2：导入导出、诊断助手和崩溃报告

反馈问题时，按这个顺序准备材料：

1. 先看 诊断助手 状态。如果显示快照正常，说明本机状态能被读取。
2. 点 导出 Markdown，会生成可读的报告。
3. 点 打开日志目录，可以找到本地日志。
4. 播放问题再打开 音频报告，启动崩溃再打开 崩溃报告。
5. 打开调试控制台 只在开发者让你开时再开。
6. 导出设置 只导出当前用户设置，不会导出音乐文件。
7. 导入设置 会覆盖当前设置，导入前会自动备份当前设置。不要导入来历不明的设置 JSON。

设置	怎么用	新手建议
版本	查看当前 ECHO NEXT 版本。	反馈问题必须带版本。
自动更新	启动后检查 GitHub Release 并下载安装。	建议开。
更新下载源	official、加速源、自定义 generic 源。	official 不行再换；自定义源要可信。
检查更新	手动检查新版本。	更新失败时点。
官网/仓库/网盘/赞助/群组	打开相关链接。	需要下载或反馈时用。
Safe mode	每次启动先打开异常记录器，收集错误和慢启动阶段。	复现疑难问题时开，平时关。
导出诊断包	导出安全诊断 zip。	报 bug 时优先导出。
诊断助手	汇总音频链路、崩溃、日志、导出入口。	反馈前先看。
崩溃报告	导出 Markdown、打开日志目录、打开崩溃/音频报告、清除异常提示。	崩溃后按这里整理证据。

危险操作

危险操作不会主动删除你的音乐文件夹，但会影响 ECHO 的本地数据库、缓存、设置、账号、插件或记录。动手前先读描述。

图 1：先救命，再清理，最后才重建

这里名字叫危险操作，不是吓唬你。照这个顺序来：

1. 曲库出问题，先看 恢复助手 的健康状态。
2. 能点 检查健康 就先检查健康。
3. 大改前先点 创建健康快照。有快照，回头才有路。
4. 如果已经坏了，优先 恢复最近健康快照，不要上来重建数据库。
5. 重启到恢复模式 是给恢复助手用的，不是普通重启按钮。
6. 打开保护目录 可以看快照和归档在哪里。
7. 导出诊断 是反馈问题前最有用的按钮之一。
8. 输入框里的 危险操作确认词 是防误触的。看清按钮提示，让你输入什么再输入什么。
9. 扫描重复歌曲 只扫描；清理扫描结果 会处理前面的结果，先确认候选。
10. 清空曲库缓存 会移除曲库索引、扫描记录和封面缓存，不会删除音乐文件或曲库文件夹。
11. 禁用硬件加速 用来排查 Chromium/GPU/图片缓存导致的异常内存，切换后要完全重启 ECHO。
12. 恢复默认设置 会重置应用偏好、封面缓存目录和外观偏好，不会删除音乐文件。
13. 重建曲库数据库 会让曲库数据库完全损坏时重新来过，旧数据会归档，新索引会重建。不要把它当普通刷新。

一句话：先快照，先诊断，先恢复；最后才清缓存、恢复默认、重建数据库。

设置	怎么用	新手建议
曲库数据库安全	查看当前数据库、健康快照、坏库归档。	数据库异常时从这里开始。
检查健康	重新读取数据库健康状态。	怀疑损坏先点。
创建健康快照	手动创建数据库快照。	大操作前先点。
恢复最新健康快照	用健康快照恢复数据库。	比重建更安全，优先试。
修复隔离副本	修被隔离的坏库副本。	有隔离状态时优先。
归档问题曲目	隔离场景下归档问题曲目。	看清说明再点。
重启进入恢复模式	重启到恢复流程。	普通问题不用。
打开保护文件夹	打开快照、坏库归档、保护记录目录。	导出前可先查看。
导出诊断	导出诊断文件。	反馈数据库问题时用。
危险确认词	输入确认词后才能执行更危险动作。	不确定确认词含义就停手。
扫描重复歌曲	只扫描将要清理的重复组。	先扫描，不要直接清理。
清理扫描结果	把低优先级重复文件移到回收站并更新索引。	高风险，确认保留项正确再点。
清空曲库缓存	移除曲库索引、扫描记录、封面缓存，不删音乐文件或文件夹。	播放问题不要先点这个。
恢复默认设置	重置应用偏好、封面缓存目录和外观偏好，不删音乐文件或曲库文件夹。	设置调乱了才用。
重建曲库数据库	归档旧数据库并创建空库，不删音乐文件。	数据库完全坏、重扫无效时才用。
删除曲库数据库	只归档并删除数据库，不主动创建新库。	比重建更硬，最后手段。
删除所有 ECHO 本地内容	清空设置、账号、插件、数据库、缓存、日志、壁纸、保护快照、下载任务记录。	最高风险。除非你要彻底重置，否则别点。

默认值和范围速查

这些值来自 ECHO 的设置默认值和归一化逻辑。普通用户不用背，排查时照表看。

设置	默认值	允许范围/选项	怎么解释
语言	跟随系统，中文系统归到 zh-CN，其他多为 en-US	zh-CN、en-US、ja-JP 等受代码支持的语言	语言只是界面文本，不影响曲库数据。
关闭到托盘	关闭	开/关	开了以后点关闭按钮只是隐藏到托盘，不是退出。
记住窗口大小	开启	开/关	关闭后窗口尺寸不再按上次状态恢复。
主题模式	浅色	light、dark、system	不会影响播放，只影响外观。
定时切换主题	关闭	开/关，深色/浅色时间	适合白天浅色、晚上深色；时间写错会回默认。
主题预设	classic	代码内置预设或自定义主题	自定义主题由主题编辑器维护。
侧栏自动隐藏	关闭	开/关	开了以后侧栏行为会更紧凑。
侧栏仅图标	关闭	开/关；自动隐藏开启时会被压回关闭	不适合新手，找不到页面时先关。
歌曲排序	默认	默认、歌手/专辑等代码支持排序	只是列表显示顺序，不改标签。
壁纸缩放	100%	100-220%	画面没铺满再加。太大会裁切。
壁纸模糊	0 px	0-40 px	字看不清才加。
壁纸亮度	100%	40-140%	太亮压低，太暗提高。
UI 不透明度	100%	0-100%	越低越透，文字可读性越差。
壁纸视觉保护	开启	开/关	建议开，避免背景太花看不清。
视频壁纸暂停策略	smart	代码支持的暂停策略	卡顿时优先关视频壁纸或用保守策略。
网络代理	关闭	关闭、手动代理、PAC	只影响联网请求，不修本地播放问题。
网络元数据	开启	开/关；网易云、QQ、酷狗等提供方	关闭后在线封面、资料、匹配能力会变弱。
音频分析	开启	开/关	关闭可减轻扫描/分析负载，但 ReplayGain、波形等能力会减少。
JUCE 输出	关闭	旧设置会被迁移；新版本满足迁移条件才允许开启	高级输出路径，不稳定时关。
JUCE 解码	关闭	旧设置会被迁移；新版本满足迁移条件才允许开启	高级解码路径，不懂别开。
DSD 输出	pcm	pcm、dop	没有明确 DSD 设备和驱动就保持 PCM。
ASIO Native DSD 实验项	关闭	开/关	实验项，高风险，不是给普通用户的。
DSD 自动音量锁	关闭	开/关	防止 DSD 场景误调音量；没用 DSD 不开。
ASIO 不可用回退	关闭	开/关	ASIO 失败时可回退，排查 ASIO 问题时有用。
独占不稳定回退	关闭	开/关	独占输出出问题时再开。
SoXR 回退	开启	开/关	建议保持开，重采样失败时更稳。
ECHO SRC 模式	关闭	off、family2x、family4x、family8x	追求稳定先关；采样率玩法再开。
ECHO SRC 质量	transparent	transparent、balanced、lowLatency	低延迟更轻，透明更保守。
暂停释放独占实验项	关闭	开/关	独占设备被占用时再试。
音频诊断窗口	关闭	开/关	出问题时临时开，平时不用。
播放音量	100%	0-100%	只是播放器音量。固定音量开启时用户要小心外部音量。
固定音量	关闭	开/关	输出给外部 DAC/功放时才考虑；耳机用户别乱开。
无缝播放	关闭	开/关	专辑连续听可开；跨格式/远程源异常就关。
淡入淡出	关闭	开/关；0-2000 ms	切歌爆音或突兀时试。追求原样输出就关。
播放速度	1.0x	0.5-2.0x	不是音质设置；听歌正常保持 1.0x。
变速模式	nightcore	nightcore、daycore、speed	调速后音高/音色可能变化。
导出格式	mp3	代码支持的导出格式	只影响导出，不影响播放库文件。
低负载播放	关闭	开/关	卡顿、低配电脑、远程源播放时优先尝试。
低负载增强	关闭	开/关	比低负载更激进，视觉/后台能力可能减少。
首页波形	开启	开/关	卡顿就关。
实时频谱	关闭	开/关	好看但吃资源，播放卡顿先关。
播放条波形进度	关闭	开/关	大库或低配电脑先关。
信号路径控制	关闭	开/关	高级音频调试用，普通用户不用。
ReplayGain	关闭	开/关；曲目/专辑模式	想统一响度再开；音量异常先关。
ReplayGain 目标响度	-14 LUFS	-24 到 -11 LUFS	数值越接近 0 越响；太响可能削波。
ReplayGain 前级增益	0 dB	-12 到 +12 dB	不懂别加正增益。
防削波	开启	开/关	建议保持开。
播放时分析 ReplayGain	开启	开/关	缺分析数据时边播边补。
扫描时补 ReplayGain	默认关闭，需要明确同意	开/关	大库会慢，用户同意后再开。
本地曲库合并策略	专辑标准、歌手标准	保守/标准等代码支持策略	专辑或歌手被乱合并时调保守。
中文繁简/异体搜索	开启	开/关	中文搜索建议保持开。
艺术家墙用专辑图	关闭	开/关	没头像时可用专辑图顶上。
艺术家流媒体专辑	开启	开/关；默认网易云	在线补专辑信息，网络差可关。
自动抓艺术家图	关闭	开/关	会联网，批量库可能慢。
实时曲库更新	关闭	开/关	本地文件经常变化才开；大库或网络盘慎开。
自动隐藏已删除文件	关闭	开/关	文件被挪走时自动隐藏，误删排查时先关。
扫描性能模式	balanced	平衡等模式	卡顿选保守，想快再提。
远程封面加载性能	balanced	平衡等模式	远程卡顿就降。
远程专辑合并	conservative	保守/标准等代码支持策略	远程库合并错时保持保守。
远程后台并发	元数据 2、封面 2、歌词 1、MV 1、时长回填 1	元数据 1-8、封面 1-48、歌词/MV/时长回填 1-4	网络/服务器弱就降，想补全快再升。
重复歌曲检测	开启	开/关；默认严格	清理前必须先扫描结果。
扫描后自动重建重复索引	关闭	开/关	大库会增加扫描后处理时间。
歌词联网	开启	开/关	关闭后只能靠本地/内嵌歌词。
歌词来源顺序	本地、LRCLIB、网易云、QQ、酷狗、酷我	可启用、禁用、排序	本地优先最稳；在线源不准就换候选。
单源歌词超时	4500 ms	1000-10000 ms	网络慢可加，太大等待久。
总歌词匹配超时	6000 ms	1500-15000 ms	网络慢可加，太大页面等待久。
歌词自动接受分数	0.5	0.3-1	越高越保守，越低越容易误匹配。
回填歌词接受分数	0.45	0.3-0.95	后台补歌词用，错配多就提高。
封面自动接受分数	0.97	0.5-1	默认很严格，避免错封面。
歌词默认偏移	0 ms	-10000 到 10000 ms	单曲整体早/晚再调。
歌词全局偏移	0 ms	-1000 到 1000 ms	全部歌都偏才调。别拿它修单曲。
歌词字号	40 px	22-56 px	普通歌词主字号。
歌词副字号	22 px	12-32 px	翻译/罗马音等辅助行。
歌词行距	110%	60-150%	挤就加，太散就降。
每行最大字数	0	0-80，0 表示不强制	小屏或竖排再调。
上下文透明度	49%	0-100%	非当前歌词行的存在感。
歌词抽屉透明度	78%	20-100%	播放器底部歌词抽屉。
逐词高亮清晰度	70%	40-100%	逐词歌词不清楚时提高。
歌词背景封面透明度	100%	0-100%	用封面背景时才明显。
歌词背景模糊	10 px	0-60 px	字不清楚就加。
歌词背景亮度	100%	40-140%	太亮压低。
歌词背景缩放	100%	70-180%	背景留边或裁切时调。
桌面歌词	关闭	开/关；可锁定	开了会出现独立桌面歌词窗。
桌面歌词字号	34 px	18-72 px	只影响桌面歌词。
桌面歌词缩放	100%	75-170%	整体大小，不只是字体。
桌面歌词透明度	96%	35-100%	太透明会看不清。
迷你播放器	关闭	开/关；自动隐藏主窗口默认开	找不到主窗口时先看是否启用了迷你播放器自动隐藏。
MV	开启	开/关；默认 Bilibili、YouTube	关闭后不自动找 MV。
MV 自动匹配阈值	0.7	0.3-1	越高越保守；错配多就提高。
MV 自动预载	开启	开/关	网慢或卡顿可关。
MV 最高播放质量	max	自动/最高等代码支持质量	网络差就别追最高。
MV 允许 60fps	开启	开/关	卡顿就关。
MV 沉浸背景	开启	开/关	卡顿、花屏、歌词不清楚时关。
MV 背景缩放	115%	100-220%	画面没铺满再加。
MV 背景位置	X 50%、Y 50%	0-100%	调整背景焦点。
MV 背景模糊	0 px	0-32 px	歌词看不清再加。
MV 背景亮度	100%	60-140%	太亮压低。
MV 背景遮罩	0%	0-100%	增强文字可读性。
MV 同步模式	balanced	balanced、stable、precise	不准先手动调，别盲目上 precise。
MV 切换重放音频	开启	开/关	换 MV 后保持同步用。
声道平衡	默认中立	声像、左右增益、左右延迟、频段增益受代码限制	听感偏耳、设备偏差再调；不懂保持 0。
自动备份	关闭	开/关；间隔默认 7 天	建议指定稳定本地目录，不要指临时盘。
歌单备份	开启	开/关	建议保持开。
自动更新	开启	官方源默认	自定义更新源写错会回默认或不可用。
启动检查账号	开启	开/关	不想看到账号状态检查可关。
隐藏账号过期提醒	开启	开/关	关了会更容易看到过期提醒。
Spotify 官方播放器自动启动	开启	开/关	Spotify 集成需要时保留。
TIDAL 国家/地区	US	合法地区码	影响 TIDAL 请求结果。
Connect 接收器自启	关闭	开/关	需要局域网控制再开。
Discord Rich Presence	关闭	开/关	开了会向 Discord 显示播放状态。
Last.fm	关闭	开/关；Scrobble/Now Playing 默认开	登录后才有意义。
Last.fm 最短提交时长	30 秒	1-240 秒	太低会误提交，太高漏提交。
Windows SMTC	开启	开/关	Windows 媒体控制中心。
SMTC 歌词	关闭	开/关	想把歌词暴露到系统媒体信息时再开。
任务栏播放控制	关闭	开/关	Windows 任务栏控制按钮。

AppSettings 字段级索引

这一节是给“有人拿字段名追问”的场景用的。它按 AppSettings 存储字段归类；字段存在不等于设置页一定有一个独立按钮，有些字段是窗口位置、登录令牌、迁移版本、页面展开状态或功能解锁标记。

字段	归属	说明
appMemoryVersion	内部迁移	设置结构版本，应用迁移旧配置时用，用户不要手改。
onboardingCompleted	首次引导	记录是否完成新手引导。
locale	通用	界面语言。
hideToTrayOnClose	通用	关闭窗口时隐藏到托盘。
rememberWindowSizeEnabled、rememberedWindowSize	通用/窗口	是否记住窗口大小，以及上次窗口尺寸。
sidebarRouteOrder、sidebarHiddenRouteIds	外观/侧栏	侧栏页面顺序和隐藏页面。
sidebarAutoHideEnabled、sidebarIconOnlyEnabled	外观/侧栏	侧栏自动隐藏和仅图标显示。
songsSort	曲库列表	歌曲列表排序方式。
appearanceTheme、appearanceThemeScheduleEnabled、appearanceThemeScheduleDarkAt、appearanceThemeScheduleLightAt	外观/主题	浅色/深色/系统主题，以及定时切换时间。
appearanceThemePreset、appearanceThemePresetOverrides、appearanceCustomThemes、appearanceThemeCustomId	外观/主题	当前预设、自定义主题覆盖、自定义主题列表和当前自定义主题。
appearanceThemePresetsExpanded、appearanceThemeCustomExpanded、appearanceSidebarLayoutExpanded	外观/页面状态	设置页里主题/自定义/侧栏区域是否展开。
appearancePreferences	外观/细节	字体、字号、文本深度、封面形状等外观偏好集合。
appCustomWallpaperPath、appPortraitWallpaperPath	外观/壁纸	横屏和竖屏壁纸路径。
appWallpaperMediaType、appPortraitWallpaperMediaType	外观/壁纸	横屏/竖屏壁纸类型，图片或视频。
appWallpaperScalePercent、appWallpaperBlurPx、appWallpaperBrightnessPercent、appWallpaperUiOpacityPercent	外观/壁纸	壁纸缩放、模糊、亮度、界面透明度。
appWallpaperVisualProtectionEnabled、appWallpaperUnifiedOpacityEnabled、nowPlayingCoverColorEnabled、appVideoWallpaperPauseMode	外观/壁纸	视觉保护、统一透明度、播放页封面取色、视频壁纸暂停策略。
rememberedAudioOutput、hiddenAudioDeviceKeys	播放/输出设备	上次输出设备和被隐藏设备。
audioUseJuceOutput、audioUseJuceDecode	播放/高级音频	JUCE 输出和 JUCE 解码开关，旧配置会受迁移版本限制。
audioDsdOutputMode、audioAsioNativeDsdExperimentalEnabled、audioDsdAutoVolumeLockEnabled	播放/DSD	DSD 输出模式、ASIO Native DSD 实验项、DSD 音量保护。
audioAsioUnavailableFallbackEnabled、audioExclusiveInstabilityFallbackEnabled、audioSoxrFallbackEnabled	播放/回退保护	ASIO、独占输出和重采样相关回退。
audioEchoSrcMode、audioEchoSrcQualityProfile	播放/重采样	ECHO SRC 倍频模式和质量档位。
audioReleaseExclusiveOnPauseExperimentalEnabled、audioIssueDiagnosticsWindowEnabled	播放/排查	暂停释放独占设备实验项、音频诊断窗口。
channelBalance	播放/声道	左右声道平衡、增益、延迟和频段平衡。
playerVolume、fixedVolumeEnabled	播放/音量	播放器音量和固定音量。
gaplessPlaybackEnabled	播放/连续播放	无缝播放。
audioTransportFadeEnabled、audioTransportFadeInMs、audioTransportFadeOutMs、audioTransportFadeCurve	播放/切歌	淡入淡出开关、时长、曲线。
playbackSpeed、playbackSpeedMode	播放/变速	播放速度和变速模式。
audioExportFormat	播放/导出	音频导出格式。
lowLoadPlaybackModeEnabled、lowLoadPlaybackEnhancementsEnabled	播放/性能	低负载播放和低负载增强。
backgroundSpacePauseEnabled	播放/内部保护	当前归一化后固定为关闭，不要承诺用户有可用开关。
homeWaveformVisualizerEnabled、audioVisualSpectrumEnabled、playerWaveformProgressEnabled	播放/视觉	首页波形、实时频谱、播放进度波形。
homeRandomHeroTitleEnabled	首页	首页随机标题。
signalPathControlEnabled	播放/高级	信号路径控制入口。
replayGainEnabled、replayGainMode、replayGainTargetLufs、replayGainPreampDb、replayGainPreventClipping	ReplayGain	响度标准化开关、模式、目标响度、前级增益、防削波。
replayGainAnalyzeOnPlay、replayGainAnalyzeMissingOnScanOptIn、replayGainAnalyzeMissingOnScan	ReplayGain	播放时分析、扫描时补分析的授权和实际开关。
albumMergeStrategy、artistMergeStrategy、remoteAlbumMergeStrategy	曲库/合并	本地专辑、歌手、远程专辑合并策略。
chineseCrossScriptSearchEnabled	曲库/搜索	中文繁简/异体搜索兼容。
artistWallAlbumArtwork、artistWallAlbumFallbackForMissingAvatars	曲库/艺术家墙	艺术家墙封面图策略。
artistStreamingAlbumsEnabled、artistStreamingAlbumsProvider	曲库/艺术家资料	在线艺术家专辑补全。
autoFetchArtistImages、artistImageFetchPaused	曲库/艺术家图	自动抓艺术家图和暂停状态。
liveLibraryUpdatesEnabled、liveLibraryAutoHideDeletedEnabled	曲库/实时更新	文件变化监听和自动隐藏已删除曲目。
coverCacheDir	曲库/封面缓存	自定义封面缓存目录。
audioAnalysisEnabled	曲库/分析	音频分析总开关。
scanPerformanceMode	曲库/扫描	扫描性能模式。
remoteCoverLoadPerformanceMode	远程/性能	远程封面加载性能模式。
remoteBackgroundConcurrency	远程/后台任务	远程元数据、封面、歌词、MV、时长回填并发。
duplicateTracksEnabled、duplicateTracksMode、duplicateTracksAutoRebuildAfterScan	曲库/重复歌曲	重复检测开关、严格度、扫描后自动重建。
playlistBackupsEnabled	曲库/歌单	歌单备份。
networkMetadataEnabled、networkMetadataProviders	曲库/在线元数据	在线元数据总开关和提供方列表。
lyricsNetworkEnabled、lyricsPreferredProvider、lyricsEnabledProviders、lyricsProviderOrder	歌词/来源	歌词联网、默认来源、启用来源、来源顺序。
lyricsProviderTimeoutMs、lyricsTotalMatchTimeoutMs	歌词/匹配	单来源超时和总匹配超时。
lyricsCoverAutoAcceptScore、lyricsAutoAcceptScore、lyricsBackfillAutoAcceptScore	歌词/自动接受	封面、手动/自动搜索、后台回填的接受阈值。
lyricsDeepSearchEnabled、lyricsAutoSearch	歌词/搜索	深度搜索和自动搜索。
lyricsRestartOnApplyEnabled、lyricsAutoSaveSidecarEnabled	歌词/应用保存	应用歌词后重启播放、自动保存外置歌词。
lyricsDefaultOffsetMs、lyricsGlobalSyncOffsetMs	歌词/偏移	单曲默认偏移和全局偏移。
lyricsTimelineCorrectionEnabled、lyricsOffsetControlsEnabled、lyricsSmartAlignmentEnabled	歌词/时序	时间轴修正、偏移控件、智能对齐。
lyricsEnabled、lyricsHeaderHidden、lyricsEmptyStateHidden	歌词/页面显示	歌词总开关、头部隐藏、空状态隐藏。
lyricsMvAutoShowTrackInfoDisabled、lyricsCandidatePanelAutoOpenEnabled	歌词/页面行为	MV 时曲目信息显示策略、候选面板自动打开。
lyricsPlayerBarDrawerEnabled、lyricsPlayerBarDrawerAutoEnableForMv、lyricsPlayerBarDrawerAutoHideEnabled	歌词/播放器抽屉	播放条歌词抽屉开关、MV 自动启用、自动隐藏。
lyricsPlayerBarDrawerOpacityPercent、lyricsPlayerBarDrawerColorMode、lyricsPlayerBarDrawerColor	歌词/播放器抽屉	抽屉透明度、颜色模式、自定义颜色。
lyricsRomanizationEnabled、lyricsUtatenKanaEnabled、lyricsTranslationEnabled	歌词/辅助文本	罗马音、假名、翻译显示。
lyricsWordHighlightEnabled、lyricsWordHighlightClarityPercent	歌词/逐词	逐词高亮和清晰度。
lyricsFontSizePx、lyricsSecondaryFontSizePx、lyricsFontFamily、lyricsFontFilePath	歌词/字体	主字号、副字号、字体名、自定义字体文件。
lyricsTextDirection、lyricsLineSpacingPercent、lyricsLineMaxChars、lyricsContextOpacityPercent	歌词/排版	横竖排、行距、每行最大字数、上下文透明度。
lyricsColor、lyricsSmartReadableColorsEnabled	歌词/颜色	歌词颜色和智能可读颜色。
lyricsHighResolutionNetworkCoverEnabled	歌词/背景	使用更高清的网络封面。
lyricsBackgroundMode、lyricsCustomWallpaperPath	歌词/背景	背景模式和自定义歌词壁纸。
lyricsCoverOpacityPercent、lyricsCoverBlurPx、lyricsCoverBrightnessPercent、lyricsBackgroundScalePercent	歌词/背景	封面透明度、模糊、亮度、背景缩放。
desktopLyricsEnabled、desktopLyricsLocked	桌面歌词	桌面歌词开关和锁定。
desktopLyricsFontSizePx、desktopLyricsScalePercent、desktopLyricsFontFamily、desktopLyricsFontFilePath	桌面歌词/字体	字号、整体缩放、字体名、自定义字体文件。
desktopLyricsColorMode、desktopLyricsColor、desktopLyricsStrokeColor、desktopLyricsOpacityPercent	桌面歌词/颜色	颜色模式、文字颜色、描边颜色、透明度。
desktopLyricsTextDirection、desktopLyricsRomanizationEnabled、desktopLyricsTranslationEnabled	桌面歌词/文本	方向、罗马音、翻译。
desktopLyricsBounds	桌面歌词/窗口	桌面歌词位置和大小。
miniPlayerEnabled、miniPlayerLocked、miniPlayerAutoHideMainWindow、miniPlayerBounds	迷你播放器	迷你播放器开关、锁定、自动隐藏主窗口、窗口位置。
mvEnabled、mvEnabledProviders、mvProviderOrder	MV/来源	MV 总开关、启用来源、来源顺序。
mvAutoSearch、mvAutoPreload、mvAutoApplyThreshold、mvPreferHighestViewCount	MV/匹配	自动搜索、预载、自动应用阈值、优先高播放量。
mvImmersiveBackground、mvImmersiveBackgroundAutoScale、mvImmersiveBackgroundScalePercent	MV/沉浸背景	背景开关、自动缩放、缩放比例。
mvImmersiveBackgroundOffsetXPercent、mvImmersiveBackgroundOffsetYPercent、mvImmersiveBackgroundBlurPx、mvImmersiveBackgroundBrightnessPercent、mvImmersiveBackgroundOverlayOpacityPercent	MV/沉浸背景	背景位置、模糊、亮度、遮罩。
mvLyricsReadabilityEnhanced、mvHideLyrics	MV/歌词	增强可读性、隐藏歌词。
mvRestartAudioOnLoad、mvSyncMode、mvReplayAudioOnChange	MV/同步	加载后重启音频、同步模式、换 MV 后重放音频。
mvMaxQuality、mvAllow60fps	MV/质量	最大质量和 60fps。
safeModeEnabled、fastStartupEnabled、dataProtectionDisabled	关于/启动保护	安全模式、快速启动、数据保护禁用状态。
autoUpdateEnabled、autoUpdateSource、autoUpdateCustomUrl	关于/更新	自动更新、更新源、自定义更新地址。
autoAccountCheckOnStartup、suppressAccountExpiryNotices	集成/账号	启动账号检查、账号过期提醒策略。
spotifyAutoLaunchOfficialPlayer、spotifyClientId、spotifyRedirectUri	集成/Spotify	Spotify 官方播放器启动和 OAuth 配置。
tidalClientId、tidalClientSecret、tidalRedirectUri、tidalCountryCode	集成/TIDAL	TIDAL OAuth 和地区配置。
downloadsFeatureUnlocked、streamingDownloadActionsEnabled	集成/下载	下载功能解锁标记和流媒体下载动作开关。
connectAutoStartReceiversEnabled	集成/Connect	Connect 接收器自动启动。
hqPlayer	集成/HQPlayer	HQPlayer 主机、端口、模式等连接设置集合。
networkProxyMode、networkProxyUrl、networkProxyBypassRules、networkProxyPacUrl	集成/代理	代理模式、代理地址、绕过规则、PAC 地址。
onlineArtistInfoBandsintownAppId、onlineArtistInfoTicketmasterApiKey、onlineArtistInfoSeatGeekClientId、onlineArtistInfoRegion、onlineArtistInfoSources	集成/在线艺人资料	演出和艺人信息来源配置。
onlineAlbumInfoDiscogsUserToken	集成/Discogs	Discogs 专辑资料令牌。
discordRichPresenceEnabled	集成/Discord	Discord 播放状态。
lastFmEnabled、lastFmUsername、lastFmSessionKey、lastFmAuthToken	集成/Last.fm	Last.fm 开关、用户名、会话、授权令牌。
lastFmScrobbleEnabled、lastFmNowPlayingEnabled、lastFmMinScrobbleSeconds	集成/Last.fm	Scrobble、正在播放、最短提交秒数。
smtcEnabled、smtcLyricsEnabled、taskbarPlaybackControlsEnabled	集成/Windows	Windows 媒体控制、SMTC 歌词、任务栏播放控制。
autoDataBackupEnabled、autoDataBackupDirectory、autoDataBackupIntervalDays	备份	自动数据备份开关、目录、间隔。
autoDataBackupLastRunAt、autoDataBackupLastPath、autoDataBackupLastError	备份/运行记录	上次备份时间、路径、错误信息。
localShortcuts、globalShortcuts	快捷键	应用内快捷键和全局快捷键配置。

字段排查注意

• 如果字段里有 LastFmSessionKey、AuthToken、ClientSecret、UserToken、账号 cookie，不要让用户截图公开，不要手动改。
• 如果字段是 Bounds、WindowSize、Expanded、LastRunAt、LastPath、LastError，一般是界面状态或运行记录，不是功能开关。
• 如果字段写着 Experimental、NativeDsd、Exclusive、Asio、Juce，默认按高风险高级音频项处理；普通用户先关。
• 如果字段是 downloadsFeatureUnlocked 或 streamingDownloadActionsEnabled，不要承诺所有构建都能下载；它受解锁状态限制。
• 如果字段是 backgroundSpacePauseEnabled，当前代码会归一化成 false，不要把它写成稳定可用功能。

出问题先按这个顺序

1. 想想刚才改了哪个设置，先改回去。
2. 播放问题先回到 System 或共享输出。
3. 关闭 EQ、ReplayGain、变速、DSD、Automix。
4. 关闭实时频谱、视频背景、后台批量补全。
5. 看 播放 -> 音频状态，复制诊断。
6. 曲库问题先看 曲库体检报告。
7. 数据库问题再去 危险操作 -> 曲库数据库安全。
8. 反馈前带版本、页面、截图、日志、复现步骤。

别一上来就删除数据库。很多问题只是输出设备、代理、歌词候选、扫描还没完成，重建数据库只会让排查更麻烦。