1. 项目定位与用途
幕境（MuJing）是一款专注于情境化英语单词学习的跨平台桌面应用程序。其核心定位是将单词学习嵌入真实影视和文档语境中，让用户通过原汁原味的例句、视频片段和互动练习来记忆词汇，而非孤立背诵。应用支持从电影、美剧、TED演讲、PDF文档等多种内容源生成个性化词库，并提供拼写练习、字幕抄写、听写测试等学习模式，最终在视频播放时通过智能弹幕实时巩固所学单词。适用于希望提升英语词汇量、特别是偏好通过视听材料学习的学习者。
项目档案应用项目
幕境MuJing：通过电影美剧真实语境记忆单词的桌面应用 - 支持Windows/macOS安装使用
tangshimin/MuJing：幕境是一款基于真实影视语境的英语单词学习桌面应用，通过电影、美剧或文档中的原声例句，结合拼写练习、弹幕视频播放和FSRS间隔重复算法，帮助用户在本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
幕境是一款基于真实影视语境的英语单词学习桌面应用，通过电影、美剧或文档中的原声例句，结合拼写练习、弹幕视频播放和FSRS间隔重复算法，帮助用户在情境中高效记忆单词。
中文项目介绍
幕境是一款专为英语学习者设计的桌面应用程序，旨在通过电影、美剧或文档中的真实语境帮助用户记忆单词，解决传统背单词方法中单词孤立、缺乏实际应用场景的问题。
应用支持多种内容源：用户可以从MKV视频中直接提取单词和对应语境，或使用字幕文件（ASS/SSA/SRT）配合任意视频生成词库，还能从PDF、TXT等文档中生成词库用于阅读预习。生成的词库具有个性化特点，链接不同来源的语境，构建完整学习体系。
在学习过程中，幕境提供拼写练习、字幕抄写、听写测试等互动方式，结合多感官记忆（视听、拼写、抄写）强化效果。其核心特色是智能弹幕视频播放器：在观看电影或美剧时，学习单词会以弹幕形式显示，实现观影同时巩固记忆；支持双语字幕切换、快捷导航（A/D键跳转、S键重复）和智能暂停（每条字幕后暂停便于跟读）。
技术层面，幕境基于Kotlin和Jetpack Compose Desktop构建，确保在Windows和macOS上流畅运行；集成VLCJ播放器处理视频，使用FFmpeg进行媒体处理，并采用FSRS间隔重复算法优化复习安排，通过SQLite数据库持久化存储词库和学习进度。
此外，应用支持导出Anki格式包（APKG），并内置丰富快捷键（如Ctrl+J播放读音、Ctrl+1/2/3播放视频片段）提升操作效率。用户可从GitHub Releases页面下载对应平台安装包，直接安装使用。
详细信息与使用说明
2. 解决的问题
传统背单词方法往往将单词与语境分离，导致记忆效率低、遗忘率高。幕境针对这一痛点，通过以下方式解决问题：首先，每个单词都关联真实影视或文档中的具体语境（如电影台词、字幕句子），让用户理解单词的实际用法；其次，结合多感官记忆（视觉、听觉、动觉），通过拼写打字、抄写字幕、听读音等方式强化肌肉记忆；再次，利用FSRS间隔重复算法科学安排复习，避免无效重复；最后，在视频播放中动态显示学习单词（弹幕），实现“学练一体”，将学习自然融入娱乐，提升持续学习动力。
3. 适用场景
幕境适用于多种英语学习场景：一是影视爱好者，希望在看美剧、电影时学习地道表达，可通过MKV视频或字幕文件生成词库，并在观影时通过弹幕巩固；二是文档阅读者，需从PDF、TXT等材料中提取专业词汇或短语，用于预习或精读；三是备考学生，可生成针对性的词汇包，通过拼写练习和听写测试检验掌握程度；四是语言教师，能利用字幕浏览器进行跟读教学，选择性播放句子；五是Anki用户，支持导出APKG格式词库，与其他学习工具集成。总之，任何希望通过真实语境提升词汇应用能力的学习者均可受益。
4. 安装方式
根据仓库信息，幕境目前仅提供Windows和macOS平台的桌面版本。安装步骤为：访问项目的GitHub Releases页面（https://github.com/tangshimin/MuJing/releases），根据操作系统下载对应的安装包（如Windows的.exe或macOS的.dmg）；下载完成后，运行安装程序并按照向导完成安装；安装后即可启动应用。仓库中未明确给出Linux版本或通过包管理器（如brew、apt）安装的方式，也未提及命令行安装选项。应用为独立可执行文件，无需用户额外配置运行时环境。
5. 使用方式
幕境的使用流程围绕“内容选择→词库生成→学习→巩固→测试”展开：首先，用户选择喜欢的电影、美剧或文档作为内容源；其次，使用内置工具从MKV视频、字幕文件或文档中提取单词和语境，生成个性化词库（具体操作参考Wiki教程链接）；然后，进入学习模式进行拼写练习（键盘打字）、字幕抄写、听写测试等互动，期间可通过快捷键控制显示选项（如Ctrl+J播放读音、Ctrl+1/2/3播放视频片段）；接着，播放视频时弹幕自动显示所学单词，支持A/D键跳转字幕、S键重复、悬停翻译等；最后，通过听写测试检验效果，并可利用FSRS算法安排复习。详细快捷键列表见README。
6. 补充说明与实现特点
幕境在实现上采用模块化架构：词库生成模块处理视频/字幕/文档解析；学习模块集成FSRS算法管理复习计划；视频播放模块基于VLCJ实现弹幕、字幕导航和双语切换；字幕处理模块支持ASS/SSA/SRT等格式；资源管理模块维护内置词库和多媒体文件。技术栈包括Kotlin、Compose Desktop（UI）、VLCJ（播放）、SQLite（数据存储）、FFmpeg（媒体处理）和OpenNLP（自然语言处理）。应用内置多平台FFmpeg和VLC库，确保开箱即用。此外，支持APKG导出以实现与Anki生态互通，并提供丰富的键盘快捷键提升效率。仓库中未提及云同步、多设备协同或移动端版本。
思维导图
幕境应用
词库生成模块
MKV视频提取
字幕文件解析(ASS/SSA/SRT)
文档(PDF/TXT)处理
学习模块
拼写练习(键盘打字)
字幕抄写
听写测试
FSRS复习调度
单词管理(添加熟悉/困难)
视频播放模块
VLCJ集成
智能弹幕显示
双语字幕切换
快捷导航(A/D跳转,S重复)
智能暂停(跟读)
字幕处理模块
多格式支持
解析与渲染
选择性播放
悬停翻译
FSRS算法模块
稳定性计算
难度调整
间隔优化
资源管理模块
内置词库(人教版/牛津等)
多媒体资源(音频/图标)
SQLite持久化
APKG导入导出
常见问题
幕境支持哪些操作系统？
根据当前仓库信息，幕境提供Windows和macOS平台的桌面版本，用户可从GitHub Releases页面下载对应安装包。仓库中未明确提及Linux版本或移动端应用。
如何从电影或美剧生成词库？
幕境支持从MKV视频文件直接提取单词和语境，或使用字幕文件（ASS/SSA/SRT）配合任意视频生成词库。具体操作步骤可参考项目Wiki中的相关教程（如“如何用MKV视频生成词库”）。
应用是否支持Anki格式？
是的，幕境支持导出APKG（Anki包）格式，实现与Anki生态的词库互通。同时，代码中包含了APKG创建和解析的示例模块，表明具备相关功能。
视频播放时的弹幕功能如何工作？
在播放视频时，幕境会以弹幕形式显示当前正在学习的单词，用户可通过悬停字幕进行翻译并一键添加到词库。播放器支持双语字幕切换、A/D键跳转、S键重复和智能暂停（每条字幕后暂停便于跟读）。
学习单词时有哪些互动练习方式？
幕境提供多种互动学习模式：拼写练习（键盘打字形成肌肉记忆）、字幕抄写（加深记忆）、听写测试（检验效果），以及通过快捷键控制显示音标、词形变化、释义等。所有练习均基于真实语境中的例句，并集成FSRS算法管理复习计划。