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 con teclado e lector de pantalla.

Inicio rápido

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 da aplicación. Os paquetes publicados non deberían sobrescribir datos de usuario como cosimo.ini, mazos persoais, bases de datos de repaso, informes, directorios de audio xunto ao mazo ou copias de seguridade.

Cando Cosimo se inicia, abre o último mazo usado. Nunha instalación nova, normalmente é decks/deck.cosimo-deck, xunto ao executable. Usa Arquivo -> Abrir mazo para abrir outro ficheiro .cosimo-deck. Se o ficheiro de mazo non existe, Cosimo pregunta se queres crealo.

Para engadir material, usa Carta -> Engadir carta para unha soa carta, ou Carta -> Engadir cartas en bloque para introducir varias seguidas. Unha carta ten unha pregunta, que é a cuestión ou pista que ves primeiro, e unha resposta, que é a solución coa que te comprobas. Mantén preguntas concretas e evita preguntas duplicadas.

A pantalla inicial mostra un resumo, unha lista de preguntas de cartas e unha barra de estado. A barra de estado indica as cartas totais, as cartas dispoñibles agora, e se hai unha sesión programada pendente ou canto falta aproximadamente para a próxima. A pantalla inicial actualízase aproximadamente unha vez por minuto. Preme F5 para actualizala manualmente.

Usa Comezar para executar a sesión programada. Durante unha sesión normal de estudo, Cosimo mostra primeiro a pregunta. Podes valorar a túa predición:

Tamén podes escoller Mostrar resposta, ou premer Espazo, para mostrar a resposta sen rexistrar unha predición. Despois de mostrar a resposta, escolle a valoración de recordo:

A valoración de recordo é o que Cosimo usa de forma máis directa para programar a carta. Preme 0 durante unha sesión normal de estudo para rematala antes de tempo. Os intentos completados gárdanse igualmente.

Usa Forzar comezo para practicar máis cando queiras ignorar a programación. Usa Estudar marcadas para cartas que marcases para atención manual. Usa Comezar exame para unha proba con respostas escritas a partir dunha mostra aleatoria, e Comezar cuestionario para practicar con respostas de opción múltiple. As sesións de exame e cuestionario son só informativas: non cambian a programación de repetición espazada.

Despois de estudar, Cosimo mostra un resumo. Escolle Gardar informe para escribir un informe de texto no directorio reports, ou Continuar para volver á pantalla inicial.

Organización dos menús

Como estuda cartas Cosimo

A repetición espazada é un método de estudo baseado en repasar o material a intervalos crecentes. Cando algo é novo, difícil ou se fallou recentemente, debería volver pronto. Cando algo é fácil e se recorda de forma consistente, pode esperar máis. O obxectivo é dedicar máis tempo ao material que precisa atención e menos a repetir o que xa está seguro.

Cosimo rexistra as túas respostas e valoracións, e usa ese historial para decidir que cartas están pendentes.

Cosimo conserva expresións como base de datos de repaso, historial de repaso, repaso programado e audio de repaso para partes establecidas da aplicación. Nesas expresións, repaso refírese ao proceso máis amplo de repetición espazada ou ao historial de estudo almacenado, non necesariamente a unha sesión enteira.

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

Cosimo usa un algoritmo de programación FSRS-6. 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 usan pasos curtos automáticos: as cartas novas normalmente usan pasos de aprendizaxe de 1 minuto e 10 minutos, e as cartas en estado de repaso marcadas como Repetir usan un paso de reaprendizaxe de 10 minutos. As cartas marcadas como Repetir non se repiten automaticamente ao final da sesión actual; Cosimo espera ata que venza o paso de aprendizaxe ou reaprendizaxe programado.

Os catro botóns de recordo teñen as mesmas etiquetas en todos os estados, pero o seu efecto de programación depende de se o elemento de estudo é novo, está en aprendizaxe, en repaso, ou en reaprendizaxe:

Os mazos estudados por primeira vez con versións beta antigas poden conter filas de programación existentes do algoritmo anterior, de estilo FSRS, de Cosimo. As versións actuais migran esas filas derivadas de programación reproducindo o historial de repaso almacenado co programador FSRS-6 actual. Isto non elimina o historial de repaso, pero as datas pendentes e os diagnósticos de recaídas do panel poden cambiar unha vez cando unha base de datos de repaso antiga se abre cunha compilación de Cosimo máis recente.

En termos de programación, unha recaída é máis específica que calquera resposta Repetir. Significa que unha carta que xa chegara ao estado de repaso se marcou como Repetir e pasou a reaprendizaxe. Repetir cando unha carta é nova, está en aprendizaxe, ou xa está en reaprendizaxe rexístrase como resposta, pero non engade outra recaída programada.

O intervalo exacto é automático. Non precisas xestionar datas manualmente. Para cartas ordinarias en estado de repaso, Cosimo pode variar lixeiramente e de forma determinista os intervalos máis longos. Isto evita que as cartas volvan agruparse sempre na mesma data futura. Os pasos curtos de aprendizaxe e reaprendizaxe non se varían.

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 sesión, 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.

As cartas útiles son concretas e non ambiguas. Unha pregunta debería pedir unha soa cousa, e a resposta esperada debería ser o bastante breve como para poder xulgala de forma consistente. Evita preguntas duplicadas: unha pregunta debería identificar unha soa carta. As respostas duplicadas están ben, pero as cartas inversas xeradas esixen coidado adicional porque unha resposta duplicada se convertería nunha pregunta inversa duplicada.

Cartas e 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. Se engades cartas novas á man, remata cada carta nova con === no canto de inventar un marcador numerado. Cosimo escollerá un ID seguro e sen usar a próxima vez que abra o mazo. Usa =i= no canto de === para unha carta engadida á man que non deba ser reversible. Cosimo tamén pode escribir next_card_id nos metadatos do mazo; déixao no seu sitio, porque evita que as cartas novas reutilicen IDs antigos despois dunha limpeza. Cando Cosimo abre un mazo antigo, garda unha copia de seguridade do orixinal segundo a configuración de copias do mazo e actualiza o ficheiro ao formato actual.

Usa Mazo -> Propiedades do mazo para ver a versión do formato do mazo e os campos opcionais de metadatos, como título, autor, descrición, URL, voces escollidas e se a xeración automática de audio está desactivada. Usa Mazo -> Editar metadatos do mazo para editar eses campos de metadatos. O mesmo diálogo contén a visibilidade do mazo para sincronización: público, non listado ou privado. A URL do servidor de sincronización, a sesión de sincronización e o nome local do dispositivo son axustes da aplicación en Ferramentas -> Opcións e Mazo -> Sincronizar, porque identifican esta instalación de Cosimo e a conta usada, non só un mazo concreto.

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 esta 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 inicial. Se atopa ficheiros antigos cosimo-settings.txt ou cosimo-last-open-deck.txt, mígraos a cosimo.ini e elimina os ficheiros antigos.

Engadir e editar cartas

Usa Carta -> Engadir carta para engadir unha carta. O editor ten campos de pregunta e resposta. 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 Carta -> 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.

Usa Carta -> Editar carta seleccionada para editar a carta seleccionada desde a lista inicial. Despois de revelar unha carta durante unha sesión de estudo, esta orde cambia a Carta -> Editar carta actual. Tamén podes escoller Editar carta ou premer e nese momento. 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ó despois de escoller a valoración de recordo.

Usa Delete ou Carta -> Eliminar carta seleccionada para eliminar a carta seleccionada do mazo. 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 da carta inversa permanecen na base de datos, pero só volven ser útiles se restauras unha copia de seguridade do mazo que conteña a carta principal orixinal.

Usa Alt+Enter, Carta -> Detalles da carta ou o menú contextual da lista de preguntas para mostrar detalles e estatísticas da carta seleccionada.

Preguntas e respostas duplicadas

Evita 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 Mazo -> 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 limpe a base de datos de repaso. Durante a resolución de duplicados, Saltar enunciado deixa a pregunta duplicada actual sen cambios e continúa con preguntas duplicadas posteriores. Cancelar resolución detén o proceso por completo. As preguntas xa resoltas permanecen cambiadas.

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.

Cartas reversibles e non reversibles

Usa Carta -> Engadir carta inversa, 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 Carta -> Marcar carta seleccionada como non reversible cando unha carta non deba ter 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 aptas reversibles a volva engadir máis adiante. Usa Carta -> Retirar marca de carta non reversible 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 de detalles da carta. Cando unha carta non reversible está seleccionada, os menús ofrecen retirar a marca de carta non reversible, non crear unha carta inversa directamente.

Usa Mazo -> Facer cartas aptas reversibles 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 retida antes de escribir e a confirmación avisa de que esa copia retida se sobrescribirá.

Usa Mazo -> 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 principais e o historial de repaso inverso permanecen na base de datos.

Suspender, adiar e marcar cartas

Usa Carta -> 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 sesións 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 un repaso pendente agora ou cando será o próximo repaso.

Usa Carta -> 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 caduca o adiamento. Mentres está adiada, aparece con (adiada), móstrase no filtro Cartas adiadas e queda excluída de sesións programadas, sesións forzadas, recontos da pantalla inicial e cálculos de pendentes na barra de estado. Usa Carta -> Quitar adiamento da carta seleccionada, ou o menú contextual, para facela dispoñible de novo inmediatamente.

Durante unha sesión de estudo, 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 sesión se adían antes de rexistrar ningunha resposta, Cosimo mostra un aviso indicando que non se estudou ningunha carta.

Usa Carta -> 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 sesión de estudo, Ctrl+F marca ou desmarca a carta actual. A pantalla de estudo tamén ten un botón para marcar ou desmarcar en ambas fases, despois dos botóns de valoración correspondentes. Marcar serve para seguimento manual: úsao cando unha carta poida necesitar edición, resulte confusa ou ambigua, teña unha resposta dubidosa ou requira atención despois da sesión. Marcar unha carta non afecta á programación nin a se a carta aparece no estudo normal. As cartas marcadas aparecen con (marcada) na lista de preguntas e poden atoparse co filtro Cartas marcadas.

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 programadas tamén mostra entre parénteses cantas están pendentes. Por exemplo, Programadas agora: 10 (6 pendentes) significa que a sesión incluiría 6 cartas pendentes e 4 cartas adicionais para chegar ao mínimo.

A barra de estado da xanela principal dá 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 síntese de voz, como 2 días, 4 semanas ou 3 meses. Durante unha sesión, a barra de estado cambia ao contexto da sesión, como sesión de estudo programada, sesión de estudo non programada, exame ou cuestionario, co progreso actual.

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.

Usa Ver -> Orde do mazo, Ver -> Próximo repaso programado, 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. Os elementos marcados do menú Ver mostran o criterio e a dirección actuais. Cando escolles outro criterio de ordenación, Cosimo restablece a dirección ao valor por defecto dese criterio. Último repaso usa descendente por defecto, poñendo primeiro as cartas estudadas máis recentemente e deixando as cartas novas ao final; último repaso ascendente pon primeiro as cartas estudadas 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, cartas adiadas, cartas problemáticas, problemas de asimetría, fallos con confianza alta e acertos con confianza baixa. Os seus recontos seguen o filtro de texto actual. O filtro de respostas duplicadas é especialmente útil antes de facer cartas reversibles.

O menú Cartas tamén pode actuar sobre as cartas que se mostran actualmente na lista inicial. Usa Marcar todas as cartas visibles ou Desmarcar todas as cartas visibles para marcar todo un conxunto filtrado para revisión manual, por exemplo todas as cartas problemáticas antes de escoller Estudar marcadas. Suspender todas as cartas visibles e Quitar suspensión de todas as cartas visibles funcionan do mesmo xeito. Cosimo pide confirmación e indica cantas cartas visibles cambiarán realmente; as cartas que xa estean no estado pedido déixanse sen cambios.

O filtro Cartas problemáticas mostra elementos de estudo activos que parecen inusualmente difíciles no mazo actual. Espera ata que un elemento teña polo menos 4 intentos, e usa o comportamento de repaso en vez de simplemente a idade da carta. Unha carta pode aparecer aí se polo menos 2 dos seus últimos 5 intentos foron Repetir, se a súa taxa vitalicia de Repetir está no 20% máis alto do mazo e é polo menos 25%, se os seus lapsos programados por intento están no 20% máis alto do mazo e son polo menos 20%, ou se a súa dificultade de programación está no 20% máis alto do mazo e é polo menos 8 na escala de dificultade FSRS de 1 a 10. As cartas suspendidas e actualmente adiadas non se mostran aí.

O filtro Problemas de asimetría é para cartas reversibles. Cando ambas direccións teñen polo menos 4 intentos e unha dirección é substancialmente máis débil, o filtro mostra o elemento de estudo máis débil. Cosimo compara unha taxa de recordo estrita lixeiramente suavizada, onde só Ben e Fácil contan como recordadas, e considera substancial unha diferenza de 30 puntos porcentuais ou máis. Isto é útil cando, por exemplo, ver unha palabra indonesia e recordar o galego é fácil, pero producir a palabra indonesia desde o galego segue sendo pouco fiable.

Os filtros Fallos con confianza alta e Acertos con confianza baixa usan intentos recentes con valoración de confianza. Fallos con confianza alta mostra elementos de estudo activos onde escolliches recentemente Probablemente o sei ou Seguro que o sei, pero despois respondiches sen recordar a resposta segundo a regra activa de recordo de calibración; abonda co último intento con confianza, ou polo menos 2 dos últimos 5 intentos con confianza. Acertos con confianza baixa mostra elementos de estudo activos onde polo menos 2 dos últimos 5 intentos con confianza foron Non o sei ou Probablemente non o sei seguidos dunha resposta que conta como recordada segundo a regra activa de recordo de calibración. Coa regra permisiva, Difícil, Ben e Fácil contan como recordadas; coa regra estrita, só Ben e Fácil. As cartas suspendidas e actualmente adiadas non se mostran en ningún dos dous filtros.

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 intentos, o último intento, o estado de programación, a dispoñibilidade, o recordo estimado agora, o recordo recente, o resumo de recaídas e o historial de intentos da carta seleccionada. O estado de carta combina nunha soa liña marcas visibles como suspendida, marcada, adiada, inversa, ten inversa e non reversible. A dispoñibilidade explica se unha carta é nova, está programada para máis tarde, está lista para un repaso programado ordinario ou espera un paso de aprendizaxe ou reaprendizaxe. Cando hai unha hora programada, a liña de dispoñibilidade inclúe tanto o tempo relativo como a data e hora UTC exacta.

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 intento e última actualización de programación, móstranse primeiro como duración relativa completa, por exemplo 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 seguida de atrás. A lista de historial de intentos do final usa só datas e horas UTC exactas.

Sesións de estudo

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 en 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.

Estudar marcadas inicia unha sesión non programada só con cartas marcadas. Esta sesión inclúe cartas marcadas estean programadas ou non, pero exclúe as cartas suspendidas ou adiadas. A orde é aleatoria, e a sesión non quita as marcas; quita as marcas manualmente cando esas cartas xa non requiran seguimento. O botón está desactivado cando non hai cartas marcadas dispoñibles para estudar.

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 no resumo da sesión.

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 é o que Cosimo usa de forma máis directa para programar a carta. A mesma valoración de recordo pode ter un efecto de programación distinto segundo se a carta aínda está nun paso curto de aprendizaxe ou xa chegou ao estado de repaso ordinario; consulta Como estuda Cosimo as cartas para máis detalles.

Se atopas un erro despois de mostrar a resposta, escolle Editar carta, usa Carta -> 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ó despois de escoller a valoración de recordo.

Se unha sesión antiga, ou un modo de estudo futuro, contén preguntas repetidas para o mesmo elemento de estudo, Cosimo mostra a distinción máis detallada entre cartas únicas, preguntas respondidas, tempo por pregunta e tempo por carta única. Os modos de estudo actuais normais non repiten as cartas valoradas como Repetir na mesma sesión. Unha carta e a súa dirección inversa xerada contan como cartas estudadas distintas.

As cartas adiadas antes de mostrar a resposta non contan como preguntas respondidas no resumo da sesión.

Escolle Gardar informe para escribir unha copia de texto do resumo dunha sesión normal 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 sesión, por exemplo Indonesian-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.

Exames e cuestionarios

Comezar exame toma unha mostra do mazo activo en vez de usar a programación. As cartas suspendidas e adiadas exclúense. Cosimo pídeche que escollas un número de preguntas ou unha porcentaxe de cartas activas, e despois selecciona e ordena as cartas ao azar para reducir as pistas producidas pola orde do mazo.

Se o mazo ten cartas inversas xeradas, a configuración do exame inclúe unha opción de dirección de estudo: só normal, só inversa ou ambas. Se o mazo non ten cartas inversas xeradas, esta opción queda oculta e o exame usa a dirección normal.

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.

Se a caixa Exame cronometrado está marcada, introduce un número enteiro de minutos para o exame. O tempo restante móstrase na barra de estado. Cosimo reproduce un ton moi breve en cada límite do 10% do tempo. Cando se esgota o tempo, calquera texto que estea no campo de resposta envíase, reprodúcense catro tons curtos, e Cosimo mostra un aviso de tempo esgotado co número de respostas enviadas. O aviso empeza coa mensaxe enfocada; usa Tab ata Seguinte para continuar á corrección, á revisión de respostas ou ao resumo.

Cando un exame que non se esgotou por tempo remata con polo menos unha resposta enviada, Cosimo reproduce dous tons longos e mostra un aviso de Exame rematado antes da corrección, da revisión de respostas ou do resumo. Isto dá ás persoas que dependen do audio do exame un límite claro entre responder preguntas e comprobar respostas.

Durante unha sesión de exame, escolle Rematar exame para parar despois das respostas enviadas ata ese momento. Se non se enviou ningunha resposta, Cosimo mostra un aviso.

As sesións de exame mostran un resumo de exame separado. Informa de preguntas seleccionadas, respostas enviadas, respostas correctas e porcentaxe correcta, coincidencias exactas, respostas non exactas aceptadas, respostas incorrectas, tempo total, tempo por pregunta, se o exame rematou antes de tempo e se se esgotou o tempo dun exame cronometrado. Os resumos de exame non cambian a base de datos de repaso. Escolle Gardar informe para escribir unha copia de texto do resumo de exame no directorio reports. Os nomes de informe de exame engaden -exam, por exemplo Indonesian-exam-2026-05-03-06-04.txt.

Comezar cuestionario tamén é non programado e só informativo. Está pensado para practicar recoñecemento con opcións múltiples, por exemplo para preparar probas externas con preguntas de tipo cuestionario. Cosimo toma unha mostra aleatoria de cartas activas e exclúe as cartas suspendidas e adiadas. Salvo que o tamaño solicitado do cuestionario o faga imposible, evita poñer as dúas direccións da mesma carta reversible nun mesmo cuestionario, para que unha pregunta non dea pistas sobre a dirección contraria.

Se o mazo ten cartas inversas xeradas, a configuración do cuestionario inclúe unha opción de dirección de estudo: só normal, só inversa ou ambas. Se o mazo non ten cartas inversas xeradas, esta opción queda oculta e o cuestionario usa a dirección normal.

Durante un cuestionario, Cosimo mostra a pregunta e unha lista de respostas posibles. Escolle unha resposta e envíaa. A corrección non se mostra ata o final. Despois do cuestionario, Cosimo mostra cada resposta enviada coa pregunta e a resposta escollida. Se a resposta escollida era incorrecta, tamén mostra a resposta correcta. Escolle Seguinte ou preme Alt-N para avanzar pola revisión de respostas, ou escolle Resumo para ir directamente ao resumo de cuestionario. O modo cuestionario non rexistra intentos, non cambia a programación das cartas e non engade respostas falladas ao final da mesma sesión. Necesita polo menos catro opcións de resposta distintas na dirección de estudo actual, de modo que as preguntas directas toman as opcións das respostas e as preguntas invertidas tómanas dos enunciados. Os enunciados de cartas marcadas como non reversibles non se usan como opcións para preguntas invertidas.

As sesións de cuestionario mostran un resumo de cuestionario con preguntas seleccionadas, respostas enviadas, respostas correctas e incorrectas, porcentaxe correcta, tempo total, tempo por pregunta e se o cuestionario rematou antes de tempo. Os resumos de cuestionario non cambian a base de datos de repaso. Escolle Gardar informe para escribir unha copia de texto do resumo de cuestionario no directorio reports. Os nomes de informe de cuestionario engaden -quiz, por exemplo Indonesian-quiz-2026-05-03-06-04.txt.

Panel de aprendizaxe

Usa Estudo -> Panel de aprendizaxe, ou preme Ctrl+L, para mostrar un resumo de aprendizaxe de todo o mazo. O panel está dividido en seccións de só lectura separadas para que poidas tabular entre resumo, distribución, carga de traballo, diagnósticos e actividade en vez de ler un só campo longo. 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 estudar inmediatamente. Isto inclúe cartas novas, que Cosimo pode poñer nunha sesión de estudo inmediatamente, e cartas con datos de programación existentes cuxa hora de repaso xa chegou. Destas, xa programadas e pendentes agora é un subconxunto de Dispoñibles agora: só conta cartas dispoñibles con datos de programación existentes. Usa o mesmo límite temporal que Dispoñibles agora, así que unha carta pendente no instante exacto en que se xerou o panel queda incluída. O panel pon Dispoñibles agora primeiro porque é a cifra operativa: cantas cartas se poden estudar agora.

Recordo medio estimado é a media desas estimacións por carta. O panel tamén mostra a mediana e as cartas estimadas máis febles para que unha media non oculte un grupo pequeno de material débil. A media das cartas máis febles é a media do recordo estimado do 10% inferior de cartas activas con estimación, redondeado cara arriba para incluír polo menos unha carta. Probablemente sabidas conta as cartas estimadas cun recordo do 90% ou máis. Maiormente estables é 70-89%, Fráxiles é 50-69%, e Moi baixo é menos do 50%. Cartas en risco conta xuntas as bandas fráxil e moi baixa. Estes números úsanse mellor para triaxe e tendencias, non como promesa de que responderás correctamente exactamente esa porcentaxe de cartas na próxima sesión.

A previsión de carga mostra cantas cartas activas están programadas agora e dentro das próximas 24 horas, 3 días, 7 días e 30 días. Estes recontos son acumulativos: unha carta dispoñible agora tamén se inclúe nos horizontes posteriores. As cartas suspendidas e adiadas exclúense. Cando Cosimo ten tempos de sesión rexistrados, a previsión tamén estima o tempo de estudo a partir do tempo medio actual por carta única estudada. É só unha estimación: reflicte intentos repetidos de sesións rexistradas anteriores, pero non pode saber cantos pasos de aprendizaxe ou reaprendizaxe vencerán durante unha sesión futura.

A sección Resumo describe a forma da carga dos próximos 7 días só cando se prevén polo menos 5 cartas. Se polo menos a metade da carga de 7 días vence en 24 horas, Cosimo di que a maior parte vence en 24 horas. Se polo menos tres cuartas partes vencen en 3 días, Cosimo di que a maior parte vence en 3 días. En caso contrario, Cosimo di que a carga está repartida ao longo da semana. Cando existen datos de tempo dos últimos 7 días, o Resumo tamén compara a carga estimada de 7 días co teu tempo de estudo rexistrado nos últimos 7 días. Se a diferenza é inferior a 5 minutos e ao 20% do tempo rexistrado recente, Cosimo describe a estimación como parecida ao tempo de estudo recente; en caso contrario descríbea como maior ou menor e mostra ambas as duracións.

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 exacta. Non o sei significa un obxectivo de recordo de 0-5%, Probablemente non o sei 5-32%, Probablemente o sei 68-95%, e Seguro que o sei 95-100%. O intervalo central déixase sen cubrir deliberadamente; mostra a resposta sen valorar confianza se non queres facer unha predición. A regra de recordo configúrase en Ferramentas -> Opcións. A regra permisiva conta Difícil, Ben e Fácil como recordadas, mentres que Repetir conta como non recordada. A regra estrita conta só Ben e Fácil como recordadas. O panel mostra a regra activa antes das cifras de calibración. O intervalo obxectivo de recordo é a media dos intervalos obxectivo das 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 obxectivo se o recordo observado cae dentro do intervalo obxectivo, hai falta de confianza se o recordo observado queda por riba do intervalo, e exceso de confianza se queda 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.

Na sección de diagnósticos, Fallos con alta confianza significa que escolliches Probablemente o sei ou Seguro que o sei e despois non recordaches a resposta segundo a regra de recordo activa. É sinal de exceso de confianza. Acertos con baixa confianza significa que escolliches Non o sei ou Probablemente non o sei e despois recordaches a resposta segundo a regra de recordo activa. É sinal de falta de confianza. Respostas conta eventos de resposta almacenados; unha carta pode achegar máis dunha resposta. Cartas afectadas conta cantas cartas teñen polo menos unha resposta dese tipo. Os recontos recentes entre parénteses usan os últimos 7 días: din todos recentes se todas as respostas ou cartas contadas son recentes, ningún recente se ningunha o é, ou noutro caso dan o número de respostas ou cartas recentes. Cartas con exceso de confianza recente significativo e Cartas con falta de confianza recente significativa usan a regra estrita de patrón recente usada polos filtros diagnósticos da lista inicial: para o exceso de confianza abonda co último intento con confianza, ou polo menos 2 dos últimos 5 intentos con confianza; para a falta de confianza deben coincidir polo menos 2 dos últimos 5 intentos con confianza.

A sección de tendencia do recordo conta respostas almacenadas de cartas do mazo actual. Recordo global usa a regra ordinaria do panel: Difícil, Ben e Fácil contan como recordadas, mentres que Repetir conta como non recordada. As liñas de valoración mostran primeiro porcentaxes, seguidas de recontos entre parénteses. A xanela recente compara os últimos 7 días cos 7 días anteriores; Cosimo só fai unha afirmación cualitativa de tendencia cando ambas xanelas conteñen polo menos 5 respostas. Un cambio de 5 puntos porcentuais ou máis descríbese como mellora ou empeoramento; diferenzas menores descríbense como amplamente estables. As tendencias de taxa de Repetir en cartas inversas usan as mesmas xanelas de 7 días, o mínimo de 5 respostas e o limiar de 5 puntos, pero unha taxa de Repetir descendente é mellor e unha ascendente é peor. As liñas de recaídas veñen do estado de programación actual das cartas activas e axudan a identificar se o mazo contén material que volve repetidamente á reaprendizaxe desde o estado de repaso. Estas recaídas programadas só contan Repetir en cartas que xa chegaran ao estado de repaso; as taxas ordinarias de Repetir móstranse por separado. As afirmacións de retención sobre aprendizaxe recente contan cartas aprendidas recentemente que non tiveron despois unha resposta Repetir. Cosimo necesita polo menos 5 cartas aprendidas recentemente antes de describir a retención recente; 90% ou máis retidas é ben retidas, 70-89% é maiormente retidas, e menos de 70% móstrase como recaídas de seguimento.

Cando existen datos temporizados de sesión, a sección Resumo inclúe o tempo medio de estudo por día de estudo activo para que esta métrica principal estea visible sen tabular ata a sección completa de actividade.

Cosimo rexistra a primeira vez que a base de datos de repaso ve cada carta física do mazo. Isto non é necesariamente a data real de creación da carta: en mazos existentes, as cartas actuais rexistraranse cando esta función as vexa por primeira vez. Por iso o panel descríbeo como cartas detectadas por primeira vez por esta base de datos de repaso. Cando a base de datos xa teña observacións anteriores, o Resumo pode mostrar unha liña de Fluxo do mazo para os últimos 7 días: cantas cartas do mazo foron detectadas por primeira vez e cantas cartas en dirección estándar chegaron ao estado de repaso. É información descritiva. A súa finalidade é axudarche a xulgar o crecemento do mazo e o ritmo de aprendizaxe sen que Cosimo che diga se debes engadir máis ou menos cartas.

A sección de actividade de estudo baséase en intentos rexistrados e resumos de sesións. Respostas almacenadas conta respostas individuais almacenadas. Días con respostas conta días UTC con polo menos unha resposta rexistrada. Os recontos de sesións, respostas e tempo etiquetados como sesións rexistradas veñen de resumos de sesións completadas. As duracións de tempo de estudo usan segundos, minutos, horas, días, semanas e anos; Cosimo non usa meses porque a súa duración varía. Días de estudo temporizados conta días UTC con polo menos un resumo de sesión completada e é a base do tempo medio de estudo por día de estudo activo. O tempo de estudo recente rexistrado e as preguntas recentes rexistradas comparan os últimos 7 días cos 7 días anteriores. Isto describe actividade de estudo real rexistrada en sesións completadas; non é unha previsión histórica de cantas cartas estaban programadas. O Resumo describe o tempo de estudo recente como maior, menor ou parecido ao dos 7 días anteriores cando existen datos de sesións con tempo; as diferenzas inferiores a 5 minutos e ao 20% da xanela anterior trátanse como parecidas. Se hai datos antigos anteriores aos resumos de sesións, o panel mostra Respostas antigas sen tempo de sesión para non confundir o total de respostas almacenadas co total menor de sesións con tempo. Esa liña ocúltase cando o valor é cero. A mesma sección tamén informa de cantas cartas físicas do mazo detectou por primeira vez esta base de datos de repaso, os recontos de primeira detección dos últimos 7 días, os 7 días anteriores e as observacións anteriores cando hai historial suficiente, e as cartas activas estándar do mazo que aínda non se estudaron.

Usa o botón Gardar informe do panel para gardar o informe completo do panel no directorio reports. O texto gardado usa cabeceiras de sección de estilo Markdown e inclúe todas as seccións do panel, aínda que o diálogo as mostre en campos separados. 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. Usa Copiar ao portapapeis para copiar ao portapapeis o mesmo texto completo do informe.

Se o mazo ten cartas inversas xeradas, o panel engade unha comparación entre cartas estándar e inversas, porque unha dirección pode ser moito máis fácil que a outra. Se as dúas medias de recordo estimado difiren en menos de 5 puntos porcentuais, Cosimo describe as direccións como similares.

Audio

O soporte de audio ten dúas partes separadas. A reprodución usa ficheiros Opus existentes, e ficheiros WAV antigos, mentres estudas, previsualizas cartas ou revisas respostas de exame. A xeración automática usa voice.exe, desde a liña de ordes ou mediante Ferramentas -> Xerar audio, para crear ficheiros Opus ou WAV a partir de voces de síntese instaladas.

A reprodución de audio de repaso é opcional e admite ficheiros .opus, con retroceso a ficheiros .wav antigos co mesmo ID de carta e lado se non existe ficheiro Opus. Configúraa en Ferramentas -> Opcións -> Audio durante o estudo:

A opción separada Tons guía para o audio automático engade sinais de orientación 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.

Ferramentas -> Opcións -> Formato de xeración de audio controla o formato usado pola xeración automática. Opus é o valor predeterminado e normalmente ocupa moito menos espazo que WAV. WAV segue dispoñible por compatibilidade ou para usuarios que prefiran audio xerado sen compresión.

Ctrl+P activa a mesma acción de reproducir/deter cando o audio de repaso está dispoñible. Na lista inicial de cartas, 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 sesión 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.

Ferramentas -> Opcións -> Reproducir audio automaticamente durante a corrección e revisión de exame controla o que acontece despois de enviar unha resposta de exame, cando Cosimo mostra un diálogo de corrección ou revisión. Sen audio automático deixa esa fase en silencio salvo que pidas audio manualmente. Pregunta, Resposta e Ambas reproducen automaticamente a pregunta, a resposta esperada, ou a pregunta seguida da resposta esperada. Nos diálogos de corrección e revisión, Ctrl+P sempre reproduce a pregunta seguida da resposta esperada cando eses ficheiros de audio existen, mesmo se o audio automático de corrección/revisión de exame está desactivado.

Ferramentas -> Opcións -> Reproducir audio automaticamente durante cuestionarios controla o audio dos cuestionarios. Sen audio automático deixa os cuestionarios en silencio salvo que reproduzas audio manualmente durante a revisión de respostas. Pregunta reproduce o audio da pregunta cando aparece cada pregunta de cuestionario. Opcións reproduce o audio dunha opción de resposta cando esa opción se selecciona, e deteno cando a lista de opcións perde o foco ou cambia a selección. Ambas combina eses comportamentos. Durante a revisión de respostas do cuestionario, o mesmo axuste controla a reprodución automática da pregunta e da resposta correcta; Ctrl+P reproduce a pregunta seguida da resposta correcta cando eses ficheiros de audio existen. Se os tons guía están activados, a revisión de respostas do cuestionario tamén reproduce un ton breve ascendente para unha resposta correcta e un ton breve descendente para unha resposta incorrecta antes de calquera audio automático de revisión.

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.opus para o lado de pregunta e Indonesian/1.response.opus para o lado de resposta. Os nomes .wav antigos, como Indonesian/1.prompt.wav, seguen reproducíndose se non existe ficheiro .opus. As cartas inversas xeradas reutilizan os ficheiros da carta principal con pregunta e resposta intercambiadas. A ferramenta de xeración de audio escribe ficheiros novos no formato seleccionado nese directorio, así que conserva copias separadas de calquera gravación que creases ti.

Ferramentas -> Eliminar audio inoperativo do mazo elimina ficheiros de audio recoñecidos por Cosimo nese directorio cando non poden usarse: ficheiros para ID de carta que xa non existen no mazo, e ficheiros de formato menos preferido ocultos por un formato preferido para o mesmo lado da carta, por exemplo un .wav cando existe o .opus correspondente. Tamén elimina as entradas correspondentes de audio-manifest.tsv. A orde ignora outros ficheiros do directorio, pide confirmación e non pode desfacerse.

As copias automáticas do contido do mazo e da base de datos de repaso non inclúen ficheiros de audio xunto ao mazo. As exportacións e copias completas do mazo si inclúen o directorio auxiliar. Se gravas ou editas o teu propio audio, asegúrate de usar copias completas do mazo ou fai copia do directorio de audio pola túa conta. A xeración actual conserva os ficheiros .opus e .wav existentes sen seguimento en lugar de sobrescribilos, pero o directorio de audio segue fóra do sistema de copias automáticas do contido do mazo e da base de datos.

Os paquetes de Windows tamén inclúen voice.exe, unha ferramenta auxiliar para xerar eses ficheiros de audio a partir de voces OneCore ou SAPI instaladas. Execútaa desde un símbolo do sistema. Por exemplo, se voice.exe está xunto a cosimo.exe, esta orde le decks/Indonesian.cosimo-deck e escribe ficheiros de audio en decks/Indonesian/:

voice Indonesian --prompt-voice "Nome de voz indonesia" --response-voice "Nome de voz galega"

Por defecto, voice.exe escribe ficheiros Opus. Usa --format wav se queres saída WAV.

Tamén podes usar Ferramentas -> 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 coa voz predeterminada equivocada do sistema. Se a opción está desactivada, usa Mazo -> Editar metadatos do mazo para escoller esas voces e motores, e comproba se o mazo está marcado como mazo de audio manual. 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 dentro do directorio reports. Se xa existe un ficheiro .opus ou .wav antigo sen seguimento para un lado concreto, voice.exe déixao intacto. Ao rematar, Cosimo informa do número de cartas para as que se xerou audio, cantos ficheiros novos se crearon, cantos ficheiros xestionados se rexeneraron ou converteron, cantos ficheiros sen seguimento se conservaron, e cantos ficheiros xa rexistrados se omitiron. Se o informe menciona ficheiros rexenerados forzosamente por sobrescritura explícita, refírese a unha ruta de sobrescritura de liña de ordes antiga ou futura, non á xeración ordinaria desde a interface.

Esta política conservadora está pensada para evitar substituír gravacións do usuario. Para un mazo cuxo audio mantés manualmente, activa Mazo de audio manual (protexer contra a xeración automática de audio) en Mazo -> Editar metadatos do mazo. Isto escribe audio_generation=disabled na cabeceira do mazo, desactiva Ferramentas -> Xerar audio, e fai que voice.exe se negue a xerar audio para ese mazo. Non impide reproducir o audio existente.

Usa voice --list-voices para ver as voces instaladas. En aprendizaxe de idiomas, escolle unha voz que corresponda ao idioma de cada lado: se as preguntas están en indonesio e as respostas en galego, usa unha voz en indonesio para as preguntas e unha voz en galego para as respostas. Se ambos lados están no mesmo idioma, --voice "Nome de voz" usa a mesma voz para ambos. 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.

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 Mazo -> 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. O mesmo editor pode marcar un mazo como de audio manual, o que engade audio_generation=disabled. Cando voice.exe está dispoñible xunto a cosimo.exe, o editor de metadatos lista as voces instaladas para o motor seleccionado. Os campos de voz seguen sendo editables, así que podes escribir un filtro manualmente se a lista falla ou se queres usar un valor que non aparece nela. O selector de motor pode listar voces OneCore, voces 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, pero non teñen prioridade sobre audio_generation=disabled.

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. O audio rexistrado no manifesto considérase xestionado por Cosimo e pode rexenerarse ou converterse ao formato de saída seleccionado. Os ficheiros .opus e .wav existentes sen seguimento considéranse gravacións do usuario e déixanse intactos; nese caso Cosimo non crea un ficheiro novo para ese lado da carta, porque podería ocultar o audio do usuario. --dry-run mostra o que se xeraría sen escribir ficheiros.

Ficheiros, copias de seguridade e mantemento

Fai copia de seguridade tanto do ficheiro do mazo como da súa base de datos de repaso 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 repaso contén o estado de programación, valoracións e 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 teñen 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.

Para outro mazo, a base de datos de repaso 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 repaso 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 contido 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 repaso de Cosimo. As copias automáticas do contido do mazo e da base de datos de repaso non conteñen audio xunto ao mazo. As copias completas do mazo si conteñen o directorio auxiliar; se non tes unha, restaura o audio desde a túa propia copia do directorio de audio.

As copias completas automáticas son distintas: cando están activadas, son paquetes comprimidos retidos que inclúen o mazo, o directorio auxiliar e a base de datos de repaso. Serven como rede de seguridade diaria para o mazo que estás usando, non como substituto das exportacións manuais antes de cambios arriscados.

Arquivo -> Exportar mazo completo escribe un paquete comprimido .zip co ficheiro .cosimo-deck actual e o seu directorio auxiliar co mesmo nome base, incluídos os ficheiros de audio e audio-manifest.tsv se existen. Non inclúe a base de datos de repaso. Cosimo propón un nome con data e hora e permíteche escoller onde gardar o paquete. Usa esta exportación cando queiras compartir o contido do mazo sen o teu historial persoal de estudo.

Arquivo -> Exportar mazo completo con historial escribe o mesmo paquete máis unha instantánea consistente da base de datos de repaso. Úsao para mover o teu propio contorno de estudo a outro equipo ou para facer unha copia manual completa. O ficheiro contén datos persoais de estudo como programacións, valoracións, historial de repaso, suspensións, marcas e adiamentos.

Arquivo -> Copia de seguridade completa do mazo escribe automaticamente o paquete de mazo e directorio auxiliar no directorio backups da aplicación e rexístrao en backups/deck-bundle-index.txt. Non inclúe a base de datos de repaso.

A copia completa automática diaria opcional tamén escribe en backups, pero usa backups/automatic-deck-bundle-index.txt e conserva unha copia retida por ruta de mazo. Inclúe a base de datos de repaso.

Arquivo -> Restaurar mazo completo restaura un destes paquetes comprimidos no directorio decks de Cosimo. Cosimo comproba primeiro o paquete e mostra o nome do ficheiro de mazo, o número de cartas, o número de ficheiros de audio, o total de ficheiros e se o paquete contén historial de estudo. Se se van sobrescribir ficheiros existentes, Cosimo avisa e escribe unha copia completa comprimida do mazo de destino antes de restaurar. Se se sobrescribirían ficheiros auxiliares pero non existe un mazo de destino que poida copiarse, Cosimo rexeita a restauración no canto de sobrescribilos.

Restaurar un paquete pode causar perda de datos. Pode substituír texto de cartas máis recente, audio auxiliar máis recente, un audio-manifest.tsv máis recente ou historial de programación e valoración máis recente na base de datos .reviews.sqlite3. Un paquete sen historial de estudo non restaurará programación nin historial de valoracións; un paquete con historial de estudo substituirá ese historial pola instantánea contida no zip. Pecha outros programas que poidan estar usando o mesmo mazo ou base de datos de repaso antes de restaurar.

Sincronización de mazos

Mazo -> Sincronizar usa a mesma maquinaria de paquetes, pero almacena a instantánea no servidor de sincronización configurado en Ferramentas -> Opcións. As instalacións novas de Cosimo usan por defecto o servidor público do proxecto, https://cosimo.isonomia.net/sync.cgi; podes substituír esa URL pola do teu propio servidor. Os servidores locais de desenvolvemento poden usar URL http://; os servidores despregados deberían usar https://. Usa Mazo -> Sincronizar -> Iniciar sesión para iniciar sesión no servidor cunha conta compatible con Mastodon. Cosimo abre a URL de autorización no navegador, pide o código de autorización e garda localmente a identidade de sincronización e o token portador de sincronización de Cosimo. Polo tanto, trata o ficheiro local de configuración como privado.

Se non queres que esta instalación de Cosimo use sincronización, borra a URL do servidor de sincronización en Ferramentas -> Opcións e garda as opcións. Cosimo rexistra esa decisión como sync_server_url=none en cosimo.ini e non volverá ao servidor público ata que establezas de novo unha URL. Tamén podes facer o mesmo editando cosimo.ini manualmente e poñendo sync_server_url=None.

O inicio de sesión compatible con Mastodon é deliberadamente limitado. A instancia fediversa só pide autorizar o ámbito read:accounts, suficiente para que o servidor de sincronización confirme que conta iniciou sesión. Non permite ler mensaxes privadas, publicar estados, seguir contas nin actuar como ti. O cliente de escritorio de Cosimo nunca recibe o teu contrasinal fediverso nin o token de acceso fediverso. Ve a URL da instancia, o código de autorización que pegas, a identidade de sincronización verificada que devolve o servidor e o token portador de Cosimo que usará nas seguintes peticións de sincronización. O servidor de sincronización recibe o código de autorización pegado, recibe brevemente un token de acceso fediverso da instancia, úsao para chamar a verify_credentials, e despois revoga ese token fediverso temporal antes de emitir un token portador de Cosimo. O servidor conserva a identidade de conta verificada, as credenciais da aplicación OAuth para a instancia, os paquetes de mazo que subas e un verificador con hash do token portador de Cosimo; non garda o teu contrasinal fediverso nin o token de acceso fediverso. A instancia fediversa ve os metadatos da aplicación OAuth Cosimo Sync, a URL de sitio web da aplicación rexistrada polo servidor de sincronización e o intercambio breve de autenticación; non ve o teu token portador de Cosimo nin os teus mazos.

Mazo -> Sincronizar -> Pechar sesión borra a identidade de sincronización e o token portador de Cosimo gardados nesta instalación de Cosimo e pídelle ao servidor que revogue o token portador de Cosimo cando o servidor está dispoñible; non elimina mazos remotos nin rexistros locais de revisión.

Estado de sincronización empeza polas accións dispoñibles, como se a subida ou descarga con historial está dispoñible. Despois mostra a copia remota, se existe, e os datos útiles para decidir que facer: visibilidade, propietario, historial de estudo, último dispositivo que subiu o mazo e cotas do servidor. Os datos opacos, como UUID, revisión remota e hashes de paquetes, aparecen máis tarde como detalles técnicos para resolver problemas ou compartir identificadores.

Mazos remotos abre unha lista seleccionable de mazos atopados no servidor configurado. Se o servidor ten resumo do mazo, a lista e os detalles empezan por información lexible: título ou nome de ficheiro, número de cartas, audio, formatos, visibilidade, propietario, dispoñibilidade de historial de estudo e último dispositivo que o subiu. UUID, revisións e hashes aparecen ao final como detalles técnicos. Copiar ID copia o UUID do mazo seleccionado, e Buscar por ID permite pegar un UUID ou URL de mazo compartido para atopar un mazo público ou non listado. Subir con historial de estudo sobe o mazo, o directorio auxiliar e a base de datos de repaso. Descargar con historial de estudo restaura a instantánea para o mesmo UUID de mazo e conta iniciada, escribindo unha copia completa comprimida antes de substituír ficheiros de mazo existentes. Subir e descargar pode tardar se o mazo contén audio, polo que Cosimo mostra un diálogo de progreso mentres a transferencia e a restauración se executan fóra do fío principal da interface. Isto é sincronización por instantáneas, non mestura: se dous equipos cambian o mesmo mazo de maneira independente, Cosimo detecta conflitos de revisión no canto de combinar os cambios. Se un equipo recentemente configurado indica un conflito ao subir porque o mazo remoto xa ten unha revisión, descarga primeiro o mazo sincronizado; iso rexistra a revisión remota localmente e permite comprobar as subidas posteriores contra o estado remoto actual.

Cada mazo sincronizado tamén ten un UUID. Se o servidor xa ten ese UUID baixo outra conta autenticada, Cosimo rexeita a subida no canto de apropiarse do mazo remoto. Se isto ocorre porque descargaches un mazo público ou non listado doutra persoa e queres manter a túa propia copia sincronizada, usa Mazo -> Editar metadatos do mazo -> Facer copia independente e garda. Cosimo asigna un novo UUID de mazo, restablece a visibilidade a privado, conserva as cartas, o audio e o historial de estudo local, e esquece o estado local de sincronización do UUID anterior.

Mantemento de base de datos e copias

Usa Ferramentas -> Limpar base de datos de repaso para eliminar permanentemente filas inactivas da base de datos de repaso correspondentes a cartas que xa non están no mazo actual e a cartas inversas xeradas inactivas. Consérvanse as cartas activas, as cartas inversas xeradas activas, as programacións actuais, as suspensións actuais e as marcas actuais. 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 antes de limpar e avisa de que a copia retida se sobrescribirá. Despois de eliminar as filas inactivas, Cosimo compacta a base de datos para que o ficheiro SQLite poida recuperar espazo non usado.

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

Usa Ferramentas -> 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.

Usa Ferramentas -> Baleirar directorio de copias só cando queiras baleirar deliberadamente o directorio backups da aplicación. Cosimo avisa antes de facelo porque a orde elimina todos os ficheiros e cartafoles dese directorio, incluídos ficheiros que quizais non fosen xerados nin rexistrados por Cosimo. A orde conserva o directorio backups, pero Cosimo non pode recuperar o seu contido despois de eliminalo.

Accesibilidade

Cosimo está deseñado para usarse con teclado e lector de pantalla. A maioría das accións de estudo poden completarse sen abrir menús:

O audio de repaso pode usarse manual ou automaticamente. Cando o audio automático durante o estudo está activado, os tons guía opcionais dan sinais sen voz: un ton curto antes do audio da pregunta, dous tons curtos antes do audio da resposta e un arpexio de tres notas cando se mostra o resumo do repaso. Os exames cronometrados tamén usan tons para marcar o progreso do tempo e os esgotamentos de tempo.

O panel de aprendizaxe está dividido en seccións de só lectura separadas para que os usuarios de lector de pantalla poidan tabular entre resumo, distribución, carga de traballo, diagnósticos e actividade en vez de ler un só campo longo. O panel tamén ten botóns Gardar informe e Copiar ao portapapeis para revisar o informe completo fóra do diálogo.

A barra de estado principal informa do estado do mazo e do tempo de repaso con expresións breves e cómodas para síntese de voz. As datas programadas nos detalles de carta inclúen duracións relativas antes das datas e horas UTC exactas, porque os tempos relativos son máis fáciles de entender con voz.

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

Opcións e idiomas

A maioría dos axustes da aplicación están en Ferramentas -> Opcións. Os metadatos propios do mazo, como título, voces, protección de audio manual e visibilidade de sincronización, están en Mazo -> Editar metadatos do mazo.

Usa Idioma para escoller inglés, español ou galego. O idioma escollido 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 noutro caso usa inglés. As configuracións rexionais descoñecidas tamén usan inglés.

Mínimo de cartas por sesión controla cantas cartas intenta incluír Cosimo cando escolles Comezar. É un mínimo, non un máximo: se hai máis cartas pendentes, inclúense todas. Se hai menos, Cosimo enche desde outras cartas dispoñibles ata alcanzar o mínimo.

Copias do mazo, Copias da base de datos de repaso e Copias completas automáticas controlan os tres sistemas de copia descritos en Ficheiros, copias de seguridade e mantemento.

As notificacións sonoras 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 temporizada da pantalla inicial detecta que hai repasos dispoñibles, ou que hai máis repasos dispoñibles desde a última actualización automática. Os cambios provocados polo usuario, 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 sesión de estudo activa, aínda que pasen a estar pendentes máis cartas durante esa sesión.

Audio durante o estudo controla sesións de estudo programadas, forzadas e con cartas marcadas:

Tons guía para o audio automático engade sinais non faladas cando o audio do estudo normal está en automático: un ton de 200 ms antes do audio da pregunta, dous tons de 100 ms antes do audio da resposta, e un arpexio ascendente de tres notas antes do resumo de estudo. O mesmo axuste activa tamén tons de acerto/erro durante a revisión de respostas de cuestionarios: dous tons ascendentes para unha resposta correcta e dous tons descendentes para unha incorrecta. Os tons de progreso, fin de tempo e fin de exame son sinais propios do exame temporizado e non dependen desta caixa.

Formato de xeración de audio controla o audio novo xerado por voice.exe e Ferramentas -> Xerar audio. Opus é o valor predeterminado e normalmente ocupa moito menos espazo. WAV segue dispoñible por compatibilidade e para audio xerado sen compresión.

Reproducir audio automaticamente durante a corrección e revisión de exame só controla a fase posterior a responder en exames. Sen audio automático deixa esa fase en silencio salvo que premas Ctrl+P. Pregunta, Resposta e Ambas reproducen a pregunta, a resposta esperada ou ambas. Durante a corrección ou revisión de exame, Ctrl+P sempre reproduce a pregunta seguida da resposta esperada se eses ficheiros existen.

Reproducir audio automaticamente durante cuestionarios controla as preguntas e a revisión de respostas de cuestionarios. Sen audio automático deixa o cuestionario en silencio salvo por Ctrl+P manual durante a revisión. Pregunta reproduce a pregunta ao aparecer cada pregunta. Opcións reproduce o audio dunha opción de resposta cando se selecciona e deteno cando se move o foco ou cambia a selección. Ambas combina ambos comportamentos. Durante a revisión de respostas, Pregunta, Opcións e Ambas controlan a reprodución automática de pregunta e resposta correcta; Ctrl+P reproduce a pregunta seguida da resposta correcta se eses ficheiros existen.

Regra de recordo para a calibración cambia como o panel de aprendizaxe e os diagnósticos de confianza deciden se unha resposta contou como recordada. Laxa conta Difícil, Ben e Fácil como recordadas. Estrita conta só Ben e Fácil. A programación segue usando a valoración real de recordo; esta opción afecta á interpretación do panel, non ao programador.

URL do servidor de sincronización é o servidor predeterminado usado por Mazo -> Sincronizar. As instalacións novas usan https://cosimo.isonomia.net/sync.cgi, o servidor público do proxecto. Podes substituílo polo teu propio servidor. Os servidores despregados deberían usar normalmente https://; as probas locais na mesma máquina poden usar http://. Para desactivar a sincronización nesta instalación, borra o campo e garda as opcións; isto escribe sync_server_url=none e impide que Cosimo use o servidor público predeterminado ata que volvas establecer unha URL. Nome local do dispositivo é unha etiqueta opcional, como sobremesa ou portátil, mostrada no estado de sincronización e nos detalles de mazos remotos para recoñecer que instalación subiu un mazo por última vez.

Coa minimización á área de notificación activada, usar 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.

As traducións mantéñense en ficheiros .po de estilo gettext, cunha pequena cantidade de código de conexión 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.

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

Consellos

Por que se chama Cosimo?

Cosimo recibe o seu nome en honra de Cosimo Piovasco di Rondò, o protagonista da novela O barón rampante, de Italo Calvino. O Cosimo de Calvino é un notorio polímata e políglota, o que fai que o seu nome encaixe cunha ferramenta de estudo.