VBDeepSeek: DeepSeek를 사용하여 4학년 단어 학습 자료를 생성하는 오픈 소스 도구입니다.

54.8K 00

일반 소개

"Vocabulary Book by DeepSeek"은 영어 학습자가 대학 영어 레벨 4(CET-4)의 어휘를 효율적으로 습득할 수 있도록 돕는 것을 목표로 DeepSeek의 빅 모델을 기반으로 개발된 오픈 소스 프로젝트입니다. 개발자 vxiaozhi가 만든 이 프로젝트는 GitHub에서 호스팅되며, DeepSeek의 강력한 언어 생성 기능과 결합된 Python 스크립트를 통해 단어의 의미, 어근, 예문, 암기 기법 등이 포함된 어휘 학습 자료를 자동으로 생성합니다. 이 도구는 단어를 알파벳 순서로 정리하고, 출력 형식이 명확하며, JSON 파일 저장을 지원하므로 학생, 교사 또는 자가 학습자에게 적합합니다. 프로젝트 코드는 공개되어 있으며 80% 이상은 DeepSeek에서 자동으로 생성되어 교육에 AI의 혁신적인 적용을 반영합니다. 4학년을 준비하든 어휘력을 향상시키든 이 도구는 편리한 학습 지원을 제공합니다.

기능 목록

4학년 어휘 학습 자료 자동 생성딥서치 인터페이스를 호출하여 단어 의미, 어근 분석, 예문 및 기억 팁을 생성합니다.
알파벳순 저장CET-4 단어를 첫 글자에 따라 A부터 Z까지 JSON 파일로 나누면 쉽게 찾고 관리할 수 있습니다.
유용한 이미지 생성스크립트를 통해 단어와 관련된 니모닉 이미지를 생성하여 암기력을 향상시킵니다.
기사 생성기블로그나 노트 정리에 적합한 글자로 시작하는 마크다운 형식의 어휘 학습 글을 생성하세요.
오픈 소스 지원전체 Python 코드가 제공되며 사용자가 자유롭게 기능을 수정하거나 확장할 수 있습니다.

도움말 사용

설치 프로세스

'딥시크릿의 어휘장'은 특정 프로그래밍 환경이 필요한 파이썬 기반 도구로, 실행하려면 특정 프로그래밍 환경이 필요합니다. 아래는 자세한 설치 및 사용 단계입니다:

1. 환경 준비

Python 설치파이썬 3.8 이상이 시스템에 설치되어 있는지 확인합니다(파이썬 웹사이트에서 다운로드하여 설치할 수 있습니다).
복제 프로젝트터미널 또는 명령줄을 열고 다음 명령을 입력하여 프로젝트를 로컬로 다운로드합니다:
```
git clone https://github.com/vxiaozhi/vocabulary-book-by-deepseek.git
cd vocabulary-book-by-deepseek
```

종속성 설치이 프로젝트는 여러 Python 라이브러리를 사용하므로 다음 명령을 실행하여 설치합니다:
```
pip install -r requirements.txt
```
그렇지 않은 경우requirements.txt를 클릭하면 핵심 라이브러리를 수동으로 설치할 수 있습니다:
```
pip install requests openai pillow
```
DeepSeek API 구성: DeepSeek API 키가 필요합니다. 딥시크 계정에 가입한 후 딥시크 플랫폼에서 키를 받아 프로젝트 구성 파일 또는 코드의 API 호출 섹션에 입력합니다.

2. 주요 기능 사용

이 프로젝트는 단어 도우미 도구와 도우미 이미지 생성 도구라는 두 가지 핵심 스크립트로 구성되어 있습니다. 자세한 작업 흐름은 다음과 같습니다:

(1) 단어 학습 자료 생성

단어 데이터 준비프로젝트는 기본적으로 제공됩니다.data/cet4/디렉터리에서 문자 A-Z로 정렬된 JSON 파일(예A.json및B.json). 각 파일에는 해당 문자로 시작하는 단어 목록이 포함되어 있습니다.
스크립트 실행::
- 터미널을 열고 프로젝트 디렉토리로 이동합니다.
- 다음 명령을 실행하여 단어 분석을 생성합니다:
```
python cet4_word_helper.py
```
- 스크립트는data/cet4/목록의 단어는 DeepSeek API를 통해 단어의 의미, 어근, 예문 및 기억 팁을 생성하는 데 사용되며 결과는result/cet4/JSON 파일을 디렉터리에 저장합니다(예A.json).

결과 보기: 생성된 JSON 파일의 구조 예시입니다:

{
"word": "abandon",
"meaning": "放弃",
"root": "a-(加强) + bandon(控制)",
"example": "He had to abandon his car in the snow.",
"memory_tip": "想象一个人在雪地里放弃aband控制on车。"
}

(2) 니모닉 그림 생성하기

이미지 생성 스크립트 실행::
- 다음 명령을 실행합니다:
```
python gen_words_img.py
```
- 스크립트는 다음을 기반으로 합니다.result/cet4/스크립트의 단어 데이터는 니모닉 이미지를 생성하는 데 사용되며, 기본적으로 지정된 디렉터리에 저장됩니다(스크립트에서 출력 경로를 구성해야 함).
사용자 지정 설정수정 : 수정gen_words_img.py매개변수(예: 이미지 크기, 해상도 또는 스타일)를 사용하여 요구 사항을 충족하는 이미지가 생성되도록 할 수 있습니다.

(3) 어휘 기사 생성

문서 생성 스크립트 실행::
- 구현:
```
python gen_articles.py
```
- 스크립트 읽기result/cet4/을 사용하여 26개의 마크다운 파일(2025-02-11-cet4-A.md)에 저장하고result/cet4_articles/카탈로그.

출력 형식각 파일에는 학습 또는 공유에 적합한 문자로 시작하는 단어에 대한 분석이 포함되어 있습니다. 예시:

---
title: "四级词汇-A开头单词"
date: 2025-02-11
---
## abandon
词义：放弃  
词根：a-(加强) + bandon(控制)  
例句：He had to abandon his car in the snow.  
记忆技巧：想象一个人在雪地里放弃aband控制on车。

3. 운영 고려 사항

API 키 보안DeepSeek API 키를 스크립트에 직접 하드코딩하지 말고 환경 변수를 사용하여 저장하는 것이 좋습니다:
```
export DEEPSEEK_API_KEY='你的密钥'
```
네트워크 연결스크립트를 실행할 때 네트워크가 사용 가능한 상태인지 확인해야 합니다.
파일 경로 확인만약data/cet4/어쩌면result/cet4/디렉터리가 누락되었으므로 스크립트 경로 구성을 수동으로 만들거나 조정해야 합니다.
확장된 기능레벨 6 단어 지원을 추가하거나 출력 형식을 조정하는 등 필요에 따라 코드를 수정할 수 있습니다.

4. 특수 기능 작동

배치 파일메인 스크립트를 한 번만 실행하여 모든 문자에 대한 단어 프로필을 한 번에 생성합니다.
사진 지원 메모리생성된 보조 이미지를 전자 노트로 가져오거나 인쇄하여 텍스트 기반 학습과 함께 사용할 수 있습니다.
기사 공유마크다운 파일은 블로그 포스팅에 바로 사용하거나 노션과 같은 도구로 가져와 학습 노트를 정리하는 데 사용할 수 있습니다.

클라인 미션 단서

Task1

用 Python 写一个 cet4 单词助记工具，对单词进行词义词根分析、例举例句、并提供一些高效的记忆技巧和窍门。 详细需求如下：
1. 单词已经按照字母归类存储在data/cet4/目录下，分别为： A.json B.json ... Z.json
2. 读取每一个 data/cet4/目录下 每个JSON文件中的所有单词，对每个单词调用OpenAI的接口生成该单词的词义、词根、例句、记忆技巧信息。
3. 生成的单词信息保存到 result/cet4/目录下，分别为： A.json B.json ... Z.json

Task2

用 Python3.8 写一个单词助记图片生成工具gen_words_img.py， 详细需求如下：
1. 读取每一个 result/cet4/目录下 每个JSON文件中的所有单词信息，每个单词信息包括word、analysis、draw_explain、draw_prompt 4个字段。
2. 对每个单词调用replicate的接口(接口具体实现在provider_replicate.py:replicate_run)生成该单词的图片。
3. 生成的图片文件保存到 result/cet4_imgs/目录下，文件名称格式为：{first_letter_of_word}/{word}.jpg。如果对应图片文件已存在，则跳过本图片文件的生成。
4. 假设所有依赖库已经安装。

Task3

用 Python3.8 写一个文章生成工具gen_articles.py， 为26个英文字母各生成一个文件，共26个文件，文件名格式为：2025-02-11-cet4-{letter}.md, 每个文件的内容组成如下：
"""
---
layout:     post
title:      "四级词汇-{letter}开头单词"
subtitle:   "四级词汇-{letter}开头单词"
date:       2025-02-11
author:     "vxiaozhi"
catalog: true
tags:
- english
- cet4
---

{{ for all word begin with letter}}
## word
{word.analysis}
{{end}}
"""
其中 word.analysis 通过读取 result/cet4/{letter}.json 获得，result/cet4/{letter}.json存储了{letter}开头的全部单词的信息，如果result/cet4/{letter}.json 不存在，则跳过该letter对应文件的生成。
更多约束如下：
1、2025-02-11-cet4-{letter}.md 保存到 result/cet4_articles 目录下。
2、Python 使用 3.8 版本。
3、假设所有Python依赖库已经安装。