SuperAPI AI 工具集

video-ingest

设计与创作

查看项目

更新于 10-15 23:33

技能介绍

用途:通过 Inngest 事件总线摄取视频,自动完成下载、NAS 传输、转写、生成 vault 笔记和摘要增强。不要手动运行 yt-dlp、mlx-whisper、scp 或手动创建笔记。

主要能力:发送 pipeline/video.requested 事件后,管道依次触发 video-download(yt-dlp 下载并传输到 NAS)、transcript-process(mlx-whisper 转写,M4 Pro 约每小时视频 5 分钟)、content-summarize(生成带摘要的 vault 笔记)。支持批量发送事件,由 Inngest 排队并控制并发。

使用方式:发送事件命令为 joelclaw send pipeline/video.requested -d '{"url":"URL_HERE"}',旧别名 pipeline/video.download 仍可用。也可用 curl 向 http://localhost:8288/e/$INNGEST_EVENT_KEY 发送。发送前应做健康检查:curl http://localhost:8288/health、检查 worker(http://localhost:3111/)和 Docker 容器。worker 宕机时可用 kubectl -n joelclaw rollout restart deployment/system-bus-worker 重启并 joelclaw refresh。监控可用 kubectl logs 和 docker logs,或打开 http://localhost:8288 查看仪表盘。

适用场景:YouTube 或视频 URL 抓取;磁盘上已有音频文件或来自 Granola/Fathom 的原始文本转写;仅重跑摘要(发送 content/summarize.requested 并指定 vaultPath)。可选字段 maxQuality 默认 "1080",可设 "720"、"1080"、"4k"。

限制与注意:事件返回 200 但无进展时,常见原因是 Docker 到 worker 连接问题,可查日志中 "Unable to reach SDK URL"。不要直接运行 yt-dlp、mlx_whisper、scp,也不要手动创建 vault 笔记或使用 codex/后台任务处理视频。输出位置:视频与元数据在 NAS /volume1/home/joel/video/YYYY/SLUG/,笔记在 ~/Vault/Resources/videos/SLUG.md,并链接到每日笔记。具体环境配置与密钥等细节资料未提供。