AI 词汇构建器

其他语言版本：[中文]

“AI 词汇构建器”是一款基于人工智能技术的智能英语词汇工具。它可以帮助您快速建立自己的英语词汇库，并更高效地学习。

主要功能：

• 独特高效的词汇构建方式：一键保存例句、翻译、生词及释义。
• 富有趣味性的故事模式和测验模式，助您轻松掌握新单词。
• 支持超过10种目标语言，并集成多种 AI 后端，包括 OpenAI、Gemini 和 Anthropic 等。

产品截图：

快速开始

本工具使用 Python 开发。请使用 pip 或其他包管理工具进行安装：

pip install ai-vocabulary-builder

pipx

pipx install ai-vocabulary-builder

uv

uv pip install ai-vocabulary-builder
# 或者使用 uvx 直接运行笔记本
# uvx --from ai-vocabulary-builder aivoc notebook

需要 Python 3.9 或更高版本。

安装完成后，运行 aivoc notebook 即可在浏览器中打开应用程序。

Docker

为了更便捷地部署并确保环境一致性，您也可以使用 Docker。有关如何构建和运行 Docker 镜像的说明，请参阅 CONTRIBUTING.md 文件。

功能

最常用的功能均可在笔记本应用中找到。以下是一些高级功能：

• 与 PopClip 集成，可通过高亮显示内容添加新单词。阅读指南

配置

本工具的主要配置可在网页上进行管理。此外，还有一些通过环境变量设置的附加配置。

AIVOC_DATA_DIR

指定存储词汇数据文件的路径。默认路径为当前用户的主目录：~/。

示例：

export AIVOC_DATA_DIR="$HOME/Documents"

为什么开发这款工具？

在学习英语的过程中，词汇构建工具至关重要。一个好的词汇构建工具至少应包含：生词、释义、例句以及例句翻译。然而，手动维护这些信息非常繁琐。因此，许多长期学习英语的人并没有属于自己的词汇库。他们常常在阅读时遇到新单词，查完字典后往往20秒就忘记了。

“AI 词汇构建器”旨在利用 AI 的力量，让构建词汇库的过程变得简单而有趣，从而使每个人都能拥有自己的词汇库，并迅速扩充词汇量。

AI Voc Builder 快速上手指南

AI Voc Builder 是一款由 AI 驱动的智能英语词汇构建工具，支持一键保存例句、翻译、生词及释义，并提供故事和测验模式辅助记忆。

环境准备

• 操作系统：Windows / macOS / Linux
• Python 版本：3.9 或更高
• 前置依赖：需确保已安装 pip、pipx 或 uv 其中一种包管理工具

💡 国内加速建议：安装时推荐使用清华或阿里镜像源以提升下载速度。 例如：pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ...

安装步骤

你可以选择以下任意一种方式进行安装：

方式一：使用 pip

pip install ai-vocabulary-builder
# 国内加速版
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ai-vocabulary-builder

方式二：使用 pipx（推荐用于隔离环境）

pipx install ai-vocabulary-builder

方式三：使用 uv（高性能替代方案）

uv pip install ai-vocabulary-builder
# 或直接运行
uvx --from ai-vocabulary-builder aivoc notebook

基本使用

安装完成后，在终端执行以下命令即可启动应用：

aivoc notebook

执行后，系统会自动在默认浏览器中打开 Web 界面。你可以在界面中：

1. 输入英文文本，利用 AI 自动提取生词、释义及例句。
2. 切换至“测验模式”或“故事模式”进行强化记忆。
3. 在设置页面配置 API Key（支持 OpenAI, Gemini, Anthropic 等后端）。

提示：数据文件默认存储在用户主目录 (~/.)，可通过设置环境变量 AIVOC_DATA_DIR 自定义存储路径。