Guía de usuario de Cosimo

Cosimo axúdache a estudar pares de pregunta e resposta con repetición espazada. Está deseñado para usarse co teclado e con lectores de pantalla.

Que significa repetición espazada

A repetición espazada é un método de estudo baseado en repasar o material con intervalos cada vez maiores.

Cando algo é novo, difícil ou se fallou hai pouco, debe volver pronto. Cando algo é fácil e se recorda de forma constante, pode esperar máis tempo. O obxectivo é dedicar máis tempo ao material que necesita atención e menos tempo a repetir o que xa está asentado.

Cosimo rexistra as túas valoracións despois de cada repaso e usa ese historial para decidir que cartas están pendentes.

Instalación e actualización

Cosimo é unha aplicación portable. Para instalalo, descomprime o ficheiro zip da versión publicada no cartafol desde o que queiras executar Cosimo e despois inicia cosimo.exe desde ese cartafol.

Para actualizar, pecha Cosimo, descomprime o novo zip sobre o cartafol existente de Cosimo e permite que se sobrescriban os ficheiros do programa. Os paquetes publicados non deberían sobrescribir datos de usuario como cosimo.ini, mazos persoais, bases de datos de repaso, informes ou copias de seguridade, nin directorios de audio xunto ao mazo. Mantén copias de seguridade normais antes de actualizar, sobre todo se gardas os teus propios mazos ou gravacións no cartafol da aplicación.

Mazos

Un mazo é un ficheiro que contén cartas. Os ficheiros de mazo de Cosimo usan a extensión .cosimo-deck.

Podes editar cartas dentro de Cosimo ou editar directamente o ficheiro do mazo nun editor de texto. O ficheiro do mazo garda preguntas, respostas, metadatos do mazo e marcas de cartas, como o estado non reversible. O historial de repaso e as valoracións gárdanse por separado.

Os ficheiros de mazo tamén conteñen un pequeno marcador numerado ao final de cada carta, como =1=. Deixa ese número no seu sitio cando edites á man. Permite que Cosimo conserve o historial de repaso da carta aínda que cambies o texto da pregunta ou da resposta. Cando Cosimo abre un mazo antigo, garda unha copia de seguranza do orixinal segundo a configuración de copias do mazo e actualiza o ficheiro ao formato actual.

Usa Arquivo -> Propiedades do mazo para ver a versión do formato do mazo e os campos de metadatos opcionais: título, autoría, descrición e URL. Usa Arquivo -> Editar metadatos do mazo para editar eses campos de metadatos.

Cosimo pode usar un directorio co mesmo nome base xunto ao ficheiro do mazo para audio de repaso opcional en formato WAV. Por exemplo, Indonesian.cosimo-deck pode usar un directorio Indonesian con ficheiros como 1.prompt.wav e 1.response.wav. Cosimo le eses ficheiros durante o repaso ordinario, e le o audio da pregunta mentres respondes preguntas de exame, se o audio está activado. As copias automáticas de Cosimo non inclúen ficheiros de audio. A ferramenta de xeración de audio pode escribir e sobrescribir ficheiros neste directorio, así que conserva copias separadas de calquera gravación creada por ti.

O mazo predeterminado é decks/deck.cosimo-deck, xunto ao executable de Cosimo. En instalacións portables de Windows, garda os teus mazos no cartafol decks xunto á aplicación. Se falta o mazo predeterminado, Cosimo crea un baleiro. Podes abrir outro mazo desde Arquivo -> Abrir mazo. Se escolles un ficheiro de mazo que non existe, Cosimo pregunta se queres crear alí un mazo baleiro.

Cando Cosimo se pecha, recorda o último mazo aberto e volve abrilo a próxima vez. Tamén conserva ata oito mazos abertos recentemente en Arquivo -> Mazos recentes, omitindo o mazo actual. Se só hai outro mazo recente, Cosimo móstrao directamente no menú Arquivo, sen colocalo nun submenú. Garda isto e outras opcións da aplicación en cosimo.ini, xunto ao executable. Cosimo tamén recorda o filtro e o modo de ordenación da lista de cartas. Se Cosimo atopa ficheiros antigos cosimo-settings.txt ou cosimo-last-open-deck.txt, mígraos a cosimo.ini e elimina os ficheiros antigos.

O cadro de opcións tamén permite configurar avisos sonoros de dispoñibilidade de repasos, audio de repaso, a regra de recordo usada pola calibración do panel de aprendizaxe e a minimización á área de notificación. Os avisos sonoros poden configurarse como Sempre, Cando Cosimo estea visible, Cando Cosimo estea na área de notificación ou Nunca. Cando a política escollida permite son, Cosimo reproduce un son breve se a actualización automática da pantalla inicial detecta que hai repasos dispoñibles, ou que hai máis repasos dispoñibles que na última actualización automática. Os cambios feitos pola persoa usuaria, como engadir ou eliminar cartas, e as actualizacións manuais con F5 non reproducen este son. Cosimo tamén permanece en silencio mentres hai unha pasada de repaso activa, aínda que haxa máis cartas que pasen a estar dispoñibles durante esa pasada. Coa minimización á área de notificación activada, a acción normal de minimizar a xanela oculta Cosimo na área de notificación en vez de deixalo na barra de tarefas. Activar a icona da área de notificación restaura a xanela, e o menú contextual da icona contén Restaurar e Saír. Pechar Cosimo segue saíndo da aplicación.

Axuda e ligazóns do proxecto

O menú Axuda abre a guía de usuario local, a wiki do proxecto e a páxina de tickets novos para informar de erros. Os informes de erro xestiónanse mediante tickets de Fossil no sitio do proxecto.

Copias de seguridade

Fai copia de seguridade tanto do ficheiro do mazo como da súa base de datos de repasos correspondente. O ficheiro do mazo contén as túas cartas, metadatos do mazo e marcas de cartas non reversibles. A base de datos de repasos contén a programación, as valoracións e o historial de repaso.

Cosimo tamén crea copias automáticas do contido do mazo. Antes de sobrescribir un mazo existente, copia a versión actual no directorio backups da aplicación, xunto ao executable. Os ficheiros de copia usan números crecentes, por exemplo backups/000001-deck.cosimo-deck. O ficheiro backups/index.txt rexistra cada nome de copia e a ruta do mazo orixinal.

Usa Arquivo -> Limpar base de datos de repaso para eliminar de forma permanente filas inactivas da base de datos de repaso correspondentes a cartas que xa non están no mazo actual e a cartas inversas xeradas que están inactivas. Consérvanse as cartas activas, as cartas inversas xeradas activas, os calendarios actuais, as suspensións actuais e as marcas actuais de cartas marcadas. As marcas de carta non reversible gárdanse no ficheiro do mazo, non na base de datos de repaso. Se as copias da base de datos de repaso están desactivadas, Cosimo avisa de que a limpeza é irreversible. Se as copias están activadas, Cosimo actualiza a copia retida da base de datos de repaso antes de limpar e avisa de que esa copia retida se sobrescribirá. Despois de eliminar as filas inactivas, Cosimo executa unha limpeza da base de datos para que o ficheiro SQLite poida recuperar espazo sen usar.

Usa Arquivo -> Recuperar espazo da base de datos para executar a mesma limpeza SQLite sen eliminar datos de repaso inactivos. Isto reescribe o ficheiro de base de datos de repaso e pode tardar un tempo nunha base de datos grande. Se as copias da base de datos de repaso están activadas, Cosimo non sobrescribe a copia retida con este comando; se as copias están desactivadas, Cosimo recórdache que comprobes que tes unha copia se che preocupa.

Para outro mazo, a base de datos de repasos está xunto ao mazo e usa o mesmo nome base. Por exemplo, galician.cosimo-deck usa galician.reviews.sqlite3; o seu directorio de audio, se existe, usa o mesmo nome base que o mazo.

Pecha Cosimo antes de copiar ou restaurar ficheiros de copia de seguridade. Restaurar só o ficheiro .cosimo-deck recupera as cartas, pero déixaas sen o seu historial de repaso anterior. Restaurar ambos ficheiros conserva as cartas e o seu historial de programación.

Cosimo comproba a integridade da base de datos de repasos ao abrir un mazo. Se Cosimo indica que esa comprobación fallou, pecha Cosimo e restaura o ficheiro .reviews.sqlite3 correspondente desde a túa copia de seguridade.

As copias automáticas do mazo conteñen só o texto do mazo, non o historial de repaso. Para restaurar unha, pecha Cosimo e copia a copia escollida por riba do ficheiro .cosimo-deck activo. Para restaurar o historial de programación, restaura o ficheiro .reviews.sqlite3 correspondente desde a túa propia copia de seguridade ou desde a copia retida da base de datos de repasos de Cosimo. As copias automáticas do mazo e da base de datos de repasos non conteñen audio xunto ao mazo; restaura o audio desde a túa propia copia do directorio de audio.

Usa Arquivo -> Opcións -> Eliminar copias antigas para conservar só a copia automática máis recente de cada ruta de mazo orixinal. Cosimo pide confirmación antes de eliminar ou renumerar ficheiros de copia.

Pantalla inicial

Se o mínimo de cartas por sesión fai que Cosimo engada cartas adicionais que aínda non están pendentes, o reconto de cartas programadas tamén mostra entre parénteses cantas están pendentes. Por exemplo, Programadas agora: 10 (6 pendentes) significa que a pasada incluiría 6 cartas pendentes e 4 cartas adicionais para chegar ao mínimo.

A barra de estado da xanela principal tamén ofrece un resumo breve: cartas totais, cartas pendentes agora, e se hai un repaso pendente agora ou canto falta aproximadamente para o próximo repaso programado. As duracións redondéanse cara arriba a unidades cómodas para voz sintetizada, como 2 días, 4 semanas ou 3 meses.

Mentres a pantalla inicial está aberta, Cosimo actualiza o resumo, os filtros da lista e a barra de estado aproximadamente unha vez por minuto. Unha carta que pase a estar pendente mentres a aplicación está aberta quedará dispoñible para Comezar sen pechar e volver abrir o mazo.

Podes engadir, editar ou eliminar cartas antes de comezar unha pasada. Despois de mostrar unha carta durante o repaso, tamén podes editar esa carta actual se atopas un erro na pregunta ou na resposta. Cartas -> Editar carta seleccionada cambia a Cartas -> Editar carta actual nese momento. Ao engadir unha soa carta, o editor tamén ten unha caixa Marcar como non reversible. Déixaa sen marcar para unha carta normal; márcaa cando a carta non deba usarse nunca para xerar unha carta inversa.

Para introducir varias cartas seguidas, usa Cartas -> Engadir cartas en bloque. Escribe a pregunta e a resposta, e preme Ctrl+Enter desde calquera dos dous campos para engadir a carta e volver ao campo de pregunta. Ao premer Tab desde o campo de resposta tamén se engade a carta e vólvese ao campo de pregunta cando ambos campos conteñen texto. Preme Escape para pechar o diálogo de entrada en bloque. A entrada en bloque non mostra a caixa de carta non reversible, para manter breve o fluxo de entrada repetida.

O diálogo de detalles de carta mostra a pregunta, a resposta, o ID de carta, o estado actual da carta, o número de repasos, o último repaso, o estado de programación, o próximo repaso programado e o historial de repasos da carta seleccionada. O estado de carta combina nunha soa liña marcas visibles como suspendida, marcada, adiada, inversa, ten inversa e non reversible. As cartas inversas xeradas mostran o ID de carta da carta principal, porque editar a carta principal no mazo tamén cambia a súa dirección inversa xerada. Os campos de data do resumo, como último repaso, último repaso da programación e próximo repaso programado, móstranse primeiro como unha duración relativa completa, como 1 día, 1 hora, 1 minuto, 1 segundo, seguida da data e hora UTC exacta entre parénteses. As datas pasadas usan a mesma duración relativa completa coa forma hai .... A lista de historial de repasos do final usa só datas e horas UTC exactas.

Usa Arquivo -> Panel de aprendizaxe, ou preme Ctrl+L, para mostrar un resumo de aprendizaxe de todo o mazo. Informa de varios tipos de datos:

A sección de recordo é unha estimación do modelo de programación de Cosimo, non un resultado medido directamente. Para cada carta activa con datos de programación que non estea suspendida nin adiada, Cosimo usa a hora do último repaso, a estabilidade almacenada e o intervalo programado real para estimar a probabilidade de que recordes a carta agora. As cartas novas sen datos de programación, as cartas suspendidas e as cartas adiadas nese momento non se inclúen nesta estimación. As cartas en aprendizaxe e reaprendizaxe usan o seu intervalo curto programado como punto efectivo do 90%, de modo que unha carta pendente tras un paso curto por fallo non pareza máis segura do que é.

Dispoñibles agora conta as cartas activas non suspendidas nin adiadas que se poden repasar inmediatamente. Isto inclúe cartas novas e cartas programadas cuxa hora de repaso xa chegou. Programadas e atrasadas é o reconto máis estreito de cartas programadas non suspendidas nin adiadas cuxa hora de repaso xa está no pasado, así que non inclúe cartas novas sen programación.

Recordo medio estimado é a media desas estimacións por carta. Cartas probablemente sabidas conta as cartas estimadas cun recordo do 90% ou máis. Cartas en risco conta as cartas estimadas por baixo do 70% de recordo. Estes números son máis útiles para orientar prioridades e observar tendencias que como promesa de que se responderá correctamente exactamente esa porcentaxe de cartas na próxima pasada.

A sección de calibración trata a túa predición antes de ver a resposta como un intervalo obxectivo de se recordarás a resposta, non como unha porcentaxe precisa. Non o sei significa un obxectivo de recordo do 0-5%, Probablemente non o sei do 5-32%, Probablemente o sei do 68-95%, e Seino con seguridade do 95-100%. O intervalo central queda deliberadamente sen cubrir; revela sen valoración de confianza se non queres facer unha predición. A regra de recordo configúrase en Arquivo -> Opcións. A regra laxa conta Difícil, Ben e Fácil como recordadas, mentres que Repetir conta como non recordada. A regra estrita só conta Ben e Fácil como recordadas. O panel mostra a regra activa antes das cifras de calibración. O intervalo de recordo obxectivo é a media dos intervalos obxectivo para as valoracións de confianza respondidas. A taxa de recordo observada é o que ocorreu realmente coa regra de recordo actual. A calibración está dentro do intervalo se o recordo observado cae dentro do intervalo obxectivo, mostra falta de confianza se o recordo observado está por enriba do intervalo, e exceso de confianza se está por baixo. As liñas por confianza mostran a mesma comparación para cada valoración de confianza. As cartas mostradas sen predición cóntanse por separado.

A sección de actividade de repaso baséase en eventos de repaso rexistrados e resumos de pasadas. Respostas almacenadas conta respostas individuais almacenadas. Días con respostas conta días UTC con polo menos unha resposta rexistrada. Os recontos de pasadas, respostas e tempo etiquetados como pasadas rexistradas veñen de resumos de pasadas completadas. Se hai datos antigos anteriores aos resumos de pasadas, o panel mostra Respostas anteriores sen tempo de pasada para non confundir o total de respostas almacenadas co total menor de pasadas con tempo. Esa liña ocúltase cando o valor é cero.

Usa o botón Gardar informe do panel para gardar o texto actual do panel no directorio reports. O nome do informe usa o nome do mazo e a hora UTC na que se abriu o panel, e o informe inclúe as rutas completas do mazo e da base de datos de repaso.

Se o mazo ten cartas inversas xeradas, o panel mostra por separado cartas estándar, cartas inversas e cartas totais, porque unha dirección pode ser moito máis fácil que a outra.

Usa Ver -> Orde do mazo, Ver -> Próximo repaso programado ou Ver -> Último repaso, Ver -> Texto da pregunta, Ver -> Texto da resposta ou Ver -> Recordo estimado para escoller como se ordena a lista de preguntas. Usa Ver -> Ascendente ou Ver -> Descendente para escoller a dirección. As opcións marcadas do menú Ver mostran o criterio e a dirección actuais. Último repaso usa descendente por defecto, poñendo primeiro as cartas repasadas máis recentemente e deixando as cartas novas ao final; último repaso ascendente pon primeiro as cartas repasadas hai máis tempo e tamén deixa as cartas novas ao final. Recordo estimado usa a mesma estimación de programación que o panel de aprendizaxe; recordo estimado ascendente pon primeiro as cartas que se estiman menos probables de lembrar e deixa ao final as cartas sen estimación, como as novas. O filtro de texto reduce a lista buscando na pregunta ou na resposta. O cadro combinado de filtro controla que tipo de cartas se mostran, incluídas cartas marcadas, preguntas duplicadas, respostas duplicadas, cartas non reversibles e cartas adiadas. Os seus recontos seguen o filtro de texto actual. O filtro de respostas duplicadas é especialmente útil antes de facer cartas reversibles.

Evita as preguntas duplicadas. Unha pregunta debería identificar unha soa carta. Cosimo rexeita as accións normais de engadir e editar que crearían unha pregunta duplicada. Se editas un mazo á man e introduces preguntas duplicadas, Cosimo abre o mazo cun aviso. Usa o filtro Preguntas duplicadas para atopalas, ou usa Cartas -> Resolver enunciados duplicados para escoller a resposta que se conservará para cada pregunta duplicada; as outras cartas con esa pregunta elimínanse do mazo, e os seus datos de repaso quedan inactivos salvo que se depure a base de datos de repaso.

As respostas duplicadas si están permitidas. A miúdo son útiles cando distintas preguntas comparten a mesma resposta. A restrición só afecta ás cartas inversas xeradas: de cada grupo de cartas coa mesma resposta, como máximo unha carta pode ter unha carta inversa xerada activa. Se houbese máis dunha, as cartas inversas xeradas terían a mesma pregunta e xa non estaría claro que carta orixinal se está preguntando. Cosimo impide crear ou editar cartas inversas cando iso produciría esa ambigüidade. Marca unha carta como non reversible se a súa resposta compartida non debería usarse nunca como pregunta inversa.

Usa Cartas -> Suspender carta seleccionada, o menú contextual da lista de preguntas, ou Ctrl+S cando a lista de preguntas teña o foco, para conservar a carta no mazo pero impedir que apareza en pasadas normais ou forzadas. A lista de preguntas marca as cartas suspendidas con (suspendida). As cartas suspendidas poden atoparse co filtro Cartas suspendidas e reactivarse desde o mesmo menú, menú contextual ou atallo. As cartas suspendidas tamén se ignoran cando a barra de estado indica se hai unha pasada pendente agora ou cando será o próximo repaso.

Usa Cartas -> Adiar carta seleccionada ata mañá, ou o menú contextual da lista de preguntas, para pospoñer temporalmente a carta seleccionada sen cambiar a súa programación almacenada. Unha carta adiada permanece no mazo e volve automaticamente cando vence o adiamento. Mentres está adiada, márcase con (adiada), aparece no filtro Cartas adiadas, e queda excluída de pasadas programadas, pasadas forzadas, recontos da pantalla inicial e cálculos de pendentes na barra de estado. Usa Cartas -> Quitar adiamento da carta seleccionada, ou o menú contextual, para facela dispoñible de novo inmediatamente.

Durante unha pasada de repaso, antes de mostrar a resposta, usa Ctrl+D ou o botón Adiar carta ata mañá para pospoñer a carta actual e continuar. O adiamento non está dispoñible despois de mostrar a resposta. Se todas as cartas da pasada se adían antes de rexistrar ningunha resposta, Cosimo mostra un aviso indicando que non se repasou ningunha carta.

Usa Cartas -> Marcar carta seleccionada, o menú contextual da lista de preguntas, ou Ctrl+F cando a lista de preguntas teña o foco para marcar ou desmarcar a carta seleccionada. Durante unha pasada de repaso, Ctrl+F marca ou desmarca a carta actual. A pantalla de repaso tamén ten un botón para marcar ou desmarcar despois dos botóns de confianza e despois dos botóns de recordo. As marcas serven para revisión manual posterior: úsaas cando unha carta poida necesitar edición, resulte confusa ou ambigua, teña unha resposta dubidosa ou requira atención despois da pasada. Marcar unha carta non afecta á programación nin a se a carta aparece no repaso. As cartas marcadas aparecen con (marcada) na lista de preguntas e poden atoparse co filtro Cartas marcadas.

Usa Repasar marcadas na pantalla inicial, ou Cartas -> Repasar cartas marcadas, para iniciar unha pasada non programada só con cartas marcadas. Esta pasada inclúe cartas marcadas estean programadas ou non, pero exclúe as cartas suspendidas ou adiadas. A orde é aleatoria, e a pasada non quita as marcas; quita as marcas manualmente cando esas cartas xa non requiran revisión. O botón está desactivado cando non hai cartas marcadas dispoñibles para repasar.

Usa Cartas -> Facer carta seleccionada reversible, ou preme Ctrl+R cando a lista de preguntas teña o foco, para engadir unha carta inversa xerada. Unha carta inversa pregunta pola resposta orixinal e espera a pregunta orixinal. As cartas inversas teñen o seu propio estado de programación e historial de repasos. Cosimo impide facer reversible unha carta cando outra carta coa mesma resposta xa ten unha carta inversa xerada activa, porque a pregunta inversa sería ambigua. As cartas inversas márcanse con (inversa) na lista de preguntas e poden atoparse co filtro Cartas inversas. Eliminar unha carta inversa elimina só a dirección inversa xerada; non elimina a carta principal. Os datos de repaso da carta inversa permanecen na base de datos e volven usarse se fas reversible de novo a carta principal. Cando unha carta inversa xerada está seleccionada, o menú de cartas e o menú contextual ofrecen eliminar esa dirección inversa, non marcar a carta principal como non reversible.

Usa Cartas -> Marcar carta seleccionada como non reversible cando unha carta non deba ter unha dirección inversa xerada. Isto escribe unha marca no ficheiro do mazo, elimina calquera carta inversa xerada activa desa carta principal e impide que Facer cartas reversibles aptas a volva engadir máis adiante. Usa Cartas -> Permitir inverter a carta seleccionada para quitar esa marca. A carta volve ser apta para inversión manual ou en bloque, sempre que a súa resposta non estea xa usada por outra carta inversa xerada activa. As cartas non reversibles aparecen con (non reversible) na lista de preguntas, poden atoparse co filtro Cartas non reversibles, e mostran a marca non reversible na liña de estado dos detalles da carta. Cando unha carta non reversible está seleccionada, os menús ofrecen permitir inverter de novo esa carta, non crear unha carta inversa directamente.

Usa Cartas -> Facer cartas reversibles aptas para marcar como reversibles nunha soa operación todas as cartas que poidan selo. Cosimo pide confirmación e indica cantas cartas poden cambiarse. Exclúense as cartas que xa son reversibles, as cartas marcadas como non reversibles e as cartas cuxo grupo de respostas xa ten unha carta inversa xerada activa. Se as copias da base de datos de repaso están activadas, esta operación actualiza a copia conservada antes de escribir, e a confirmación avisa de que esa copia conservada se sobrescribirá.

Usa Cartas -> Desfacer última reversión en bloque para eliminar só as cartas inversas creadas pola última reversión en bloque. Consérvanse as cartas inversas creadas manualmente e os lotes anteriores. As cartas orixinais e o historial de repaso inverso permanecen na base de datos.

Eliminar unha carta principal tamén elimina a súa carta inversa xerada da lista de preguntas, porque a carta inversa deriva da carta principal. Os datos de repaso inverso permanecen na base de datos, pero só volven ser útiles se restauras unha copia de seguranza do mazo que conteña a carta principal orixinal.

Problema coñecido: cando entras na lista de preguntas co tabulador ou con maiúsculas+tabulador, algunhas combinacións de lector de pantalla e wxWidgets anuncian dúas veces o elemento seleccionado. Unha vez dentro da lista, a navegación coas frechas debería funcionar normalmente.

Comezar unha pasada

Comezar usa a programación. Repasa primeiro as cartas pendentes. Se hai menos cartas pendentes que o mínimo de cartas por sesión configurado, Cosimo engade cartas adicionais ao azar desde o resto do mazo.

Forzar comezo ignora a programación. Pon todas as cartas non suspendidas nin adiadas nunha orde aleatoria. Úsao cando queiras estudar aínda que non haxa cartas pendentes, ou cando queiras unha sesión de práctica máis longa.

Comezar exame toma unha mostra do mazo activo en vez de usar a programación. As cartas suspendidas e adiadas exclúense. Cosimo pregunta se debe escoller un número de preguntas ou unha porcentaxe das cartas activas, e despois escolle e ordena esas cartas ao azar para reducir as pistas producidas pola orde do mazo.

Durante un exame, Cosimo mostra cada pregunta e pídeche que escribas a resposta. Non mostra a corrección mentres o exame está en curso. As respostas exactas contan como correctas automaticamente. Ao final, para cada resposta que non foi unha coincidencia exacta, Cosimo mostra a pregunta, a túa resposta e a resposta esperada, e pregunta se a resposta debe contar como correcta.

Se a caixa Exacto está marcada ao comezar o exame, as respostas non exactas non se corrixen manualmente. Contan como incorrectas, e Cosimo mostra cada unha para revisión coa pregunta, a túa resposta e a resposta esperada. Escolle Seguinte ou preme Alt-N para seguir revisando respostas inexactas, ou escolle Resumo para ir directamente ao resumo do exame.

O modo exame actualmente só produce un informe. Non rexistra eventos de repaso, non cambia a programación das cartas e non engade respostas falladas ao final da mesma pasada. Isto é deliberado: a primeira versión é unha ferramenta de avaliación, non outra entrada para a programación.

Durante unha pasada normal, preme 0 para rematala antes de tempo. Durante unha pasada de exame, escolle Rematar exame para parar despois das respostas enviadas ata ese momento. Se non se enviou ningunha resposta, Cosimo mostra un aviso.

Antes de ver a resposta

Cando se mostra unha pregunta, podes valorar que probabilidade cres que tes de saber a resposta:

Tamén podes escoller Mostrar resposta, ou premer Espazo, para mostrar a resposta sen rexistrar unha predición. Isto gárdase como Sen responder nas estatísticas da pasada.

Valorar despois de ver a resposta

Despois de valorar a túa predición, ou de mostrar directamente a resposta, Cosimo mostra a resposta. Entón valora o que ocorreu realmente:

Esta valoración do recordo é o que Cosimo usa de forma máis directa para programar a carta.

Se atopas un erro despois de mostrar a resposta, escolle Editar carta, usa Cartas -> Editar carta actual, ou preme e. Cosimo abre o mesmo editor que se usa no resto da aplicación, garda o texto da carta e volve ao paso de valoración posterior á resposta. A decisión de programación tómase só cando escollas a valoración do recordo.

Audio de repaso

O audio de repaso é opcional e polo momento só admite ficheiros WAV. Configúrao en Arquivo -> Opcións -> Audio durante os repasos:

A opción separada Tons guía para o audio automático de repaso engade sinais breves cando o audio automático está activado: un ton curto antes do audio da pregunta, dous tons curtos antes do audio da resposta e un arpexio de tres notas cando aparece o resumo do repaso. A opción está desactivada por defecto.

Ctrl+P activa a mesma acción de reproducir/deter cando o audio de repaso está dispoñible. Na lista de cartas preparadas, Ctrl+P ou o botón Reproducir/deter audio previsualiza a carta seleccionada reproducindo o audio da pregunta e despois o audio da resposta. Pasar á carta seguinte, mostrar a resposta, rematar a pasada ou pechar a xanela detén inmediatamente calquera audio de carta que se estea reproducindo. En modo exame, o audio da pregunta está dispoñible mentres respondes a pregunta; o audio da resposta aínda non se usa durante a corrección do exame.

Os ficheiros de audio viven no directorio co mesmo nome base xunto ao mazo. Para a carta 1 de Indonesian.cosimo-deck, usa Indonesian/1.prompt.wav para o lado de pregunta e Indonesian/1.response.wav para o lado de resposta. As cartas inversas xeradas reutilizan os ficheiros da carta principal con pregunta e resposta intercambiadas.

As copias automáticas do mazo e da base de datos de repasos non inclúen ficheiros de audio xunto ao mazo. Se gravas ou editas os teus propios WAV, fai copia do directorio de audio antes de usar Arquivo -> Xerar audio ou voice --overwrite.

Os paquetes de Windows tamén inclúen voice.exe, unha ferramenta para xerar estes ficheiros WAV usando voces OneCore ou SAPI instaladas. Execútase desde unha consola. Por exemplo, se voice.exe está xunto a cosimo.exe, este comando le decks/Indonesian.cosimo-deck e escribe ficheiros de audio en decks/Indonesian/:

voice Indonesian --prompt-voice "nome de voz en indonesio" --response-voice "nome de voz en inglés"

Tamén podes usar Arquivo -> Xerar audio desde Cosimo despois de abrir un mazo. Esta opción só está dispoñible cando o mazo ten metadatos de Voz da pregunta, Voz da resposta, Motor de voz da pregunta e Motor de voz da resposta, para que Cosimo non xere audio silenciosamente cunha voz predeterminada incorrecta do sistema. Se a opción está desactivada, usa Arquivo -> Editar metadatos do mazo para escoller esas voces e motores. Mostra un diálogo de progreso mentres voice.exe traballa sobre o mazo actual, e escribe a saída da ferramenta nun ficheiro de texto do directorio reports. A opción do menú non sobrescribe audio existente salvo que o manifesto indique que cambiou o texto de carta xerado, a voz seleccionada ou o motor seleccionado. Se aínda non existe manifesto, os WAV seleccionados existentes rexenéranse unha vez para que o novo manifesto reflicta o texto actual da carta, a voz seleccionada e o motor seleccionado. Se xa existe un manifesto pero un ficheiro de audio individual non ten entrada, ese ficheiro non se modifica e engádese ao manifesto para que poidan detectarse cambios posteriores no texto da carta, na voz ou no motor. Ao rematar, Cosimo informa de cantas cartas tiveron audio xerado, cantos ficheiros de audio eran novos, cantos se rexeneraron porque cambiou o texto da carta, a voz ou o motor, cantos ficheiros sen seguimento se rexeneraron para crear un manifesto ausente, cantos ficheiros existentes se engadiron ao manifesto, e cantos ficheiros se omitiron.

Esta política de rexeneración está pensada para audio producido por voice.exe. Se gravaches ou editaches manualmente un ficheiro cuxo nome coincide cun lado dunha carta seleccionada, unha edición posterior do mazo ou un cambio de voz pode facer que Arquivo -> Xerar audio sobrescriba esa gravación. Usa --dry-run primeiro se tes dúbidas, e conserva a túa propia copia de seguridade das gravacións antes de xerar audio.

Usa voice --list-voices para ver as voces instaladas. Usa --engine onecore ou --engine sapi para listar ou xerar cun motor concreto; --prompt-engine e --response-engine poden seleccionar motores distintos para os dous lados. Para aprender idiomas, escolle unha voz que corresponda ao idioma de cada lado: se as preguntas están en indonesio e as respostas en inglés, usa unha voz en indonesio para as preguntas e unha voz en inglés para as respostas. Se ambos lados están no mesmo idioma, --voice "nome de voz" usa a mesma voz para ambos.

Os metadatos do mazo tamén poden gardar filtros de voz e motores de voz predeterminados. Configura Voz da pregunta, Voz da resposta, Motor de voz da pregunta e Motor de voz da resposta en Arquivo -> Editar metadatos do mazo, ou engade prompt_voice=, response_voice=, prompt_voice_engine= e response_voice_engine= á cabeceira do mazo. voice.exe usa eses valores predeterminados cando non se indica a opción correspondente na liña de ordes. Cando voice.exe está dispoñible xunto a cosimo.exe, o editor de metadatos mostra as voces instaladas para o motor seleccionado. Os campos de voz seguen sendo editables, así que podes escribir un filtro manualmente se o listado falla ou se queres usar un valor que non aparece na lista. O selector de motor pode listar voces de OneCore, voces de SAPI, ou ambas; cando escolles unha voz da lista, Cosimo garda automaticamente o motor correspondente. Se escribes ou editas un filtro de voz manualmente, escolle onecore ou sapi antes de gardar para que voice.exe saiba que motor usar. As opcións de liña de ordes seguen tendo prioridade sobre os metadatos do mazo.

A ferramenta escribe un ficheiro audio-manifest.tsv no directorio de audio. Usa ese manifesto para omitir o audio cuxo texto de carta, voz seleccionada e motor seleccionado non cambiaron, e para rexenerar ficheiros cando algún deles cambiou. Os ficheiros de audio existentes sen entrada no manifesto rexenéranse se non existe ningún manifesto; se xa existe un manifesto, déixanse intactos na execución actual, pero engádense ao manifesto para que poidan detectarse cambios futuros. Usa --overwrite se queres actualizar inmediatamente todos os ficheiros seleccionados. --dry-run mostra que se xeraría sen escribir ficheiros.

Como funciona a programación

Cosimo garda cada repaso completado na base de datos de repasos. Para cada carta, consulta o historial de repaso e estima cando debe volver a carta.

Cosimo usa un algoritmo de programación de estilo FSRS. Segue a dificultade e a estabilidade de cada carta. As respostas correctas repetidas fan que a carta sexa máis estable e alongan o intervalo, mentres que as respostas falladas ou incorrectas devolven a carta cara á aprendizaxe. As cartas marcadas como Repetir prográmanse cun paso curto de aprendizaxe ou reaprendizaxe, tras uns 10 minutos. Tamén aparecen unha vez máis ao final da pasada actual. Cando varias cartas necesitan repetirse, esas repeticións ordénanse ao azar. Se a repetición se volve marcar como Repetir, rexístrase con normalidade, pero non se engade outra vez á mesma pasada.

O intervalo exacto é automático. Non necesitas xestionar datas pola túa conta.

O mínimo de cartas por sesión controla cantas cartas intenta incluír Cosimo cando premes Comezar. Por exemplo:

O mínimo non é un máximo. As cartas pendentes non se ocultan só porque haxa máis que o mínimo.

Cando empeza unha pasada, as cartas pendentes en aprendizaxe e reaprendizaxe aparecen antes que as cartas normais de repaso. Despois veñen as cartas novas. Dentro dos grupos de aprendizaxe/reaprendizaxe e repaso, aparecen primeiro as cartas que levan máis tempo pendentes. As cartas coa mesma data pendente, ou con datas pendentes separadas por aproximadamente unha hora ou menos, ordénanse ao azar dentro dese grupo. As cartas novas tamén se ordenan ao azar, para que as cartas engadidas por grupos temáticos non se repasen na orde do mazo.

Estatísticas

As cartas adiadas antes de mostrar a resposta non contan como preguntas respondidas nas estatísticas da pasada.

As pasadas de exame mostran un resumo de exame separado. Indica o número de preguntas seleccionadas, respostas enviadas, respostas correctas e porcentaxe, coincidencias exactas, respostas non exactas aceptadas, respostas incorrectas, tempo total, tempo por pregunta, e se o exame rematou antes de tempo. Os resumos de exame non cambian a base de datos de repaso.

Escolle Gardar informe para escribir unha copia en texto dun resumo de pasada normal ou de exame no directorio reports xunto ao executable. Cosimo crea o directorio se fai falta. Os nomes de informe normais usan o nome do ficheiro do mazo sen a súa extensión e a hora UTC en que rematou a pasada; por exemplo, Indonesian-2026-05-03-06-04.txt. Os informes de exame engaden -exam, por exemplo Indonesian-exam-2026-05-03-06-04.txt. Se xa existe un informe con ese nome, Cosimo engade un sufixo numérico en vez de sobrescribilo. O texto do informe inclúe a ruta completa do mazo.

Idiomas e traducións

Cosimo admite actualmente inglés, español e galego. Cambia o idioma en Arquivo -> Opcións.

A elección de idioma gárdase e úsase a próxima vez. Se aínda non se gardou ningún idioma, Cosimo usa español cando a configuración rexional do sistema é española, galego cando é galega e, nos demais casos, usa inglés. As configuracións rexionais descoñecidas tamén usan inglés.

As traducións mantéñense en ficheiros .po de estilo gettext, con algúns cambios pequenos no código fonte para cada idioma novo. Se queres traballar nunha tradución, contacta primeiro con David Picón Álvarez en @modulux@node.isonomia.net para coordinar o traballo.