Anki Contextual Reader

一个面向语言学习场景的 Anki 阅读插件，支持 EPUB、Markdown、纯文本阅读，以及 AI 语境解释与快速制卡。

项目出处与说明

• 本仓库基于 AnkiWeb 插件页面中的原项目继续修改，原始出处：https://ankiweb.net/shared/info/1098514784
• 我并非该项目的原开发者；当前仓库主要用于在原项目基础上的个人修改与整理
• 当前 GitHub 仓库：https://github.com/Sonder9999/anki-contextual-reader
• 相关介绍视频出处：ANKI EPUB 阅读器 + AI 语境解释 + 快速制卡
  https://www.bilibili.com/video/BV1PkCFY4Em4/

功能特点

• 支持文本选择和翻译
• 自动生成单词释义和例句
• 一键添加到Anki卡片
• 支持OpenAI和自定义API服务
• 支持导入 Markdown (.md)、EPUB (.epub) 与纯文本文件
• Markdown 阅读支持标题导航，并尽量保留下划线、高亮、列表、引用等格式
• 阅读界面采用更接近电子书的三栏布局：目录 / 阅读区 / AI 面板

Topics

anki language-learning reader epub markdown ai contextual-reading

安装说明

1. 确保你的Anki版本在2.1.50以上

2. 下载插件文件

3. 将插件文件夹放入Anki的插件目录：

   • Windows: %APPDATA%\Anki2\addons21\
   • Mac: ~/Library/Application Support/Anki2/addons21/
   • Linux: ~/.local/share/Anki2/addons21/

4. 安装依赖（两种方法）：

   方法一：使用Anki的Python环境安装

   cd {插件目录}/anki_reader
   "C:\Program Files\Anki\python\python.exe" -m pip install aiohttp yarl multidict attrs charset-normalizer async-timeout frozenlist aiosignal idna --target=vendor

   方法二：使用系统Python环境安装

   cd {插件目录}/anki_reader
   python -m pip install -r requirements.txt --target=vendor

5. 重启Anki

配置说明

1. 在Anki菜单中选择"工具" -> "Anki Reader"
2. 点击"设置"按钮
3. 选择AI服务类型：
   • OpenAI：需要填写API Key和可选的API地址
   • 自定义API：需要填写API地址和相关端点

使用方法

1. 在Anki菜单中选择"工具" -> "Anki Reader"
2. 点击打开文件，可导入 EPUB、Markdown 或 TXT
3. 在 Markdown 模式下，可使用左侧目录快速跳转到标题位置
4. 选择单词或段落：
   • 单词：自动获取释义和例句
   • 段落：自动翻译
5. 点击"添加到Anki"将内容添加到卡片中

常见问题

1. 如果遇到依赖安装问题：

   • 确保使用了正确的Python版本（与Anki使用的版本相同）
   • 尝试使用Anki自带的Python环境安装
   • 检查vendor目录是否存在并包含所有依赖包

2. 如果遇到API连接问题：

   • 检查网络连接
   • 确认API Key是否正确
   • 确认API地址是否可访问

支持与反馈

如果你遇到任何问题或有建议，请在GitHub上提交issue。