Nihong AI explaination 霓虹AI讲解

一个 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：

配置项	默认值	说明
笔记输出目录	（空）	相对 vault 根，留空 = 根目录；支持下拉选择 vault 内文件夹
语法拆解输出目录	（空）	语法拆解笔记保存目录，留空 = 根目录
大模型分组	见下	可配置多组（API 地址 / 模型 id / API Key），支持复制 / 新增 / 删除
AI 讲解大模型	默认分组	AI 讲解使用此分组
语法拆解大模型	默认分组	语法拆解使用此分组
翻译大模型	默认分组	翻译使用此分组
温度	0.7
最大重试次数	3
重试间隔	2000 ms
翻译目标语言	中文
词典卡片字号	0	8–32 px，0 = 用 Obsidian 主题默认
朗读语速	1.0	0.5–3.0，1.0 = 正常
禁用 Lexis 悬浮窗	关	开启后改用本插件自带选区按钮

离线词典

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

• 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