企业官网建设流程全解析

EeveeSpotifyReincarnated 是一款增强 iOS 版 Spotify 体验的开源 tweak（插件），核心卖点之一就是自定义歌词：它能替换 Spotify 免费版的有限歌词，接入 SpicyLyrics、Musixmatch、LRCLIB、Genius、PetitLyrics 五大歌词源，支持逐字卡拉OK、逐行滚动同步、罗马字/翻译歌词等高级玩法。本文对比 5 大歌词源的特点，并给出一套新手可直接照做的完美配置方案。

自定义歌词功能一览：能替换成什么样？

打开 Spotify 的"正在播放"页面，普通免费账号看到的歌词非常有限。启用 EeveeSpotifyReincarnated 的歌词替换后，你可以得到：

• 🎤逐字高亮卡拉OK（SpicyLyrics 独家）：单词随歌声逐字点亮
• 📜逐行滚动同步：歌词随播放进度自动滚动（Musixmatch / LRCLIB / PetitLyrics）
• 🌏罗马化歌词：日语、韩语、中文歌曲自动显示罗马音/罗马字
• 🌐翻译歌词（Musixmatch 专属）：输入语言代码即可查看译制版
• 🛟Genius 兜底：主源加载失败时自动切换到 Genius 补上歌词

五大来源的枚举定义在 LyricsSource.swift，默认源是 SpicyLyrics（defaultSource返回.spicylyrics）。

5大歌词源横向对比：哪个最适合你？

官方对来源的说明（与 README.md 一致）：Genius 质量最佳、曲库最大但永远不做时间同步；LRCLIB 最开放、提供逐行同步但缺曲较多；Musixmatch 是 Spotify 自身使用的服务，同步体验好但必须有令牌。

SpicyLyrics：零配置的逐字卡拉OK（推荐默认）

SpicyLyrics 是最省心的选择——它直接复用 Spotify 自身的访问令牌请求歌词 API，不需要任何额外配置。它提供三种数据精度（见 SpicyLyricsRepository.swift）：

• Syllable：逐音节时间轴 → 呈现逐字高亮的卡拉OK效果
• Line：逐行时间轴 → 普通滚动歌词
• Static：纯文本

当歌曲的逐字数据还在服务端排队生成时（HTTP 503），插件会自动按退避策略重试最多 5 次再降级，所以偶尔"先显示纯文本、几秒后变成逐字"属于正常现象。

选中 SpicyLyrics 后，设置里还会多出一组卡拉OK外观选项（EeveeLyricsSettingsView.swift）：

• Lyrics alignment（对齐方式）：控制歌词居中/左右对齐
• Reversed direction（反向滚动）：歌词从下往上滚动，当前行位置更低，更贴近"唱卡拉OK"的手感

Musixmatch 配置技巧：令牌获取 + 翻译歌词

Musixmatch 是 Spotify 官方采用的歌词服务，逐行同步质量最高，但需要User Token（配置界面见 EeveeLyricsSettingsView+lyricsSourceSection.swift）：

获取令牌步骤

1. 在 App Store 安装 Musixmatch 并注册登录
2. 进入 Musixmatch 的Settings（设置）> Get help（获取帮助）> Copy debug info（复制调试信息）
3. 把调试信息整段粘贴进 EeveeSpotify 的词令输入框即可
4. 没有令牌时也可以点"Request anonymous token（请求匿名令牌）"按钮尝试获取

进阶玩法：翻译/罗马音

在 Musixmatch 语言输入框填一个2 字母语言代码（如en、zh），若该曲存在对应翻译就会显示翻译版歌词；填r+ 语言字母（如rj）则显示罗马音（逻辑见 MusixmatchLyricsRepository.swift）。

⚠️ 两个常见报错：

• Unauthorized：令牌失效，重新复制粘贴即可
• Restricted：版权限制（美国 IP 常见），可考虑更换网络出口

LRCLIB：最开放的逐行同步源，还能换服务器

LRCLIB 是面向公众开放的歌词库，提供逐行时间同步，但对冷门歌曲覆盖一般（解析逻辑见 LrclibLyricsRepository.swift）。

它还有一个独家优势：支持自定义服务器地址。在设置里可把默认的https://lrclib.net/api替换为你自建的镜像，界面会对 URL 做有效性检测并给出绿勾/红圈提示（EeveeLyricsSettingsView+lyricsSourceSection.swift）。

另外该源内置了 IPv6 网络故障时的 IPv4 直连兜底，弱网/校园网环境下稳定性比直觉好。

Genius 与 PetitLyrics：覆盖面王与日语专家

Genius（GeniusLyricsRepository.swift）按"歌名 + 歌手"搜索，标题与歌手双重匹配后取最相关结果。它的歌词最优质、曲库最全、新专更新最快，但只有纯文本、不会随播放滚动。开启罗马化选项时，它会优先抓取 "Genius Romanizations" 账号下的罗马音版本。

PetitLyrics（PetitLyricsRepository.swift）则是日语歌爱好者的首选：提供大量逐行同步的日语歌词和一部分国际曲目。听歌单里日韩占比较高时，它值得设为主源。

完美配置技巧：这套组合拳抄作业

下面这套配置兼顾体验与稳定，按你的听歌习惯微调即可（所有选项对应 LyricsOptions.swift）：

通用方案（适合大多数人）

1. 主源选SpicyLyrics：零配置 + 逐字卡拉OK，体验上限最高
2. 打开Genius Fallback（Genius 兜底）：主源查不到歌时自动用 Genius 补上，保证"总有词看"
3. 打开Show Fallback Reasons：能看到为什么触发了兜底，方便排查
4. 打开Hide on Error（错误时隐藏）：加载失败时直接隐藏歌词组件，比弹错误提示更清爽

听日韩歌加餐

5. 打开Romanized Lyrics（罗马化歌词）：日/韩/中歌曲自动附加罗马音

想用 Musixmatch 的加餐

6. 主源切 Musixmatch，粘贴令牌；语言码留空看原词，或填 2 字母码看翻译

注意事项：切换歌词源后需要重启 Spotify才能生效（设置页有明确提示）；如果某首歌显示 "Couldn't load the lyrics"，换首歌或依赖 Genius 兜底即可，通常不是你的配置问题。

总结

EeveeSpotifyReincarnated 的自定义歌词功能通过 5 大可切换的歌词源覆盖了几乎所有场景：要逐字卡拉OK选 SpicyLyrics（默认即可），要官方同步选 Musixmatch（需令牌），要开放服务选 LRCLIB（可换服务器），要曲库全就靠 Genius 兜底，听日语歌选 PetitLyrics。配合兜底、罗马音、错误隐藏三个开关，这套歌词体验可以说直接拉满。歌词相关源码集中在 Sources/EeveeSpotify/Lyrics/ 目录，感兴趣的同学可以按上文路径自行探索。