如何把Manatan接入Anki:AnkiConnect一键导出带音频的词句卡片
如何把Manatan接入Anki:AnkiConnect一键导出带音频的词句卡片
Manatan 是一款面向动漫、漫画和小说的沉浸式语言学习工具,内置词典查词、OCR 截词、视频字幕对照等能力。通过 AnkiConnect 桥接,Manatan 可以把查到的单词、句子连同发音音频、振假名、音调、词频和截图一键写入 Anki 卡片,帮你把"看懂"变成"记住"。本文带你完成从 AnkiConnect 安装到字段映射、一键导出的完整配置。
准备工作:装好 Anki 与 AnkiConnect
🔧 在动手配置 Manatan 之前,先让 Anki 这一侧"开门接客":
- 安装 Anki(桌面版或 AnkiDroid 均可),并新建一个准备存放学习卡片的牌组(Deck)。
- 安装 AnkiConnect 插件:在 Anki 的 Add-ons 面板中搜索并安装 AnkiConnect,它是 Manatan 与 Anki 通信的桥梁。
- 确认监听地址:AnkiConnect 默认监听
http://127.0.0.1:8765,这也是 Manatan 的默认值。 - 授权跨域访问:当 Manatan 的网页/客户端首次调用 AnkiConnect 时,Anki 端可能弹出权限请求,点击 Yes 即可。Manatan 的调用逻辑会自动执行
requestPermission握手来解决浏览器 CORS 拦截,源码见 anki.ts。
💡 移动端(AnkiDroid)与桌面端的地址可能不同,配置时留意设置里的提示;若使用远程 Anki,填写对应地址即可。
三步开启 Manatan 的 AnkiConnect 集成
打开 Manatan 右上角的 ⚙️ 设置,找到 AnkiConnect Integration 区域(实现位于 SettingsModal.tsx):
第 1 步:启用并检查连接状态
- 勾选 Enable AnkiConnect。
- 页面顶部会出现一个状态圆点:绿色 Connected 表示握手成功;红色 Not Connected 则点一下重试按钮。
- 如有需要,修改 AnkiConnect URL(默认
http://127.0.0.1:8765),见 SettingsModal.tsx。
第 2 步:选择目标牌组与卡片类型
连接成功后,页面会自动列出你 Anki 里的所有牌组和卡片模型(Card Type):
- Target Deck:卡片存放的牌组,下拉选择即可。
- Card Type:选择卡片模板,例如常用的 Basic 或自定义模板。
牌组、模型、字段均通过 deckNames / modelNames / modelFieldNames 接口自动拉取,无需手动填写,逻辑见 getDeckNames。
第 3 步:字段映射,把音频"对上号"
选中 Card Type 后会出现 Field Mapping 表格(SettingsModal.tsx),把 Anki 的每个字段映射到 Manatan 的内容:
| Anki 字段 | 可映射内容(Content) | 说明 |
|---|---|---|
| Front / 词 | Target Word | 词条本身(如 何か) |
| Reading | Reading / Furigana | 读音或带假名标注 |
| Glossary | Glossary | 完整释义列表 |
| Pitch Accent | Pitch Accent 等 | 音调信息,适合日语卡片 |
| Frequency | Frequency / Harmonic Frequency | 词频,可指定最低值、调和均值或特定词典 |
| Sentence | Sentence / Sentence Furigana | 当前句及其假名标注 |
| Audio | Word Audio / Sentence Audio | 🔊 单词或整句发音音频 |
| Image | Image | 查词位置的截图(可先裁剪) |
想让卡片带音频,关键就是给音频字段映射 Word Audio(单词发音)或 Sentence Audio(整句朗读)。音频来源由 wordAudio.ts 解析,写入时会根据实际格式自动保存为 m4a / ogg / wav / webm(anki.ts)。
一键导出:在词典弹窗里添加带音频的卡片
配置完成后,回到学习场景(视频、漫画或小说),查词弹出的词典浮层右侧会多出一个绿色 Add to Anki 按钮(DictionaryView.tsx):
- 点击后,Manatan 按字段映射组装词条、释义、振假名、截图,并附带音频,通过
addNote一次性写入 Anki(addNote),卡片自动打上manatan标签,方便日后筛选。 - 旁边还有一个 Open in Anki 按钮,可立刻在 Anki 浏览器中定位这张卡片检查效果。
- 截图会先经压缩与缩放(默认质量 0.92)再转成 WebP 写入,避免媒体库膨胀;开启 Enable Cropper 后还能发送前手动裁剪画面。
重复词怎么办:防重复与覆盖策略
同一个词反复查,卡片不该反复建。Manatan 在添加前会自动用 Anki 查询语法检查该词是否已存在(DictionaryView.tsx),配合设置项选择策略:
| 设置 | 选项 | 行为 |
|---|---|---|
| 重复处理 | prevent(默认) | 已存在则不重复添加 |
| overwrite | 覆盖已有卡片 | |
| add | 允许重复添加 | |
| 查重范围 | deck / deck-root | 在当前牌组或整个父牌组范围内查重 |
选择 overwrite 后,每个字段还能单独指定更新模式(实现见 calculateUpdatedFields):覆盖、有值才覆盖、追加、前置、仅填空、跳过——例如"释义追加、音频覆盖"的组合非常实用。
另外一个巧妙功能:更新最后一张卡片。如果你刚手动在 Anki 里建了一张卡片,Manatan 可以自动找到今天创建的最后一张(且不超过 5 分钟)的笔记,把截图、句子和音频补进去,还会保留你手写的 HTML 加粗等格式(updateLastCard)。
常见问题排查
- 状态一直 Not Connected:确认 Anki 已启动且 AnkiConnect 已启用;远程环境下把 URL 改成可访问的地址。
- 提示 "Connection blocked. Please click 'Yes' on the Anki permission popup.":这是浏览器跨域授权,在 Anki 弹出的授权框点 Yes 即可。
- 音频字段是空的:检查该字段是否映射了 Word Audio / Sentence Audio,且 Anki 模板里该字段支持嵌入音频文件。
- 连接类错误(Connection refused / ERR_CONNECTION_REFUSED):属于典型的端口未监听,优先检查 8765 端口与防火墙;Manatan 对这类错误已做了静默处理,只在非连接类问题上打印警告(logAnkiError)。
小结
整套流程只需三步:装好 AnkiConnect → 勾选启用并选择牌组/卡片类型 → 映射好字段,之后每查到一个值得记的词,一键就能得到一张带发音、截图和完整释义的 Anki 卡片。边看动漫边积累词库,语言学习就此进入"刷剧即复习"的节奏。
更多相关源码:
- 集成设置面板:SettingsModal.tsx
- 词典浮层 Anki 按钮:DictionaryView.tsx
- AnkiConnect 协议封装:anki.ts


