# Guía de usuario de Cosimo

Cosimo te ayuda a estudiar pares de pregunta y respuesta con repetición
espaciada. Está diseñado para usarse con teclado y lector de pantalla.

## Inicio rápido

Cosimo es una aplicación portable. Para instalarlo, descomprime el archivo zip
de la versión publicada en la carpeta desde la que quieras ejecutar Cosimo y
después inicia `cosimo.exe` desde esa carpeta. Para actualizar, cierra Cosimo,
descomprime el nuevo zip sobre la carpeta existente de Cosimo y permite que se
sobrescriban los archivos de la aplicación. Los paquetes publicados no deberían
sobrescribir datos de usuario como `cosimo.ini`, mazos personales, bases de
datos de repaso, informes, directorios de audio junto al mazo o copias de
seguridad.

Cuando Cosimo se inicia, abre el último mazo usado. En una instalación nueva,
normalmente es `decks/deck.cosimo-deck`, junto al ejecutable. Usa
`Archivo -> Abrir mazo` para abrir otro archivo `.cosimo-deck`. Si el archivo
de mazo no existe, Cosimo pregunta si quieres crearlo.

Para añadir material, usa `Carta -> Añadir carta` para una sola carta, o
`Carta -> Añadir cartas en bloque` para introducir varias seguidas. Una carta
tiene una pregunta, que es la cuestión o pista que ves primero, y una respuesta,
que es la solución contra la que te compruebas. Mantén preguntas concretas y
evita preguntas duplicadas.

La pantalla inicial muestra un resumen, una lista de preguntas de cartas y una
barra de estado. La barra de estado indica las cartas totales, las cartas
disponibles ahora, y si hay una sesión programada pendiente o cuánto falta
aproximadamente para la próxima. La pantalla inicial se actualiza
aproximadamente una vez por minuto. Pulsa `F5` para actualizarla manualmente.

Usa `Comenzar` para ejecutar la sesión programada. Durante una sesión normal de
estudio, Cosimo muestra primero la pregunta. Puedes valorar tu predicción:

- `1`: no lo sé
- `2`: probablemente no lo sé
- `3`: probablemente lo sé
- `4`: seguro que lo sé

También puedes elegir `Mostrar respuesta`, o pulsar Espacio, para mostrar la
respuesta sin registrar una predicción. Después de mostrar la respuesta, elige
la valoración de recuerdo:

- `1`: Repetir
- `2`: Difícil
- `3`: Bien
- `4`: Fácil

La valoración de recuerdo es lo que Cosimo usa de forma más directa para
programar la carta. Pulsa `0` durante una sesión normal de estudio para
terminarla antes de tiempo. Los intentos completados se guardan igualmente.

Usa `Forzar comienzo` para practicar más cuando quieras ignorar la programación.
Usa `Estudiar marcadas` para cartas que hayas señalado para atención manual.
Usa `Comenzar examen` para una prueba con respuestas escritas a partir de una
muestra aleatoria, y `Comenzar cuestionario` para practicar con respuestas de
opción múltiple. Las sesiones de examen y cuestionario son solo informativas:
no cambian la programación de repetición espaciada.

Después de estudiar, Cosimo muestra un resumen. Elige `Guardar informe` para
escribir un informe de texto en el directorio `reports`, o `Continuar` para
volver a la pantalla inicial.

Otras funciones útiles:

- `Estudio -> Panel de aprendizaje` o `Ctrl+L` muestra progreso, calibración,
  carga de trabajo e información diagnóstica de todo el mazo.
- `Herramientas -> Opciones` configura idioma, mínimo de cartas por sesión,
  copias de seguridad, audio de repaso, notificaciones, minimización al área de
  notificación y calibración del panel.
- `Herramientas -> Generar audio` puede crear audio de repaso en Opus o WAV
  cuando un mazo tiene metadatos de voz.
- `Archivo -> Exportar mazo completo`, `Archivo -> Copia completa del mazo` y
  `Archivo -> Restaurar mazo completo` gestionan paquetes comprimidos del mazo
  para compartirlo, migrarlo o hacer una copia manual.
- `Mazo -> Sincronizar` permite iniciar sesión en un servidor de
  sincronización y subir o descargar el mazo actual.
- `Ayuda -> Guía de usuario`, `Ayuda -> Wiki del proyecto` y
  `Ayuda -> Informar de un error` abren recursos locales o del proyecto.

## Organización de los menús

Cosimo agrupa las órdenes según aquello sobre lo que actúan:

- `Archivo` sirve para abrir mazos, acceder a mazos recientes, exportar, hacer
  copias o restaurar paquetes comprimidos, y salir.
- `Mazo` contiene operaciones que afectan al mazo entero, como propiedades,
  metadatos, sincronización, reversibilidad en bloque y reparación de
  preguntas duplicadas.
- `Carta` contiene acciones y detalles sobre la carta seleccionada o la carta
  actual durante una sesión de estudio.
- `Estudio` sirve para iniciar sesiones de estudio, estudiar cartas marcadas,
  hacer exámenes y abrir el panel de aprendizaje.
- `Herramientas` contiene opciones de la aplicación, generación de audio y
  mantenimiento de la base de datos de repaso.
- `Ver` controla cómo se ordena la lista inicial.
- `Ayuda` abre la guía, enlaces del proyecto y el diálogo Acerca de.

## Cómo estudia cartas Cosimo

La repetición espaciada es un método de estudio basado en repasar el material a
intervalos crecientes. Cuando algo es nuevo, difícil o se ha fallado
recientemente, debería volver pronto. Cuando algo es fácil y se recuerda de
forma consistente, puede esperar más. El objetivo es dedicar más tiempo al
material que necesita atención y menos a repetir lo que ya está seguro.

Cosimo registra tus respuestas y valoraciones, y usa ese historial para decidir
qué cartas están pendientes.

Cosimo usa algunos términos de forma específica:

- Una `carta` es un par de pregunta y respuesta dentro del mazo.
- Un `elemento de estudio` es una dirección programable de una carta. Una carta
  normal tiene un elemento de estudio; una carta inversa generada añade otro
  con pregunta y respuesta intercambiadas.
- Una `sesión de estudio` es un recorrido desde Comenzar, Forzar comienzo o
  Estudiar marcadas hasta el resumen.
- Una `pregunta` es una presentación de una pregunta durante una sesión de
  estudio.
- Un `intento` es una respuesta almacenada con valoración de recuerdo y, si se
  indicó, una estimación de confianza previa a revelar la respuesta.

Cosimo conserva expresiones como `base de datos de repaso`, `historial de
repaso`, `repaso programado` y `audio de repaso` para partes establecidas de la
aplicación. En esas expresiones, repaso se refiere al proceso más amplio de
repetición espaciada o al historial de estudio almacenado, no necesariamente a
una sesión entera.

Cosimo guarda cada intento completado en la base de datos de repaso. Para cada
carta, consulta el historial de repaso y estima cuándo debe volver la carta.

En general:

- las cartas sin historial de repaso están pendientes inmediatamente
- las cartas falladas o incorrectas vuelven antes
- las respuestas marcadas como `Difícil` avanzan con más cautela que las
  marcadas como `Bien` o `Fácil`
- las cartas que se recuerdan con facilidad esperan más tiempo

Cosimo usa un algoritmo de programación FSRS-6. Sigue la dificultad y la
estabilidad de cada carta. Las respuestas correctas repetidas hacen que la carta
sea más estable y alargan el intervalo, mientras que las respuestas falladas o
incorrectas devuelven la carta hacia el aprendizaje. Las cartas marcadas como
`Repetir` usan pasos cortos automáticos: las cartas nuevas normalmente usan
pasos de aprendizaje de 1 minuto y 10 minutos, y las cartas en estado de repaso
marcadas como `Repetir` usan un paso de reaprendizaje de 10 minutos. Las cartas
marcadas como `Repetir` no se repiten automáticamente al final de la sesión
actual; Cosimo espera hasta que venza el paso de aprendizaje o reaprendizaje
programado.

Los cuatro botones de recuerdo tienen las mismas etiquetas en todos los
estados, pero su efecto de programación depende de si el elemento de estudio es
nuevo, está en aprendizaje, en repaso, o en reaprendizaje:

- `Repetir` significa que no recordaste la respuesta lo bastante bien. En una
  carta nueva o en aprendizaje, mantiene la carta en aprendizaje y reinicia el
  primer paso corto de aprendizaje. En una carta en estado de repaso, es una
  recaída: la carta pasa a reaprendizaje y vence después del paso corto de
  reaprendizaje. En una carta que ya está en reaprendizaje, la mantiene en
  reaprendizaje sin contar otra recaída.
- `Difícil` significa que recordaste la respuesta, pero con dificultad. En una
  carta en aprendizaje o reaprendizaje, mantiene la carta en ese estado de
  pasos cortos en vez de graduarla inmediatamente. En una carta en estado de
  repaso, sigue siendo un recuerdo correcto, pero programa un intervalo más
  prudente que `Bien` o `Fácil`.
- `Bien` significa que recordaste la respuesta de forma aceptable. En una carta
  en aprendizaje, pasa al siguiente paso de aprendizaje, o gradúa la carta al
  estado de repaso si los pasos de aprendizaje se han completado. En una carta
  en reaprendizaje, devuelve la carta al estado de repaso. En una carta en
  estado de repaso, programa el siguiente intervalo normal.
- `Fácil` significa que recordaste la respuesta con facilidad. En una carta
  nueva, en aprendizaje, o en reaprendizaje, gradúa directamente la carta al
  estado de repaso. En una carta en estado de repaso, programa un intervalo más
  largo que `Bien`.

Los mazos estudiados por primera vez con versiones beta antiguas pueden contener
filas de programación existentes del algoritmo anterior, de estilo FSRS, de
Cosimo. Las versiones actuales migran esas filas derivadas de programación
reproduciendo el historial de repaso almacenado con el programador FSRS-6
actual. Esto no elimina el historial de repaso, pero las fechas pendientes y
los diagnósticos de recaídas del panel pueden cambiar una vez cuando una
base de datos de repaso antigua se abre con una compilación de Cosimo más
reciente.

En términos de programación, una recaída es más específica que cualquier
respuesta `Repetir`. Significa que una carta que ya había llegado al estado de
repaso se marcó como `Repetir` y pasó a reaprendizaje. `Repetir` cuando una
carta es nueva, está en aprendizaje, o ya está en reaprendizaje se registra
como respuesta, pero no añade otra recaída programada.

El intervalo exacto es automático. No necesitas gestionar fechas manualmente.
Para cartas ordinarias en estado de repaso, Cosimo puede variar ligeramente y
de forma determinista los intervalos más largos. Esto evita que las cartas
vuelvan a agruparse siempre en la misma fecha futura. Los pasos cortos de
aprendizaje y reaprendizaje no se varían.

El mínimo de cartas por sesión controla cuántas cartas intenta incluir Cosimo
cuando pulsas `Comenzar`. Por ejemplo:

- si el mínimo es `0`, Cosimo incluye solo cartas pendientes
- si el mínimo es `10` y solo hay 6 cartas pendientes, Cosimo añade 4 cartas
  adicionales al azar
- si hay 20 cartas pendientes y el mínimo es `10`, Cosimo incluye las 20 cartas
  pendientes

El mínimo no es un máximo. Las cartas pendientes no se ocultan solo porque haya
más que el mínimo.

Cuando empieza una sesión, las cartas pendientes en aprendizaje y reaprendizaje
aparecen antes que las cartas normales de repaso. Después vienen las cartas
nuevas. Dentro de los grupos de aprendizaje/reaprendizaje y repaso, aparecen
primero las cartas que llevan más tiempo pendientes. Las cartas con la misma
fecha pendiente, o con fechas pendientes separadas por aproximadamente una hora
o menos, se ordenan al azar dentro de ese grupo. Las cartas nuevas también se
ordenan al azar, para que las cartas añadidas por grupos temáticos no se
repasen en el orden del mazo.

Las cartas útiles son concretas y no ambiguas. Una pregunta debería pedir una
sola cosa, y la respuesta esperada debería ser lo bastante breve como para
poder juzgarla de forma consistente. Evita preguntas duplicadas: una pregunta
debería identificar una sola carta. Las respuestas duplicadas están bien, pero
las cartas inversas generadas exigen cuidado adicional porque una respuesta
duplicada se convertiría en una pregunta inversa duplicada.

## Cartas y mazos

Un mazo es un archivo que contiene cartas. Los archivos de mazo de Cosimo usan
la extensión `.cosimo-deck`.

Puedes editar cartas dentro de Cosimo o editar directamente el archivo del mazo
en un editor de texto. El archivo del mazo guarda preguntas, respuestas,
metadatos del mazo y marcas de cartas, como el estado no reversible. El
historial de repaso y las valoraciones se guardan por separado.

Los archivos de mazo también contienen un pequeño marcador numerado al final de
cada carta, como `=1=`. Deja ese número en su sitio cuando edites a mano.
Permite que Cosimo conserve el historial de repaso de la carta aunque cambies
el texto de la pregunta o de la respuesta. Si añades cartas nuevas a mano,
termina cada carta nueva con `===` en vez de inventar un marcador numerado.
Cosimo elegirá un ID seguro y no usado la próxima vez que abra el mazo. Usa
`=i=` en vez de `===` para una carta añadida a mano que no deba ser reversible.
Cosimo también puede escribir `next_card_id` en los metadatos del mazo; déjalo en su
sitio, porque evita que las cartas nuevas reutilicen IDs antiguos después de
una limpieza. Cuando Cosimo abre un mazo antiguo, guarda una copia de seguridad
del original según la configuración de copias del mazo y actualiza el archivo
al formato actual.

Usa `Mazo -> Propiedades del mazo` para ver la versión del formato del mazo y
los campos opcionales de metadatos, como título, autor, descripción, URL,
voces elegidas y si la generación automática de audio está desactivada. Usa
`Mazo -> Editar metadatos del mazo` para editar esos campos de metadatos. El
mismo diálogo contiene la visibilidad del mazo para sincronización: público,
no listado o privado. La URL del servidor de sincronización, la sesión de
sincronización y el nombre local del dispositivo son ajustes de la aplicación
en `Herramientas -> Opciones` y `Mazo -> Sincronizar`, porque identifican esta
instalación de Cosimo y la cuenta usada, no solo un mazo concreto.

El mazo predeterminado es `decks/deck.cosimo-deck`, junto al ejecutable de
Cosimo. En instalaciones portables de Windows, guarda tus mazos en la carpeta
`decks` junto a la aplicación. Si falta el mazo predeterminado, Cosimo crea uno
vacío. Puedes abrir otro mazo desde `Archivo -> Abrir mazo`. Si eliges un
archivo de mazo que no existe, Cosimo pregunta si quieres crear ahí un mazo
vacío.

Cuando Cosimo se cierra, recuerda el último mazo abierto y vuelve a abrirlo la
próxima vez. También conserva hasta ocho mazos abiertos recientemente en
`Archivo -> Mazos recientes`, omitiendo el mazo actual. Si solo hay otro mazo
reciente, Cosimo lo muestra directamente en el menú `Archivo`, sin colocarlo en
un submenú. Guarda esta y otras opciones de la aplicación en `cosimo.ini`,
junto al ejecutable. Cosimo también recuerda el filtro y el modo de ordenación
de la lista inicial. Si encuentra archivos antiguos `cosimo-settings.txt` o
`cosimo-last-open-deck.txt`, los migra a `cosimo.ini` y elimina los archivos
antiguos.

### Añadir y editar cartas

Usa `Carta -> Añadir carta` para añadir una carta. El editor tiene campos de
pregunta y respuesta. También tiene una casilla `Marcar como no reversible`.
Déjala sin marcar para una carta normal; márcala cuando la carta no deba usarse
nunca para generar una carta inversa.

Para introducir varias cartas seguidas, usa `Carta -> Añadir cartas en bloque`.
Escribe la pregunta y la respuesta, y pulsa `Ctrl+Enter` desde cualquiera de
los dos campos para añadir la carta y volver al campo de pregunta. Al pulsar
Tab desde el campo de respuesta también se añade la carta y se vuelve al campo
de pregunta cuando ambos campos contienen texto. Pulsa Escape para cerrar el
diálogo de entrada en bloque. La entrada en bloque no muestra la casilla de
carta no reversible, para mantener breve el flujo de entrada repetida.

Usa `Carta -> Editar carta seleccionada` para editar la carta seleccionada
desde la lista inicial. Después de revelar una carta durante una sesión de
estudio, esta orden cambia a `Carta -> Editar carta actual`. También puedes
elegir `Editar carta` o pulsar `e` en ese momento. Cosimo abre el mismo editor
que se usa en el resto de la aplicación, guarda el texto de la carta y vuelve
al paso de valoración posterior a la respuesta. La decisión de programación se
toma solo después de elegir la valoración de recuerdo.

Usa `Delete` o `Carta -> Eliminar carta seleccionada` para eliminar la carta
seleccionada del mazo. Eliminar una carta principal también elimina su carta
inversa generada de la lista de preguntas, porque la carta inversa se deriva de
la carta principal. Los datos de repaso de la carta inversa permanecen en la
base de datos, pero solo vuelven a ser útiles si restauras una copia de
seguridad del mazo que contenga la carta principal original.

Usa `Alt+Enter`, `Carta -> Detalles de la carta` o el menú contextual de la
lista de preguntas para mostrar detalles y estadísticas de la carta
seleccionada.

### Preguntas y respuestas duplicadas

Evita preguntas duplicadas. Una pregunta debería identificar una sola carta.
Cosimo rechaza las acciones normales de añadir y editar que crearían una
pregunta duplicada. Si editas un mazo a mano e introduces preguntas duplicadas,
Cosimo abre el mazo con un aviso. Usa el filtro `Preguntas duplicadas` para
encontrarlas, o usa `Mazo -> Resolver enunciados duplicados` para elegir la
respuesta que se conservará para cada pregunta duplicada; las otras cartas con
esa pregunta se eliminan del mazo, y sus datos de repaso quedan inactivos salvo
que se depure la base de datos de repaso.
Durante la resolución de duplicados, `Saltar enunciado` deja la pregunta
duplicada actual sin cambios y continúa con preguntas duplicadas posteriores.
`Cancelar resolución` detiene el proceso por completo. Las preguntas ya
resueltas permanecen cambiadas.

Las respuestas duplicadas sí están permitidas. A menudo son útiles cuando
distintas preguntas comparten la misma respuesta. La restricción solo afecta a
las cartas inversas generadas: de cada grupo de cartas con la misma respuesta,
como máximo una carta puede tener una carta inversa generada activa. Si hubiera
más de una, las cartas inversas generadas tendrían la misma pregunta y ya no
estaría claro qué carta original se está preguntando. Cosimo impide crear o
editar cartas inversas cuando eso produciría esa ambigüedad. Marca una carta
como no reversible si su respuesta compartida no debería usarse nunca como
pregunta inversa.

### Cartas reversibles y no reversibles

Usa `Carta -> Añadir carta inversa`, o pulsa `Ctrl+R` cuando la lista de
preguntas tenga el foco, para añadir una carta inversa generada. Una carta
inversa pregunta por la respuesta original y espera la pregunta original. Las
cartas inversas tienen su propio estado de programación e historial de
repasos. Cosimo impide hacer reversible una carta cuando otra carta con la
misma respuesta ya tiene una carta inversa generada activa, porque la pregunta
inversa sería ambigua. Las cartas inversas se marcan con `(inversa)` en la
lista de preguntas y pueden encontrarse con el filtro `Cartas inversas`.
Eliminar una carta inversa elimina solo la dirección inversa generada; no
elimina la carta principal. Los datos de repaso de la carta inversa permanecen
en la base de datos y se vuelven a usar si haces reversible de nuevo la carta
principal. Cuando una carta inversa generada está seleccionada, el menú de
cartas y el menú contextual ofrecen eliminar esa dirección inversa, no marcar
la carta principal como no reversible.

Usa `Carta -> Marcar carta seleccionada como no reversible` cuando una carta no
deba tener dirección inversa generada. Esto escribe una marca en el archivo del
mazo, elimina cualquier carta inversa generada activa de esa carta principal e
impide que `Hacer cartas aptas reversibles` la vuelva a añadir más adelante.
Usa `Carta -> Quitar marca de carta no reversible` para quitar esa marca. La
carta vuelve a ser apta para inversión manual o en bloque, siempre que su
respuesta no esté ya usada por otra carta inversa generada activa. Las cartas
no reversibles aparecen con `(no reversible)` en la lista de preguntas, pueden
encontrarse con el filtro `Cartas no reversibles`, y muestran la marca no
reversible en la línea de estado de detalles de la carta. Cuando una carta no
reversible está seleccionada, los menús ofrecen quitar la marca de carta no
reversible, no crear una carta inversa directamente.

Usa `Mazo -> Hacer cartas aptas reversibles` para marcar como reversibles en
una sola operación todas las cartas que puedan serlo. Cosimo pide confirmación
e indica cuántas cartas pueden cambiarse. Se excluyen las cartas que ya son
reversibles, las cartas marcadas como no reversibles y las cartas cuyo grupo de
respuestas ya tiene una carta inversa generada activa. Si las copias de la base
de datos de repaso están activadas, esta operación actualiza la copia retenida
antes de escribir y la confirmación avisa de que esa copia retenida se
sobrescribirá.

Usa `Mazo -> Deshacer última reversión en bloque` para eliminar solo las cartas
inversas creadas por la última reversión en bloque. Se conservan las cartas
inversas creadas manualmente y los lotes anteriores. Las cartas principales y
el historial de repaso inverso permanecen en la base de datos.

### Suspender, aplazar y marcar cartas

Usa `Carta -> Suspender carta seleccionada`, el menú contextual de la lista de
preguntas, o `Ctrl+S` cuando la lista de preguntas tenga el foco, para conservar
la carta en el mazo pero impedir que aparezca en sesiones normales o forzadas.
La lista de preguntas marca las cartas suspendidas con `(suspendida)`. Las
cartas suspendidas pueden encontrarse con el filtro `Cartas suspendidas` y
reactivarse desde el mismo menú, menú contextual o atajo. Las cartas
suspendidas también se ignoran cuando la barra de estado indica si hay un
repaso pendiente ahora o cuándo será el próximo repaso.

Usa `Carta -> Aplazar carta seleccionada hasta mañana`, o el menú contextual de
la lista de preguntas, para posponer temporalmente la carta seleccionada sin
cambiar su programación almacenada. Una carta aplazada permanece en el mazo y
vuelve automáticamente cuando caduca el aplazamiento. Mientras está aplazada,
aparece con `(aplazada)`, se muestra en el filtro `Cartas aplazadas` y queda
excluida de sesiones programadas, sesiones forzadas, recuentos de la pantalla
inicial y cálculos de pendientes en la barra de estado. Usa
`Carta -> Quitar aplazamiento de carta seleccionada`, o el menú contextual, para
hacerla disponible de nuevo inmediatamente.

Durante una sesión de estudio, antes de mostrar la respuesta, usa `Ctrl+D` o el
botón `Aplazar carta hasta mañana` para posponer la carta actual y continuar.
El aplazamiento no está disponible después de mostrar la respuesta. Si todas
las cartas de la sesión se aplazan antes de registrar ninguna respuesta, Cosimo
muestra un aviso indicando que no se estudió ninguna carta.

Usa `Carta -> Marcar carta seleccionada`, el menú contextual de la lista de
preguntas, o `Ctrl+F` cuando la lista de preguntas tenga el foco para marcar o
desmarcar la carta seleccionada. Durante una sesión de estudio, `Ctrl+F` marca
o desmarca la carta actual. La pantalla de estudio también tiene un botón para
marcar o desmarcar en ambas fases, después de los botones de valoración
correspondientes. Marcar sirve para seguimiento manual: úsalo cuando una carta
pueda necesitar edición, resulte confusa o ambigua, tenga una respuesta dudosa
o requiera atención después de la sesión. Marcar una carta no afecta a la
programación ni a si la carta aparece en el estudio normal. Las cartas marcadas
aparecen con `(marcada)` en la lista de preguntas y pueden encontrarse con el
filtro `Cartas marcadas`.

## Pantalla inicial

Cuando Cosimo se inicia, se abre en la pantalla inicial. Esta pantalla muestra:

- cuántas cartas hay en el mazo
- cuántas cartas están programadas ahora
- el mínimo de cartas por sesión
- el archivo de base de datos de repaso
- una lista de preguntas de cartas

Si el mínimo de cartas por sesión hace que Cosimo añada cartas adicionales que
todavía no están pendientes, el recuento de programadas también muestra entre
paréntesis cuántas están pendientes. Por ejemplo, `Programadas ahora: 10 (6
pendientes)` significa que la sesión incluiría 6 cartas pendientes y 4 cartas
adicionales para llegar al mínimo.

La barra de estado de la ventana principal da un resumen breve: cartas totales,
cartas pendientes ahora, y si hay un repaso pendiente ahora o cuánto falta
aproximadamente para el próximo repaso programado. Las duraciones se redondean
hacia arriba a unidades cómodas para síntesis de voz, como `2 días`,
`4 semanas` o `3 meses`. Durante una sesión, la barra de estado cambia al
contexto de la sesión, como sesión de estudio programada, sesión de estudio no
programada, examen o cuestionario, con el progreso actual.

Mientras la pantalla inicial está abierta, Cosimo actualiza el resumen, los
filtros de la lista y la barra de estado aproximadamente una vez por minuto.
Una carta que pase a estar pendiente mientras la aplicación está abierta quedará
disponible para `Comenzar` sin cerrar y volver a abrir el mazo.

Teclas útiles en la pantalla inicial:

- `Alt-M`: comenzar la sesión programada
- `Alt-F`: forzar el comienzo con todas las cartas no suspendidas ni aplazadas
- `Alt-X`: comenzar una sesión de examen con una muestra aleatoria de cartas
  activas
- `Alt-Z`: comenzar una sesión de cuestionario con una muestra aleatoria de
  cartas activas
- `Alt-L`: ir al filtro de texto de la lista de preguntas
- `F5`: actualizar el resumen, los filtros de lista y la barra de estado
- `Ctrl+L`: mostrar el panel de aprendizaje
- `Alt-S`: salir
- `Alt+Enter`: mostrar detalles y estadísticas de la carta seleccionada
- `Delete`: eliminar la carta seleccionada de la lista de preguntas
- `Ctrl+S`: suspender o reactivar la carta seleccionada
- `Ctrl+F`: marcar o desmarcar la carta seleccionada
- `Ctrl+D`: aplazar la carta seleccionada hasta mañana, o quitar su
  aplazamiento
- `Ctrl+R`: hacer reversible la carta seleccionada, o eliminar la carta inversa
  generada

Usa `Ver -> Orden del mazo`, `Ver -> Próximo repaso programado`,
`Ver -> Último repaso`, `Ver -> Texto de pregunta`, `Ver -> Texto de respuesta`
o `Ver -> Recuerdo estimado` para elegir cómo se ordena la lista de preguntas.
Usa `Ver -> Ascendente` o `Ver -> Descendente` para elegir la dirección. Los
elementos marcados del menú Ver muestran el criterio y la dirección actuales.
Cuando eliges otro criterio de ordenación, Cosimo restablece la dirección al
valor por defecto de ese criterio. Último repaso usa descendente por defecto,
poniendo primero las cartas estudiadas más recientemente y dejando las cartas
nuevas al final; último repaso ascendente pone primero las cartas estudiadas
hace más tiempo y también deja las cartas nuevas al final. Recuerdo estimado
usa la misma estimación de programación que el panel de aprendizaje; recuerdo
estimado ascendente pone primero las cartas que se estiman menos probables de
recordar y deja al final las cartas sin estimación, como las nuevas.

El filtro de texto reduce la lista buscando en la pregunta o la respuesta. El
cuadro combinado de filtro controla qué tipo de cartas se muestran, incluidas
cartas marcadas, preguntas duplicadas, respuestas duplicadas, cartas no
reversibles, cartas aplazadas, cartas problemáticas, problemas de asimetría,
fallos con confianza alta y aciertos con confianza baja. Sus recuentos siguen
el filtro de texto actual. El filtro de respuestas duplicadas es especialmente
útil antes de hacer cartas reversibles.

El menú Cartas también puede actuar sobre las cartas que se muestran
actualmente en la lista inicial. Usa `Marcar todas las cartas visibles` o
`Desmarcar todas las cartas visibles` para marcar todo un conjunto filtrado
para revisión manual, por ejemplo todas las cartas problemáticas antes de
elegir `Estudiar marcadas`. `Suspender todas las cartas visibles` y
`Quitar suspensión de todas las cartas visibles` funcionan del mismo modo.
Cosimo pide confirmación e indica cuántas cartas visibles cambiarán realmente;
las cartas que ya estén en el estado pedido se dejan sin cambios.

El filtro `Cartas problemáticas` muestra elementos de estudio activos que
parecen inusualmente difíciles en el mazo actual. Espera hasta que un elemento
tenga al menos 4 intentos, y usa el comportamiento de repaso en vez de
simplemente la edad de la carta. Una carta puede aparecer ahí si al menos 2 de
sus últimos 5 intentos fueron `Repetir`, si su tasa vitalicia de `Repetir` está
en el 20% más alto del mazo y es al menos 25%, si sus lapsos programados por
intento están en el 20% más alto del mazo y son al menos 20%, o si su
dificultad de programación está en el 20% más alto del mazo y es al menos 8 en
la escala de dificultad FSRS de 1 a 10. Las cartas suspendidas y actualmente
aplazadas no se muestran ahí.

El filtro `Problemas de asimetría` es para cartas reversibles. Cuando ambas
direcciones tienen al menos 4 intentos y una dirección es sustancialmente más
débil, el filtro muestra el elemento de estudio más débil. Cosimo compara una
tasa de recuerdo estricta ligeramente suavizada, donde solo `Bien` y `Fácil`
cuentan como recordadas, y considera sustancial una diferencia de 30 puntos
porcentuales o más. Esto es útil cuando, por ejemplo, ver una palabra indonesia
y recordar el español es fácil, pero producir la palabra indonesia desde el
español sigue siendo poco fiable.

Los filtros `Fallos con confianza alta` y `Aciertos con confianza baja` usan
intentos recientes con valoración de confianza. `Fallos con confianza alta`
muestra elementos de estudio activos donde elegiste recientemente
`Probablemente lo sé` o `Seguro que lo sé`, pero después respondiste
sin recordar la respuesta según la regla activa de recuerdo de calibración;
basta con el último intento con confianza, o al menos 2 de los últimos 5
intentos con confianza. `Aciertos con confianza baja` muestra elementos de
estudio activos donde al menos 2 de los últimos 5 intentos con confianza fueron
`No lo sé` o `Probablemente no lo sé` seguidos de una respuesta que cuenta como
recordada según la regla activa de recuerdo de calibración. Con la regla
permisiva, `Difícil`, `Bien` y `Fácil` cuentan como recordadas; con la regla
estricta, solo `Bien` y `Fácil`. Las cartas suspendidas y actualmente
aplazadas no se muestran en ninguno de los dos filtros.

El diálogo de detalles de carta muestra la pregunta, la respuesta, el ID de
carta, el estado actual de la carta, el número de intentos, el último intento,
el estado de programación, la disponibilidad, el recuerdo estimado ahora, el
recuerdo reciente, el resumen de recaídas y el historial de intentos de la carta
seleccionada. El estado de carta combina en una sola línea marcas visibles como
suspendida, marcada, aplazada, inversa, tiene inversa y no reversible. La
disponibilidad explica si una carta es nueva, está programada para más tarde,
está lista para un repaso programado ordinario o espera un paso de aprendizaje
o reaprendizaje. Cuando hay una hora programada, la línea de disponibilidad
incluye tanto el tiempo relativo como la fecha y hora UTC exacta.

Las cartas inversas generadas muestran el ID de carta de la carta principal,
porque editar la carta principal en el mazo también cambia su dirección inversa
generada. Los campos de fecha del resumen, como último intento y última
actualización de programación, se muestran primero como duración relativa
completa, por ejemplo `1 día, 1 hora, 1 minuto, 1 segundo`, seguida de la fecha
y hora UTC exacta entre paréntesis. Las fechas pasadas usan la misma duración
relativa completa seguida de `atrás`. La lista de historial de intentos del
final usa solo fechas y horas UTC exactas.

## Sesiones de estudio

Hay tres órdenes normales de sesión de estudio:

`Comenzar` usa la programación. Repasa primero las cartas pendientes. Si hay
menos cartas pendientes que el mínimo de cartas por sesión configurado, Cosimo
añade cartas adicionales al azar desde el resto del mazo.

`Forzar comienzo` ignora la programación. Pone todas las cartas no suspendidas
ni aplazadas en orden aleatorio. Úsalo cuando quieras estudiar aunque no haya
cartas pendientes, o cuando quieras una sesión de práctica más larga.

`Estudiar marcadas` inicia una sesión no programada solo con cartas marcadas.
Esta sesión incluye cartas marcadas estén programadas o no, pero excluye las
cartas suspendidas o aplazadas. El orden es aleatorio, y la sesión no quita las
marcas; quita las marcas manualmente cuando esas cartas ya no requieran
seguimiento. El botón está desactivado cuando no hay cartas marcadas
disponibles para estudiar.

Cuando se muestra una pregunta, puedes valorar qué probabilidad crees que
tienes de saber la respuesta:

- `1`: no lo sé
- `2`: probablemente no lo sé
- `3`: probablemente lo sé
- `4`: seguro que lo sé

Esta es tu predicción antes de ver la respuesta.

También puedes elegir `Mostrar respuesta`, o pulsar Espacio, para mostrar la
respuesta sin registrar una predicción. Esto se guarda como `Sin responder` en
el resumen de la sesión.

Después de valorar tu predicción, o de mostrar directamente la respuesta,
Cosimo muestra la respuesta. Entonces valora lo que ha ocurrido realmente:

- `1`: Repetir
- `2`: Difícil
- `3`: Bien
- `4`: Fácil

Esta valoración es lo que Cosimo usa de forma más directa para programar la
carta. La misma valoración de recuerdo puede tener un efecto de programación
distinto según si la carta todavía está en un paso corto de aprendizaje o ya
ha llegado al estado de repaso ordinario; consulta `Cómo estudia Cosimo las
cartas` para más detalles.

Si encuentras un error después de mostrar la respuesta, elige `Editar carta`,
usa `Carta -> Editar carta actual`, o pulsa `e`. Cosimo abre el mismo editor
que se usa en el resto de la aplicación, guarda el texto de la carta y vuelve
al paso de valoración posterior a la respuesta. La decisión de programación se
toma solo después de elegir la valoración de recuerdo.

Al final de una sesión de estudio, Cosimo muestra un resumen de esa sesión:

- cuántas cartas se han estudiado
- tiempo total y tiempo por carta
- recuentos y porcentajes de las valoraciones de predicción, incluidas las
  respuestas mostradas sin predicción
- recuentos y porcentajes de las valoraciones de recuerdo

Si una sesión antigua, o un modo de estudio futuro, contiene preguntas
repetidas para el mismo elemento de estudio, Cosimo muestra la distinción más
detallada entre cartas únicas, preguntas respondidas, tiempo por pregunta y
tiempo por carta única. Los modos de estudio actuales normales no repiten las
cartas valoradas como `Repetir` en la misma sesión. Una carta y su dirección
inversa generada cuentan como cartas estudiadas distintas.

Las cartas aplazadas antes de mostrar la respuesta no cuentan como preguntas
respondidas en el resumen de la sesión.

Elige `Guardar informe` para escribir una copia de texto del resumen de una
sesión normal en el directorio `reports`, junto al ejecutable. Cosimo crea el
directorio si hace falta. Los nombres de informe normales usan el nombre del
archivo del mazo sin su extensión y la hora UTC en que terminó la sesión, por
ejemplo `Indonesian-2026-05-03-06-04.txt`. Si ya existe un informe con ese
nombre, Cosimo añade un sufijo numérico en vez de sobrescribirlo. El texto del
informe incluye la ruta completa del mazo.

Elige `Continuar` para volver a la pantalla inicial.

## Exámenes y cuestionarios

`Comenzar examen` toma una muestra del mazo activo en vez de usar la
programación. Las cartas suspendidas y aplazadas se excluyen. Cosimo te pide que
elijas un número de preguntas o un porcentaje de cartas activas, y después
selecciona y ordena las cartas al azar para reducir las pistas producidas por
el orden del mazo.

Si el mazo tiene cartas inversas generadas, la configuración del examen incluye
una opción de dirección de estudio: solo normal, solo inversa o ambas. Si el
mazo no tiene cartas inversas generadas, esta opción queda oculta y el examen
usa la dirección normal.

Durante un examen, Cosimo muestra cada pregunta y te pide que escribas la
respuesta. No muestra la corrección mientras el examen está en curso. Las
respuestas exactas cuentan como correctas automáticamente. Al final, para cada
respuesta que no fue una coincidencia exacta, Cosimo muestra la pregunta, tu
respuesta y la respuesta esperada, y pregunta si la respuesta debe contar como
correcta.

Si la casilla `Exacto` está marcada al comenzar el examen, las respuestas no
exactas no se corrigen manualmente. Cuentan como incorrectas, y Cosimo muestra
cada una para revisión con la pregunta, tu respuesta y la respuesta esperada.
Elige `Siguiente` o pulsa `Alt-N` para seguir revisando respuestas inexactas, o
elige `Resumen` para ir directamente al resumen del examen.

Si la casilla `Examen cronometrado` está marcada, introduce un número entero de
minutos para el examen. El tiempo restante se muestra en la barra de estado.
Cosimo reproduce un tono muy breve en cada límite del 10% del tiempo. Cuando se
agota el tiempo, cualquier texto que esté en el campo de respuesta se envía, se
reproducen cuatro tonos cortos, y Cosimo muestra un aviso de tiempo agotado con
el número de respuestas enviadas. El aviso empieza con el mensaje enfocado; usa
Tab hasta `Siguiente` para continuar a la corrección, la revisión de respuestas
o el resumen.

Cuando un examen que no se ha agotado por tiempo termina con al menos una
respuesta enviada, Cosimo reproduce dos tonos largos y muestra un aviso de
`Examen terminado` antes de la corrección, la revisión de respuestas o el
resumen. Esto da a los usuarios que dependen del audio del examen un límite
claro entre responder preguntas y comprobar respuestas.

Durante una sesión de examen, elige `Terminar examen` para parar después de las
respuestas enviadas hasta ese momento. Si no se envió ninguna respuesta, Cosimo
muestra un aviso.

Las sesiones de examen muestran un resumen de examen separado. Informa de
preguntas seleccionadas, respuestas enviadas, respuestas correctas y porcentaje
correcto, coincidencias exactas, respuestas no exactas aceptadas, respuestas
incorrectas, tiempo total, tiempo por pregunta, si el examen terminó antes de
tiempo y si se agotó el tiempo de un examen cronometrado. Los resúmenes de
examen no cambian la base de datos de repaso. Elige `Guardar informe` para
escribir una copia de texto del resumen de examen en el directorio `reports`.
Los nombres de informe de examen añaden `-exam`, por ejemplo
`Indonesian-exam-2026-05-03-06-04.txt`.

`Comenzar cuestionario` también es no programado y solo informativo. Está
pensado para practicar reconocimiento con opciones múltiples, por ejemplo para
preparar pruebas externas con preguntas de tipo cuestionario. Cosimo toma una
muestra aleatoria de cartas activas y excluye las cartas suspendidas y
aplazadas. Salvo que el tamaño solicitado del cuestionario lo haga imposible,
evita poner las dos direcciones de la misma carta reversible en un mismo
cuestionario, para que una pregunta no dé pistas sobre la dirección contraria.

Si el mazo tiene cartas inversas generadas, la configuración del cuestionario
incluye una opción de dirección de estudio: solo normal, solo inversa o ambas.
Si el mazo no tiene cartas inversas generadas, esta opción queda oculta y el
cuestionario usa la dirección normal.

Durante un cuestionario, Cosimo muestra la pregunta y una lista de respuestas
posibles. Elige una respuesta y envíala. La corrección no se muestra hasta el
final. Después del cuestionario, Cosimo muestra cada respuesta enviada con la
pregunta y la respuesta elegida. Si la respuesta elegida era incorrecta,
también muestra la respuesta correcta. Elige `Siguiente` o pulsa `Alt-N` para
avanzar por la revisión de respuestas, o elige `Resumen` para ir directamente
al resumen de cuestionario. El modo cuestionario no registra intentos, no
cambia la programación de las cartas y no añade respuestas falladas al final de
la misma sesión. Necesita al menos cuatro opciones de respuesta distintas en la
dirección de estudio actual, de modo que las preguntas directas toman las
opciones de las respuestas y las preguntas invertidas las toman de los
enunciados. Los enunciados de cartas marcadas como no reversibles no se usan
como opciones para preguntas invertidas.

Las sesiones de cuestionario muestran un resumen de cuestionario con preguntas
seleccionadas, respuestas enviadas, respuestas correctas e incorrectas,
porcentaje correcto, tiempo total, tiempo por pregunta y si el cuestionario
terminó antes de tiempo. Los resúmenes de cuestionario no cambian la base de
datos de repaso. Elige `Guardar informe` para escribir una copia de texto del
resumen de cuestionario en el directorio `reports`. Los nombres de informe de
cuestionario añaden `-quiz`, por ejemplo
`Indonesian-quiz-2026-05-03-06-04.txt`.

## Panel de aprendizaje

Usa `Estudio -> Panel de aprendizaje`, o pulsa `Ctrl+L`, para mostrar un
resumen de aprendizaje de todo el mazo. El panel está dividido en secciones de
solo lectura separadas para que puedas tabular entre resumen, distribución,
carga de trabajo, diagnósticos y actividad en vez de leer un solo campo largo.
Informa de varios tipos de datos:

- recuentos de cartas por estado de programación: nuevas, en aprendizaje, en
  repaso y en reaprendizaje
- recuentos de cartas disponibles, y cuántas de esas ya están programadas y
  pendientes ahora, ignorando las cartas suspendidas y aplazadas
- estimaciones de recuerdo del modelo para cartas activas con datos de
  programación
- distribución del recuerdo estimado, incluyendo mediana, media de las cartas
  más débiles y bandas de recuerdo
- previsión de carga para las próximas 24 horas, 3 días, 7 días y 30 días, con
  tiempo estimado de estudio cuando hay datos de tiempo registrados, además de
  afirmaciones prudentes en el resumen sobre la forma y la presión de la carga
- calibración de confianza a partir de tus predicciones previas a la respuesta
  y tus valoraciones posteriores del recuerdo
- tendencia de recuerdo, recuentos de recaídas y afirmaciones conservadoras de
  tendencia reciente cuando hay datos suficientes
- diagnósticos como cartas en riesgo, recaídas repetidas, fallos con alta
  confianza y retención de aprendizaje reciente
- actividad de estudio, incluyendo días con respuestas, respuestas
  almacenadas, respuestas en sesiones registradas, recuentos de elementos
  repetidos cuando las sesiones antiguas los contienen, tiempo empleado en
  sesiones completadas, tiempo de estudio registrado reciente y tiempo medio de
  estudio por día de estudio activo cuando existen datos de tiempo
- información sobre primera detección de cartas del mazo, que ayuda a comparar
  el material introducido recientemente con las cartas que han llegado al
  estado de repaso

La sección de recuerdo es una estimación del modelo de programación de Cosimo,
no un resultado medido directamente. Para cada carta activa con datos de
programación que no esté suspendida ni aplazada, Cosimo usa la hora del último
repaso, la estabilidad almacenada y el intervalo programado real para estimar
la probabilidad de que recuerdes la carta ahora. Las cartas nuevas sin datos de
programación, las cartas suspendidas y las cartas aplazadas en ese momento no
se incluyen en esta estimación. Las cartas en aprendizaje y reaprendizaje usan
su intervalo corto programado como punto efectivo del 90%, de modo que una
carta pendiente tras un paso corto por fallo no parezca más segura de lo que
es.

`Disponibles ahora` cuenta las cartas activas no suspendidas ni aplazadas que
se pueden estudiar inmediatamente. Esto incluye cartas nuevas, que Cosimo puede
poner en una sesión de estudio inmediatamente, y cartas con datos de
programación existentes cuya hora de repaso ya ha llegado. `De estas, ya
programadas y pendientes ahora` es un subconjunto de `Disponibles ahora`: solo
cuenta cartas disponibles con datos de programación existentes. Usa el mismo
límite temporal que `Disponibles ahora`, así que una carta pendiente en el
instante exacto en que se generó el panel queda incluida. El panel pone
`Disponibles ahora` primero porque es la cifra operativa: cuántas cartas se
pueden estudiar ahora.

`Recuerdo medio estimado` es la media de esas estimaciones por carta. El panel
también muestra la mediana y las cartas estimadas más débiles para que una
media no oculte un grupo pequeño de material débil. La media de las cartas más
débiles es la media del recuerdo estimado del 10% inferior de cartas activas
con estimación, redondeado hacia arriba para incluir al menos una carta.
`Probablemente sabidas` cuenta las cartas estimadas con un recuerdo del 90% o
más. `Mayormente estables` es 70-89%, `Frágiles` es 50-69%, y `Muy bajo` es
menos del 50%. `Cartas en riesgo` cuenta juntas las bandas frágil y muy baja.
Estos números se usan mejor para triaje y tendencias, no como promesa de que
responderás correctamente exactamente ese porcentaje de cartas en la próxima
sesión.

La previsión de carga muestra cuántas cartas activas están programadas ahora y
dentro de las próximas 24 horas, 3 días, 7 días y 30 días. Estos recuentos son
acumulativos: una carta disponible ahora también se incluye en los horizontes
posteriores. Las cartas suspendidas y aplazadas se excluyen. Cuando Cosimo
tiene tiempos de sesión registrados, la previsión también estima el tiempo de
estudio a partir del tiempo medio actual por carta única estudiada. Es solo una
estimación: refleja intentos repetidos de sesiones registradas anteriores, pero
no puede saber cuántos pasos de aprendizaje o reaprendizaje vencerán durante
una sesión futura.

La sección Resumen describe la forma de la carga de los próximos 7 días solo
cuando se prevén al menos 5 cartas. Si al menos la mitad de la carga de 7 días
vence en 24 horas, Cosimo dice que la mayor parte vence en 24 horas. Si al
menos tres cuartas partes vencen en 3 días, Cosimo dice que la mayor parte
vence en 3 días. En caso contrario, Cosimo dice que la carga está repartida a
lo largo de la semana. Cuando existen datos de tiempo de los últimos 7 días, el
Resumen también compara la carga estimada de 7 días con tu tiempo de estudio
registrado en los últimos 7 días. Si la diferencia es inferior a 5 minutos y al
20% del tiempo registrado reciente, Cosimo describe la estimación como parecida
al tiempo de estudio reciente; en caso contrario la describe como mayor o menor
y muestra ambas duraciones.

La sección de calibración trata tu predicción antes de ver la respuesta como un
intervalo objetivo de si recordarás la respuesta, no como un porcentaje exacto.
`No lo sé` significa un objetivo de recuerdo de 0-5%, `Probablemente no lo sé`
5-32%, `Probablemente lo sé` 68-95%, y `Seguro que lo sé` 95-100%. El intervalo
central se deja sin cubrir deliberadamente; muestra la respuesta sin valorar
confianza si no quieres hacer una predicción. La regla de recuerdo se configura
en `Herramientas -> Opciones`. La regla permisiva cuenta `Difícil`, `Bien` y
`Fácil` como recordadas, mientras que `Repetir` cuenta como no recordada. La
regla estricta cuenta solo `Bien` y `Fácil` como recordadas. El panel muestra
la regla activa antes de las cifras de calibración. El intervalo objetivo de
recuerdo es la media de los intervalos objetivo de las valoraciones de
confianza respondidas. La tasa de recuerdo observada es lo que ocurrió
realmente con la regla de recuerdo actual. La calibración está dentro del
objetivo si el recuerdo observado cae dentro del intervalo objetivo, hay falta
de confianza si el recuerdo observado queda por encima del intervalo, y exceso
de confianza si queda por debajo. Las líneas por confianza muestran la misma
comparación para cada valoración de confianza. Las cartas mostradas sin
predicción se cuentan por separado.

En la sección de diagnósticos, `Fallos con alta confianza` significa que
elegiste `Probablemente lo sé` o `Seguro que lo sé` y después no recordaste la
respuesta según la regla de recuerdo activa. Es señal de exceso de confianza.
`Aciertos con baja confianza` significa que elegiste `No lo sé` o
`Probablemente no lo sé` y después recordaste la respuesta según la regla de
recuerdo activa. Es señal de falta de confianza. `Respuestas` cuenta eventos de
respuesta almacenados; una carta puede aportar más de una respuesta. `Cartas
afectadas` cuenta cuántas cartas tienen al menos una respuesta de ese tipo. Los
recuentos recientes entre paréntesis usan los últimos 7 días: dicen `todos
recientes` si todas las respuestas o cartas contadas son recientes, `ninguno
reciente` si ninguna lo es, o en otro caso dan el número de respuestas o cartas
recientes. `Cartas con exceso de confianza reciente significativo` y `Cartas
con falta de confianza reciente significativa` usan la regla estricta de patrón
reciente usada por los filtros diagnósticos de la lista inicial: para el exceso
de confianza basta con el último intento con confianza, o al menos 2 de los
últimos 5 intentos con confianza; para la falta de confianza deben coincidir al
menos 2 de los últimos 5 intentos con confianza.

La sección de tendencia del recuerdo cuenta respuestas almacenadas de cartas
del mazo actual. `Recuerdo global` usa la regla ordinaria del panel: `Difícil`,
`Bien` y `Fácil` cuentan como recordadas, mientras que `Repetir` cuenta como no
recordada. Las líneas de valoración muestran primero porcentajes, seguidos de
recuentos entre paréntesis. La ventana reciente compara los últimos 7 días con
los 7 días anteriores; Cosimo solo hace una afirmación cualitativa de tendencia
cuando ambas ventanas contienen al menos 5 respuestas. Un cambio de 5 puntos
porcentuales o más se describe como mejora o empeoramiento; diferencias menores
se describen como ampliamente estables. Las tendencias de tasa de `Repetir` en
cartas inversas usan las mismas ventanas de 7 días, el mínimo de 5 respuestas y
el umbral de 5 puntos, pero una tasa de `Repetir` descendente es mejor y una
ascendente es peor. Las líneas de recaídas vienen del estado de programación
actual de las cartas activas y ayudan a identificar si el mazo contiene
material que vuelve repetidamente desde el estado de repaso al reaprendizaje.
Estas recaídas programadas solo cuentan `Repetir` en cartas que ya habían
llegado al estado de repaso; las tasas ordinarias de `Repetir` se muestran por
separado. Las afirmaciones de retención sobre aprendizaje reciente cuentan
cartas aprendidas recientemente que no han tenido después una respuesta
`Repetir`. Cosimo necesita al menos 5 cartas aprendidas recientemente antes de
describir la retención reciente; 90% o más retenidas es `bien retenidas`,
70-89% es `mayormente retenidas`, y menos de 70% se muestra como recaídas de
seguimiento.

Cuando existen datos temporizados de sesión, la sección Resumen incluye el
tiempo medio de estudio por día de estudio activo para que esta métrica
principal esté visible sin tabular hasta la sección completa de actividad.

Cosimo registra la primera vez que la base de datos de repaso ve cada carta
física del mazo. Esto no es necesariamente la fecha real de creación de la
carta: en mazos existentes, las cartas actuales se registrarán cuando esta
función las vea por primera vez. Por eso el panel lo describe como cartas
detectadas por primera vez por esta base de datos de repaso. Cuando la base de
datos ya tenga observaciones anteriores, el Resumen puede mostrar una línea de
`Flujo del mazo` para los últimos 7 días: cuántas cartas del mazo fueron
detectadas por primera vez y cuántas cartas en dirección estándar llegaron al
estado de repaso. Es información descriptiva. Su finalidad es ayudarte a juzgar
el crecimiento del mazo y el ritmo de aprendizaje sin que Cosimo te diga si
debes añadir más o menos cartas.

La sección de actividad de estudio se basa en intentos registrados y resúmenes
de sesiones. `Respuestas almacenadas` cuenta respuestas individuales
almacenadas. `Días con respuestas` cuenta días UTC con al menos una respuesta
registrada. Los recuentos de sesiones, respuestas y tiempo etiquetados como
sesiones registradas vienen de resúmenes de sesiones completadas. Las
duraciones de tiempo de estudio usan segundos, minutos, horas, días,
semanas y años; Cosimo no usa meses porque su duración varía. `Días de
estudio temporizados` cuenta días UTC con al menos un resumen de sesión
completada y es la base del tiempo medio de estudio por día de estudio activo.
El tiempo de estudio reciente registrado y las preguntas recientes registradas
comparan los últimos 7 días con los 7 días anteriores. Esto describe actividad
de estudio real registrada en sesiones completadas; no es una previsión
histórica de cuántas cartas estaban programadas. El Resumen describe el tiempo
de estudio reciente como mayor, menor o parecido al de los 7 días anteriores
cuando existen datos de sesiones con tiempo; las diferencias inferiores a 5
minutos y al 20% de la ventana anterior se tratan como parecidas. Si hay datos
antiguos anteriores a los resúmenes de sesiones, el panel muestra `Respuestas
antiguas sin tiempo de sesión` para no confundir el total de respuestas
almacenadas con el total menor de sesiones con tiempo. Esa línea se oculta
cuando el valor es cero. La misma sección también informa de cuántas cartas
físicas del mazo ha detectado por primera vez esta base de datos de repaso, los
recuentos de primera detección de los últimos 7 días, los 7 días anteriores y
las observaciones anteriores cuando hay suficiente historial, y las cartas
activas estándar del mazo que todavía no se han estudiado.

Usa el botón `Guardar informe` del panel para guardar el informe completo del
panel en el directorio `reports`. El texto guardado usa encabezados de sección
de estilo Markdown e incluye todas las secciones del panel, aunque el diálogo
las muestre en campos separados. El nombre del informe usa el nombre del mazo y
la hora UTC en la que se abrió el panel, y el informe incluye las rutas
completas del mazo y de la base de datos de repaso. Usa `Copiar al portapapeles`
para copiar al portapapeles el mismo texto completo del informe.

Si el mazo tiene cartas inversas generadas, el panel añade una comparación
entre cartas estándar e inversas, porque una dirección puede ser mucho más
fácil que la otra. Si las dos medias de recuerdo estimado difieren en menos de
5 puntos porcentuales, Cosimo describe las direcciones como similares.

## Audio

El soporte de audio tiene dos partes separadas. La reproducción usa archivos
Opus existentes, y archivos WAV antiguos, mientras estudias, previsualizas
cartas o revisas respuestas de examen. La generación automática usa
`voice.exe`, desde la línea de órdenes o mediante
`Herramientas -> Generar audio`, para crear archivos Opus o WAV a partir de
voces de síntesis instaladas.

La reproducción de audio de repaso es opcional y admite archivos `.opus`, con
retroceso a archivos `.wav` antiguos con el mismo ID de carta y lado si no
existe archivo Opus. Configúrala en
`Herramientas -> Opciones -> Audio durante el estudio`:

- `Sin audio`: Cosimo ignora el audio de las cartas.
- `Manual`: si la pregunta o respuesta actual tiene audio, Cosimo indica que
  hay audio disponible y muestra un botón `Reproducir/detener audio`.
- `Automático`: Cosimo reproduce el audio de la pregunta cuando aparece una
  pregunta y el audio de la respuesta cuando aparece una respuesta durante el
  repaso ordinario. El mismo botón puede detener o volver a reproducir el audio
  actual.

La opción separada `Tonos guía para el audio automático` añade
señales de orientación breves cuando el audio automático está activado: un tono
corto antes del audio de pregunta, dos tonos cortos antes del audio de
respuesta y un arpegio de tres notas cuando aparece el resumen del repaso. La
opción está desactivada por defecto.

`Herramientas -> Opciones -> Formato de generación de audio` controla el
formato usado por la generación automática. `Opus` es el valor predeterminado
y normalmente ocupa mucho menos espacio que WAV. `WAV` sigue disponible por
compatibilidad o para usuarios que prefieran audio generado sin compresión.

`Ctrl+P` activa la misma acción de reproducir/detener cuando el audio de repaso
está disponible. En la lista inicial de cartas, `Ctrl+P` o el botón
`Reproducir/detener audio` previsualiza la carta seleccionada reproduciendo el
audio de la pregunta y después el audio de la respuesta. Pasar a la carta
siguiente, mostrar la respuesta, terminar la sesión o cerrar la ventana detiene
inmediatamente cualquier audio de carta que se esté reproduciendo. En modo
examen, el audio de la pregunta está disponible mientras respondes la pregunta.

`Herramientas -> Opciones -> Reproducir audio automáticamente durante la corrección y revisión de examen`
controla lo que ocurre después de enviar una respuesta de examen, cuando Cosimo
muestra un diálogo de corrección o revisión. `Sin audio automático` deja esa
fase en silencio salvo que pidas audio manualmente. `Pregunta`, `Respuesta` y
`Ambas` reproducen automáticamente la pregunta, la respuesta esperada, o la
pregunta seguida de la respuesta esperada. En los diálogos de corrección y
revisión, `Ctrl+P` siempre reproduce la pregunta seguida de la respuesta
esperada cuando esos archivos de audio existen, incluso si el audio automático
de corrección/revisión de examen está desactivado.

`Herramientas -> Opciones -> Reproducir audio automáticamente durante cuestionarios`
controla el audio de los cuestionarios. `Sin audio automático` deja los
cuestionarios en silencio salvo que reproduzcas audio manualmente durante la
revisión de respuestas. `Pregunta` reproduce el audio de la pregunta cuando
aparece cada pregunta de cuestionario. `Opciones` reproduce el audio de una
opción de respuesta cuando esa opción se selecciona, y lo detiene cuando la
lista de opciones pierde el foco o cambia la selección. `Ambas` combina esos
comportamientos. Durante la revisión de respuestas del cuestionario, el mismo
ajuste controla la reproducción automática de la pregunta y de la respuesta
correcta; `Ctrl+P` reproduce la pregunta seguida de la respuesta correcta
cuando esos archivos de audio existen. Si los tonos guía están activados, la
revisión de respuestas del cuestionario también reproduce un tono breve
ascendente para una respuesta correcta y un tono breve descendente para una
respuesta incorrecta antes de cualquier audio automático de revisión.

Los archivos de audio viven en el directorio con el mismo nombre base junto al
mazo. Para la carta `1` de `Indonesian.cosimo-deck`, usa
`Indonesian/1.prompt.opus` para el lado de pregunta y
`Indonesian/1.response.opus` para el lado de respuesta. Los nombres `.wav`
antiguos, como `Indonesian/1.prompt.wav`, siguen reproduciéndose si no existe
archivo `.opus`. Las cartas inversas generadas reutilizan los archivos de la
carta principal con pregunta y respuesta intercambiadas. La herramienta de
generación de audio escribe archivos nuevos en el formato seleccionado en ese
directorio, así que conserva copias separadas de cualquier grabación que hayas
creado tú.

`Herramientas -> Eliminar audio inoperativo del mazo` elimina archivos de
audio reconocidos por Cosimo en ese directorio cuando no pueden usarse:
archivos para ID de carta que ya no existen en el mazo, y archivos de formato
menos preferido ocultos por un formato preferido para el mismo lado de carta,
por ejemplo un `.wav` cuando existe el `.opus` correspondiente. También elimina
las entradas correspondientes de `audio-manifest.tsv`. La orden ignora otros
archivos del directorio, pide confirmación y no puede deshacerse.

Las copias automáticas del contenido del mazo y de la base de datos de repaso
no incluyen archivos de audio junto al mazo. Las exportaciones y copias
completas del mazo sí incluyen el directorio auxiliar. Si grabas o editas tu
propio audio, asegúrate de usar copias completas del mazo o haz copia del
directorio de audio por tu cuenta. La generación actual conserva los archivos
`.opus` y `.wav` existentes sin seguimiento en lugar de sobrescribirlos, pero
el directorio de audio sigue estando fuera del sistema de copias automáticas
del contenido del mazo y de la base de datos.

Los paquetes de Windows también incluyen `voice.exe`, una herramienta auxiliar
para generar esos archivos de audio a partir de voces OneCore o SAPI
instaladas. Ejecútala desde un símbolo del sistema. Por ejemplo, si `voice.exe` está junto a
`cosimo.exe`, esta orden lee `decks/Indonesian.cosimo-deck` y escribe archivos
de audio en `decks/Indonesian/`:

```bat
voice Indonesian --prompt-voice "Nombre de voz indonesia" --response-voice "Nombre de voz española"
```

Por defecto, `voice.exe` escribe archivos Opus. Usa `--format wav` si quieres
salida WAV.

También puedes usar `Herramientas -> Generar audio` desde Cosimo después de
abrir un mazo. Esta opción solo está disponible cuando el mazo tiene metadatos
de `Voz de la pregunta`, `Voz de la respuesta`, `Motor de voz de la pregunta` y
`Motor de voz de la respuesta`, para que Cosimo no genere audio silenciosamente
con la voz predeterminada equivocada del sistema. Si la opción está
desactivada, usa `Mazo -> Editar metadatos del mazo` para escoger esas voces y
motores, y comprueba si el mazo está marcado como mazo de audio manual. Muestra
un diálogo de progreso mientras `voice.exe` trabaja sobre el mazo actual y
escribe la salida de la herramienta en un archivo de texto dentro del directorio
`reports`. Si ya existe un archivo `.opus` o `.wav` antiguo sin seguimiento
para un lado concreto, `voice.exe` lo deja intacto. Al terminar, Cosimo informa
del número de cartas para las que se generó audio, cuántos archivos nuevos se
crearon, cuántos archivos gestionados se regeneraron o convirtieron, cuántos
archivos sin seguimiento se conservaron y cuántos archivos ya registrados se
omitieron. Si
el informe menciona archivos regenerados forzosamente por sobrescritura
explícita, se refiere a una ruta de sobrescritura de línea de órdenes antigua o
futura, no a la generación ordinaria desde la interfaz.

Esta política conservadora está pensada para evitar sustituir grabaciones del
usuario. Para un mazo cuyo audio mantienes manualmente, activa
`Mazo de audio manual (proteger contra generación automática de audio)` en
`Mazo -> Editar metadatos del mazo`. Esto
escribe `audio_generation=disabled` en la cabecera del mazo, desactiva
`Herramientas -> Generar audio`, y hace que `voice.exe` se niegue a generar
audio para ese mazo. No impide reproducir el audio existente.

Usa `voice --list-voices` para ver las voces instaladas. En aprendizaje de
idiomas, escoge una voz que corresponda al idioma de cada lado: si las
preguntas están en indonesio y las respuestas en español, usa una voz en
indonesio para las preguntas y una voz en español para las respuestas. Si ambos
lados están en el mismo idioma, `--voice "Nombre de voz"` usa la misma voz para
ambos. Usa `--engine onecore` o `--engine sapi` para listar o generar con un
motor concreto; `--prompt-engine` y `--response-engine` pueden seleccionar
motores distintos para los dos lados.

Los metadatos del mazo también pueden guardar filtros de voz y motores de voz
predeterminados. Configura `Voz de la pregunta`, `Voz de la respuesta`,
`Motor de voz de la pregunta` y `Motor de voz de la respuesta` en
`Mazo -> Editar metadatos del mazo`, o añade `prompt_voice=`,
`response_voice=`, `prompt_voice_engine=` y `response_voice_engine=` a la
cabecera del mazo. `voice.exe` usa esos valores predeterminados cuando no se
indica la opción correspondiente en la línea de órdenes. El mismo editor puede
marcar un mazo como de audio manual, lo que añade `audio_generation=disabled`.
Cuando `voice.exe` está disponible junto a `cosimo.exe`, el editor de metadatos
lista las voces instaladas para el motor seleccionado. Los campos de voz siguen
siendo editables, así que puedes escribir un filtro manualmente si la lista
falla o si quieres usar un valor que no aparece en ella. El selector de motor
puede listar voces OneCore, voces SAPI, o ambas; cuando eliges una voz de la
lista, Cosimo guarda automáticamente el motor correspondiente. Si escribes o
editas un filtro de voz manualmente, elige `onecore` o `sapi` antes de guardar
para que `voice.exe` sepa qué motor usar. Las opciones de línea de órdenes
siguen teniendo prioridad sobre los metadatos del mazo, pero no tienen
prioridad sobre `audio_generation=disabled`.

La herramienta escribe un archivo `audio-manifest.tsv` en el directorio de
audio. Usa ese manifiesto para omitir el audio cuyo texto de carta, voz
seleccionada y motor seleccionado no han cambiado. El audio registrado en el
manifiesto se considera gestionado por Cosimo y puede regenerarse o convertirse
al formato de salida seleccionado. Los archivos `.opus` y `.wav` existentes
sin seguimiento se consideran grabaciones del usuario y se dejan intactos; en
ese caso Cosimo no crea un archivo nuevo para ese lado de la carta, porque
podría ocultar el audio del usuario. `--dry-run`
muestra lo que se generaría sin escribir archivos.

## Archivos, copias de seguridad y mantenimiento

Haz copia de seguridad tanto del archivo del mazo como de su base de datos de
repaso correspondiente. El archivo del mazo contiene tus cartas, metadatos del
mazo y marcas de cartas no reversibles. La base de datos de repaso contiene el
estado de programación, valoraciones e historial de repaso.

Cosimo también crea copias automáticas del contenido del mazo. Antes de
sobrescribir un mazo existente, copia la versión actual en el directorio
`backups` de la aplicación, junto al ejecutable. Los archivos de copia tienen
números crecientes, por ejemplo `backups/000001-deck.cosimo-deck`. El archivo
`backups/index.txt` registra cada nombre de copia y la ruta del mazo original.

Configura las copias automáticas del mazo en `Herramientas -> Opciones`:

- `Completas`: conserva todas las copias automáticas del mazo.
- `Solo última`: conserva solo la copia automática más reciente de cada ruta de
  mazo original.
- `Ninguna`: no crea copias automáticas del mazo.

Configura las copias de la base de datos de repaso en
`Herramientas -> Opciones`:

- `Al comenzar sesión`: actualiza una copia retenida de la base de datos de
  repaso cuando comienza una sesión de estudio.
- `Desactivadas`: no crea ni actualiza copias de la base de datos de repaso.

Configura las copias completas automáticas en `Herramientas -> Opciones`:

- `Diarias`: cuando Cosimo arranca o abre un mazo, escribe una copia completa
  comprimida retenida si el mazo actual no tiene una copia completa de menos de
  24 horas. Esta copia incluye el archivo del mazo, el directorio auxiliar con
  el mismo nombre base y la base de datos de repaso. Solo se escribe después de
  abrir correctamente el mazo y pasar la comprobación de integridad de la base
  de datos.
- `Desactivadas`: no crea copias completas retenidas automáticamente.

Para el mazo predeterminado, copia:

- `decks/deck.cosimo-deck`
- `decks/deck.reviews.sqlite3`, si existe
- `decks/deck/`, si usas audio junto al mazo

Para otro mazo, la base de datos de repaso está junto al mazo y usa el mismo
nombre base. Por ejemplo, `spanish.cosimo-deck` usa
`spanish.reviews.sqlite3`; su directorio de audio, si existe, usa el mismo
nombre base que el mazo.

Cierra Cosimo antes de copiar o restaurar archivos de copia de seguridad.
Restaurar solo el archivo `.cosimo-deck` recupera las cartas, pero las deja sin
su historial de repaso anterior. Restaurar ambos archivos conserva las cartas y
su historial de programación.

Cosimo comprueba la integridad de la base de datos de repaso al abrir un mazo.
Si Cosimo indica que esa comprobación ha fallado, cierra Cosimo y restaura el
archivo `.reviews.sqlite3` correspondiente desde tu copia de seguridad.

Las copias automáticas del contenido del mazo contienen solo el texto del mazo, no el
historial de repaso. Para restaurar una, cierra Cosimo y copia la copia elegida
por encima del archivo `.cosimo-deck` activo. Para restaurar el historial de
programación, restaura el archivo `.reviews.sqlite3` correspondiente desde tu
propia copia de seguridad o desde la copia retenida de la base de datos de
repaso de Cosimo. Las copias automáticas del contenido del mazo y de la base de
datos de repaso no contienen audio junto al mazo. Las copias completas del mazo
sí contienen el directorio auxiliar; si no tienes una, restaura el audio desde
tu propia copia del directorio de audio.

Las copias completas automáticas son distintas: cuando están activadas, son
paquetes comprimidos retenidos que incluyen el mazo, el directorio auxiliar y
la base de datos de repaso. Sirven como red de seguridad diaria para el mazo
que estás usando, no como sustituto de las exportaciones manuales antes de
cambios arriesgados.

`Archivo -> Exportar mazo completo` escribe un paquete comprimido `.zip` con el
archivo `.cosimo-deck` actual y su directorio auxiliar con el mismo nombre base,
incluidos los archivos de audio y `audio-manifest.tsv` si existen. No incluye la
base de datos de repaso. Cosimo propone un nombre con fecha y hora y te permite
elegir dónde guardar el paquete. Usa esta exportación cuando quieras compartir
el contenido del mazo sin tu historial personal de estudio.

`Archivo -> Exportar mazo completo con historial` escribe el mismo paquete más
una instantánea consistente de la base de datos de repaso. Úsalo para mover tu
propio entorno de estudio a otro equipo o para hacer una copia manual completa.
El archivo contiene datos personales de estudio como programaciones,
valoraciones, historial de repaso, suspensiones, marcas y aplazamientos.

`Archivo -> Copia completa del mazo` escribe automáticamente el paquete de mazo
y directorio auxiliar en el directorio `backups` de la aplicación y lo registra
en `backups/deck-bundle-index.txt`. No incluye la base de datos de repaso.

La copia completa automática diaria opcional también escribe en `backups`, pero
usa `backups/automatic-deck-bundle-index.txt` y conserva una copia retenida por
ruta de mazo. Incluye la base de datos de repaso.

`Archivo -> Restaurar mazo completo` restaura uno de estos paquetes comprimidos
en el directorio `decks` de Cosimo. Cosimo comprueba primero el paquete y
muestra el nombre del archivo de mazo, el número de cartas, el número de
archivos de audio, el total de archivos y si el paquete contiene historial de
estudio. Si se van a sobrescribir archivos existentes, Cosimo avisa y escribe
una copia completa comprimida del mazo de destino antes de restaurar. Si se
sobrescribirían archivos auxiliares pero no existe un mazo de destino que pueda
copiarse, Cosimo rechaza la restauración en lugar de sobrescribirlos.

Restaurar un paquete puede causar pérdida de datos. Puede reemplazar texto de
cartas más reciente, audio auxiliar más reciente, un `audio-manifest.tsv` más
reciente o historial de programación y valoración más reciente en la base de
datos `.reviews.sqlite3`. Un paquete sin historial de estudio no restaurará
programación ni historial de valoraciones; un paquete con historial de estudio
reemplazará ese historial por la instantánea contenida en el zip. Cierra otros
programas que puedan estar usando el mismo mazo o base de datos de repaso antes
de restaurar.

`Mazo -> Sincronizar` usa la misma maquinaria de paquetes, pero almacena la
instantánea en el servidor de sincronización configurado en
`Herramientas -> Opciones`. Los servidores locales de desarrollo pueden usar
URL `http://`; los servidores desplegados deberían usar `https://`. Usa
`Mazo -> Sincronizar -> Iniciar sesión` para iniciar sesión en el servidor con
una cuenta compatible con Mastodon. Cosimo abre la URL de autorización en el
navegador, pide el código de autorización y guarda localmente la identidad de
sincronización y el token portador de sincronización de Cosimo. Por tanto,
trata el archivo local de configuración como privado.

El inicio de sesión compatible con Mastodon es deliberadamente limitado. La
instancia fediversa sólo pide autorizar el ámbito `read:accounts`, suficiente
para que el servidor de sincronización confirme qué cuenta ha iniciado sesión.
No permite leer mensajes privados, publicar estados, seguir cuentas ni actuar
como tú. El cliente de escritorio de Cosimo nunca recibe tu contraseña
fediversa ni el token de acceso fediverso. Ve la URL de la instancia, el código
de autorización que pegas, la identidad de sincronización verificada que
devuelve el servidor y el token portador de Cosimo que usará en las siguientes
peticiones de sincronización. El servidor de sincronización recibe el código de
autorización pegado, recibe brevemente un token de acceso fediverso de la
instancia, lo usa para llamar a `verify_credentials`, y después revoca ese token
fediverso temporal antes de emitir un token portador de Cosimo. El servidor
conserva la identidad de cuenta verificada, las credenciales de la aplicación
OAuth para la instancia, los paquetes de mazo que subas y un verificador con
hash del token portador de Cosimo; no guarda tu contraseña fediversa ni el
token de acceso fediverso. La instancia fediversa ve los metadatos de la
aplicación OAuth Cosimo Sync, la URL de sitio web de la aplicación registrada
por el servidor de sincronización y el intercambio breve de autenticación; no ve
tu token portador de Cosimo ni tus mazos.

`Mazo -> Sincronizar -> Cerrar sesión` borra la identidad de sincronización y
el token portador de Cosimo guardados en esta instalación de Cosimo y pide al
servidor que revoque el token portador de Cosimo cuando el servidor está
disponible; no elimina mazos remotos ni registros locales de revisión.

`Estado de sincronización` muestra el UUID del mazo, visibilidad, URL del
servidor, identidad propietaria, nombre local del dispositivo y el último
estado conocido de revisión y hashes. También comprueba el servidor configurado
e indica si hay una copia remota del UUID del mazo actual, su revisión,
visibilidad, identidad propietaria, si tiene historial de estudio y el último
dispositivo que hizo una subida. También muestra la información de cuota que
anuncia el servidor de sincronización. Sin iniciar sesión, esto se limita a
límites generales, como el máximo de mazos por propietario o límites de
almacenamiento. Con sesión iniciada, también muestra tu número actual de mazos
y tamaño de paquetes almacenados frente a esos límites. `Mazos remotos`
enumera los mazos encontrados en el servidor configurado. `Subir con historial
de estudio` sube el mazo, el directorio auxiliar y la base de datos de repaso.
`Descargar con historial de estudio` restaura la instantánea para el mismo
UUID de mazo y cuenta iniciada,
escribiendo una copia completa comprimida antes de sustituir archivos de mazo
existentes. Subir y descargar puede tardar si el mazo contiene audio, por lo
que Cosimo muestra un diálogo de progreso mientras la transferencia y la
restauración se ejecutan fuera del hilo principal de la interfaz. Esto es
sincronización por instantáneas, no mezcla: si dos equipos cambian el mismo
mazo de manera independiente, Cosimo detecta conflictos de revisión en lugar
de combinar los cambios. Si un equipo recién configurado indica un conflicto
al subir porque el mazo remoto ya tiene una revisión, descarga primero el mazo
sincronizado; eso registra la revisión remota localmente y permite comprobar
las subidas posteriores contra el estado remoto actual.

Cada mazo sincronizado tiene además un UUID. Si el servidor ya tiene ese UUID
bajo otra cuenta autenticada, Cosimo rechaza la subida en lugar de apropiarse
del mazo remoto. Si esto ocurre porque has descargado un mazo público o no
listado de otra persona y quieres mantener tu propia copia sincronizada, usa
`Mazo -> Editar metadatos del mazo -> Hacer copia independiente` y guarda. Cosimo
asigna un nuevo UUID de mazo, restablece la visibilidad a privado, conserva las
cartas, el audio y el historial de estudio local, y olvida el estado local de
sincronización del UUID anterior.

Usa `Herramientas -> Depurar base de datos de repaso` para eliminar
permanentemente filas inactivas de la base de datos de repaso correspondientes
a cartas que ya no están en el mazo actual y a cartas inversas generadas
inactivas. Se conservan las cartas activas, las cartas inversas generadas
activas, las programaciones actuales, las suspensiones actuales y las marcas
actuales. Las marcas de carta no reversible se guardan en el archivo del mazo,
no en la base de datos de repaso. Si las copias de la base de datos de repaso
están desactivadas, Cosimo avisa de que la depuración es irreversible. Si las
copias están activadas, Cosimo actualiza la copia retenida antes de depurar y
avisa de que la copia retenida se sobrescribirá. Después de eliminar las filas
inactivas, Cosimo compacta la base de datos para que el archivo SQLite pueda
recuperar espacio no usado.

Usa `Herramientas -> Recuperar espacio de base de datos` para ejecutar la misma
compactación SQLite sin eliminar datos de repaso inactivos. Esto reescribe el
archivo de base de datos de repaso y puede tardar en una base de datos grande.
Si las copias de la base de datos de repaso están activadas, esta orden no
sobrescribe la copia retenida; si están desactivadas, Cosimo te recuerda que
compruebes que tienes una copia si te preocupa.

Usa `Herramientas -> Opciones -> Eliminar copias antiguas` para conservar solo
la copia automática más reciente de cada ruta de mazo original. Cosimo pide
confirmación antes de eliminar o renumerar archivos de copia.

Usa `Herramientas -> Borrar directorio de copias` solo cuando quieras vaciar
deliberadamente el directorio `backups` de la aplicación. Cosimo avisa antes de
hacerlo porque la orden elimina todos los archivos y carpetas de ese
directorio, incluidos archivos que quizá no hayan sido generados ni registrados
por Cosimo. La orden conserva el directorio `backups`, pero Cosimo no puede
recuperar su contenido después de eliminarlo.

Para ayuda paso a paso sobre recuperación, consulta
[Solución de problemas](troubleshooting-es.md).

## Accesibilidad

Cosimo está diseñado para usarse con teclado y lector de pantalla. La mayoría
de acciones de estudio pueden completarse sin abrir menús:

- las teclas numéricas `1` a `4` eligen valoraciones de confianza antes de la
  respuesta y valoraciones de recuerdo después de la respuesta
- la tecla Espacio muestra la respuesta sin registrar una valoración de
  confianza
- `0` termina antes de tiempo una sesión normal de estudio
- `e` edita la carta actual después de revelar la respuesta
- `Ctrl+D` aplaza la carta actual antes de revelar la respuesta
- `Ctrl+F` marca o desmarca la carta actual
- `Ctrl+P` reproduce o detiene el audio de carta disponible

La pantalla inicial también tiene órdenes directas de teclado para acciones
comunes:

- `Alt-M` comienza la sesión programada
- `Alt-F` fuerza el comienzo con cartas disponibles
- `Alt-X` comienza un examen
- `Alt-Z` comienza un cuestionario
- `Ctrl+L` abre el panel de aprendizaje
- `Alt+Enter` abre detalles de la carta seleccionada

El audio de repaso puede usarse manual o automáticamente. Cuando el audio
automático durante el estudio está activado, los tonos guía opcionales dan
señales sin voz: un tono corto antes del audio de pregunta, dos tonos cortos antes del
audio de respuesta y un arpegio de tres notas cuando se muestra el resumen del
repaso. Los exámenes cronometrados también usan tonos para marcar el progreso
del tiempo y los agotamientos de tiempo.

El panel de aprendizaje está dividido en secciones de solo lectura separadas
para que los usuarios de lector de pantalla puedan tabular entre resumen,
distribución, carga de trabajo, diagnósticos y actividad en vez de leer un solo
campo largo. El panel también tiene botones `Guardar informe` y
`Copiar al portapapeles` para revisar el informe completo fuera del diálogo.

La barra de estado principal informa del estado del mazo y del tiempo de repaso
con expresiones breves y cómodas para síntesis de voz. Las fechas programadas
en los detalles de carta incluyen duraciones relativas antes de las fechas y
horas UTC exactas, porque los tiempos relativos son más fáciles de entender con
voz.

Problema conocido: cuando entras en la lista de preguntas con Tab o Shift+Tab,
algunas combinaciones de lector de pantalla y wxWidgets anuncian el elemento
seleccionado dos veces. Una vez dentro de la lista, la navegación con flechas
debería funcionar normalmente.

## Opciones e idiomas

Configura el mínimo de cartas por sesión en `Herramientas -> Opciones`. El
diálogo de opciones también puede configurar sonidos de disponibilidad de
repasos, audio de repaso, tonos guía, audio de corrección/revisión de examen,
la regla de recuerdo usada por la calibración del panel de aprendizaje, copias
del mazo y de la base de datos de repaso, idioma y minimización al área de
notificación.

Las notificaciones sonoras pueden configurarse como `Siempre`,
`Cuando Cosimo esté visible`, `Cuando Cosimo esté en el área de notificación` o
`Nunca`. Cuando la política elegida permite sonido, Cosimo reproduce un sonido
breve si la actualización temporizada de la pantalla inicial detecta que hay
repasos disponibles, o que hay más repasos disponibles desde la última
actualización automática. Los cambios provocados por el usuario, como añadir o
eliminar cartas, y las actualizaciones manuales con `F5` no reproducen este
sonido. Cosimo también permanece en silencio mientras hay una sesión de estudio
activa, aunque pasen a estar pendientes más cartas durante esa sesión.

Con la minimización al área de notificación activada, usar la acción normal de
minimizar la ventana oculta Cosimo en el área de notificación en vez de dejarlo
en la barra de tareas. Activar el icono del área de notificación restaura la
ventana, y el menú contextual del icono contiene Restaurar y Salir. Cerrar
Cosimo sigue saliendo de la aplicación.

Cosimo admite actualmente inglés, español y gallego. Cambia el idioma en
`Herramientas -> Opciones`. El idioma elegido se guarda y se usa la próxima
vez. Si todavía no se ha guardado ningún idioma, Cosimo usa español cuando la
configuración regional del sistema es española, gallego cuando es gallega, y en
caso contrario usa inglés. Las configuraciones regionales desconocidas también
usan inglés.

Las traducciones se mantienen en archivos `.po` de estilo gettext, con una
pequeña cantidad de código de conexión para cada idioma nuevo. Si quieres
trabajar en una traducción, contacta primero con David Picón Álvarez en
`@modulux@node.isonomia.net` para coordinar el trabajo.

El menú `Ayuda` abre la guía local de usuario, la wiki del proyecto y la página
de nuevo ticket para informar de errores. Los informes de errores se gestionan
mediante tickets de Fossil en el sitio del proyecto.

## Consejos

- Haz preguntas concretas. Una carta debe preguntar una sola cosa.
- Evita preguntas duplicadas. Hacen ambiguo el mazo; usa el filtro de preguntas
  duplicadas y `Mazo -> Resolver enunciados duplicados` si una edición manual
  las crea.
- Mantén las respuestas lo bastante cortas como para poder juzgarlas de forma
  consistente.
- Las respuestas duplicadas están bien, pero solo una carta de un grupo con la
  misma respuesta puede tener una carta inversa generada activa.
- Usa `Forzar comienzo` para practicar más, no como sustituto de la sesión
  programada.
- Si una carta resulta confusa, edítala antes de la siguiente sesión. Si
  encuentras una errata o una respuesta incorrecta después de mostrar la carta,
  edítala antes de valorar el recuerdo.
- Usa `0` cuando quieras terminar una sesión antes de tiempo; tus intentos
  completados se guardan igualmente.

## ¿Por qué se llama Cosimo?

Cosimo recibe su nombre en honor a Cosimo Piovasco di Rondò, el protagonista de
la novela *El barón rampante*, de Italo Calvino. El Cosimo de Calvino es un
notorio polímata y políglota, lo que hace que su nombre encaje con una
herramienta de estudio.
