vocabflow

在终端中复习单词的 CLI 工具，基于间隔重复算法 (SM-2)。搭配 VocabFlow 网页端使用，在命令行中高效复习你的生词本。

安装

npm install -g vocabflow

快速开始

1. 先在 vocab.now 注册并登录账号，添加你要学习的单词
2. 在终端中登录 CLI：

vocabflow login

这会打开浏览器跳转到 vocab.now 登录页面，登录后自动完成授权。

3. 开始复习今天到期的单词：

vocabflow review

命令

vocabflow login

打开浏览器跳转到 vocab.now 进行登录授权。你需要先在网页端有一个账号，CLI 会通过本地回调服务器接收登录凭证。

vocabflow logout

清除本地保存的登录凭证。

vocabflow status

查看当前登录状态。

vocabflow review

启动交互式复习会话，复习今天到期的单词。

复习模式：

| 模式 | 参数 | 说明 | |------|------|------| | 正向 | --mode forward | 看单词，回忆释义（默认） | | 选择 | --mode revert | 四选一：看单词选中文释义 | | 反向 | --mode backward | 看释义，回忆单词 |

# 默认正向模式
vocabflow review

# 四选一模式
vocabflow review --mode revert

快捷键（正向模式）：

| 按键 | 操作 | |------|------| | Space | 显示释义和例句 | | 1 | 评分：忘记了 | | 2 | 评分：模糊 | | 3 | 评分：已掌握 | | p | 发音 | | r | 切换复习模式 | | h / l | 上一个 / 下一个 | | Backspace | 删除单词 | | q | 退出 |

快捷键（选择模式）：

| 按键 | 操作 | |------|------| | A / B / C / D | 选择答案 | | p | 发音 | | r | 切换复习模式 | | h / l | 上一个 / 下一个 | | Backspace | 删除单词 | | q | 退出 |

vocabflow settings

查看或修改 CLI 设置。

# 查看当前设置
vocabflow settings

# 设置默认复习模式
vocabflow settings set default-mode forward
vocabflow settings set default-mode revert
vocabflow settings set default-mode backward
vocabflow settings set default-mode choice

vocabflow clear cache

清除本地缓存的发音音频文件。

vocabflow --version

显示当前版本号。

特性

• 间隔重复 — SM-2 算法自动安排最佳复习时间
• 多种复习模式 — 闪卡、四选一、反向模式
• 单词发音 — 支持 API 音频和系统 TTS（按 p 发音）
• 键盘驱动 — Vim 风格导航（h/l 切换单词）
• 本地音频缓存 — 发音音频缓存到本地，加速播放

别名

vocabflow 和 vocab 都可以作为命令使用：

vocab review
vocab login

环境要求

• Node.js >= 18
• 一个 VocabFlow 账号

License

MIT