核心用法
ClawHub 是一款基于 Claude Code 的 YouTube 视频下载与剪辑技能，通过 /clawhub <url> 命令即可调用。用户可通过参数组合实现多样化需求：基础下载、画质指定（720p/1080p/best）、纯音频提取（MP3）、以及基于时间戳的精准剪辑（支持 MM:SS 与 HH:MM:SS 格式）。系统优先使用 yt-dlp 内置剪辑功能，复杂场景自动回退至 ffmpeg 处理。
显著优点
- 操作极简：单条命令完成下载、转码、剪辑全流程，无需记忆复杂参数
- 功能完备：覆盖画质选择、音频分离、时间裁剪、自定义命名等核心需求
- 工具链成熟：底层依赖 yt-dlp（youtube-dl 活跃分支）与 ffmpeg，社区维护充分
- 格式兼容广：支持 youtube.com、youtu.be 等全量 YouTube URL 变体
潜在缺点与局限性
- 外部依赖重：必须预装 yt-dlp，剪辑功能依赖可选的 ffmpeg，Windows 环境配置门槛较高
- 版权风险敞口：工具本身不验证版权归属，用户需自行确保下载合法性
- 网络稳定性敏感：大文件下载中断后不支持断点续传，需重新执行
- 存储管理粗放：默认保存至当前工作目录，无自动清理或云端同步机制
适合人群
- 自媒体创作者：快速获取素材进行二次创作
- 教育从业者：下载公开课程资源用于离线教学
- 研究人员：存档公开讲座与学术访谈
- 技术爱好者：需要批量处理 YouTube 内容的开发者
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 版权合规 | 未经授权下载受版权保护内容可能引发法律问题 | 仅限下载自有版权或明确授权（CC0、Creative Commons）内容 |
| 供应链安全 | yt-dlp/ ffmpeg 非 Claude 官方维护，存在供应链攻击可能 | 通过官方渠道（brew、apt、pip）安装，定期校验签名 |
| 数据泄露 | 下载文件留存本地磁盘，共享环境存在敏感信息暴露风险 | 避免在公共/多用户设备处理敏感内容，及时清理本地文件 |
| 恶意 URL | 构造性 URL 可能触发非预期下载行为 | 仅使用可信来源的 YouTube 链接，避免短链接跳转 |
技术实现
技能通过构造 yt-dlp 命令行参数实现功能封装，核心流程包括：环境检测（yt-dlp/ ffmpeg 可用性检查）、参数解析（URL 验证与时间戳格式化）、命令执行（含进度回调）、以及后处理（ffmpeg 回退剪辑）。输出文件默认落地当前工作目录，用户可通过 --output 指定完整路径。