Esta guía cubre pasos habituales de recuperación para las versiones beta portables de Cosimo.

Antes de cambiar archivos

Cierra Cosimo antes de copiar, sustituir o eliminar archivos de mazo y bases de datos de repaso. La base de datos de repaso es un archivo SQLite, y cerrar Cosimo evita copiarla mientras hay una escritura en curso.

Para el mazo predeterminado, los archivos principales son:

• decks/deck.cosimo-deck
• decks/deck.reviews.sqlite3
• cosimo.ini
• backups/index.txt
• backups/review-db-index.txt

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.

Errores al leer el mazo

Si Cosimo no puede leer un mazo, abre el archivo .cosimo-deck en un editor de texto y comprueba los separadores de las cartas:

• --- separa la pregunta de la respuesta.
• =número= termina una carta y conserva su historial de repaso.
• Los finales de carta antiguos === se aceptan, pero Cosimo los actualiza a finales numerados cuando puede abrir y guardar el mazo.

Cada carta necesita una pregunta no vacía y una respuesta no vacía. Si una pregunta o una respuesta contiene accidentalmente una línea separadora por sí sola, Cosimo la interpreta como estructura del mazo, no como texto de la carta.

Restaurar el texto de las cartas

Las copias automáticas del mazo contienen solo texto de cartas. No contienen historial de repaso.

Para restaurar texto de cartas:

1. Cierra Cosimo.
2. Abre backups/index.txt.
3. Busca el archivo de copia cuya ruta original coincida con el mazo que quieres restaurar.
4. Copia ese archivo de copia encima del archivo .cosimo-deck activo.
5. Inicia Cosimo otra vez.

Si también necesitas el historial de programación, restaura el archivo .reviews.sqlite3 correspondiente desde una copia de seguridad externa o desde la copia retenida de la base de datos de repaso de Cosimo.

Errores de integridad y coherencia de la base de datos

Cosimo comprueba la base de datos de repaso con SQLite cuando abre un mazo. Si la base de datos falla la comprobación de integridad, Cosimo se detiene antes de migrar o escribir el mazo.

Cosimo también comprueba si la base de datos de repaso es lógicamente coherente con el mazo que se está abriendo. Por ejemplo, rechaza enlaces rotos a repasos de una pasada, valores almacenados de valoración o programación que no son válidos, y cartas reversibles activas cuya respuesta está duplicada por otra carta activa. El historial antiguo de cartas eliminadas, incluidas cartas inversas eliminadas, puede permanecer inactivo.

Para recuperarla:

1. Cierra Cosimo.
2. Localiza la base de datos de repaso activa. Para el mazo predeterminado es decks/deck.reviews.sqlite3.
3. Si el error menciona una respuesta duplicada en una carta reversible, edita el mazo para que la respuesta de la carta reversible activa sea única, o restaura una versión del mazo anterior a la duplicación. Si Cosimo todavía puede abrir el mazo, el filtro Respuestas duplicadas de la lista inicial puede ayudar a encontrar las cartas en conflicto.
4. Para otros errores de integridad o coherencia, aparta el archivo .reviews.sqlite3 dañado.
5. Restaura un archivo .reviews.sqlite3 correcto.
6. Inicia Cosimo otra vez.

Si las copias de la base de datos de repaso están activadas, backups/review-db-index.txt relaciona el archivo de copia retenida con la ruta de la base de datos original. Copia la copia correspondiente encima del archivo .reviews.sqlite3 dañado.

Si no tienes ninguna copia utilizable de la base de datos de repaso, puedes eliminar el archivo .reviews.sqlite3 dañado. Cosimo creará una base de datos de repaso nueva, pero se perderán las valoraciones anteriores, la programación y el historial de repaso.

El audio de repaso no se reproduce

El audio de repaso por ahora solo admite archivos WAV. Comprueba que Archivo -> Opciones -> Audio durante los repasos no esté configurado como Sin audio, y que el archivo esté en el directorio con el mismo nombre base junto al mazo.

Por ejemplo, la carta 1 de decks/Indonesian.cosimo-deck usa:

• decks/Indonesian/1.prompt.wav
• decks/Indonesian/1.response.wav

Las cartas inversas generadas reutilizan esos archivos con pregunta y respuesta intercambiadas. Cosimo no crea ni copia automáticamente estos archivos de audio. El modo examen usa por ahora el audio de la pregunta mientras respondes, pero no reproduce el audio de la respuesta durante la corrección del examen ni durante la revisión de respuestas de un examen exacto.

Opciones de copia de seguridad

Las copias del mazo se configuran en Archivo -> Opciones:

• Completas conserva todas las copias automáticas del contenido del mazo.
• Solo la última conserva solo la copia automática más reciente del contenido del mazo para cada ruta de mazo original.
• Ninguna desactiva las copias automáticas del contenido del mazo.

Las copias de la base de datos de repaso se configuran por separado:

• Al comenzar sesión actualiza una copia retenida de la base de datos de repaso cuando comienza una pasada.
• Desactivadas desactiva las copias de la base de datos de repaso.

La copia retenida de la base de datos de repaso es independiente de las copias numeradas del contenido del mazo.

Estado de ejecución

Cosimo guarda el estado portable de la aplicación en cosimo.ini, junto al ejecutable. Este archivo contiene opciones y la ruta del último mazo abierto.

Las versiones beta antiguas usaban cosimo-settings.txt y cosimo-last-open-deck.txt. Si Cosimo encuentra cualquiera de esos archivos, escribe su contenido en cosimo.ini y después elimina los archivos antiguos.

Si Cosimo abre el mazo equivocado al iniciarse, cierra Cosimo y edita o elimina la entrada last_open_deck en cosimo.ini.

Archivos bloqueados o de solo lectura

Si Cosimo no puede guardar un mazo, un archivo de opciones, un informe, una copia de seguridad o un cambio en la base de datos de repaso:

• Asegúrate de que el archivo no esté abierto en otro programa.
• Comprueba que la carpeta permita escritura.
• En instalaciones portables, evita ejecutar Cosimo desde una ubicación de solo lectura.
• Cierra Cosimo antes de copiar archivos desde decks o backups.

Cosimo bloquea las sobrescrituras del mazo cuando fallan las copias obligatorias del mazo o la escritura del índice de copias. Si esto ocurre, corrige el problema de permisos del archivo o de la carpeta e intenta editar la carta otra vez.

Si no se puede registrar una respuesta durante un repaso, Cosimo deja la carta actual en la pasada para que la respuesta no se pierda en silencio. Si no se puede registrar el resumen de la pasada, es posible que las respuestas de las cartas individuales sí se hayan guardado, pero que falten datos para análisis posteriores por pasada.

Cosimo se inicia sin poder abrir un mazo

Si Cosimo se inicia sin ningún mazo abierto, el mensaje inicial debería indicar el archivo de mazo y la base de datos de repaso que intentó usar. Esto puede ocurrir cuando no se puede crear la carpeta decks predeterminada, no se puede leer el mazo seleccionado, o no se puede abrir o crear la base de datos de repaso.

Para recuperarte:

1. Cierra Cosimo.
2. Comprueba que se pueda escribir en la carpeta indicada y que no esté en un medio de solo lectura.
3. Cierra otros programas que puedan estar usando el mazo o la base de datos de repaso indicados.
4. Si la base de datos de repaso está dañada y tienes una copia, restáurala.
5. Inicia Cosimo otra vez, o abre otro mazo.

Notas para lectores de pantalla

La lista de preguntas de la pantalla inicial puede anunciar dos veces el elemento seleccionado con algunas combinaciones de lector de pantalla y wxWidgets. Es un comportamiento conocido del control nativo. Una vez que el foco está dentro de la lista, la navegación con las flechas debería funcionar normalmente.

Informes de errores

Cuando informes de un problema, incluye:

• Versión de Cosimo.
• Versión del sistema operativo.
• Lector de pantalla y versión, si el problema afecta a la accesibilidad.
• Si el mazo es el predeterminado u otra ruta de mazo.
• El mensaje de error exacto.
• Si existen cosimo.ini, backups/index.txt o backups/review-db-index.txt.
• Los pasos que llevaron al problema.