微信扫一扫秒懂 v3.3.18
把视频榨成干货，秒懂。
⚠️ 能力边界（必读）
执行任务前先确认是否在能力范围内，不在范围内直接告知用户：
| ✅ 能做 | ❌ 不能做 | | :--- | :--- | | 已发布的录播视频（B站/抖音/小红书/YouTube/本地） | 直播、实时流、预告片 | | 视频时长 ≤ 2 小时，文件 ≤ 500MB | 付费/会员专属视频、私密视频 | | 单个视频或批量处理 | 审核中/转码中的视频 | | 多语言转写与翻译 | 纯音乐/无语音视频的内容分析 |
功能概述
一键提取视频内容并生成结构化结果，支持 B站、抖音、小红书、YouTube 及本地视频。
| 功能 | 触发示例 | | :--- | :--- | | 📝 AI 摘要 | "帮我总结这个视频"、"这个视频讲了什么" | | 🎯 金句提取 | "提取视频里的金句"、"有什么精彩语录" | | 🧠 思维导图 | "给视频做思维导图"、"做个脑图" | | 📖 章节分段 | "把视频分章节"、"按段落总结" | | 📱 社交文案 | "帮我写小红书文案"、"发朋友圈怎么配文" | | 🖼️ 分享卡片 | "生成分享卡片"、"做个摘要图" | | 📄 字幕导出 | "导出字幕"、"提取字幕文本"、"给我字幕文件" | | ⏱️ 时间戳标记 | "标出重点时间"、"金句在第几分钟"、"关键节点时间戳" | | ⭐ 内容评分 | "这个视频打几分"、"给视频评个分"、"视频质量怎么样" | | 🔍 竞品对比 | "对比这几个视频"、"哪个视频讲得更好"、"这几个评测谁更客观" |
核心参数
| 参数 | 说明 |
| :--- | :--- |
| --url | 视频链接 |
| --file | 本地视频路径 |
| --full-analysis | 摘要+金句+导图+评分 |
| --chapters | AI 章节分段 |
| --social | 社交文案 |
| --share | 分享卡片 |
| --export-subtitles | 字幕导出 |
| --output | 输出文件路径 |
| --lang | 语言: zh/en/ja |
关键约束
- 仅支持已发布的录播视频，不支持直播/付费/私密/审核中视频
- 视频时长 ≤ 2 小时，文件 ≤ 500MB；超限视频告知用户剪辑后再处理
- 需要阿里云 DashScope API Key（新用户有免费额度，对话模式无需配置）
- 需要系统安装 FFmpeg（对话模式无需配置）
- 🔧 启动时自动检测并安装缺失的 Python 依赖；本地用户可用
python scripts/check_env.py --setup一键自动配置全部环境 - ⚠️ 输出完整性自检：分析完成后必须检查章节数、金句数、摘要长度是否合理。若章节不足 3 个或金句为空或摘要明显截断，自动重试一次转写+分析。重试后仍不完整，告知用户"视频较长，部分内容可能未完整覆盖，建议用章节分段模式重新处理"
执行流程
- 先对照「能力边界」检查用户请求是否在范围内，不在范围内直接告知原因
- 下载视频 → 提取音频 → 转写 → 分析
- 分析完成后执行「输出完整性自检」
- 遇到错误时，用通俗语言解释原因和解决办法，不要堆砌技术术语
错误提示规范
- 视频下载失败 → "这个视频暂时下不了，可能是链接失效、视频已删除或设为私密。检查一下链接或者换个视频试试？"
- API Key 未配置 → "还没配置 API Key，去阿里云 DashScope 免费领一个就行（https://dashscope.console.aliyun.com/），新用户免费"
- FFmpeg 未安装 → "电脑上还没装 FFmpeg（视频处理工具），装一下就行：Windows 去 ffmpeg.org 下载，Mac 用 brew install ffmpeg"
- 转写失败 → "语音转写没成功，可能是视频音质太差或网络不稳定，重试一次通常能解决"
- 输出不完整 → "结果看起来不太完整，正在自动重试…"
📖 完整使用指南、场景指引、FAQ、避坑指南 → 请参阅 README.md