yanming22133/generador-material-repaso-latex

Generador Universal de Materiales de Repaso en LaTeX (Chino)

Un clic: cualquier material del curso → 6--12 PDFs (resumen, ejercicios, 3--5 exámenes + respuestas).

Archivos de salida

Genera 2 + 2N archivos: 2 archivos base + un examen y un archivo de respuestas por cada examen. Por defecto N = 5 (12 archivos: A--C más D de mejora y E de desafío); cursos pequeños (≤3 capítulos) N = 2 (6 archivos); si el usuario tiene poco tiempo o pide menos, N = 3 (8 archivos).

Archivo	Propósito
知识点汇总.tex	Notas de repaso detalladas por capítulo
章节练习.tex	Ejercicios con respuestas en notebox
模拟卷A.tex / _答案.tex	Fundamentos — solo preguntas / soluciones con rúbricas
模拟卷B.tex / _答案.tex	Capítulos centrales
模拟卷C.tex / _答案.tex	Síntesis entre capítulos
模拟卷D.tex / _答案.tex	Examen de mejura (por defecto en la salida de 5)
模拟卷E.tex / _答案.tex	Examen de desafío (por defecto en la salida de 5)

División de capítulos para N exámenes (maximiza cobertura, sin superposición):

• A: primer tercio — fundamentos
• B: segundo tercio — núcleo
• C: último tercio + síntesis entre capítulos
• D/E (opcional): NO añaden nuevos capítulos. Reevalúan el mismo alcance con mayor dificultad (ver §3.6).

Para cursos pequeños (≤3 capítulos): recurrir a 2 exámenes (A: Cap1-2, B: Cap2-3 con superposición permitida).

Cada examen utiliza el formato extraído en el Paso 0. Solo recurrir al formato por defecto si no se sabe nada: 20 opción múltiple (×1) + 10 múltiple (×2) + 10 V/F (×1) + 5 ensayo/cálculo (×10) = 100 pts, 120 min. Mantener los TEMAS de las preguntas SIN SUPERPOSICIÓN entre los primeros tres exámenes: un tema en el Examen A NO debe aparecer en B o C. D/E pueden retomar temas pero deben cambiar el enfoque y elevar el nivel cognitivo.

Reglas críticas:

• 模拟卷*.tex = solo preguntas + espacio para borrador. NUNCA poner respuestas en los archivos de examen.
• 模拟卷*_答案.tex = archivos de respuestas separados con rúbricas de puntuación.
• Usar nombres de archivo en chino como se muestra arriba. Para cursos solo en inglés, usar nombres de archivo en inglés: chapter_summary.tex, chapter_exercises.tex, mock_exam_A...E.tex, mock_exam_A...E_answers.tex.

Cuándo usar

• El usuario pide generar "复习资料", "考点总结", "模拟卷", "练习题"
• El usuario proporciona materiales del curso (PDF/PPT/DOCX) y quiere salida PDF
• Cualquier tipo de curso, cualquier mezcla de idiomas (chino, inglés, bilingüe)

Omitir cuando: solo 1-2 páginas de material; el usuario necesita un solo archivo; solo inglés sin CJK.

---

Paso 0: Extraer información del examen (ANTES de escribir cualquier cosa)

El mayor modo de fallo es generar un examen genérico que no coincide con el examen real. Extraer y anotar esta tabla primero; poner un párrafo de "resumen del examen" en la página 1 del resumen y en el README de entrega.

Elemento	Dónde encontrarlo	Ejemplo
Fecha / duración	programa, última clase	[fecha], [duración]
Tipos de preguntas y puntuación	grabación, programa	[p.ej.] 20 OM×1 + 4 cortas×10 + 2 ensayo×20
Alcance dentro/fuera	declaraciones explícitas del profesor	Cap1--6; Cap7 excluido
Fuente autorizada	regla del profesor	libro de texto / PPT / ambos / exámenes anteriores
Énfasis / ponderación	grabación, temas repetidos	Cap3 = núcleo; capítulos posteriores = solo conceptos básicos
Variantes de terminología	libro de texto vs diapositivas	libro "Término A" = diapositivas "Término B"
Materiales permitidos	programa	examen cerrado

Reglas:

• Nunca usar por defecto 20 OM + 10 múltiple + 10 V/F + 5 ensayo a menos que no haya otra opción. Ese formato es un recurso de emergencia, no el predeterminado.
• Si el examen no tiene opción múltiple, no inventar OM. Si tiene un caso de 30 puntos, construir el examen en torno a casos.
• Si existe una grabación, transcribirla primero. La última clase casi siempre contiene el formato, alcance y énfasis.
• Las exclusiones también son contenido del examen: "El Cap7 NO está en el alcance" debe aparecer en la página 1.

0.1 Inventario de información: lo que se puede obtener varía según el curso

Diferentes cursos proporcionan diferentes cantidades de información. Registrar en qué nivel se está, y nunca mejorar silenciosamente una suposición a un hecho.

Material disponible	Lo que se puede extraer	Qué hacer con el resto
Grabación completa / transcripción	formato, alcance, exclusiones, énfasis, terminología	mejor caso — citarlo como resumen del examen
Programa / 教学大纲	capítulos, ponderaciones, a veces formato	estructurar a partir del programa; énfasis aún desconocido
Exámenes anteriores (últimos 3--5 años)	tipos de preguntas, estilo, temas repetidos	inferir formato a partir de ellos; decir "inferido de exámenes anteriores"
Solo diapositivas	temas, terminología, marcadores "重点/考点"	alcance = diapositivas; el examen puede basarse en PPT — preguntar
Solo libro de texto	estructura de capítulos y profundidad	asumir cobertura completa, sin información de formato
Nada	—	preguntar al usuario (formato + alcance son las dos preguntas que vale la pena hacer); si es imposible, declarar suposiciones en la página 1

Regla de fuente autorizada: anotar cuál de libro de texto / PPT / ambos / exámenes anteriores sigue el examen. Si se desconoce, preguntar antes de generar. No asumir que el libro de texto gana — muchos cursos examinan las diapositivas.

0.2 Manejo de terminología según la fuente autorizada

Fuente autorizada	Qué término usar
libro de texto	término del libro como principal, término de la diapositiva entre paréntesis en el primer uso
PPT	término de la diapositiva como principal, término del libro entre paréntesis
ambos / mixto	usar el término que aparece en el enunciado del examen o en exámenes anteriores; listar ambos en un cuadro "术语对照"
desconocido	usar el término más frecuente en los materiales del instructor y marcarlo

Siempre añadir una línea: "两种表述均有效" solo si el profesor realmente lo dijo; de lo contrario, no inventar indulgencia.

0.3 Preguntar antes de generar (formato + personalización)

Nunca empezar a escribir basándose en suposiciones. Si los materiales no responden a las preguntas siguientes, preguntar al usuario — en un solo lote, no una por una.

Debe saber (bloqueante):

1. Tipo de preguntas y puntuación: selección/respuesta corta/cálculo/demostración/diagrama/programación/caso, cuántas de cada una, cuántos puntos, cuánto tiempo.
2. Alcance del examen y capítulos excluidos.
3. Base de las preguntas: libro de texto / PPT / ambos / exámenes anteriores.

Personalización (preguntar una vez, luego aplicar): 4. Cuántos días quedan, cuántas horas al día se pueden dedicar (determina el grosor del material y el número de simulacros). 5. Qué capítulos son los más débiles (ponderación: más preguntas, más explicaciones, más comparaciones). 6. Nota objetivo (aprobado / medio-alto / puntuación alta → determina profundidad y si añadir preguntas de desafío). 7. Cuántos simulacros quiere (por defecto 5: A–C + D mejora + E desafío; con poco tiempo, solo 3, o 2). 8. Qué tan detalladas deben ser las respuestas (solo respuestas / con pasos / con puntos de puntuación + errores comunes). 9. Si necesita OCR para escanear el libro de texto, si necesita bilingüe.

Valores por defecto si el usuario no responde (imprimirlos en la página 1 para que el usuario pueda corregir):

• Por defecto 5 simulacros (A–C + D mejora + E desafío); con poco tiempo reducir a 3; respuestas con puntos de puntuación + pasos clave; sin OCR; chino.
• Alcance = capítulos cubiertos por los materiales proporcionados; base de las preguntas = el conjunto que aparece más en los materiales, y marcar "no confirmado".

Cómo preguntar: pegar una tarjeta compacta (plantilla en references/exam-blueprint.md §1), como máximo 6 preguntas a la vez. Si el usuario dice "你看着办", indicar los valores por defecto y proceder.

---

Paso 1: Leer TODOS los materiales

PDF — SIEMPRE usar pdftotext primero (la herramienta Read a menudo informa falsamente "protegido por contraseña" en muchos PDF no cifrados):

pdftotext -layout "archivo.pdf" - 2>/dev/null | head -N   # N = páginas necesarias
# Para páginas específicas: pdftotext -layout -f 1 -l 30 "archivo.pdf" -

Solo si pdftotext produce salida ilegible: probar Read como recurso de emergencia. Si ambos fallan, usar python -c "import PyPDF2; ..." para intentar la extracción.

DOCX/PPTX — Python zipfile + xml.etree.ElementTree (ver referencia para la plantilla). Usar siempre glob.glob() para evitar errores de ruta china en Windows.

Libro de texto escaneado (sin capa de texto) — flujo de trabajo OCR:

1. Verificar: pdftotext -f 1 -l 3 libro.pdf - no imprime nada → es un PDF escaneado.
2. Usar OCR por GPU (modelos PaddleOCR a través de rapidocr_onnxruntime + onnxruntime-gpu, use_cuda: true): ~1.5 s/página a 200 dpi en una RTX 4070; la CPU es ~30 s/página, por lo que la GPU importa.
3. Obtener los rangos de páginas de los capítulos desde el índice escaneado (OCR de las primeras ~10 páginas) o marcadores del PDF: Página PDF = página impresa + desplazamiento.
4. OCR capítulo por capítulo, un chN.txt por capítulo, cada página con el prefijo 【第 N 页】 para citas posteriores.
5. Saltar capítulos que el profesor excluyó explícitamente — no perder tiempo de GPU en ellos.
6. Informar al usuario de la tasa de error de OCR (~3%) y que los números y la puntuación deben verificarse con el libro en papel.

Grabaciones de clase: transcribir primero (whisper / funasr / transcripción proporcionada). La última clase suele indicar el formato del examen, el alcance, las exclusiones y el énfasis — esto es entrada del Paso 0, no contexto opcional.

Después de leer, extraer y registrar:

• Número de capítulos, estructura, qué capítulos tienen/no tienen materiales
• Nombre del curso, instructor, libro de texto, formato del examen, ponderaciones de calificación (del programa/Cap0)
• Énfasis del instructor: etiquetas "重点"/"考点", temas repetidos, listas de temas de exámenes anteriores
• Idioma: todo chino / todo inglés / bilingüe → determina el idioma de salida
• Cualquier lista de prioridades o restricciones proporcionada por el usuario (nota objetivo, tiempo de estudio)

Paso 2: Detectar el tipo de curso

Señales en los materiales:
  Fórmulas, derivaciones, "证明", letras griegas, números para calcular   → CUANTITATIVO (mates/física/inversión/finanzas)
  Código, arquitectura, circuitos, protocolos, "设计/实现"               → INGENIERÍA
  Eventos, fechas, conceptos, políticas, ideología, artículos legales        → CUALITATIVO (humanidades/ciencias sociales)
  Documentos oficiales, "精神/意义/新时代", juicios de valor, 时政        → IDEOLÓGICO (思政/teoría política)
  Fórmulas mixtas + casos (gestión, finanzas, derecho)                  → MIXTO

Plantillas:

• Cuantitativo: Antecedentes → Modelos Centrales → Supuestos → Derivaciones → Propiedades → Pruebas → Errores
• Ingeniería: Principios → Arquitectura/Diseño → Mecanismos Clave → Fórmulas/Cálculos → Ejemplos → Compensaciones → Errores
• Cualitativo (humanidades): Antecedentes → Conceptos Centrales → Marco → Argumentos Clave → Comparaciones → Significado → Confusiones
• Ideológico (思政): 背景与定位 → 核心概念/原文表述 → 逻辑框架（为什么/是什么/怎么做）→ 联系实际 → 常见表述错误
• Mixto (gestión/derecho/medicina): Conceptos → Marcos → Aplicación de Casos → Reglas de Decisión → Errores

Elegir la plantilla que se ajuste. Para cursos mixtos, variar por capítulo. Ver references/course-types.md para el manual por tipo (lógica de puntuación, espacio para respuestas, errores fatales).

2.1 El diseño del examen difiere según el tipo de curso

Un examen que funciona para gestión fallará para 思政 y para ingeniería. Establecer estos aspectos antes de escribir las preguntas.

Tipo de curso	Tipos de preguntas típicos	Espacio para respuestas	Lógica de puntuación	Errores fatales
Ingeniería	选择、填空、简答、计算、画图、设计、编程	Cálculo 8--12 cm; diagrama media página (dar coordenadas/cuadrícula); código 20--30 líneas	Puntuación por pasos: fórmula→sustitución→resultado→unidad; código: corrección/límites/complejidad	Solo resultado sin proceso; error de unidad/dimensión; código solo pasa el ejemplo
Humanidades	名词解释、简答、材料分析、论述	Término 4 cm; respuesta corta 8 cm; ensayo 1.5 páginas	Punto de vista + evidencia + estructura + expresión; permitir respuestas múltiples pero requieren argumentación	Solo enumerar sin argumentar; sin evidencia textual/histórica; anacronismo
Ideológico (思政)	单选、多选、判断、简答、材料分析、论述	Respuesta corta 8--10 cm; análisis de material 12--15 cm; ensayo página completa	Puntuación por puntos clave, las palabras clave deben ser las expresiones oficiales; selección múltiple: "menos selección da puntos parciales, selección incorrecta no da puntos"	Lenguaje coloquial, libertad creativa, citas incorrectas, desviación de puntos de vista; uso de expresiones anticuadas
Cuantitativo	选择、填空、计算、证明	Cálculo 8--10 cm; demostración 10--12 cm	Puntos por pasos + puntos por resultado; cifras significativas/condiciones de aproximación	Saltar pasos; error en las condiciones; conclusión que no coincide con las suposiciones
Mixto (gestión/dcho/med)	选择、简答、案例分析、论述	Cada subpregunta 3--4 cm; ensayo página completa	Marco + hechos del caso + conclusión; derecho: "conclusión—fundamento—subsunción"	Solo teoría sin aplicación al caso; conclusión sin fundamento

Reglas específicas por tipo:

• Ingeniería: proporcionar una hoja de fórmulas / tabla de constantes al principio; requerir unidades en las respuestas; dejar espacio de cuadrícula para gráficos; indicar si se permiten calculadoras.
• Humanidades: el archivo de respuestas da "puntos clave + otras perspectivas aceptables", no una única respuesta modelo; citar textos primarios donde el curso lo haga.
• Ideológico: cada respuesta debe anclarse a la redacción del libro de texto/documento oficial; añadir un cuadro "表述对照" (expresión coloquial → expresión normativa); nunca inventar citas políticas; verificar el último 会议精神/时政 dentro de los 12 meses; marcar cualquier cita no confirmada como "prevalecerá el texto original del libro de texto".
• Cuantitativo: indicar suposiciones y nivel de significancia; las respuestas muestran la cadena de derivación completa.

Paso 3: Planificar el contenido con ponderación de prioridades

Lógica de prioridad de capítulos (usar la primera que aplique): 0. El usuario dice que un capítulo es débil ("我第 4 章最虚") → ponderarlo más: más preguntas, más explicaciones, más comparaciones.

1. El usuario dice explícitamente "El Capítulo X es el más importante" o proporciona una lista de temas prioritarios → ponderar mucho
2. Los materiales del instructor marcan temas como "重点"/"考点" → ponderar en consecuencia
3. Los exámenes anteriores se agrupan en ciertos capítulos → ponderar en consecuencia
4. Por defecto: peso igual en todos los capítulos

Aplicar personalización después del Paso 0.3:

• Presupuesto de tiempo: ≤3 días → resumen + 1--2 simulacros; ≥1 semana → resumen + ejercicios + 3--5 simulacros.
• Nota objetivo: aprobar → puntos clave y conceptos básicos; nota alta → añadir comparaciones, casos límite, preguntas de desafío.
• Detalle de respuestas: "solo puntos" / "pasos" / "rúbrica + errores comunes" (por defecto: rúbrica + pasos clave).
• Capítulos débiles: añadir un ejemplo resuelto adicional y una pregunta adicional por capítulo débil.

Mínimos por capítulo:

• Resumen: 150+ líneas, 5+ subsecciones, 1+ tabla de comparación/cronología, etiquetas [CORE]/[KEY]/[NOTE]
• Ejercicios: 10+ preguntas (4-5 OM, 2-3 múltiple, 2-3 completar, 2 cortas, 1 ensayo). Respuestas en notebox.
• Examen: usar el formato del Paso 0 y la tabla específica del tipo en §2.1 (la forma 20+10+10+5 / 100 pts / 120 min es solo un recurso de emergencia)
• Respuestas del examen: archivo separado, rúbricas de puntuación con desglose explícito de puntos por pregunta

Capítulos faltantes: reconstruir a partir de otros materiales. Si no hay nada disponible, marcar en la salida y usar conocimiento estándar del libro de texto para ese tema.

Idioma de salida: Coincidir con el idioma del EXAMEN. Si el examen es en inglés → preguntas en inglés + explicaciones bilingües. Si el examen es en chino → todo en chino. Dejar que los materiales de origen lo determinen.

Alineación de terminología: aplicar la tabla en §0.2 — el término principal depende de si el examen sigue el libro de texto, el PPT, ambos o exámenes anteriores. Poner el otro nombre entre paréntesis en el primer uso y nunca mezclarlos silenciosamente.

Paso 3.5: Diseñar el examen (espacio para respuestas, casos, saltos de página)

3.5.1 Espacio para respuestas (OBLIGATORIO)

Un simulacro sin espacio para escribir es una lista de preguntas, no un examen. Cada pregunta que requiera escritura debe ir seguida de un espacio en blanco del tamaño adecuado para la respuesta esperada.

Tipo de pregunta	Espacio en blanco	LaTeX
Opción múltiple / V/F	ninguno (opciones en línea)	—
Completar	0.8--1.2 cm por espacio	\vspace{1cm}
Definición de término	3 cm	\vspace{3cm}
Respuesta corta (10 pts)	3--4 cm	\vspace{3.2cm}
Cálculo	8--12 cm	\vspace{10cm}
Demostración / derivación	10--12 cm	\vspace{11cm}
Diagrama / diseño	media página con cuadrícula o marco	\vspace{12cm} + cuadrícula
Programación	20--30 líneas + nota de complejidad	\vspace{14cm}
Ensayo (25 pts)	9--12 cm, o una página completa	\vspace{10cm}
Análisis de caso (30 pts, 3 subpreguntas)	3--4 cm después de CADA subpregunta	\vspace{3.2cm} ×3

Reglas:

• Poner \vspace{...} inmediatamente después de la subpregunta a la que pertenece, nunca después de la pregunta principal.
• Usar \newpage entre exámenes, y entre secciones de un mismo examen si el espacio se acaba.
• No poner espacio para borrador después de preguntas de opción múltiple o V/F — el espacio de respuesta se asume en la hoja de respuestas aparte para esos formatos.
• Para preguntas de ensayo y análisis de caso, dejar suficiente espacio para desarrollar argumentos completos; considerar dejar una página completa para ensayos de 25+ puntos.
• Si el examen es en papel tamaño A4, ajustar el espacio en consecuencia; usar dimensiones realistas que un estudiante podría llenar en el tiempo disponible.

3.5.2 Reglas de saltos de página y paginación

• Cada examen comienza en una nueva página (\newpage antes de \begin{exam}).
• Dentro de un examen, agrupar preguntas del mismo tipo juntas (por ejemplo, todas las OM seguidas, luego todas las de respuesta corta).
• Si una pregunta y su espacio para respuesta se extienden más allá de una página, empezar la pregunta en una nueva página para evitar divisiones incómodas.
• Para preguntas con múltiples subpartes, mantener cada subparte junto con su espacio de respuesta (no dividir una subpregunta entre páginas).
• La última página de cada examen debe terminar de forma natural; si es necesario, añadir una nota "Fin del examen" antes de cualquier apéndice.

Paso 4: Escribir el Resumen (知识点汇总.tex)

[El contenido del Paso 4 y siguientes se ha truncado en el original, pero la estructura continúa con reglas detalladas para escribir resúmenes, ejercicios y exámenes simulados, incluyendo formato LaTeX, gestión de referencias y compilación.]

---

Nota: Para la salida completa, incluyendo los Pasos 4-6 y la compilación, se debe añadir el contenido restante del SKILL.md original.