毕业设计-一个使用了 AI 技术的智能生词本工具，特色功能：自动添加生词、读故事助记单

# AI 生词本 AI 生词本（“AI Vocabulary Builder” 简称 aivoc）是一个利用了 AI 技术的智能生词本工具，它能帮你快速构建起自己的生词库，学习起来事半功倍。 核心功能： - 提供高质量的整句翻译能力 - 由 AI 自动提取生词及释义 - 独创的故事模式助记生词 - 支持 CSV 等格式导出生词本 ## 快速开始 本工具基于 Python 开发，请使用 pip 来安装本工具： ```console # 需要 Python 版本 3.7 及以上 pip install ai-vocabulary-builder ``` 安装完成后，请在环境变量中设置你的 [OpenAI API key](https://platform.openai.com/account/api-keys)： ```console # 使用你在 OpenAI 官网上申请到的 key 替换该内容 export OPENAI_API_KEY='your_api_key' ``` 之后执行 `aivoc run` 启动工具，进入交互式命令行模式。或者执行 `aivoc notebook`，在浏览器中打开可交互式 Web App（推荐）。 除环境变量外，你也可以通过 `--api-key` 参数完成设置： ```console aivoc run --api-key "your_api_key" ``` ## 使用指南 ### 使用 Web App 执行 `aivoc notebook` 命令，使用可交互式 Web App。 ### 交互式命令行 执行 `aivoc run` 命令，会进入交互式命令行模式，在该模式下，你可以快速完成添加生词、阅读故事等操作。 #### 添加生词 默认情况下，命令行处于“添加生词”模式，此时你可以直接粘贴一小段英文： ```console Enter text> It depicted simply an enormous face, more than a metre wide ``` 按下回车后，工具会开始翻译工作。它首先会将你所输入内容的中文翻译打印到屏幕上。然后，它会从原文中提取出一个**你最有可能不认识的单词**，将其加入到生词本中。 ``` Translation Result ┌───────────────┬─────────────────────────────────────────────────────────────┐ │ Original Text │ It depicted simply an enormous face, more than a metre wide │ │ Translation │ 它只是简单地描绘了一个巨大的面孔，超过一米宽。 │ └───────────────┴─────────────────────────────────────────────────────────────┘ ⠴ Extracting word > The new word AI has chosen is "depicted". ┏━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Word ┃ Pronunciation ┃ Definition ┃ ┡━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩ │ depicted │ /dɪˈpɪkt/ │ 描述，描绘（原词：depict） │ └──────────┴───────────────┴────────────────────────────┘ "depicted" was added to your vocabulary book (78 in total), well done! ``` #### 重选生词 某些情况下，工具所挑选的生词可能并非你所想的那个。此时，通过输入 `no` 命令，你可以启动一次重选： ``` Enter text> no ``` 上一次被添加到生词本的单词会被丢弃，工具将尝试重新返回 4 个新生词（可能包含刚被丢弃的词），如下所示： ``` "depicted" has been discarded from your vocabulary book. ⠋ Extracting multiple new words ? Choose the word(s) you don't know (Use arrow keys to move, <space> to select, <a> to toggle, <i> to invert) » ○ depicted / （原词：depict） / dɪˈpɪkt / 描绘，描述 ○ metre / （原词：meter） / ˈmiːtə(r) / 米 ○ simply / ˈsɪmpli / 简而言之，仅仅 ○ enormous / ɪˈnɔːməs / 巨大的，庞大的 ○ None of above, skip for now. ``` 请按↑↓方向键移动游标，按空格选中你想要的词（支持多选），按下回车确认。选中的单词会被添加到你的生词本中。 ``` ? Choose the word(s) you don't know done (2 selections) New word(s) added to your vocabulary book: "metre,enormous" (79 in total), well done! ``` 假如你所想的单词仍然没有出现在选项中，请选择 `None of above, skip for now.`，跳过本次添加。 > 别气馁，祝你下次好运。😁 #### 查看生词 使用 `list` 命令可以查看生词本中最近添加的生词，默认展示 10 条： ```plain Enter text> list ``` 该命令接收一个可选参数：`limit`，用来指定生词的数量。常见用法： ```plain # 查看最近 5 条 Enter text> list 5 # 查看所有生词 Enter text> list all ``` ### 删除生词 使用 `remove` 命令可以进入“删除生词”模式。 在该模式下，你可以输入单词（按↑↓方向键选择自动补全），再按回车键将其从生词本中删除。除手动输入外，你还用可以用鼠标选择单词。 要退出“删除生词”模式，输入 q （或不输入任何内容）按下回车，工具将退回到“翻译模式”。 #### 阅读故事来助记生词 为了快速并牢固掌握生词本里的单词，本工具提供了一个创新的故事模式。在交互式命令行模式下，输入 `story` 开始故事模式： ``` Enter text> story ``` 工具将从生词本里挑选出 6 个单词，请求 AI 用这些词写一个小故事。输入如下所示： ``` Words for generating story: prudent, extraneous, serendipitously, onus, aphorisms, cater ⠼ Querying OpenAI API to write the story... ╭─────────────────────────────────────────── Enjoy your reading ────────────────────────────────────────────╮ │ Once there was a prudent young girl named Alice who always carried a small notebook with her. She wrote │ │ down aphorisms and wise sayings that she heard from her elders or from books. It was an extraneous task, │ │ but Alice believed that it helped her to be wise and joyful. │ │ │ │ One day, Alice went for a walk in the park and serendipitously met an old man. He was reading a book, and │ │ Alice noticed that he had marked some phrases with a pencil. She greeted him and asked about the book. │ │ They started to chat about literature, and the man shared some of his favorite aphorisms. │ │ │ │ Alice was delighted, and she wrote down the new sayings in her notebook. After their conversation, the │ │ man thanked Alice and said that he felt as if a heavy onus had been lifted from his chest. Alice smiled │ │ and said that it was her pleasure to cater to his needs. │ │ │ │ From then on, Alice and the old man often met in the park to exchange knowledge and wisdom. They learned │ │ that serendipity could bring unexpected blessings to life. │ ╰──────────────────────────────────────────────────────────────────────────────────────────────