Que fait stepkeeper ?
<Use_When>
- 사용자가 YouTube 하우투 URL을 공유하고 깔끔하고 따라하기 쉬운 텍스트/시각 가이드를 원할 때
- 사용자가 튜토리얼의 음성 설명이 모호하다고 느끼고 "보여주는" 프레임을 원할 때
- 사용자가 레시피나 절차를 노트 앱에 저장하고 싶을 때 </Use_When>
<Do_Not_Use_When>
- 동영상이 말하는 머리 강의, 브이로그, 리뷰 또는 시각적으로 확인 가능한 동작이 없는 팟캐스트인 경우
- 콘텐츠가 안전과 직결된 경우(의료, 전기, 가스, 중장비) — 전문가 검토 프로필이 필요합니다. </Do_Not_Use_When>
<How_To_Run>
하나의 명령으로 분석 → 캡처 → 선택 → 렌더링 → 내보내기를 수행합니다.
--language는 문서 언어(BCP-47: en, ko, ja, …)이며 동영상의 음성 언어가 아닙니다. 영어 하우투 동영상은 en 또는 ko 출력 모두 작동합니다.
-
완전 자동 (ffmpeg 없음, 스크린샷 대신 타임스탬프 링크):
- 한국어 문서:
stepkeeper <URL> --profile generic --language ko --links-only - 영어 문서:
stepkeeper <URL> --profile generic --language en --links-only
- 한국어 문서:
-
스크린샷 포함 완전 자동 (Gemini가 각 가이드별 프레임 선택):
stepkeeper <URL> --profile recipe --language en --auto-pick --export goodnotes재생성된picker.html을 검토하세요(AI가 미리 선택). 사용자가 수정하면python -m stepkeeper.feedback add <semantic-evaluation.json>을 실행하여 기록합니다. -
수동/에이전트 프레임 선택:
stepkeeper <URL> --profile recipe --language en- 에이전트 경로:
work/frames/…아래의 세 개 후보 프레임을 직접 읽고,picks.json을 직접 작성(의미 판단)한 후 다음을 다시 실행하세요:--picks <picks.json> --export goodnotes(또는obsidian/bundle/notion).
Notion 내보내기는 NOTION_TOKEN과 --parent <page-id>가 필요합니다.
아티팩트는 현재 디렉토리 아래에 생성됩니다(STEPKEEPER_DATA로 재정의 가능).
</How_To_Run>