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>