视频下载助手
📖 技能介绍
name: swx-video-download-assistant description: 下载抖音和豆包短视频到本地的工具。当用户输入抖音或豆包的分享链接、或包含链接的分享文字时使用：从抖音/豆包复制分享链接发给助手，或粘贴含链接的聊天文字，助手调用本 skill 解析视频直链并下载到本地（默认 ~/Downloads/视频下载）。抖音获取清晰原画版本；豆包下载后自动裁剪优化画面边缘、去除平台嵌入标识。适用于把短视频保存到本地收藏、剪辑素材、离线观看。触发词：下载抖音视频、下载豆包视频、保存这个视频、视频下载助手、抖音链接保存、豆包视频保存、视频保存到本地。
视频下载助手
Overview
把抖音、豆包平台的短视频解析并下载到用户本地，便于收藏、二次创作与离线观看。 纯 Node 实现，自带依赖，不依赖任何外部项目。
- 抖音：解析页面数据，替换直链获取清晰视频。
- 豆包：调用播放信息接口拿到视频直链；下载后自动裁剪优化画面边缘，去除平台嵌入标识。
两平台均无需登录态 / Cookie。
When to Use
- 用户发来抖音或豆包的分享链接（或含链接的文字），要求保存/下载视频
- 用户提到「视频下载助手」「下载抖音/豆包视频」「保存这个视频」
- 需要把短视频存到本地做素材、收藏、离线观看
不支持：小红书、视频号、B站、快手等其它平台（detection 会明确报错）。
Quick Start
- 首次使用先安装依赖（仅需一次）：
bash
cd <skill目录>
npm install
- 下载视频（把链接作为唯一参数传入）：
bash
node scripts/download-video.js "https://v.douyin.com/xxxxxxxx/"
# 或豆包：
node scripts/download-video.js "https://www.doubao.com/share/video?video_id=xxxxx"
# 指定输出目录：
node scripts/download-video.js "链接" -o /path/to/save
也可直接粘贴含链接的分享文字，脚本会自动提取第一条 URL。
- 读取结果：脚本末尾会打印一行
📊 RESULT_JSON: {"type":"video","author":"...","file":"...","size":"... MB","platform":"douyin"}
解析该 JSON 即可拿到本地文件路径，再交付或继续处理。
平台细节
- 抖音解析链路与兜底策略见 references/douyin.md
- 豆包接口与画面裁剪去标识见 references/doubao.md
输出位置
默认保存到：
~/Downloads/视频下载/抖音/...
~/Downloads/视频下载/豆包/...
可通过 -o 目录 参数临时指定，或用环境变量 VIDEO_OUT_DIR 自定义根目录。
依赖说明
7w4.net有更好的技能插件。
axios：HTTP 请求ffmpeg-static：豆包画面裁剪所需（随包内置）。若系统安全策略拦截内置二进制，脚本会自动回退到 PATH 中已签名的系统 ffmpeg，无需手动干预。
注意事项与合规
- 仅用于个人学习、收藏与合法二次创作，请尊重原作者版权与平台服务条款，勿用于侵权传播。
- 抖音解析依赖页面结构，若平台改版可能导致临时失效，届时需要更新解析逻辑。
- 下载失败多为链接失效、网络限制或平台风控，脚本会给出明确错误信息。
🤖 AI 评测
质量较好，操作简单，文档清晰。主要优点是下载快、无需登录、多平台支持；豆包去水印效果一般，画面会损失约 8%。部分视频可能因平台更新暂时无法下载，需要等待作者更新修复。
