Huanmuyu

Huanmuyu is a language self-study plugin for Obsidian. It gives you a daily check-in calendar, new-word cards, spaced-repetition review, graded reading, text-to-speech, sentence practice, and a personal vocabulary book. It supports English, Japanese, Korean, French, Chinese, Spanish, and Arabic. Korean content is organized into TOPIK 1–6 bands, while a required Japanese placement test recommends an N5–N1 starting point. English and Japanese natural speech run locally. All learning progress stays inside your own vault.

一个装在 Obsidian 里的语言自学插件：打卡日历 + 今日新词 + 艾宾浩斯复习 + 分级阅读 + 自然朗读 + 造句练习 + 生词库。支持英/日/韩/法/中/西班牙/阿拉伯语；韩语按 TOPIK 1—6 分级，日语通过入门测试推荐 N5—N1 起点。学习进度全部存在你本机，不上传。

📖 图文使用教程：https://api.monoi.cn/nbp/native/guide

它怎么工作

• 插件(本仓库)：学习界面、内置分级词表、词卡基础信息和本地进度。开源、MIT。
• 内容：装好插件并验证授权后即可使用内置内容；也可以在插件内导入自己的单词和 Markdown 文章。
• 日语完整中文词卡：N5—N1 的单词释义与例句对照全部面向中文学习者显示为简体中文，不再混入英文解释。
• 日语分级阅读：N5—N1 每级内置 60 篇原创日中对照短文，进入当天页面时自动创建，不需要另外下载文章。
• 朗读：英语和日语自然声模型在电脑本地运行；日语固定使用清晰的 02 号女声。首次选择日语时会在后台缓存一次发音资源，朗读文字不会上传。
• 授权：公众号购买 100 天权益；插件在线校验密钥(api.monoi.cn)，绑 1 台设备。

安装

• 社区插件市场：搜「换母语」→ 安装 → 启用。
• 手动：把 release 里的 main.js / manifest.json / styles.css 放进 你的库/.obsidian/plugins/huanmuyu/，再在第三方插件里启用。

网络使用 (Network use)

本插件在下列情况下会发起网络请求，除此之外不联网、不上传你的学习数据：

• 你的词卡、文章、打卡进度、生词库全部只存在你自己的 Obsidian 库里，不会上传到任何服务器。
• 本插件不会替你调用第三方 AI 接口，也不会上传笔记、文章、打卡进度或生词库。
• The plugin contacts api.monoi.cn only for license validation and official English learning assets. It never uploads notes, progress, or the personal vocabulary book.

从源码构建

npm install
npm run build   # 产出 main.js

源码在 main.ts(TypeScript，esbuild 打包)。

许可

插件代码使用 MIT 许可。韩语词汇数据说明见 KOREAN-DATA-NOTICE.md，日语 N5—N1 词汇数据与授权说明见 JAPANESE-DATA-NOTICE.md。

—— monoi.cn