learnnote-assistant

LearnNote é um assistente de aprendizagem AI local-first com o objetivo de organizar vídeos assistidos e materiais locais em notas de estudo pesquisáveis e editáveis. O projeto foca no Windows 10/11 x64 como plataforma principal; após a instalação, inicia um serviço local para leitura, edição e retorno à fonte através de um workbench web. Não exige registro de conta LearnNote; vídeos, legendas, notas, complementos e registros de revisão são salvos localmente por padrão, sem tarefas em nuvem proprietárias ou telemetria de produto. Principais capacidades: - Entrada de conteúdo: Permite colar URLs de vídeo, selecionar vídeos locais ou importar PDF, Markdown, TXT e HTML. Links comuns não exigem a instalação de extensões de navegador. - Fluxo prioritário de legendas: Quando legendas estão disponíveis, o sistema as lê, pulando o download do vídeo e a transcrição de voz, chamando então modelos de texto para gerar visões gerais, pontos principais e fontes com marcação de tempo; o texto original da legenda é preservado independentemente. Sem legendas, a mídia é obtida e transcrita conforme o método selecionado antes da organização. - Transcrição e OCR: A transcrição local utiliza faster-whisper; o primeiro uso requer o download do modelo correspondente, com a velocidade dependendo da duração do vídeo, tamanho do modelo e ambiente de CPU/GPU. O OCR de tela é usado para extração de texto via frames; o README esclarece que o OCR de legendas de tela completa ainda não é fornecido como fluxo de fallback automático. - Configuração de modelos: É possível salvar uma conexão de modelo de texto ou visual para uso compartilhado entre a web, App e extensões; suporta predefinições de serviço ou interfaces compatíveis, além de conexão com serviços de modelos locais. A API Key pode ser mantida no serviço local ou no armazenamento de credenciais do sistema. - Extensão de navegador: Utilizada para páginas de cursos ou Bilibili já logadas, transferindo legendas e recursos acessíveis na página atual; a extensão não grava abas, não ignora DRM, permissões de conta ou progresso de cursos. Colar apenas a URL não recupera automaticamente o estado de login de outro navegador. - Notas e Leitura: O corpo do texto e as fontes são separados, permitindo retornar ao vídeo via marcação de tempo; suporta a edição do texto e salvamento de complementos pessoais, mantendo a versão original e a revisada separadamente. Oferece um assistente global e Skills explícitas para perguntas, resumos e autotestes sobre o conteúdo selecionado, exibindo a Skill, o escopo e o método de execução na resposta. - Organização e Exportação: Fornece cursos, cartões de revisão, planos de estudo, histórico de versões, aprendizagem por fragmentos, OCR, diagnóstico e exportação; suporta colapso de barra lateral, sumário, ajustes de fonte, tamanho, espaçamento, largura de leitura, temas e densidade. Perguntas ao assistente não enviadas são salvas como rascunhos locais, preservando a versão anterior antes de uma nova geração. - Integração: Oferece diretório de integração com Obsidian; o site oficial e a documentação de ajuda incluem fluxos de produto, configurações de modelo e solução de problemas de conexão da extensão. Modo de uso: Baixe o instalador Windows ou descompacte o ZIP portátil e execute LearnNote.exe; salve a conexão do modelo nas configurações, confirme a fonte e o método de processamento para iniciar a tarefa. A página de tarefas exibe o progresso, etapas concluídas ou puladas e registros de processamento; após a conclusão, é possível ler o resumo, editar ou exportar. Limites e Restrições: Suporta vídeos locais, Bilibili, YouTube e recursos de mídia comuns acessíveis na sessão atual; atualizações de sites, expiração de login ou reprodução criptografada podem afetar a obtenção, podendo-se continuar com arquivos locais. PDFs escaneados requerem OCR prévio. Verificações de contrato básico para macOS/Linux não equivalem à conclusão de assinatura de desktop nativa, instalação ou aceitação de upgrade. Telas estreitas de celular podem ler a web, mas o serviço padrão é apenas para acesso local; sincronização entre dispositivos e App independente para celular não estão nos compromissos atuais. Desenvolvimento e Licença: O repositório inclui backend, workbench web, extensão de navegador e site estático; o ambiente de desenvolvimento pode executar first-run-checklist.ps1 e start-learnnote.ps1, com regressão de backend via unittest. O projeto adota a Apache License 2.0. O README menciona referências ao fluxo de legendas e notas de vídeo do BiliNote, organização de ferramentas de legenda e estudo do Cetle, e interação de cliente multi-modelo do Cherry Studio.