自定义配置文件（手动高级模式）

什么时候需要用它

Lyricify 的设置页里覆盖了 90% 的常用选项，但有些高级设置（比如自定义全局快捷键的 JSON 结构、Lyricify 歌词库的路径、某些实验性功能的开关）只能直接编辑配置文件。

打开方式：主菜单 → 设置 → 手动（高级），Lyricify 会自动在系统默认的文本编辑器（通常是记事本）里打开配置文件。

文件在哪里

配置文件位置在 Windows 用户目录下，具体路径取决于你装的是哪个渠道的版本：

• GitHub Releases 版：%LOCALAPPDATA%\Lyricify\settings.json
• Microsoft Store 版：%LOCALAPPDATA%\Packages\<Lyricify 包名>\LocalState\settings.json

直接复制粘贴到资源管理器地址栏就能打开。

配置文件里有什么（常见键）

{
  "keybinding": { ... },
  "keybindings": [ ... ],
  "syncFrequency": 2,
  "timeOffset": -600,
  "language": "zh-CN",
  "theme": "Dark",
  "useMediaSessionEnhanced": true,
  "preset": "Default",
  "customApiClient": { ... },
  "desktopLyrics": { ... }
}

• keybindings：所有全局快捷键的具体定义（JSON 数组），可以在这里加主快捷键和备用快捷键
• customApiClient：自定义 Spotify API Client 的 Client ID 和 Client Secret 存储位置
• desktopLyrics：桌面歌词的外观设置（位置、透明度、字体等）
• syncFrequency、timeOffset、language 等就是设置页里那些选项的底层值

改完自动热重载

保存配置文件后，Lyricify 会在 1-2 秒内自动重新加载——不需要重启。如果改错了某个键导致解析失败（比如忘了加逗号），Lyricify 会弹窗提示「配置文件无效，已恢复默认值」，然后自动重建一份。

备份建议

改之前建议先复制一份 settings.json 到别的地方备份——万一改坏了又忘记了改了什么，有备份就不怕。

不要随便动的键

• customApiClient：Client Secret 是敏感信息，不要上传到 Git 或分享给别人
• token、accessToken：Spotify 授权相关的 token，删掉等于重新授权
• lyricsLibraryPath：如果改过歌词库路径，不要手动改回系统默认值——里面存着你标记和导入的所有歌词，路径错了就找不回来

恢复默认

设置文件整体损坏或想重置所有设置：关掉 Lyricify，删掉 settings.json，重新打开 Lyricify，它会自动创建一份默认配置，同时自动进入首次启动的欢迎界面。