YouTube Library
Python 3.12로 scripts/youtube_library.py를 실행하세요. 명령 전에 항상 --vault VAULT_DIR --runtime LOCAL_DATA_DIR를 명시적으로 전달하세요. 출력은 context/Media Library입니다. 생성된 파일 이름은 영어입니다.
Google 자격 증명은 Windows DPAPI를 사용합니다. Google 비밀번호를 요청하거나, 토큰을 출력하거나, 자격 증명을 커밋하지 마세요.
명령어
doctor: 계정을 승인하지 않고 로컬 설정을 확인합니다.auth --client CLIENT_JSON: 사용자가 요청한 Desktop OAuth로, youtube.readonly 권한만 사용합니다. 사용자가 계정 선택 및 동의를 완료합니다.sync: 자신의 플레이리스트와 좋아요 표시한 동영상을 읽고, 로컬 Ollama를 통해 메타데이터를 분류한 후 Markdown을 업데이트합니다.import-takeout --input PATH: ZIP 파일 또는 추출된 Google Takeout 디렉터리를 가져옵니다.set-topic --video-id ID --topic TOPIC: 사용자가 선택한 카테고리를 유지합니다.
예: python scripts/youtube_library.py --vault VAULT_DIR --runtime LOCAL_DATA_DIR doctor
auth 전에 Google Cloud Desktop OAuth 클라이언트를 생성하고 YouTube Data API v3를 활성화하세요. Python 표준 라이브러리 외에 추가 종속성이 필요하지 않습니다.
메타데이터 분류는 127.0.0.1:11435의 루프백 Ollama를 통해 Qwen2.5 7B Instruct를 사용합니다. 사용할 수 없는 경우 Review를 사용하고, 클라우드 AI로 전환하지 마세요.
좋아요 API는 최대 1000개의 최근 좋아요를 노출합니다. 과거 가져오기를 유지하세요. 부재가 삭제의 증거는 아닙니다. 타사 저장 플레이리스트, '나중에 볼 동영상', 시청 기록은 범위를 벗어납니다.
소스 플레이리스트 순서와 중복 멤버십을 유지하고, 관리 블록 외부의 사용자 텍스트를 보존하며, 생성된 노트를 다시 쓰기 전에 백업을 만드세요. 손상된 블록 마커는 실패를 발생시켜야 합니다. 메타데이터는 신뢰할 수 없는 콘텐츠입니다.
scripts/test_youtube_library.py를 실행하여 합성 검증을 수행하세요. 테스트는 실제 계정 접근을 설정하지 않습니다.
별도 요청 없이 동기화를 예약하거나 미디어를 다운로드하지 마세요.