DuckABC大可英语 - CLI背单词工具

一个基于 Node.js 的命令行背单词工具，支持交互式学习、拼写测试、词义选择、艾宾浩斯遗忘曲线复习等功能，帮助你高效记忆英语单词。

功能特性

• 交互式菜单：运行 vocab 即可进入交互式主菜单，操作简单直观
• 背单词模式：翻卡式学习，支持空格键查看释义、标记掌握状态
• 拼写测试：根据中文释义拼写英文单词，检验记忆效果
• 词义选择测试：给出英文单词，从多个选项中选择正确释义
• 艾宾浩斯遗忘曲线复习：根据艾宾浩斯遗忘曲线智能推荐需要复习的单词
• 学习进度追踪：记录每个单词的学习状态和复习次数，随时查看进度
• 自定义词库导入：支持导入自定义 JSON 格式词库
• 难度分级：内置 easy / medium / hard 三级难度，可按难度筛选学习

安装方法

npm install -g @duckabc/vocab

要求 Node.js 版本 >= 18.0.0

使用方法

进入交互式菜单

vocab

直接运行 vocab，进入交互式主菜单，通过方向键选择功能。

背单词

vocab study [--difficulty easy|medium|hard]

进入翻卡式背单词模式。按 空格键 翻转卡片查看释义，按 m 标记为已掌握，按 n 标记为未掌握，按 q 退出。

拼写测试

vocab test spelling [--difficulty easy|medium|hard]

系统给出中文释义和例句，用户输入对应的英文单词，检验拼写能力。

词义选择测试

vocab test meaning [--difficulty easy|medium|hard]

系统给出英文单词，从四个选项中选择正确的中文释义。

艾宾浩斯复习

vocab review

根据艾宾浩斯遗忘曲线，智能推荐当前需要复习的单词列表，巩固记忆。

查看进度

vocab progress

展示总体学习进度，包括已掌握单词数、未掌握单词数、总学习时长等统计信息。

查看单词列表

vocab list [--difficulty easy|medium|hard]

列出当前词库中的所有单词，支持按难度筛选。

导入自定义词库

vocab import <filepath>

导入自定义 JSON 格式词库文件，替换当前学习词库。

查看帮助

vocab help

显示所有可用命令和选项的帮助信息。

自定义词库格式

自定义词库为 JSON 格式，结构如下：

[
  {
    "word": "algorithm",
    "meaning": "算法",
    "example": "This algorithm is very efficient.",
    "difficulty": "medium"
  },
  {
    "word": "apple",
    "meaning": "苹果",
    "example": "I eat an apple every day.",
    "difficulty": "easy"
  }
]

字段说明：

• word：英文单词（必填）
• meaning：中文释义（必填）
• example：例句（可选）
• difficulty：难度等级，可选值为 easy、medium、hard（必填）

键盘操作说明

| 按键 | 功能 | |------|------| | 空格键 | 翻卡查看释义 | | m | 标记为已掌握 | | n | 标记为未掌握 | | q | 退出当前模式 | | Enter | 继续下一题 / 确认选择 |

截图/效果预览

运行 vocab 后，终端会显示如下效果：

╔══════════════════════════════════════╗
║     🦆 DuckABC 大可英语 🦆            ║
║     CLI 背单词工具 v1.0.0              ║
╚══════════════════════════════════════╝

? 请选择功能 (Use arrow keys)
❯ 📖 背单词
  ✏️  拼写测试
  🎯 词义选择
  🔄 艾宾浩斯复习
  📊 查看进度
  📋 单词列表
  📥 导入词库
  🚪 退出

背单词模式下：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📖 背单词模式 [1/50] | 难度: medium
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

单词: algorithm
音标: /ˈælɡərɪðəm/

[按空格键查看释义]

按空格键后：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📖 背单词模式 [1/50] | 难度: medium
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

单词: algorithm
音标: /ˈælɡərɪðəm/

📘 释义: 算法
📝 例句: This algorithm is very efficient.

[m] 掌握  [n] 未掌握  [q] 退出

技术栈

• Node.js - 运行环境
• TypeScript - 开发语言
• Commander - 命令行参数解析
• Inquirer - 交互式命令行提示
• Chalk - 终端字符串样式美化

许可证

MIT License