¿Qué hace Anki Exam Forge?
Convierte exámenes pasados dispersos, PDFs escaneados y diapositivas de clase en un sistema de estudio Anki .apkg en evolución, sin duplicados, construido alrededor de la recuperabilidad de la memoria y el ROI del examen.
Rutas de Ejecución Duales (MCP o CLI Independiente)
Usa la interfaz que esté disponible en tu entorno de agente:
-
MCP Tools (cuando se instala como plugin Antigravity o servidor MCP):
anki_doctor— verifica la preparación de Python, SQLite, OOXML (.pptx/.docx) y extracción de PDF.anki_extract_source— extrae texto, notas del orador, páginas PNG renderizadas (para PDFs escaneados) e imágenes incrustadas de.pdf,.pptx,.docx,.md/.txto carpetas de imágenes.anki_analyze_frequency— agrupa elementos de examen porconcept_keycanónico, cuenta las apariciones exactas de forma determinista, genera un informe de frecuencia en Markdown y produce undeck.jsonpriorizado.anki_validate_deck— verifica presencia de pregunta/respuesta, sintaxis de cloze{{c1::...}}, opciones MCQ>= 2,card_id/guidúnicos, y rutas de archivos multimedia.anki_build_apkg— compiladeck.jsonen un.apkgcon GUID determinista (ExamForge-Basic,ExamForge-MCQ,ExamForge-Cloze) ordenado por frecuencia de examen.anki_inspect_apkg— inspecciona un.apkgexistente (prefiriendocollection.anki21), extrae multimedia empaquetada y filtra notas por etiqueta (leech), mazo, consulta ominLapses.anki_diff_supplement— compara tarjetas candidatas de diapositivas/clase contra undeck.jsono.apkgexistente, manteniendo intactos todos los GUID originales y añadiendo solo tarjetas genuinamente nuevas.anki_apply_mnemonics— escribe mnemotecnias estructuradas de técnica de memoria en las tarjetas coincidentes mientras mantiene los GUID originales para actualizaciones de Anki sin pérdida de progreso.
-
CLI Independiente (cuando se instala via
--skill-onlyo se ejecuta sin MCP):- Python puro (funciona directamente desde la carpeta de la habilidad, cero requisitos pip para el flujo central
.apkg/.pptx/.docx):python <directorio-de-habilidad-o-plugin>/engine/cli.py <doctor|extract|freq|validate|build|inspect|diff|mnemonic> ... - Wrapper Node.js (cuando se ejecuta desde el repositorio del plugin):
node <directorio-del-plugin>/server/cli.mjs <doctor|extract|freq|validate|build|inspect|diff|mnemonic> ...
- Python puro (funciona directamente desde la carpeta de la habilidad, cero requisitos pip para el flujo central
Flujo de Trabajo en Ciclo Cerrado de 4 Fases
Fase 1: Ingestión de Exámenes Pasados y Análisis de Frecuencia
- Ejecuta
anki_doctor(ocli.py doctor) para confirmar la preparación de PDF/Python. - Extrae fuentes en ventanas manejables: llama a
anki_extract_sourceen PDFs de exámenes pasados (fromPage: 1, maxPages: 15..20, renderMode: "auto"). Para páginas escaneadas/con muchas imágenes, lee las imágenespages/page_XXX.pnggeneradas con tu capacidad de visión multimodal en lugar de depender únicamente del texto OCR escaso. Continúa connext_from_pagehasta cubrir todos los exámenes. - Normaliza cada pregunta de examen en elementos JSON estructurados que contengan:
concept_key: nombre de concepto canónico conciso para que preguntas redactadas de manera diferente que evalúan el mismo hecho subyacente se fusionen limpiamente (ej.,"桡神经损伤临床表现","胃食管反流病一线用药").card_type:"basic"|"mcq"|"cloze".front/stem/text,options(paramcq),back/answer,explanation,topic,source_years(ej.,["2021", "2023"]), ymedia(nombres de archivos de diagramas).
- Nunca cuentes frecuencias mentalmente: pasa el array/archivo de elementos extraídos a
anki_analyze_frequency(eligesubjectPreset:clinical-medicine,postgrad-exam,law-examogeneral) para generar el informe de frecuencia en Markdown determinista y eldeck.jsonpriorizado.
Fase 2: Creación de Tarjetas, Validación y Empaquetado .apkg
- Antes de finalizar las tarjetas, consulta:
- Guía de Diseño de Tarjetas — atomicidad, selección de cloze vs MCQ vs básica, e higiene de diagramas.
- Presets por Materia — convenciones de campos y jerarquías de etiquetas para medicina clínica, exámenes de posgrado/licencia, y STEM/humanidades.
- Valida antes de empaquetar: ejecuta
anki_validate_deck(pasamediaDirsi las tarjetas referencian figuras extraídas). Corrige cualquier error bloqueante (invalid_cloze,missing_media,duplicate_card_id, etc.) y considera dividir tarjetas verbosas señaladas por advertencias. - Construye el
.apkg: ejecutaanki_build_apkg(subdeckStrategy: "tier"coloca las tarjetas en01-高频必背,02-中频常考,03-真题常规,04-课件补充, ordenadas para que las tarjetas de exámenes pasados de mayor frecuencia aparezcan primero en la coladuede Anki).
Fase 3: Suplemento Incremental de Diapositivas / Apuntes de Clase (Potenciador de Puntuación)
Una vez que las tarjetas de alto rendimiento de exámenes pasados forman la línea base de aprobación, usa diapositivas de clase (.pptx, .docx, .pdf) para llenar los vacíos restantes del plan de estudios sin sobrescribir o duplicar tarjetas existentes:
- Extrae el mazo de diapositivas con
anki_extract_source(extractImages: trueextrae diagramas/tablas incrustados enmedia/). - Redacta tarjetas candidatas a partir de las nuevas diapositivas/apuntes.
- Ejecuta
anki_diff_supplementcontra eldeck.jsonexistente o el.apkgexportado:- Los duplicados exactos se saltan automáticamente.
- Los casi duplicados (
similarity >= nearThreshold) se muestran para revisión; pasamergeNear: truecuando los detalles de la diapositiva enriquecen una tarjeta de examen pasado existente. - Los conceptos nuevos se asignan a
source::ppt-supplementy se colocan en04-课件补充, mientras que cada tarjeta existente mantiene suguidoriginal exacto.
- Revalida y reconstruye
.apkg(anki_build_apkg). Reimportar en Anki actualiza las notas modificadas en su lugar sin perder el historial de repaso.
Fase 4: Reparación de Tarjetas Atascadas / Leech con Mnemotecnias
Cuando un usuario exporta su mazo activo de Anki (con información de programación, o marca "Support older Anki versions / 兼容旧版 Anki" al exportar .apkg) o apunta a elementos obstinados:
- Ejecuta
anki_inspect_apkgcontagFilter: "leech"y/ominLapses: 3(oquerypara palabras clave específicas) para aislar las tarjetas que siguen fallando en la recuperación. - Aplica el Libro de Jugadas de Mnemotecnias para crear ganchos de memoria cortos y vívidos (
acronym,rhyme,homophone,mechanism,contrast,visual,loci) dirigidos específicamente al por qué el usuario confunde esa tarjeta. - Escribe los ganchos en el campo
Mnemonica través deanki_apply_mnemonics(updateOnly: trueemite un.apkgde actualización quirúrgica liviana que contiene solo las tarjetas parcheadas con sus GUID originales exactos). - Recuerda al usuario: las mnemotecnias resuelven la codificación inicial para elementos obstinados; la repetición espaciada de Anki mantiene la recuperabilidad a largo plazo — continúa repasando la tarjeta actualizada normalmente.