SuperAPI AI 工具集

youtube-notetaker

通用与其它

查看项目

更新于 10-16 05:54

技能介绍

用途:把 YouTube 演讲/讲座整理成个人本地学习库。每段视频对应一个纯 Markdown 文件,包含按时间戳截取的幻灯片、完整带时间戳转录文本和可编辑笔记;自带小型服务器把库渲染成浏览器中的交互式深读页面,所有内容都是磁盘上完全归你所有的文件。

主要能力:以 Markdown 库为唯一数据源;文件名 slug 即 YouTube ID;frontmatter 存视频元数据与 slides 数组,正文存 [HH:MM:SS] 转录行;_media/ 存放按视频命名空间化的幻灯片图片。服务器 scripts/serve.py 提供前端页面与 API:GET /api/video-deepdives 列出全部视频,GET /api/video-deepdives/<id> 返回单个视频,GET /api/video-deepdives/_media/<file> 提供图片,PATCH 写回笔记。新增视频只需写入 Markdown 与媒体文件,几乎无需改动 HTML。

必要用法:需要 yt-dlp、ffmpeg 在 PATH 中,以及 Python 3 与 Pillow、PyYAML(pip install yt-dlp pillow pyyaml)。启动服务器:python3 scripts/serve.py --dir ~/video-deepdives --port 8000。添加视频流程:setup.sh 解析 ID 并检查是否允许嵌入;download.sh 下载视频与字幕;detect_slides.sh 做场景检测;contact_sheet.py 生成联系表供人工筛选,将保留时间戳写入 keep.txt;extract_slides.py 抽取幻灯片并安装到 _media;vtt_to_transcript.py 生成转录;write_library_item.py 组装 Markdown;最后 serve.py 加 verify.sh 验证。

适用场景:系统化学习技术演讲、讲座,需要幻灯片加转录加笔记的本地资料库。

限制:需要上述上游工具与本地环境;不授权破坏性、生产、付费或外部消息操作;嵌入被禁用(oembed 401)时无法内联播放,只能给“在 YouTube 打开该时刻”链接;媒体文件名必须带 YTID 前缀避免冲突。收费、价格等信息暂未提供。