learnnote-assistant

LearnNote는 로컬 우선 AI 학습 도우미로, 시청한 영상과 로컬 자료를 다시 찾아보고 편집할 수 있는 학습 노트로 정리하는 것을 목표로 합니다. Windows 10/11 x64 데스크톱을 주요 플랫폼으로 하며, 설치 후 로컬 서비스를 실행하여 웹 워크벤치에서 읽기, 편집 및 원본 확인이 가능합니다. LearnNote 계정 등록이 필요 없으며 영상, 자막, 노트, 보충 및 복습 기록은 기본적으로 로컬에 저장되며, 자체 클라우드 작업이나 제품 텔레메트리는 포함되지 않습니다. 주요 기능: - 콘텐츠 입력: 영상 URL 붙여넣기, 로컬 영상 선택, 또는 PDF, Markdown, TXT, HTML 가져오기가 가능합니다. 일반 링크의 경우 브라우저 확장 프로그램 설치가 필요하지 않습니다. - 자막 우선 프로세스: 사용 가능한 자막이 있으면 자막을 읽어 영상 다운로드와 음성 전사 단계를 건너뛰고, 텍스트 모델을 호출하여 개요, 핵심 포인트 및 타임스탬프가 포함된 출처를 생성하며 자막 원문은 별도로 보존합니다. 자막이 없는 경우 미디어를 가져와 선택한 방식으로 전사한 후 정리합니다. - 전사 및 OCR: 로컬 전사는 faster-whisper를 사용하며, 최초 사용 시 해당 모델을 다운로드해야 합니다. 속도는 영상 길이, 모델 크기 및 CPU/GPU 환경에 따라 달라집니다. 화면 OCR은 프레임 추출 텍스트 추출에 사용됩니다. README에 명시된 바와 같이 전체 화면 자막 OCR은 아직 자동 폴백(fallback) 프로세스로 제공되지 않습니다. - 모델 설정: 텍스트 또는 비전 모델 연결 설정을 한 번 저장하여 웹, 앱 및 확장 작업에서 공용으로 사용할 수 있습니다. 서비스 프리셋 또는 호환 인터페이스를 지원하며 로컬 모델 서비스와도 연결 가능합니다. API Key는 로컬 서비스 또는 시스템 자격 증명 저장소에 보관할 수 있습니다. - 브라우저 확장 프로그램: 로그인된 Bilibili 또는 강의 페이지에서 현재 페이지가 접근 가능한 자막과 리소스를 전달합니다. 확장 프로그램은 탭을 녹화하지 않으며, DRM, 계정 권한 또는 강의 진도를 우회하지 않습니다. URL만 붙여넣는 경우에는 다른 브라우저의 로그인 상태를 자동으로 가져오지 않습니다. - 노트 및 읽기: 본문과 출처가 분리되어 있으며 타임스탬프를 통해 영상으로 돌아갈 수 있습니다. 본문 편집 및 개인 보충 내용 저장을 지원하며, 최초 생성본과 수정본이 각각 보존됩니다. 글로벌 어시스턴트와 명시적 Skill을 제공하여 선택한 내용에 대해 질문, 요약, 자가 테스트가 가능하며, 답변 시 사용된 Skill, 범위 및 실행 방식이 표시됩니다. - 조직 및 내보내기: 강의, 복습 카드, 학습 계획, 버전 기록, 클립 학습, OCR, 진단, 내보내기 기능을 제공합니다. 사이드바 접기, 아웃라인, 폰트 크기 및 줄 간격, 읽기 너비, 테마 및 밀도 설정이 가능합니다. 전송되지 않은 어시스턴트 질문은 로컬 초안으로 저장되며, 다시 생성하기 전까지 이전 생성본이 유지됩니다. - 통합: Obsidian 통합 디렉토리를 제공합니다. 공식 웹사이트와 도움말 문서에는 제품 프로세스, 모델 설정, 확장 프로그램 연결 문제 해결 등의 설명이 포함되어 있습니다. 사용 방법: Windows 설치 패키지를 다운로드하거나 포터블 ZIP 압축을 푼 후 LearnNote.exe를 실행합니다. 설정에서 모델 연결을 저장하고 출처와 처리 방식을 확인한 후 작업을 시작하면, 작업 페이지에서 진행률, 완료 또는 건너뛴 단계 및 처리 기록이 표시됩니다. 완료 후에는 요약본을 읽거나 편집 및 내보내기를 할 수 있습니다. 경계 및 제한 사항: 로컬 영상, Bilibili, YouTube 및 현재 세션에서 접근 권한이 있는 일반 미디어 리소스를 지원합니다. 사이트 업데이트, 로그인 만료 또는 암호화 재생으로 인해 리소스 획득에 영향이 있을 수 있으며, 이 경우 로컬 파일을 계속 사용할 수 있습니다. PDF 스캔은 먼저 OCR이 필요합니다. macOS/Linux의 기초 계약 확인이 네이티브 데스크톱 서명, 설치 및 업그레이드 검수가 완료되었음을 의미하지는 않습니다. 모바일 좁은 화면에서 웹 읽기가 가능하지만, 기본 서비스는 로컬 접속만 지원하며 기기 간 동기화 및 독립 모바일 앱은 현재 약속 범위에 포함되지 않습니다. 개발 및 라이선스: 저장소에는 백엔드, 웹 워크벤치, 브라우저 확장 프로그램 및 정적 공식 웹사이트가 포함되어 있습니다. 개발 환경에서는 first-run-checklist.ps1 및 start-learnnote.ps1을 실행할 수 있으며, 백엔드 회귀 테스트는 unittest를 사용합니다. 프로젝트는 Apache License 2.0을 채택하고 있습니다. README에 따르면 BiliNote의 자막 우선 및 영상 노트 워크플로우, Cetle의 자막 및 학습 도구 조직, Cherry Studio의 다중 모델 클라이언트 상호작용을 참고하였습니다.