背单词这件事我折腾了很久。用了很多 App要么卡片太简陋只有单词中文释义要么复习流程太机械。我想做的是把每个单词都变成一张有温度的卡片——有英文释义、有使用场景、有记忆技巧、有发音还有地道的例句。于是一口气做了这个 CLI 工具anki-vocab。它把 ClaudeLLM、OpenAI TTS、Anki 串成了一条流水线按下一个命令所有事情自动完成。更妙的是我发现光存卡片还不够。记过的单词得用起来。于是我又加了一个阅读理解练习模式从你的单词库里抽取词汇让 Claude 生成一篇考研英语风格的阅读文章你在浏览器里阅读、做题鼠标悬停就能看词义。功能一览功能说明AI 制卡调用 Claude 生成结构化单词卡片英文释义、用法、记忆技巧、Collins 释义、中文翻译AI 发音OpenAI TTS 生成地道美音即时播放并嵌入卡片一键入库自动存入 Anki支持创建/更新/去重AnkiConnect通过 HTTP API 与 Anki 交互无需手动导入离线缓存Anki 没开自动写入 SQLite下次自动同步阅读练习生成考研英语风格阅读理解400-500 词5 道题鼠标悬停查词义错题追踪答错的单词自动记录下次优先练习弱词可插拔 TTSTTS 层完全解耦换 ElevenLabs 只需一行代码安装git clone https://github.com/zhchoice123/anki-vocab.git cd anki-vocab python -m venv venv source venv/bin/activate pip install -r requirements.txt # 配置 API Key cp .env.example .env # 编辑 .env填入 ANTHROPIC_API_KEY 和 OPENAI_API_KEY前置条件Python 3.11Anki 桌面版 AnkiConnect 插件一个名为英语单词模板(vocab配色)的 Note Type10 个字段用法一查词制卡最简单的方式./word tenacious终端会显示一张漂亮的 Rich 渲染卡片╭──────────────────────────────────────────────────────────────╮ │ │ │ tenacious adj.顽强的坚韧不拔的 │ │ │ │ ★★★★☆ │ │ │ │ 1. SIMPLE MEANING │ │ Someone who keeps trying and never gives up. │ │ │ │ 2. KEY IDEA │ │ It shows very strong will and determination. │ │ │ │ ... │ │ │ │ ✓ Saved to Anki │ ╰──────────────────────────────────────────────────────────────╯同时你会听到 TTS 朗读 tenacious。卡片已自动存入 Anki。如果这个词已经在牌组里了它会直接播放已有音频并展示卡片不会重复调用 API。支持短语./word give up支持参数覆盖./word --deck My Deck serenity # 指定牌组 ./word --speed 0.8 verbose # 慢速发音更清晰 ./word -v tenacious # 开启 debug 日志用法二阅读理解练习这是我个人最喜欢的功能。./word practice它会做以下几件事从你的单词库中智能选词优先选你答错过的弱词不足再补新词调用 Claude 生成一篇阅读文章——题材随机经济、科技、历史、政治、文化…400-500 词4-6 段考研英语难度生成 5 道选择题覆盖考研五大题型主旨大意、细节理解、推理判断、词义猜测、作者态度启动本地 Web 服务http://127.0.0.1:8766自动打开浏览器页面效果深色主题护眼✨目标单词蓝色高亮鼠标悬停弹出英文简单释义✅做完提交后即时判分标出对错并显示解析错题自动写入 SQLite下次优先复习./word practice -n 8 # 只用 8 个词生成文章 ./word practice --port 8767 # 换端口 ./word practice --no-browser # 不自动打开浏览器错题追踪原理每次你答错一道题系统会读取这道题的target_word它考察的是哪个单词然后在 SQLiteword_errors表中记录一次错误。下次运行./word practice时WordSelector会先按error_count DESC, last_error DESC取出弱词再用最新添加的单词补足到 10 个也就是说你的弱词会被反复照顾直到你真正掌握。离线也能用Anki 没开完全没问题。当你执行./word tenacious时如果 AnkiConnect 连不上工具会静默把完整卡片 音频 Base64 写入~/.anki-vocab/pending.db。下次运行任意命令时后台线程会自动把这些 pending 的卡片推送到 Anki并提示[sync] synced 3 pending word(s) to Anki技术架构这个项目代码量不大约 2000 行 Python但结构比较清晰anki-vocab/ ├── add_word.py # CLI 入口子命令路由 ├── config.py # 环境变量配置 ├── models.py # 数据模型WordCard、ReadingMaterial… ├── anki/ │ ├── repository.py # AnkiConnect HTTP 客户端 │ ├── cache.py # LRU 缓存装饰器 │ ├── formatter.py # WordCard ↔ Anki 字段映射 │ └── local_store.py # SQLite 离线缓存 错题追踪 ├── llm/ │ ├── base.py # LLM 抽象基类 │ └── claude.py # Claude 提供商查词 阅读生成 ├── tts/ # TTS 完全解耦 │ ├── base.py # TTS 抽象基类 │ ├── openai_tts.py # OpenAI TTS 实现 │ ├── player.py # 跨平台音频播放 │ └── utils.py # PCM → WAV 工具 ├── services/ │ └── word_service.py # 业务编排层 ├── practice/ # 阅读理解练习模式 │ ├── selector.py # 智能选词错题优先 │ ├── generator.py # 阅读生成器 │ ├── server.py # Flask Web 服务 │ ├── templates/ │ │ └── practice.html # 阅读 UI │ └── static/ │ └── style.css # 深色主题 Tooltip ├── display/ │ └── renderer.py # Rich 终端渲染 └── tests/ └── test_core.py # 单元测试40 测试用例设计亮点Repository Decorator 模式CachingAnkiRepository给 Anki 操作加了 LRU 缓存find读缓存save/update写穿缓存