# Nihong AI explaination 霓虹AI讲解

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

## 功能

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

## 安装

### 手动构建

```bash
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/`。

## 开发

```bash
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
```