核心功能
本 skill 提供完整的 m3u8/HLS 流媒体视频下载解决方案,覆盖从网页 URL 提取到最终 MP4 合成的全链路工作流。
主要用法
1. URL 提取:针对网页链接,通过浏览器自动化注入 JavaScript 代码,从 HLS.js 播放器实例或全局 window 对象中嗅探 m3u8 地址
2. 主播放列表处理:自动识别多码率主播放列表(Master Playlist),支持选取最高画质(如 1080p)的子播放列表
3. 分段并行下载:使用 aria2c 实现 16 并发连接的高速下载,支持断点续传与多连接分片加速
4. 格式兼容:支持非标准扩展名(如 .jpeg 伪装的分段),自动处理 TS 流合并
5. 加密解密:完整支持 AES-128 加密流,自动提取密钥并调用 ffmpeg 解密合成
显著优点
- 高性能:aria2c 多线程下载显著优于单线程 curl/wget
- 完整链路:从网页 → m3u8 → 分段 → 解密 → MP4 一站式解决
- 灵活性:提供手动分步流程与快捷脚本两种模式,适应不同复杂度场景
- 格式鲁棒:处理非标准扩展名、相对/绝对 URL 混合等边缘情况
潜在局限
- 依赖外部工具:必须预装 aria2c 和 ffmpeg,跨平台兼容性受限(文档仅提供 macOS brew 安装指令)
- 脚本覆盖不全:快捷脚本明确说明不处理主播放列表、非标准扩展等复杂情况
- 浏览器隔离要求:提取 URL 需使用
profile=openclaw隔离浏览器,操作门槛较高 - 无内置重试机制:aria2c 配置虽支持断点续传,但对 403/451 等版权限制无特殊处理
适合人群
- 开发者/技术用户:熟悉命令行操作和流媒体协议
- 内容归档需求:需要下载受 AES-128 保护的合法授权视频
- 调试分析场景:排查 HLS 播放问题或验证加密实现
常规风险提示
- 版权合规:HLS/m3u8 常用于 DRM 保护的付费内容,未经授权下载可能违反服务条款及版权法
- 隐私安全:浏览器自动化可能暴露用户身份,需严格使用隔离 profile
- 密钥安全:AES 密钥明文传输,存在被中间人截获风险(若源站未使用 HTTPS)
- 存储占用:高分段数视频可能产生大量临时文件,需确保 /tmp 空间充足
---
本 skill 技术实现成熟,但使用场景需严格限定于合法授权内容的个人备份与技术分析。