VBDeepSeek: una herramienta de código abierto para generar materiales de estudio de palabras de 4º curso utilizando DeepSeek.

Introducción general

"Vocabulary Book by DeepSeek" es un proyecto de código abierto desarrollado en base al gran modelo de DeepSeek, con el objetivo de ayudar a los estudiantes de inglés a dominar eficientemente el vocabulario del nivel 4 de inglés universitario (CET-4). El proyecto está alojado en GitHub, creado por el desarrollador vxiaozhi, a través del script Python combinado con las potentes capacidades de generación de lenguaje de DeepSeek, genera automáticamente materiales de aprendizaje de vocabulario que contienen significados de palabras, palabras raíz, frases de ejemplo y técnicas de memorización. La herramienta organiza las palabras por orden alfabético, tiene un formato de salida claro, admite el almacenamiento de archivos JSON y es adecuada para estudiantes, profesores o autodidactas. El código del proyecto es abierto y DeepSeek genera automáticamente 80% o más, lo que refleja la innovadora aplicación de la IA en la educación. Ya sea para preparar el 4º curso o para mejorar el vocabulario, esta herramienta proporciona un cómodo apoyo al aprendizaje.

Lista de funciones

• Generación automática de materiales de estudio de vocabulario de 4º curso: Llama a la interfaz DeepSeek para generar significados de palabras, análisis de raíces, frases de ejemplo y consejos de memoria.
• Almacenamiento alfabéticoDividir palabras CET-4 en archivos JSON de la A a la Z según la primera letra, fácil de encontrar y gestionar.
• Generación de imágenes útiles: Generar imágenes mnemotécnicas relacionadas con palabras mediante guiones para mejorar la memorización.
• Generador de artículos: Genera artículos de aprendizaje de vocabulario en formato Markdown empezando por una letra, apto para blogs u organización de notas.
• Soporte de código abiertoCódigo Python: Se proporciona el código Python completo y los usuarios son libres de modificar o ampliar la funcionalidad.

Utilizar la ayuda

Proceso de instalación

"Vocabulary Book by DeepSeek" es una herramienta basada en Python que requiere un determinado entorno de programación para funcionar. A continuación se detallan los pasos de instalación y uso:

1. Preparación medioambiental

• Instalación de Python: Asegúrese de que Python 3.8 o superior está instalado en su sistema, que puede descargarse e instalarse desde el sitio web de Python.
• proyecto de clonaciónAbra un terminal o una línea de comandos e introduzca el siguiente comando para descargar el proyecto localmente:

  git clone https://github.com/vxiaozhi/vocabulary-book-by-deepseek.git
  cd vocabulary-book-by-deepseek

• Instalación de dependencias: El proyecto depende de varias librerías Python, ejecute el siguiente comando para instalarlas:

  pip install -r requirements.txt
  

  si norequirements.txtlas bibliotecas básicas pueden instalarse manualmente:

  pip install requests openai pillow
  

• Configuración de la API DeepSeekSe necesita la clave API de DeepSeek. Después de registrarse para obtener una cuenta DeepSeek, obtenga la clave en la plataforma DeepSeek e introdúzcala en la sección de llamada a la API en el archivo o código de configuración del proyecto.

2. Utilización de las funciones principales

El proyecto consta de dos scripts principales: la herramienta de ayuda para palabras y la herramienta de generación de imágenes de ayuda. A continuación se detalla el flujo de funcionamiento:

(1) Generar materiales de estudio de palabras

• Preparar datos de palabrasProyectos por defectodata/cet4/Archivos JSON ordenados por letras de la A a la Z en el directorio (p. ej.A.jsonyB.json). Cada archivo contiene una lista de palabras que empiezan por la letra correspondiente.
• Ejecución de scripts::
  • Abra un terminal y vaya al directorio del proyecto.
  • Ejecute el siguiente comando para generar un análisis de palabras:

    python cet4_word_helper.py
    

  • El script leerá eldata/cet4/Las palabras de la lista se utilizan para generar significados de palabras, raíces, frases de ejemplo y consejos para la memoria a través de la API DeepSeek, y los resultados se guardan en el archivoresult/cet4/JSON en el directorio (por ejemploA.json).
• Ver resultadosEjemplo de la estructura del archivo JSON generado:

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

(2) Generación de imágenes mnemotécnicas

• Ejecutar el script de generación de imágenes::
  • Ejecute el siguiente comando:

    python gen_words_img.py
    

  • El guión se basará en elresult/cet4/Los datos de palabras del script se utilizan para generar imágenes mnemónicas, que se guardan por defecto en el directorio especificado (es necesario configurar la ruta de salida en el script).
• Ajustes personalizadosModificacióngen_words_img.pyparámetros, como el tamaño, la resolución o el estilo de la imagen, para garantizar que se generen imágenes que cumplan los requisitos.

(3) Generar artículos de vocabulario

• Ejecute el script de generación de artículos::
  • Implantación:

    python gen_articles.py
    

  • Lectura del guiónresult/cet4/en el archivo JSON, generando 26 archivos Markdown (como el archivo2025-02-11-cet4-A.md), guardar enresult/cet4_articles/Catálogo.
• formato de salida: Cada archivo contiene análisis de palabras que empiezan por letras, adecuados para aprender o compartir. Ejemplo:

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

3. Consideraciones operativas

• Seguridad de las claves APINo codifique las claves API de DeepSeek directamente en los scripts, se recomienda utilizar variables de entorno para almacenarlas:

  export DEEPSEEK_API_KEY='你的密钥'
  

• conexión de redAsegúrese de que la red está libre cuando ejecute el script, ya que depende de la API DeepSeek.
• Comprobación de rutas de archivosSidata/cet4/tal vezresult/cet4/Falta el directorio, necesita crear manualmente o ajustar la configuración de la ruta del script.
• Funciones ampliadasEl código puede modificarse en función de las necesidades, por ejemplo para añadir soporte de palabras de nivel 6 o ajustar el formato de salida.

4. Funcionamiento de las funciones especiales

• archivo por lotesGenerar perfiles de palabras para todas las letras a la vez ejecutando el script principal una sola vez.
• Memoria asistida por imágenesLas imágenes de ayuda generadas pueden importarse a los apuntes electrónicos o imprimirse para complementar el aprendizaje basado en texto.
• Compartir artículosLos archivos Markdown pueden utilizarse directamente para publicar en blogs o importarse a herramientas como Notion para organizar notas de estudio.

Cuestiones de la Misión Cline

Tarea1

用 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

Tarea2

用 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. 假设所有依赖库已经安装。

Tarea3

用 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依赖库已经安装。