LyricLens · 聆思

一个 VS Code 扩展。你在 Spotify 网页版听歌，它把歌词同步显示在侧边栏，逐行跟着播放高亮，配上翻译和注音。想深究某首歌的时候，可以在右边展开这首歌的生词和语法卡片。

面向一边工作一边听歌、想顺手把生词和语法学下来的人。日语和英语支持得最完整。

功能

• 歌词逐行同步。直接读 Spotify 网页播放器的歌词接口拿时间戳，当前行高亮。不需要在网页上打开歌词面板。
• 翻译。直译保留原文语序便于对照学习，意译重写成通顺中文但仍逐行对齐。两种在设置里切换。
• 注音。日语汉字标假名，英文标 IPA。本地计算，不联网不花钱。
• 歌词解析。按语言点归并的词汇和语法卡片，带读音、词性、释义、接续和例句，按你的水平过滤。可选功能。
• 词与卡片互跳。有解析的词在歌词里带下划线，点词看卡片，点卡片跳回歌词并定位播放。
• 播放控制。标题栏可播放暂停，一键跳回 Spotify 网页搜歌切歌。

安装

在 VS Code 扩展面板搜 LyricLens 安装，或者从 Releases 下载 .vsix 手动装：

code --install-extension lyriclens-0.1.1.vsix

快速开始

第一步，启动浏览器。 点状态栏左下角的 ♪。扩展会用一个独立的 Chrome 配置开一个带调试端口的窗口，跟你日常用的那个互不干扰。第一次要登录 Spotify，之后会记住。

第二步，放一首歌。 在刚打开的 Spotify 页面里播放任意歌曲，歌词随即出现在侧边栏。

到这里注音已经能用了，因为它在本地算。翻译要再配一步。

第三步，配翻译模型。 点面板标题栏的齿轮，填三样：

任何 OpenAI 兼容的服务都可以。不配置也能使用，翻译会退回免费的 Google 翻译。

选模型注意一点：这个任务不需要推理能力。推理模型会把 token 预算花在思考上，慢、贵，而且思考模式下有些服务商会忽略 temperature。用普通对话模型就行。DeepSeek 的思考模式扩展会自动关掉。

歌词解析

点标题栏的学士帽，右边展开这首歌的学习卡片。面板够宽时左右分栏，窄了自动改上下堆叠，中间可以拖。

卡片按语言点归并，不按行罗列。同一个语法点在歌里出现五次，是一张卡加五个跳转位置，不是五条重复。每张卡列读音、词性、释义、接续和一个新例句，写成字段而不是段落，因为要背的是词条不是文章。

单独有一类叫「歌词特有现象」：日语的口语缩约、助词脱落、倒装，英语的 standin'、gonna、省略主语。这些教材基本不讲，但恰好是听歌时最容易卡住的地方。

有解析的词在歌词里带虚线下划线，点一下跳到对应卡片。没有下划线的词就是没有解析。

英文歌一样能用，IPA 注音和语法卡片都有：

设置

隐私

API Key 存在 VS Code 的 SecretStorage，不写进设置文件，也不会进 Git。

开了模型翻译或解析之后，歌词、歌名、歌手会发到你自己填的那个地址。发给谁由你决定，中间不经过任何第三方服务器。注音在本地算，什么都不发。

扩展通过调试协议连的是你自己机器上的 Chrome，只读 Spotify 页面的播放状态和歌词。

常见问题

一直显示「正在加载歌词」。 确认是在 Spotify 网页版放歌，不是桌面客户端。如果 Chrome 被导航去了别的网址，面板会提示，点「回到 Spotify」就行。

翻译失败。 面板会说清是什么原因，给对应的按钮。想看原始报错就点「查看日志」。

这首歌不高亮。 Spotify 的歌词有带时间戳和不带的两种，后者只能显示不能跟随，它自己的播放器也一样。

解析按钮没了。 它只在有歌词的时候出现。也可以在设置里关掉。

限制

只支持 Spotify 网页版，桌面客户端没有能读的接口。

解析每首歌要发一次请求，结果按歌缓存。面板关着的时候不会发任何请求。

生词还不能跨歌积累。听多了，同一个语法点会在不同歌里反复出现，目前每首都会讲一遍。

反馈

用着不对、想要什么功能，都欢迎开 issue： github.com/duanshanchong/LyricLens/issues

报问题的时候如果能带上这几样，定位会快很多：歌曲名、面板上显示的提示文字，以及 Output 面板里 LyricLens 频道的日志（命令面板运行 LyricLens: 查看日志 可以打开）。

许可

MIT