name: swx-video-download-assistant description: 下载抖音和豆包短视频到本地的工具。当用户输入抖音或豆包的分享链接、或包含链接的分享文字时使用：从抖音/豆包复制分享链接发给助手，或粘贴含链接的聊天文字，助手调用本 skill 解析视频直链并下载到本地（默认 ~/Downloads/视频下载）。抖音获取清晰原画版本；豆包下载后自动裁剪优化画面边缘、去除平台嵌入标识。适用于把短视频保存到本地收藏、剪辑素材、离线观看。触发词：下载抖音视频、下载豆包视频、保存这个视频、视频下载助手、抖音链接保存、豆包视频保存、视频保存到本地。

视频下载助手

Overview

把抖音、豆包平台的短视频解析并下载到用户本地，便于收藏、二次创作与离线观看。 纯 Node 实现，自带依赖，不依赖任何外部项目。

• 抖音：解析页面数据，替换直链获取清晰视频。
• 豆包：调用播放信息接口拿到视频直链；下载后自动裁剪优化画面边缘，去除平台嵌入标识。

两平台均无需登录态 / Cookie。

When to Use

• 用户发来抖音或豆包的分享链接（或含链接的文字），要求保存/下载视频
• 用户提到「视频下载助手」「下载抖音/豆包视频」「保存这个视频」
• 需要把短视频存到本地做素材、收藏、离线观看

不支持：小红书、视频号、B站、快手等其它平台（detection 会明确报错）。

Quick Start

1. 首次使用先安装依赖（仅需一次）：

bash cd <skill目录> npm install

1. 下载视频（把链接作为唯一参数传入）：

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。

1. 读取结果：脚本末尾会打印一行

📊 RESULT_JSON: {"type":"video","author":"...","file":"...","size":"... MB","platform":"douyin"}

解析该 JSON 即可拿到本地文件路径，再交付或继续处理。

平台细节

• 抖音解析链路与兜底策略见 references/douyin.md
• 豆包接口与画面裁剪去标识见 references/doubao.md

输出位置

默认保存到：

~/Downloads/视频下载/抖音/...
~/Downloads/视频下载/豆包/...

可通过 -o 目录 参数临时指定，或用环境变量 VIDEO_OUT_DIR 自定义根目录。

依赖说明

• axios：HTTP 请求
• ffmpeg-static：豆包画面裁剪所需（随包内置）。若系统安全策略拦截内置二进制，脚本会自动回退到 PATH 中已签名的系统 ffmpeg，无需手动干预。

注意事项与合规

• 仅用于个人学习、收藏与合法二次创作，请尊重原作者版权与平台服务条款，勿用于侵权传播。
• 抖音解析依赖页面结构，若平台改版可能导致临时失效，届时需要更新解析逻辑。
• 下载失败多为链接失效、网络限制或平台风控，脚本会给出明确错误信息。

质量较好，操作简单，文档清晰。主要优点是下载快、无需登录、多平台支持；豆包去水印效果一般，画面会损失约 8%。部分视频可能因平台更新暂时无法下载，需要等待作者更新修复。