---

🌸 ¿Qué es Onigiri Test?

Onigiri Test es un plugin de estudio para Obsidian Desktop que transforma notas Markdown en una biblioteca organizada de tests. Mantiene la relación entre carpetas, archivos y contenido para que cada tema de la bóveda tenga su propio espacio de aprendizaje.

La experiencia combina una interfaz japonesa kawaii, cuatro modos de estudio, siete niveles de dificultad, sonidos, música, TTS opcional, un asistente de importación mediante IA y un sistema de rachas con historial.

✨ Funciones principales

🗂️ Biblioteca organizada Árbol propio de carpetas, archivos y tests. Creación, renombrado y eliminación desde el panel lateral. Importación de la estructura de la bóveda. Buscador de carpetas, archivos y tests.	🎮 Cuatro modos de estudio Flashcards. Preguntas y respuestas. Emparejamiento. Escritura exacta.
🤖 Asistente de IA Guía paso a paso integrada. Prompt preparado para ChatGPT, Claude o Gemini. Importación de paquetes ZIP y JSON compatibles. Creación masiva de los cuatro tipos de test.	🔥 Motivación y seguimiento Racha diaria y mejor racha. Progreso semanal de lunes a domingo. Historial completo de sesiones. Resultados, precisión, errores y duración.
🔊 Experiencia audiovisual Mascotas específicas para cada sección. Música y efectos de sonido configurables. TTS del sistema opcional y desactivado por defecto. Animaciones, celebraciones y reacciones kawaii.	🔐 Privacidad local-first Biblioteca y progreso guardados localmente. Las notas no se envían automáticamente a terceros. El flujo con IA es manual y se ejecuta únicamente cuando el usuario lo decide.

🎴 Cuatro formas de estudiar

Modo	Funcionamiento	Ideal para
💗 Flashcards	Muestra una pregunta, permite pedir una pista y revelar la respuesta.	Recuerdo rápido y repaso diario.
💙 Preguntas y respuestas	Presenta cuatro opciones y corrige inmediatamente la selección.	Comprobar conceptos y distinguir respuestas similares.
💚 Emparejamiento	Muestra cinco preguntas y cinco respuestas mezcladas para relacionarlas.	Asociaciones, traducciones y vocabulario.
💜 Escritura	El usuario escribe exactamente la respuesta correspondiente.	Memorización activa y ortografía.

Flashcards

Cada tarjeta ofrece tres acciones:

• 🔴 No me lo sé…
• 🟡 Una ayudita, que muestra la solución durante 0,5 segundos.
• 🟢 ¡Soy un crack!!!

Al responder se revela la solución y se reproducen la animación y el efecto configurados.

Resultados detallados

Al finalizar una sesión:

• Pulsa Aciertos para consultar todas las respuestas correctas.
• Pulsa A repasar para ver cada fallo, la respuesta dada y la solución correcta.
• El resultado queda registrado en el historial de estudio y puede contribuir a la racha diaria.

⭐ Siete niveles de dificultad

Antes de comenzar un test aparece un selector horizontal. La dificultad determina cuántas veces se repite el contenido completo.

Nivel	Repeticiones	Frase de Onigiri
Onigiri normal	×1	«Me gustaría un combate de calentamiento…»
Super Onigiri 1	×3	«Te mostraré mi verdadera fuerza.»
Super Onigiri 2	×5	«He superado el poder de un Super Onigiri ordinario.»
Super Onigiri 3	×7	«Os presento al Super Onigiri Fase 3.»
Onigiri Dios	×9	«¡Así que este es el Poder de un Dios!»
Onigiri Blue	×11	«Superaré el poder de los dioses…»
Onigiri Ultra Instinto	×13	«Acabemos de una vez con esto…»

🤖 De la bóveda a los tests con IA

El botón Asistente de IA muestra una guía integrada para convertir una bóveda grande sin crear cada test manualmente:

1. Comprime el directorio completo de la bóveda en ZIP o RAR.
2. Adjunta el archivo a una IA compatible, como ChatGPT, Claude o Gemini.
3. Copia el prompt estructurado incluido en Onigiri Test.
4. Descarga el paquete generado por la IA.
5. Pulsa Importar Tests para reconstruir la organización y añadir los tests.

El formato recomendado es un ZIP con un archivo onigiri-test-import.json. ZIP es la opción preferida; la apertura de RAR puede requerir 7-Zip o WinRAR en el equipo.

📝 Contenido Markdown reconocido

Onigiri Test puede obtener parejas de pregunta y respuesta a partir de tablas, listas y formatos explícitos como:

Pregunta :: Respuesta

Q: Pregunta
A: Respuesta

En las tablas Markdown, la primera columna se interpreta como pregunta y las columnas restantes forman la respuesta. El contenido original no se modifica.

🔥 Panel de racha

El panel de racha reúne en una sola vista:

• Racha actual y mensaje motivacional.
• Calendario de la semana.
• Mejor racha histórica.
• Aciertos, elementos revisados y precisión global.
• Historial con archivo, test, fecha, duración, puntuación, dificultad, repeticiones y mejor cadena.

Un día se añade a la racha cuando se completa por primera vez ese día un test con una puntuación mínima del 60 %. Los tests adicionales quedan registrados, pero no incrementan artificialmente el contador diario.

El botón REINICIAR borra únicamente los datos de racha y solicita confirmación antes de hacerlo.

🌍 Interfaz bilingüe

Desde las opciones se puede alternar entre:

• 🇪🇸 Español
• 🇬🇧 English

El cambio se aplica a paneles, botones, menús, mensajes, tests, resultados y frases del TTS, y queda guardado para futuras sesiones.

🎵 TTS, música y efectos

Los controles de opciones permiten activar o desactivar de forma independiente:

• TTS del sistema.
• Efectos de sonido.
• Música de fondo.
• Animaciones.

El TTS está desactivado por defecto. Cuando se activa, utiliza las voces instaladas en el sistema e intenta seleccionar una voz japonesa cuando detecta escritura japonesa.

Música asociada a cada contexto:

• Flashcards: 24-lets-go.mp3
• Preguntas, emparejamiento y escritura: 25-square.mp3
• Resultados: 26-results.mp3
• Panel principal: 27-start.mp3

🔐 Privacidad

Onigiri Test funciona con un enfoque local-first:

• Los tests, ajustes, rachas y resultados permanecen en el dispositivo.
• El plugin no sube automáticamente la bóveda ni sus notas.
• El asistente de IA únicamente proporciona instrucciones y un prompt; el usuario decide si comparte un ZIP con un servicio externo.

Revisa siempre las políticas de privacidad de la IA elegida antes de adjuntar contenido personal, académico o profesional.

💻 Requisitos

• Obsidian Desktop 1.5.0 o posterior.
• Plugins de la comunidad habilitados.
• Espacio suficiente para los recursos de imagen y audio incluidos.

Onigiri Test está marcado como plugin exclusivo de escritorio.

📦 Instalación manual

1. Descarga la versión oficial desde el repositorio o canal autorizado de Zazen AI Studio.
2. Descomprime la carpeta onigiri-test dentro de:

TuBóveda/.obsidian/plugins/onigiri-test/

3. Comprueba que manifest.json, main.js y styles.css estén directamente dentro de esa carpeta.
4. Reinicia Obsidian o recarga los plugins.
5. Abre Ajustes → Plugins de la comunidad y activa Onigiri Test.
6. Pulsa el icono de Onigiri en la barra lateral.

🗃️ Estructura recomendada del repositorio

onigiri-test/
├── assets/
│   ├── difficulty/
│   ├── mascot/
│   ├── music/
│   ├── sounds/
│   └── onigiri-test.png
├── docs/
│   └── images/
├── LICENSE
├── README.md
├── main.js
├── manifest.json
├── package.json
├── styles.css
└── versions.json

🧩 Desarrollo y comprobación

El paquete incluye un script básico para validar la sintaxis de JavaScript:

npm run check

[!NOTE] La edición Original no se distribuye como software de código abierto. La disponibilidad del código en un repositorio no concede permiso para copiarlo, modificarlo, redistribuirlo ni crear versiones derivadas.

📜 Licencia

Onigiri Test Original se distribuye bajo la Zazen AI Studio Personal Use License 1.0.

La licencia permite descargar, instalar y utilizar el plugin gratuitamente en bóvedas personales, educativas o profesionales. No permite, sin autorización previa y por escrito de Zazen AI Studio:

• Vender, monetizar, sublicenciar o cobrar por el plugin.
• Redistribuirlo, reflejarlo o publicarlo en otro repositorio o plataforma.
• Publicar versiones modificadas, traducidas o derivadas.
• Extraer o reutilizar personajes, ilustraciones, logotipos, música, sonidos u otros recursos.
• Utilizar el software o sus recursos como material de entrenamiento para sistemas de IA.
• Eliminar o alterar los avisos de autoría y propiedad.

Consulta el archivo LICENSE para conocer las condiciones completas.

Copyright © 2026 Samuel Acosta Fernández, bajo el nombre Zazen AI Studio. Todos los derechos reservados.

🆕 Novedades de la versión 2.6.1

• Panel de racha reorganizado para mostrar la información principal sin desplazamiento en escritorio.
• Distribución inspirada en el mockup oficial: mascota y racha, estadísticas, semana, mejor racha e historial.
• Historial con desplazamiento interno para sesiones largas.
• Nueva paleta pastel en rosa sakura, melocotón, verde, azul y lavanda.
• Mejor adaptación a ventanas pequeñas y pantallas estrechas.
• Conservación del sistema de rachas, reinicio, historial y traducciones existentes.

🌸 Historial reciente

Versión 2.6.0 — Sistema de rachas

• Botón Racha junto al asistente de IA y las opciones.
• Calendario semanal, mejor racha e historial detallado.
• Registro diario a partir de un 60 % de puntuación.
• Notificaciones al conseguir nuevos días consecutivos.

Versión 2.5.1 — Mascotas por sección

• Recursos transparentes mejorados.
• Ilustraciones exclusivas para opciones, IA y cada tipo de test.

Versión 2.5.0 — Idiomas e importación con IA

• Interfaz Español/English.
• Asistente integrado con prompt de conversión.
• Importación automática de carpetas y cuatro tipos de test.

💖 Autor

---

🇬🇧 English overview

Onigiri Test — Kawaii study plugin for Obsidian

Onigiri Test turns Markdown notes into an organised library of interactive study sessions. It includes flashcards, multiple choice, matching and exact-writing tests; seven difficulty levels; AI-assisted batch importing; streak tracking; optional system TTS; music, effects and animations; and a fully bilingual Spanish/English interface.

The plugin follows a local-first approach. Notes and progress are not uploaded automatically. The AI assistant only provides a workflow and prompt; users decide whether to share a vault archive with a third-party AI service.

Onigiri Test Original is proprietary software distributed under the Zazen AI Studio Personal Use License 1.0. Installation and use are permitted under the terms of LICENSE; redistribution, resale, derivative publication and reuse of included assets are prohibited without prior written permission.

[!IMPORTANT] Onigiri Test Original es software propietario. Su uso está sujeto a la Zazen AI Studio Personal Use License 1.0 incluida en el archivo LICENSE.