ysyecust/lecture-to-notes

해결하는 문제

강의 비디오를 보는 것은 수동적이고 나중에 복습하기 어렵습니다. 이 프로젝트는 비디오 URL을 구조화되고 읽기 쉬운 중국어 핸드아웃으로 자동 변환합니다: LaTeX 소스 파일, 컴파일된 PDF, 잘라낸 그림, 수정된 자막, 검증 보고서. 발표자의 말하는 흐름을 따르는 대신 독자의 질문에 맞춰 콘텐츠를 재구성하며, 각 그림에는 비디오의 정확한 부분을 보여주는 각주가 있고, 모든 수치 주장은 자막이나 화면 텍스트와 대조됩니다.

작동 방식

파이프라인은 YouTube, Bilibili(멀티파트 재생목록 포함) 또는 X/Twitter의 비디오 링크를 받습니다. 먼저 플랫폼을 식별하고 메타데이터를 가져옵니다. 그런 다음 5단계 폴백으로 자막을 얻으려고 시도합니다: 수동 CC, 플랫폼 자동 자막, 하드 자막에서 OCR, 로컬 자동 음성 인식(ASR), 마지막으로 사전 또는 LLM 기반 수정. 동시에 비디오를 다운로드하고 프레임을 추출한 다음 정적 내비게이션 바와 자막 밴드를 잘라내고, 발표자 카메라와 슬라이드 영역이 있는 경우 슬라이드 부분만 유지합니다. 자막과 정리된 프레임을 수집한 후, 독자 우선 쓰기 단계에서 LaTeX 노트를 생성합니다: 장은 독자 질문에 따라 구성되고, 수식에는 기호 표가 있으며, 숫자는 교차 검증을 위해 별도 표에 기록됩니다. 노트는 xelatex로 두 번 컴파일한 다음, 완전성, 그림 시간 일관성, 그림이 각주와 같은 페이지에 유지되는지 확인하는 게이트키퍼 스크립트로 검증합니다. 모든 검사가 통과해야 최종 PDF와 모든 지원 산출물이 생성됩니다.

대상 사용자

온라인 강의에서 고품질의 복습하기 쉬운 노트를 원하는 모든 사람—특히 원시 비디오보다 구조화된 핸드아웃을 선호하는 중국어 사용 학생이나 독학자. 기존 강의 녹화를 세련된 코스 자료로 변환하려는 교육자에게도 유용합니다. 이 프로젝트는 Claude Code, Codex, DeepSeek Harness용 즉시 사용 가능한 에이전트 스킬을 제공하므로, 이러한 도구를 가진 사용자는 간단한 명령으로 전체 프로세스를 시작할 수 있습니다. 포함된 온라인 코스 라이브러리는 9개 코스, 100개 이상의 강의를 제공하며 출력 예시를 보여주고 웹 최적화 텍스트와 원본 PDF 모드로 모두 탐색할 수 있습니다.

주요 기능

• 5단계 자막 폴백 – 수동 CC에서 OCR, 로컬 ASR까지, 플랫폼이 제공하지 않아도 캡션을 보장합니다.
• 독자 우선 쓰기 – 장은 말하는 순서가 아닌 독자 질문에 따라 재구성되며, 수식 뒤에는 항상 기호 설명이 이어집니다.
• 시간 추적 가능한 그림 – 노트의 각 이미지에는 정확한 비디오 시간 범위의 각주가 있으며, 검증 단계에서 그림과 각주가 같은 페이지에 유지되도록 보장합니다.
• 수치 주장 검증 – 단위가 있는 숫자는 별도의 TSV 파일로 추출되어 대본과 교차 검증됩니다.
• 이중 형식 읽기 – 글꼴 크기 조절 가능한 웹 페이지와 비디오로 이동하는 클릭 점프 기능, 전체 텍스트 검색과 확대/축소가 있는 원본 PDF 리더.
• 에이전트 스킬 통합 – Claude Code, Codex, DeepSeek Harness용 스킬로 설치 가능; /lecture-to-notes <URL>을 입력하기만 하면 됩니다.
• 활성 코스 라이브러리 – 9개 코스, 101개 강의, 2,451페이지의 중국어 핸드아웃이 이미 온라인에서 제공됩니다.