zlej123/stepkeeper

stepkeeper 是做什麼的？

<Use_When>

• 使用者分享 YouTube 教學網址，並想要一份乾淨、可跟隨的文字/視覺指南。
• 使用者抱怨教學中的口頭指示不明確，並想要「示範給我看」的畫面。
• 使用者想要將食譜/流程儲存到筆記應用程式中。 </Use_When>

<Do_Not_Use_When>

• 影片是講話式講座、Vlog、評論或 podcast，其中沒有可視覺解析的動作。
• 內容涉及安全關鍵領域（醫療、主電源、瓦斯、重型機械）——需要經過專家審查的設定檔。 </Do_Not_Use_When>

<How_To_Run> 單一指令驅動分析 → 捕捉 → 挑選 → 渲染 → 導出。 --language 是文件語言（BCP-47：en、ko、ja……），而不是影片的口語語言。英文教學影片可以使用 en 或 ko 輸出。

1. 全自動（無需 ffmpeg，使用時間戳記連結而非螢幕截圖）：

   • 韓文文件：stepkeeper <URL> --profile generic --language ko --links-only
   • 英文文件（英語使用者）：stepkeeper <URL> --profile generic --language en --links-only

2. 全自動含螢幕截圖（Gemini 為每個指南挑選影格）： stepkeeper <URL> --profile recipe --language en --auto-pick --export goodnotes 檢查重新產生的 picker.html（AI 已預先選取）；若使用者修正了任何內容， 請執行 python -m stepkeeper.feedback add <semantic-evaluation.json> 以記錄修正。

3. 手動/代理影格選取：

   • 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>