秒懂 v3.6.0
> 把视频榨成干货，秒懂。
🎯 一句话介绍
输入视频链接 → 秒懂自动下载、转写、分析 → 输出摘要/金句/字幕/卡片等结构化内容。
支持 B站、抖音、小红书、YouTube 及本地视频文件。
⚡ 功能一览
📝 核心分析
| 功能 | 怎么用 | 输出什么 |
|---|---|---|
| AI 摘要 | "帮我总结这个视频" | 3-5 段结构化摘要，提炼核心要点 |
| 完整分析 | --full-analysis |
摘要 + 金句 + 思维导图 + 评分，一次全出 |
| 章节分段 | --chapters 或 "把视频分章节" |
按内容自动拆分 3-5 章，带时间戳 |
| 内容评分 | --score 或 "给视频打分" |
信息密度、表达质量、推荐度等维度评分 |
💎 内容提取
| 功能 | 怎么用 | 输出什么 |
|---|---|---|
| 金句提取 | --quotes 或 "提取金句" |
精选 5-10 条金句，附时间戳定位 |
| 思维导图 | --mindmap 或 "做个脑图" |
Markdown 格式层级导图 |
| 时间戳标记 | --timestamps 或 "标出重点时间" |
关键节点的时间定位，方便跳转 |
📤 导出与输出
| 功能 | 怎么用 | 输出什么 |
|---|---|---|
| 纯文本字幕 | --export-subtitles |
完整字幕文本（.txt） |
| SRT 字幕 | --export-srt |
带时间戳的标准 SRT 文件，可直接导入剪映/PR/VLC |
| 多语言字幕 🆕 | --translate-srt en,ja |
翻译字幕 SRT，支持英/日/韩/法等 10+ 种语言 |
| 分享卡片 | --share 或 "生成分享卡片" |
精美 PNG 图片，含摘要 + 视频信息 |
| 社交文案 | --social 或 "写小红书文案" |
适配小红书/朋友圈/微博的分享文案 |
🔍 高级功能
| 功能 | 怎么用 | 输出什么 |
|---|---|---|
| 长视频分块分析 🆕 | 自动（超过 1 小时视频触发） | 自动拆分→逐块分析→合并结果，不丢内容 |
| 竞品对比 | --compare url1,url2,url3 |
多个视频横向对比，分析差异和优劣 |
| 批量处理 | --batch url1,url2 |
一次处理多个视频，合并输出 |
| 多语言 | --lang en / --translate ja |
摘要输出为英/日/韩/法等 10+ 种语言 |
| 原始语言指定 | --source-lang en |
指定视频原始语言（默认自动检测） |
🚀 快速上手
# 最简用法：总结一个视频
python scripts/video_summarizer.py --url "https://www.bilibili.com/video/BVxxxxx"
# 完整分析（摘要+金句+导图+评分）
python scripts/video_summarizer.py --url "https://..." --full-analysis
# 摘要 + SRT 字幕
python scripts/video_summarizer.py --url "https://..." --export-srt
# 竞品对比
python scripts/video_summarizer.py --compare "url1,url2,url3"
# 本地视频
python scripts/video_summarizer.py --file "C:\Videos\lecture.mp4"
📋 全部参数
| 参数 | 说明 | 示例 |
|---|---|---|
--url |
视频链接 | --url "https://bilibili.com/video/BVxxx" |
--file |
本地视频路径 | --file "video.mp4" |
--full-analysis |
完整分析（摘要+金句+导图+评分） | |
--quotes |
提取金句 | |
--mindmap |
生成思维导图 | |
--chapters |
AI 章节分段 | |
--score |
内容评分 | |
--timestamps |
显示时间戳 | |
--share |
生成分享卡片图片 | |
--social |
社交文案（可选平台） | --social xiaohongshu |
--export-subtitles |
导出纯文本字幕 | |
--export-srt |
导出 SRT 字幕（带时间戳） | |
--translate-srt |
翻译字幕到指定语言（逗号分隔） | --translate-srt en,ja,ko |
--compare |
竞品对比，多个 URL 逗号分隔 | --compare "url1,url2" |
--batch |
批量处理，多个 URL 逗号分隔 | --batch "url1,url2" |
--lang |
摘要语言（默认 zh） | --lang en |
--source-lang |
视频原始语言（默认 auto） | --source-lang ja |
--translate |
翻译摘要到指定语言 | --translate ko |
--output |
输出文件路径 | --output result.md |
--force-cloud |
跳过敏感内容检测 | |
--skip-auto-install |
跳过自动安装依赖 | |
--version |
显示版本号 |
⚠️ 能力边界
| ✅ 能做 | ❌ 不能做 |
|---|---|
| 已发布的录播视频（B站/抖音/小红书/本地） | 直播、实时流、预告片 |
| 视频时长 ≤ 2 小时，文件 ≤ 500MB | 付费/会员专属视频、私密视频 |
| 单个视频或批量处理 | 审核中/转码中的视频 |
| 多语言转写与翻译 | 纯音乐/无语音视频的内容分析 |
🔒 数据隐私
- 使用阿里云 DashScope（通义听悟 + 通义千问）进行语音转写和内容分析
- 音频数据会上传至阿里云处理，处理完成后不会持久化存储
- 敏感内容管控：标题含"机密""绝密"等高危词 → 自动阻断；含"内部""隐私"等 → 弹窗提醒
- 用
--force-cloud可强制跳过检测（需自行承担风险）
🔧 环境要求
| 依赖 | 说明 |
|---|---|
| Python 3.8+ | 运行环境 |
| FFmpeg | 音视频处理（启动时自动检测） |
| DashScope API Key | 阿里云免费额度，新用户免注册费 |
| Python 包 | 启动时自动安装，或手动 pip install -r requirements.txt |
> 💡 环境一键配置：python scripts/check_env.py --setup
💬 错误提示
| 场景 | 提示 |
|---|---|
| 视频下载失败 | "视频暂时下不了，可能是链接失效或已删除" |
| API Key 未配置 | "去阿里云 DashScope 免费领一个" |
| FFmpeg 未安装 | "电脑上还没装 FFmpeg，装一下就行" |
| 转写失败 | "可能是音质太差或网络不稳定，重试一次" |
| 输出不完整 | 自动重试最多 2 次，切换不同策略 |
📖 更多
完整使用指南、场景指引、FAQ → 请参阅 README.md
