VideoHub Douyin Download

复用 F:/work/VideoHub/src/douyin_cli.py。

适用场景

• 下载单个抖音视频
• 下载用户主页作品
• 处理分享文本中的抖音链接
• 指定下载目录

常用命令

python src/douyin_cli.py "https://v.douyin.com/xxxxx/"
python src/douyin_cli.py "https://www.douyin.com/video/xxxxx" -o "workspace/douyin_downloads"
python src/douyin_cli.py "https://www.douyin.com/user/xxxxx" --cookie "your_cookie" --limit 3

前置条件

• 单视频优先使用 f2，解析失败或依赖不可用时自动回退 DLPanda；不再需要本地 douyinVd 服务。
• f2 返回 HTTP 403 后，同一程序进程内相同 Cookie/代理/UA 配置暂停该来源15分钟，期间公开单视频直接走 DLPanda；到期或配置变更后再试，不表示已修好F2接口。查看带作品ID、实际来源与保存路径的阶段结果，不把“解析完成”当作文件已下载。
• DLPanda 只用于公开单视频链接回退，绝不能向它转发用户的抖音 Cookie。
• 用户主页批量下载需要有效 Cookie 和可用的 f2 环境。
• 当前 CLI 默认保存视频和封面，不保存 JSON 元数据，不下载音乐。

注意

• 用户主页批量下载已有入口，但失败原因可能是 Cookie 缺失/失效、f2 缺失、主页不可访问或解析不到作品；不要在未实际运行前承诺一定可下载。
• 若用户给的是分享口令文本，先提取出 URL 再调用 CLI。