支持从 YouTube、Bilibili、抖音及所有 yt-dlp 兼容平台下载视频，可自动选择最佳分辨率、合并音视频并清理文件名

核心用法

Video Downloader 是一款基于 yt-dlp 和 ffmpeg 的通用视频下载工具，兼容 YouTube、Bilibili、抖音等主流视频平台。用户通过 /video-downloader <URL> [分辨率] [输出目录] 指令即可快速下载视频，支持指定画质（默认优先 1080p）和自定义输出路径。工具会自动处理音视频分离问题、清理文件名中的特殊字符，最终返回本地文件路径供后续使用（如配合 sendfiles-to-feishu 发送）。

显著优点

1. 多平台兼容：依托 yt-dlp 强大的站点支持能力，覆盖数百个视频网站
2. 智能处理：自动选择最佳分辨率、合并分离的音视频流、生成安全文件名
3. 零质量损失：不重新编码，直接下载原始媒体流，保留源画质
4. 简洁可控：命令行参数清晰，支持临时目录或自定义输出路径

潜在缺点与局限性

• 依赖外部二进制文件：必须预装 yt-dlp 和 ffmpeg，安装门槛对非技术用户不友好
• 无内置发送功能：下载后需手动调用其他技能（如 sendfiles-to-feishu）完成分享
• 平台政策风险：部分网站（如 YouTube）禁止下载行为，存在账号或 IP 受限可能
• 无下载进度可视化：命令行工具通常缺乏图形进度反馈

适合人群

• 需要批量获取公开视频素材的内容创作者、研究人员
• 熟悉命令行操作的技术用户
• 有离线观看需求且尊重版权的个人用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 版权合规 | 下载受版权保护内容可能违反平台服务条款或当地法律 |

| 账号安全 | 频繁下载可能触发平台反爬虫机制，导致 IP 限制或账号封禁 |

| 恶意链接 | 处理未知来源 URL 时存在被引导至钓鱼网站的风险 |

| 依赖安全 | yt-dlp 和 ffmpeg 需从可信渠道安装，避免捆绑恶意软件 |

核心用法

video-downloader 是一款基于 yt-dlp 的通用视频下载技能，通过简单的命令行接口实现多平台视频获取。基础用法为：

/video-downloader <视频URL> [分辨率] [输出目录]

• 视频URL：必填，支持 yt-dlp 兼容的任意站点
• 分辨率：可选，默认自动选择最高可用（优先 1080p），可指定 720p、480p 等
• 输出目录：可选，默认为系统临时目录

执行后返回本地文件路径，需配合 sendfiles-to-feishu 等技能进行二次分发。

显著优点

1. 平台覆盖广：依托 yt-dlp 支持 1000+ 视频网站，涵盖 YouTube、Bilibili、TikTok、Twitter 等主流平台
2. 质量无损：直接拉取原始流，不重新编码，保留源画质与音频品质
3. 自动化处理：智能选择最佳分辨率、自动合并分离的音视频流、生成安全文件名（去除特殊字符、限制长度）
4. 轻量依赖：仅依赖 Python 标准库，外部工具通过包管理器（Homebrew）安装，依赖面可控
5. 开源透明：MIT-0 许可证，代码公开可审计，无商业限制

潜在缺点与局限性

• 无内置 URL 验证：当前版本未对输入 URL 进行格式校验或域名白名单限制，存在误用风险
• 路径遍历风险：输出目录参数未做规范化验证，理论上可能写入任意系统路径
• 网络行为不可控：依赖 yt-dlp 访问用户指定 URL，可能触及非预期域名
• 无原生发送功能：下载后需手动调用其他技能传输文件，工作流不够闭环
• 版权合规依赖用户：工具本身不判断内容版权状态，使用者需自行确保下载合法性

适合人群

• 内容创作者：本地备份参考素材、提取无水印源文件用于二次创作
• 研究人员：存档公开讲座、学术报告、纪录片等可能下架的内容
• 运营团队：批量获取竞品分析素材（需确保合规）
• 技术爱好者：需要可脚本化、可集成的视频下载方案

常规风险

| 风险类别 | 具体表现 | 缓解建议 |

|---------|---------|---------|

| 法律合规 | 下载受版权保护内容 | 仅用于已获授权或公共领域内容 |

| 信息安全 | 恶意 URL 可能触发非预期下载 | 手动审核 URL 来源，避免短链接 |

| 系统安全 | 路径遍历导致文件写入任意位置 | 使用默认输出目录或限定沙箱路径 |

| 隐私泄露 | 视频平台通过 IP 追踪下载行为 | 必要时配合代理或 VPN 使用 |

安全认证解读

安全评级 A 级（70分），属标准安全级别。主要扣分项为输入验证不足（RISK-002）和路径处理宽松（RISK-003）。Subprocess 调用 yt-dlp/ffmpeg 为功能必需，参数传递方式（列表而非字符串拼接）已降低注入风险。建议生产环境部署前实施 URL 白名单与输出目录限制，可提升至 S 级。