xiaobai6k downloadsStudy languages with timestamped YouTube transcripts, playback controls, and on-demand AI translation.
在 Obsidian 中把 YouTube、哔哩哔哩英文视频和公开 Podcast 节目变成可跟读、可听写、可查词、可复习的学习材料。支持 RSS 订阅、学习聊天、高亮笔记、带时间戳字幕、本地缓存播放、逐句翻译、离线词典和生词本。
[!IMPORTANT] Lingua Study 2.2.1 仅支持桌面版 Obsidian。移动端仍处于测试阶段,不包含在本次正式发布范围内。当前主要面向“英文视频字幕 → 简体中文学习”的场景。公开 YouTube 字幕导入使用非官方公开接口,因为 YouTube 官方字幕下载 API 只能下载用户有权编辑的视频字幕。YouTube 与哔哩哔哩的公开接口可能随时变化。本插件不会绕过登录、地区、嵌入、会员或反机器人限制。
扫描下方二维码加入 Lingua Study QQ 群:

QQ群号:1124526985
播客与听写(2.2.1):可从导入入口或 RSS 面板粘贴 Spotify 节目及单集链接,使用公开 RSS 音频建立学习内容;播客采用精简音频播放器。首遍与错词重听使用无编号逐词输入框,按回车跳到下一词。
卡片复习(2.2.1):在单词卡正面误点评分时先翻面,翻面后再次评分才会记录复习结果。
卡片复习(2.2.0):在同一页面切换单词卡片与短句卡片;可从生词本或高亮笔记进入,并在统一统计页查看两类卡片的数据和复习热力图
桌面播放器定位(2.1.0):长按置顶按钮可在 Obsidian 窗口内移动播放器;取消置顶后回到笔记原位,Paper 主题工具栏随播放器宽度连续缩放
本地模型学习聊天(2.1.0):可连接本机已运行的兼容服务,手动填写模型 ID,并在设置中测试连接;翻译和知识卡不受此选项影响
数据安全修复(2.1.0):避免同步中的生词本、高亮库被误建覆盖;隔离损坏条目、保留备份,并在字幕改名后更新关联数据
知识点双击查词(2.0.1):双击生成的知识卡中的英文单词,可在右侧词典查看释义;已高亮的知识点文字也支持查词
学习聊天:右侧栏按学习目标分别管理当前会话,可带入选中的字幕或知识卡内容;需单独配置 AI 聊天服务
RSS 订阅:在右侧栏管理 Podcast 和 YouTube 频道,按标签浏览、刷新并创建可重复打开的学习笔记
高亮笔记:选中学习文字后保存彩色高亮和个人笔记,在高亮笔记库中回看
Whisper 模型下载来源:默认使用 Hugging Face,官方站点无法连接时可填写可信且兼容的 HTTPS 备用来源
B站本地英文字幕识别:可缓存且实际为英语语音的视频没有可用英文字幕时,桌面端可在确认下载模型后使用本地 Whisper Base English 生成字幕;识别中断后可从已有播放器重试
B站缓存路径:Mac 和 Windows 可选择 Obsidian 仓库外的视频缓存目录;旧默认缓存保持只读兼容,不会自动搬移或删除文件
划词翻译开关:可随时关闭字幕选区的自动翻译悬浮窗,不影响双击查词和手动翻译命令
本地视频学习:从原有 Lingua Study 入口导入本地 MP4,并自动匹配同名 SRT/VTT 字幕
多服务划句翻译:支持百度翻译、DeepSeek、Kimi 与 OpenAI 兼容服务,译文显示为可拖动悬浮卡片
FSRS-6 复习计划:使用真实 FSRS-6 调度,并可设置目标留存率
初高中学习目标:新增初中英语和高中英语,词典同步保留对应考试标签
词典更新提醒:旧版完整词典继续可用,只在“学习与词典”页询问是否更新,不会强制下载
生词与词形增强:完整编辑生词字段并长期保留个人版本,查词支持词形还原、别名和模糊建议
可选界面外观:默认保留经典外观,也可在设置中切换为 Lingua Paper;两种外观的功能保持一致
播放器自由缩放:桌面端可从播放器四个角拖动调整大小,控制器同步缩放并记住宽度
版本更新提醒:打开设置页时检查最新官方 Release,仅在发现新版时直接打开 Obsidian 内的插件更新页面
逐句听写:反复播放当前句,提交后进行逐词对照与评分
影子跟读:跟随原声录音,支持暂停、继续、波形显示和录音回放
生词学习闭环:双击查词、加入生词本、完整编辑学习字段、保留视频原句并安排每日复习
生词本导出:可导出为 Obsidian 学习笔记或桌面端分页 PNG 长图
字幕平滑跟随:播放过程中自动保持当前句可见,减少页面跳动和重复布局
字幕可重新导入:哔哩哔哩播放器已有字幕时仍显示字幕按钮,可替换错误或失败的导入结果
自定义词典:桌面端可导入不超过 100 MB、最多 100 万词条的 CSV、TSV 或 JSON 词典,并优先使用自定义释义
youtube-nocookie.com 嵌入 YouTube 播放器yt-dlp 时,可自动把它作为 YouTube 字幕获取的后备方案版本检查只在用户打开 Lingua Study 设置页时请求本项目 GitHub 最新正式 Release 的 manifest.json;不会上传笔记、词典、生词、设置或使用数据,也不会自行下载或覆盖插件文件。
yt-dlp,提高 YouTube 字幕后备获取的成功率Lingua Study 的项目页面可能会先出现在 Obsidian 社区网站,而插件稍后才进入 Obsidian 客户端的正式目录。审核版本能够在客户端搜索到以后,打开:
设置 → 第三方插件 → 浏览
搜索 Lingua Study,然后安装或更新。在客户端尚未收录前,请使用下面的手动安装方法。
打开与目标版本对应的 GitHub Release。
下载 main.js、manifest.json 和 styles.css。
在仓库中创建以下插件目录:
<仓库目录>/.obsidian/plugins/lingua-study/
将下载的三个文件放入该目录。
重新加载 Obsidian。
在 设置 → 第三方插件 中启用 Lingua Study。
哔哩哔哩字幕导入不需要 Chrome 扩展。如果视频要求登录,Lingua Study 会在 Obsidian 内打开一个独立的哔哩哔哩登录窗口,并在登录成功后自动重试。
导入成功后,Lingua Study 会:
Lingua Study/Transcripts播放器中的 打开原视频 按钮可跳转到视频来源页面。如果当前处理范围内有多个受支持的视频链接,插件会先询问要导入哪一个。
如果希望恢复“粘贴链接后自动导入”,请打开:
设置 → 第三方插件 → Lingua Study → 通用选项 → 粘贴视频链接后自动创建学习内容
该功能默认关闭,避免粘贴资料时意外触发导入。
YouTube 字幕会按照以下顺序自动尝试:
yt-dlp:先尝试人工英文字幕,再尝试自动英文字幕.srt 或 .vtt 文件,最大 10 MB字幕保存目录和 yt-dlp 的完整路径可以在以下位置修改:
设置 → 第三方插件 → Lingua Study → YouTube 字幕导入
不填写 yt-dlp 路径时,插件会搜索系统 PATH,以及常见的 Homebrew、MacPorts 和 Windows 命令位置。已有且有效的字幕文件会直接复用,不再发起网络请求;同一视频已经存在学习块时,也不会重复插入。
Lingua Study 会直接读取哔哩哔哩的独立字幕轨道,并把公开的合并版 MP4 下载到操作系统缓存目录。如果平台提示字幕需要登录,用户可以在 Obsidian 内的隔离窗口中登录,插件随后自动重试。该登录会话与 Chrome 分开。
导入成功后,插件会保存字幕、删除笔记中的长视频链接、插入一个学习块并切换到阅读视图。支持 BV 号、av 号、多分 P 视频的 ?p= 链接和官方 b23.tv 分享链接。
字幕创建按照以下顺序进行:
.srt 或 .vtt 文件第 5 项会在第一次使用时确认下载固定版本的模型和运行环境。识别完全在设备上进行,不会上传视频或音频;它不会把中文、日文或其他语言翻译成英语。缓存、平台权限或识别失败时,已创建的播放器会保留,之后仍可添加 SRT/VTT 或导入博主文稿。
如果所在网络无法连接 Hugging Face,可在“设置 → Lingua Study → 文稿导入与对齐 → 备用模型下载地址”填写可信的 HTTPS 模型站点根地址。该站点必须直接提供与官方相同路径、相同固定版本的模型文件;留空仍使用 Hugging Face。切换来源可能需要重新下载模型,音视频始终留在本机。某些镜像会重定向回 Hugging Face,无法解决原站不可访问的问题。
如果最后只创建了播放器,插件会删除笔记中原本可见的哔哩哔哩链接,同时保留周围的其他笔记内容。播放器旁会保留一个紧凑的字幕图标,之后可以继续添加 SRT/VTT,或者导入 PDF、DOCX、TXT、Markdown 和直接粘贴的文字稿。文稿中已有的中文内容会作为对应的本地翻译保存,不会调用 AI 翻译接口。
可通过以下位置打开视频缓存目录:
设置 → 第三方插件 → Lingua Study → 哔哩哔哩视频与登录 → 打开缓存文件夹
缓存视频位于 Obsidian 仓库之外,不受 Obsidian Sync 管理。生成的字幕 JSON 仍保存在仓库内配置的字幕目录中。哔哩哔哩登录 Cookie 只保存在 Electron 的隔离持久会话中,不会写入笔记、字幕、插件设置或 Obsidian Sync;可以在同一设置区域中清除。
Spotify 链接需能匹配到同名的公开播客 RSS;若有多个同名节目、没有公开音频或单集无法在 RSS 中确认,请改用节目公开 RSS 地址。订阅与条目清单保存在库内的 Lingua Study/Subscriptions/subscriptions.json,学习笔记保存在 Lingua Study/Subscriptions/Notes;取消订阅不会删除已创建的学习笔记、字幕或音频缓存。此面板仅支持电脑端,不在侧栏内播放。自动刷新默认关闭。
/v1 地址和模型 ID,再主动点击“测试连接”。API Key 仅在本机服务要求时填写,并应使用单独的本地凭据。插件不会下载或启动模型;服务可能自行转发请求到云端,是否真正离线取决于服务和模型。Lingua Study/Highlights/高亮笔记.md;一条标注属于多个类别时会出现在多个章节。再次导出会刷新这篇插件生成的笔记,请把手动修改保存在其他笔记中。Spotify 链接会先用标题查找同名的公开播客音频,确认来源后再从 Apple Podcasts 目录取得该节目的 RSS;它不会下载 Spotify 的音频或视频。Spotify 独家节目、未公开 RSS 或不同平台标题不一致时可能无法匹配,可改为粘贴节目公开 RSS。Spotify 视频单集导入的是公开音频版本,播放时间轴可能不同。Apple Podcasts 链接会直接查找该节目的 RSS;也可以直接粘贴公开 RSS 或 Atom feed 地址。节目音频缓存到操作系统目录(macOS 为 ~/Library/Caches/Lingua Study/Podcasts),不会写入 Obsidian 仓库或同步。若节目提供 Podcasting 2.0 标记的英文 .vtt / .srt 文稿,会直接使用;否则首次使用会确认下载本地 Whisper Base English 模型,再在设备上生成英文时间轴。单集音频上限为 512 MB;同一节目在当前笔记中不会重复插入。
.en、.eng、.english 标记的 SRT/VTT;单个视频模式也可以手动选择其他字幕。视频保持在原文件夹,不会复制到 Obsidian 仓库;字幕 JSON 仍保存在已配置的字幕目录。移动或删除原视频后,可在播放器中点击文件夹按钮重新选择。第一版仅支持电脑端 MP4 和 UTF-8 编码的 SRT/VTT;是否能播放还取决于 Obsidian/Electron 支持的视频编码。
Lingua Study 1.0.x 创建的笔记和版本 1 JSON 字幕仍然兼容。高级用户也可以手动创建字幕 JSON:
{
"version": 1,
"videoId": "abcdefghijk",
"sourceUrl": "https://www.youtube.com/watch?v=abcdefghijk",
"language": "en",
"segments": [
{
"start": 4,
"end": 10,
"text": "Welcome to this language lesson."
}
]
}
然后在 Markdown 笔记中添加:
```lingua-study
transcript: Language study/Transcripts/example.json
```
切换到阅读视图后即可使用播放器和字幕。早期开发版本使用的 english-video-study 代码块仍然兼容。
打开 设置 → 第三方插件 → Lingua Study,然后选择一个翻译服务。
https://api.deepseek.comdeepseek-v4-flash 或 deepseek-v4-prokimi-k2.6需要填写:
https://example.com/v1;也可以填写完整的 /chat/completions 地址翻译功能当前暂不支持自定义请求头、Anthropic 兼容接口、Ollama 和其他翻译目标语言;Ollama 仅可用于上文的本地模型学习聊天。可以选择启用整篇翻译;插件会按顺序逐句请求,并自动跳过已有结果的句子。在字幕阅读界面拖选多个单词后,插件会直接调用当前翻译服务,并在选区附近显示可拖动的非模态悬浮卡片;单独双击一个单词仍执行离线查词。Markdown 编辑器中选中文字后,可从命令面板运行“Lingua Study:翻译选中的英文文本”,并可为该命令设置快捷键。
听写和跟读目前仅支持桌面端的 YouTube 播放器或已经本地缓存的哔哩哔哩视频。哔哩哔哩在线外部播放器无法提供精确的逐句控制;跟读还需要系统允许 Obsidian 使用麦克风。
多设备复习提醒:复习评分目前写入同一个 Lingua Study/Vocabulary/wordbook.json。请在一台设备完成复习并等待同步结束,再到另一台设备继续;两台设备离线同时评分可能互相覆盖。待独立的复习事件记录方案完成后才能可靠合并并发评分。
首次创建生词本前会确认文件是否仍在同步;如果本机曾见过的生词本后来缺失,插件会停止写入。单条词条损坏时,正常词条仍可读取;下一次写入前会保存完整原文件和坏词条隔离文件。
用户第一次手动编辑字幕时,原始版本会写入同一个版本 1 字幕 JSON 的可选 originalText 字段,已有文件仍保持兼容。
双击一个英文单词会执行完全离线的词典查询,不会调用 AI 服务。词典会优先使用明确的词形关系,再对未收录的规则变化和常见不规则词进行本地原形匹配,例如 studied → study、went → go;加入生词本时保存原形,以便合并语境和复习记录。压缩后的 ECDICT 考试与词频子集已经内置于 main.js。用户还可以在 设置 → Lingua Study → 学习与词典 中安装完整 ECDICT。插件优先下载约 24.4 MB 的预生成 ZIP,不可用时自动回退到 ECDICT 官方 CSV;下载支持断点续传和最多三次尝试。词典保存在操作系统缓存目录,不写入 Obsidian 笔记库,也不参与 Obsidian Sync。发音按钮使用操作系统已经安装的英文语音。
电脑端还可以在同一设置页导入自定义 CSV、TSV 或 JSON 词典,并可分别下载三种模板。CSV 和 TSV 使用 word、phonetic、definition、translation、pos、tags、forms 列;JSON 使用相同字段,顶层可以是词条数组,也可以是包含 entries 数组的对象,tags 和 forms 可填写字符串或字符串数组。forms 也接受 aliases、词形、词形变化 或 别名 表头,多个词形可以用空格、逗号、斜杠、竖线或分号分隔。三种格式都支持对应的中文字段名;word 必填,英文释义和中文释义至少填写一项。自定义词典只在本机处理,最多 100 MB、1,000,000 个词条;同一文件中的重复单词以后出现的记录为准。查词顺序为自定义词典、ECDICT 完整版、内置精简版,删除自定义词典不会影响 ECDICT 或生词本。
启用翻译缓存后,Lingua Study 会在字幕文件旁创建独立缓存文件:
example.json
example.zh-CN.translations.json
example.zh-CN.study.json
b23.tv、api.bilibili.com,以及白名单中的 HTTPS bilivideo.com 或 bilivideo.cn CDN 域名127.0.0.1 的临时随机地址,只提供插件已经校验过的缓存文件,支持按范围读取,不会把缓存暴露到互联网,并会在插件卸载时停止player.bilibili.com 并使用官方外部播放器youtube.com 下的 HTTPS 地址,可能使用公开观看页面、内部播放器和 timed-text 字幕接口;插件不包含固定 YouTube API Keyyt-dlp 时,插件不会通过 Shell 执行它,会忽略用户级 yt-dlp 配置,只把字幕下载到临时目录,解析完成后删除;不会请求视频或音频Thank you for using Lingua Study.;本地学习聊天的连接测试只发送简短的 请只回答 OK。yt-dlp 不会随插件打包、安装或自动更新;只有电脑上已经存在兼容的可执行文件时才能作为后备方案npm ci
npm test
npm run typecheck
npm run build
npm run check:release
生产构建会生成 main.js;构建不会自动发布 GitHub Release,发布仍需维护者单独执行。
维护者发布说明见 RELEASING.md。
MIT © 2026 xiaobai。插件内置和可选的第三方组件见 THIRD_PARTY_NOTICES.md。