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>