Nihong AI explaination

一个 Obsidian 插件。选中一段日文文字，在选区下方弹出按钮，点击后调用大模型生成讲解笔记，自动保存为 <输出目录>/<选中文字>.md；同时支持语法拆解、翻译、离线查词典（含声调）与朗读。

功能

• 选中文字 → 选区下方浮动按钮「AI 讲解 / 语法拆解 / 翻译 / 查词典 / 朗读」（同时支持编辑器右键菜单与命令面板）
• AI 讲解：调用大模型，生成结构化讲解笔记
• 语法拆解：调用大模型，对日语句子/短语做逐词拆解与语法点讲解，保存为笔记
• 翻译：调用大模型，结果以浮动卡片展示
• 查词典：离线 Yomitan 词典，弹窗展示释义、例句、声调（圆圈数字 ⓪①②…）
• 朗读：Google Translate TTS，长文本分片、LRU 缓存、支持语速与停止
• epub 转 md：右键 .epub 文件 → 转换为 Markdown（去振假名、每章一文件、插图提取到 images/）
• 讲解笔记保存为 <outputDir>/<word>.md，语法拆解保存为 <grammarOutputDir>/<句子>.md

安装

手动构建

npm install
npm run build

配置

在 Settings → Nihong AI explaination：

离线词典

设置页「离线词典」区块：

• Jitendex 词典：单按钮，首次点击为「安装词典」（从 Jitendex 官方源下载 jitendex-yomitan.zip 并导入 IndexedDB），已安装后变为「更新词典」（检测 GitHub 最新版本号，本地 zip 版本一致则跳过下载，否则清空旧数据重新导入）
• 清空词典：清空 IndexedDB 中的词典数据

Jitendex 词典源：https://jitendex.org/pages/downloads.html（GitHub release：stephenmk/stephenmk.github.io）。

声调数据来自 kanjium accents.txt https://raw.githubusercontent.com/mifunetoshiro/kanjium/master/data/source_files/raw/accents.txt。

使用

AI 讲解

1. 在任意笔记中选中一段日文文字
2. 选区下方出现按钮，点击「AI 讲解」（或右键菜单 / 命令面板）
3. 完成后提示 已生成: <path>，并在配置目录下创建 <word>.md

语法拆解

1. 选中一个日语句子或短语
2. 点击「语法拆解」（或右键菜单 / 命令面板）
3. 完成后在语法拆解输出目录下创建 <句子>.md，含整体含义、逐词解析、关键语法点、相似改写与整句语感

翻译 / 查词典 / 朗读

选中文字后点对应按钮即可。查词典弹窗展示词头、声调、义项、例句；朗读支持长文本分片与缓存。

epub 转 md

在文件管理器右键 .epub 文件 → 「转换为 md」，产物在同层 <文件名>/ 目录下，每章一个 .md，插图提取到 <文件名>/images/。

开发

npm install        # 安装依赖
npm run dev        # esbuild watch 模式 -> dist/
npm run build      # tsc 类型检查 + esbuild 生产打包 -> dist/
npm run typecheck  # 仅 tsc -noEmit -skipLibCheck
npm run test       # esbuild 编译 test/*.test.ts -> test-dist/ 后 node --test