歌词跟着音乐走。
Cross Lyrics 是面向 Apple Music 与 Spotify 的 Mac 歌词应用。Mac 负责识别歌曲与校准进度，iPhone、iPad、锁屏和灵动岛接着显示同一份歌词、译文与罗马音。
一处播放，多处显示
Mac 播放，所有屏幕都懂。
Mac 负责识别歌曲、挑选歌词和校准进度。iPhone 与 iPad 在同一局域网里直接接上这份结果，不重复搜索，也不各自漂移。手机自己开始播放时，本机优先。
- 01
播放留在熟悉的地方
继续使用 Apple Music 或 Spotify。Cross Lyrics 接管歌词显示，不接管你的播放习惯。
- 02
拿起设备，直接接上
前台打开移动端，就能跟随附近 Mac 的同一首歌、同一份歌词与同一套校准。
- 03
锁屏后，下一句还在
开启跨设备锁屏歌词后，当前句与副行通过可选 Relay 更新到 Live Activity 与灵动岛。
先听一句
音频和歌词都是项目自制的，只有普通 LRC。行内进度按字数估算，中文大约每秒三个字；估算走完就停在句末等下一句，不硬拖到下一句开始。
app 里也是这么做的：没有可靠的字词时间戳，就不假装有。
三种背景，跟着歌走
进度条会跟着当前视觉变。夜航是一条彗尾光轨，星轨是点状星路加一颗发光的星头，潮汐是波浪填充。Spotify 给了封面地址，背景就用封面色彩晕染。
四个来源，只选一份
切歌后同时查 LRCLIB、AMLL、网易云和 QQ 音乐。四份候选放进同一套规则打分，取分最高的，不是谁先返回谁赢。
打分会看标题、歌手、版本、时长、时间轴与跨来源印证。第一个可用候选出现后还会短暂等待，看有没有更可靠的一份。
匹配错了，菜单里的「不是这首歌」会记住它并立刻重查，被拒绝的候选以后不会再选。
四个都没命中，就先去掉版本后缀、括号和 feat. 等噪声再查。配置了 AI 接口时，还可以生成几组更接近曲库写法的查询词。刘海上的「没有歌词 · 点这里搜索」本身就是按钮。
听见原文，也听懂它。
原文、译文和罗马音沿着同一条时间线前进。中文目标会优先使用可用的社区译文；没有时回落到系统翻译，也可以选择你自己配置的 OpenAI 兼容服务。
日语和韩语歌词可以显示罗马音跟唱行。点「这句在讲什么」，AI 会用两三句讲清白话意思和意象；生词本留下值得记的词、读音、释义与原句。AI 是理解层，不是产品运行的前提。
用量保险丝
AI 调用默认每天 150 次、估算 ¥1、单曲最多 3 次。到顶或请求失败时自动回落到系统翻译，面板里能看到当天用量。
API Key 存在系统钥匙串里，不写进配置文件
只在需要时申请权限
Mac 端按功能可能需要「自动化」来读取和控制 Apple Music 与 Spotify；使用附近歌词屏时还需要「本地网络」。不申请屏幕录制、麦克风、辅助功能或完全磁盘访问，本地音频通过文件选择器获得访问。
播放本地音频时，旋律柱由真实 FFT 驱动（Accelerate／vDSP，20 个对数频段）。跟随流媒体时拿不到音频流，就改用歌词事件生成，并标明这是前奏、间奏还是尾奏。不会假装自己听到了声音。
收藏、随记、歌词和译文缓存、用量记录默认写在 ~/Library/Application Support/AmbientLyrics。附近设备通过加密的本地会话传输播放信息、歌词与样式，没有账号。
开启跨设备锁屏歌词后，Live Activity 所需的歌名、当前句与副行会经过 Cloudflare Relay，再由 APNs 发到 iPhone；它不会传输音频流。AI 翻译则只在启用时把歌词发到你配置的模型服务。
每次自动查找的查询词、候选分数和拒绝原因写进本地 lyric-decisions.jsonl，只写不读，删掉不影响使用。
快速了解
关于 Cross Lyrics
这些答案对应产品当前真实能力，方便人和搜索引擎直接理解，不靠“全能 AI”四个字蒙混过关。
- Cross Lyrics 是什么？
- Cross Lyrics 是一个本地优先的 Mac 歌词显示应用。它跟随 Apple Music、Spotify 或本地音频，把同步歌词、译文和罗马音显示在 Mac 刘海与桌面歌词页，并可继续显示到 iPhone、iPad、锁屏和灵动岛。
- 跨设备歌词怎样同步？
- Mac 统一完成歌曲识别、歌词匹配和时间校准；前台打开的 iPhone 与 iPad 通过加密的局域网会话接收同一结果。可选的锁屏歌词仅把歌名、当前句与副行经 Relay 和 APNs 更新到 Live Activity，不传输音频流。
- 必须配置 AI 才能使用吗？
- 不需要。基础歌词查找、同步显示与系统翻译不依赖 AI。只有在你主动配置 OpenAI 兼容模型服务后，Cross Lyrics 才会用它生成查询词、翻译或解释单句；失败或达到限额时会回退。
- 歌词和隐私数据存在哪里？
- 歌词缓存、译文、收藏、随记和用量记录默认保存在 Mac 本地，不需要账号。只有启用模型服务或跨设备锁屏歌词时，相应歌词文本或 Live Activity 元数据才会发送到你选择的服务。
带它回家
需要 macOS 13 或以上；iPhone 与 iPad 伴侣端需要 iOS 17 或以上。现在仍是本地原型，Mac 安装脚本不会自动安装移动端。
zsh ./install-local.sh
