使用douyin-downloader工具可一键下载抖音合集视频，支持mix模式、自动去水印、保留高清画质，并按发布时间倒序命名文件、生成metadata.json和images子目录。
想把抖音上某个合集里的几十个视频一次性保存到本地，不用手动点开每个视频下载，还要避开水印和画质压缩问题，直接用 douyin-downloader 工具就能实现——它原生支持 mix 模式，专为合集设计，解析准确率高，且自动跳过已下载项。
获取合集链接
打开抖音 App 或网页版，找到目标合集页面，点击右上角「分享」→「复制链接」。注意必须是完整合集页链接，形如 https://www.douyin.com/mix/xxxxxx，不是单个视频链接，也不是用户主页链接。如果复制出来的是短链（如 dyurl.cn/xxx），需先在浏览器中打开并重定向到原始 mix 链接，否则工具无法识别。
这一步不能跳过，【链接格式错误会导致整个下载任务失败】，工具会报“invalid mix id”错误，且不提示具体原因。
配置并启动下载
方法一：命令行快速执行（推荐）
打开终端或命令提示符，进入 douyin-downloader 项目目录，执行：python main.py --mode mix --url "https://www.douyin.com/mix/xxxxxx"
方法二：使用 config.yaml 配置文件（适合多次复用）
编辑项目根目录下的 config.yaml，将 mode: 改为 mix，在 url: 后填入你的合集链接，保存后直接运行 python main.py 即可。
首次运行时会自动创建 downloads/mix/ 子目录，并按合集标题命名文件夹。下载过程中实时显示进度条、已下载数量、剩余时间，失败项会单独记录在 logs/error.log 中。
确保无水印与高清输出
第一步：确认工具版本 ≥ v2.4.0
旧版本对新合集结构兼容性差，可能漏解析部分视频或强制回退到带水印源。执行 git pull 更新代码，或从 GitHub 最新版重新 clone。
第二步：检查 config.yaml 中的 prefer_no_watermark: true 是否启用（默认开启）
该参数控制是否优先请求无水印视频地址。若设为 false，工具会降级使用带水印源，且不警告。
第三步：观察日志中的 resolution 字段
成功下载的每一行日志末尾都会标注类似 [1080p@50fps] 或 [4K@30fps]，说明已命中最高清无水印源；若出现 [720p@watermark]，说明当前视频仅提供带水印版本，工具不会强行跳过，但会在数据库中标记为“watermarked”，方便后续人工筛查。
处理下载完成后的文件
1. 进入 downloads/mix/合集名称_XXXXXX/ 目录
2. 所有视频按发布时间倒序命名，格式为 20260728_153244_作者昵称_标题前10字.mp4
3. 同目录下生成 metadata.json，含每个视频的原始ID、发布时间、点赞数、评论数、BGM信息
4. 若合集中含图文内容，会额外生成 images/ 子目录，保存高清封面与文字截图
这一步操作起来很简单，直接把整个文件夹拖进剪辑软件时间线就行，无需重命名或格式转换。
