learnnote-assistant

LearnNote es un asistente de aprendizaje con IA priorizando el almacenamiento local, cuyo objetivo es organizar videos vistos y materiales locales en notas de estudio editables y consultables. El proyecto se centra en Windows 10/11 x64 como plataforma principal; tras la instalación, inicia un servicio local para leer, editar y regresar a la fuente desde un panel web. No requiere registro de cuenta de LearnNote; los videos, subtítulos, notas, suplementos y registros de repaso se guardan por defecto en el equipo local, sin tareas en la nube ni telemetría de producto. Capacidades principales: - Entrada de contenido: Permite pegar URLs de video, seleccionar videos locales o importar PDF, Markdown, TXT y HTML. Los enlaces comunes no requieren la instalación de extensiones de navegador. - Flujo prioritario de subtítulos: Cuando hay subtítulos disponibles, los lee omitiendo la descarga del video y la transcripción de voz, llamando luego a un modelo de texto para generar resúmenes, puntos clave y fuentes con marcas de tiempo, manteniendo el texto original de los subtítulos; si no hay subtítulos, obtiene el medio y lo transcribe según el método seleccionado antes de organizar. - Transcripción y OCR: La transcripción local utiliza faster-whisper; el primer uso requiere descargar el modelo correspondiente, y la velocidad depende de la duración del video, el tamaño del modelo y el entorno de CPU/GPU. El OCR de pantalla se usa para la extracción de texto mediante fotogramas; el README aclara que el OCR automático de subtítulos de pantalla completa aún no está disponible como flujo de respaldo. - Configuración de modelos: Permite guardar una conexión de modelo de texto o visual para uso compartido entre la web, la App y las tareas de la extensión; soporta preajustes de servicio o interfaces compatibles, así como conexiones a servicios de modelos locales. La API Key puede almacenarse en el servicio local o en el almacén de credenciales del sistema. - Extensión de navegador: Utilizada para páginas de Bilibili o cursos ya iniciados, transfiriendo los subtítulos y recursos accesibles en la página actual; la extensión no graba pestañas ni evade DRM, permisos de cuenta o progreso de cursos. Pegar una URL no obtiene automáticamente el estado de sesión de otro navegador. - Notas y lectura: El cuerpo del texto y las fuentes están separados, permitiendo regresar al video mediante marcas de tiempo; soporta la edición del texto y el guardado de suplementos personales, conservando el borrador original y la versión revisada; ofrece un asistente global y Skills explícitas para hacer preguntas, resumir o autoevaluarse sobre el contenido seleccionado, mostrando la Skill, el alcance y el método de ejecución. - Organización y exportación: Proporciona cursos, tarjetas de repaso, planes de estudio, registros de versiones, aprendizaje de fragmentos, OCR, diagnóstico y exportación; soporta colapso de barra lateral, esquemas, ajustes de fuente, tamaño, interlineado, ancho de lectura, temas y densidad. Las preguntas del asistente no enviadas se guardan como borradores locales, conservando la versión generada anterior antes de una nueva generación. - Integración: Ofrece un directorio de integración con Obsidian; el sitio oficial y la documentación de ayuda incluyen instrucciones sobre flujos de producto, configuración de modelos y resolución de problemas de conexión de extensiones. Modo de uso: Descargar el instalador de Windows o descomprimir el ZIP portátil y ejecutar LearnNote.exe; guardar la conexión del modelo en la configuración, confirmar la fuente y el método de procesamiento para iniciar la tarea. La página de tareas muestra el progreso, los pasos completados o saltados y los registros de procesamiento; al finalizar, se puede leer el resumen, editar o exportar. Límites y restricciones: Soporta videos locales, Bilibili, YouTube y recursos multimedia comunes accesibles en la sesión actual; las actualizaciones de sitios, la expiración de sesiones o la reproducción cifrada pueden afectar la obtención, pudiendo continuar con archivos locales. El escaneo de PDF requiere OCR previo. Las comprobaciones de contrato básico para macOS/Linux no equivalen a la finalización de la firma de escritorio nativa, instalación y aceptación de actualizaciones. Las pantallas estrechas de móviles pueden leer la web, pero el servicio por defecto es solo para acceso local; la sincronización entre dispositivos y una App móvil independiente no están comprometidas actualmente. Desarrollo y licencia: El repositorio incluye el backend, el panel web, la extensión de navegador y el sitio oficial estático; el entorno de desarrollo puede ejecutar first-run-checklist.ps1 y start-learnnote.ps1, con regresiones de backend mediante unittest. El proyecto utiliza la Apache License 2.0. El README menciona referencias a BiliNote para el flujo de subtítulos y notas de video, Cetle para la organización de herramientas de aprendizaje y subtítulos, y Cherry Studio para la interacción de clientes multimodelo.