核心用法
Video Summarizer 是一个面向视频内容工作者的自动化总结工具，通过命令行执行 ./video-summarize.sh "视频URL" 即可完成全流程处理。支持 B 站、YouTube、小红书、抖音四大平台，自动识别平台后并行下载字幕与视频，经 AI 分析生成包含关键概念、核心要点、视频章节、注意事项的结构化 Markdown 文档，并可选推送至 Notion 数据库。
显著优点
1. 多平台覆盖与智能降级：B 站/YouTube 优先使用官方字幕（Plan A，准确率 90%+），小红书/抖音自动切换语音转录（Plan B，三层降级保障）， Groq API → 本地 Faster-Whisper → Whisper.cpp 逐级兜底。
2. 端到端自动化：从 URL 输入到 Notion 推送全流程无需人工干预，AI 基于内容自动生成关键帧截图时间戳，ffmpeg 精准截取后上传阿里云 OSS，生成永久外链嵌入文档。
3. 性能优化设计：字幕下载与视频下载并行执行节省 32% 时间，GPU 自适应选择 Whisper 模型（显存 ≥8GB 用 large-v2，无 GPU 用 base CPU），支持断点续跑避免重复处理。
4. 结构化输出规范：输出包含 8 个标准模块（概述、视频信息、关键概念表、核心要点、视频章节、注意事项、总结），四层标签策略（标题 hashtag → 元数据 → AI 关键词 → 默认值）确保分类准确性。
潜在缺点与局限性
- 依赖链复杂：需同时配置 ffmpeg (≥6.1)、yt-dlp (≥2026.03.17)、Python 依赖、阿里云 OSS、DashScope API，任一环节缺失即中断。
- 隐私与成本风险：视频内容需上传至第三方 AI 服务（阿里云 DashScope），虽建议用非生产环境 API Key，但仍存在数据外泄可能；OSS 公开读取权限若配置不当可能导致截图泄露。
- 平台策略依赖：B 站官方字幕需用户主动扫码获取 Cookies，存在过期需重新登录问题；YouTube 需网络可达（可能需代理）。
- 转录质量波动：Plan B 语音转录准确率 80-90%，口音、背景音乐、低音质场景下降明显。
适合人群
- 知识型视频创作者/研究者：需要将大量教程、讲座、分享视频结构化归档
- Notion 重度用户：希望建立自动化视频知识库，替代手动笔记
- 技术背景用户：能熟练配置环境变量、排查依赖问题、理解 API 配额管理
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 密钥泄露 | ~/.openclaw/.env 存储 API Keys，若设备共享或备份不当易暴露 | 使用子账号 Key、设置 IP 白名单、定期轮换 |
| Cookies 滥用 | B 站 Session Token 存储于 ~/.cookies/，权限过高可能被恶意利用 | 专用设备使用、定期清理、不分享 Cookies 文件 |
| 数据残留 | /tmp/video-summarizer-*/ 临时文件可能包含完整视频/音频 | 配置自动清理脚本、敏感内容手动删除 |
| OSS 配置错误 | Bucket 公开可读权限若范围过大，截图可能被枚举访问 | 专用 Bucket、仅授予 PutObject/GetObject、启用防盗链 |