适合，如果你

• 你要在 Python 3.8+ 中批量下载个人主页的 post、like、mix 或 music。

  README 的“Requirements”和“Feature Overview”列出 Python 3.8+ 及 `/user/{sec_uid}` 的四种 mode。
• 你需要 SQLite 下载历史、默认 5 并发、重试和 increase.post 等磁盘增量下载。

  README 的“Feature Overview”和“Key Config Fields”分别列出 SQLite history、默认 concurrency 5、指数退避及 increase.post/like/mix/music。
• 你要把下载器作为 REST API，以 --serve --serve-port 8000 提交任务并查询状态。

  README 的“Run as REST API server”给出该命令，并列出 `/api/v1/download`、`/api/v1/jobs` 和 `/api/v1/health`。
• 你只需要 post 的浏览器回退，且能安装 Playwright Chromium 并手动完成 CAPTCHA。

  README 的“Install dependencies”和“FAQ”要求安装 playwright、Chromium，并说明浏览器回退对 post 已完整验证。

不适合，如果你

• 你必须让 collect 或 collectmix 与 post、like、mix、music 同时运行。

  README 的“Current Limitations”明确要求 collect/collectmix 单独使用，不能组合其他 mode。
• 你需要对 favorites collection 使用 increase 增量停止。

  README 的“Current Limitations”说明 increase 只适用于 post/like/mix/music，favorites collection 不支持 incremental stop。
• 你的交付物必须是无需额外处理的可播放 HLS 直播文件。

  README 的“Current Limitations”说明 HLS 只保存 playlist，需 ffmpeg 才能得到 playable output。
• 你要求所有直播场景都经过验证并具备稳定支持。

  README 的“Current Limitations”明确称 webcast room endpoint 未验证所有 live scenario，并标记为 experimental。

前置条件

• Python 3.8+，支持 macOS / Linux / Windows。 / Python 3.8+, with macOS, Linux, and Windows support.
• 先执行 README 原文命令 pip install -r requirements.txt。 / Run the README command pip install -r requirements.txt first.
• 浏览器回退需要 playwright 和 Chromium：pip install playwright；python -m playwright install chromium。 / Browser fallback requires playwright and Chromium: pip install playwright; python -m playwright install chromium.
• 默认配置使用 cookies 字段，README 示例包含 ttwid、odin_tt 和 passport_csrf_token。 / The sample configuration uses cookies fields including ttwid, odin_tt, and passport_csrf_token.
• Docker 部署需要 Dockerfile，以及 config.yml 和 Downloaded 挂载路径。 / Docker deployment requires the Dockerfile plus mounted config.yml and Downloaded paths.
• 转写需要 transcript.enabled、有效 OPENAI_API_KEY 或 transcript.api_key，模型示例为 gpt-4o-mini-transcribe。 / Transcription requires transcript.enabled and a valid OPENAI_API_KEY or transcript.api_key; the example model is gpt-4o-mini-transcribe.

第一步命令（README 原文）

pip install -r requirements.txt

要注意

• 遇到只下载约 20 条 post 时，README 要求开启 browser_fallback.enabled、关闭 headless 并手动完成验证。

  README 的 FAQ“Why do I only get around 20 posts?”。
• collect 与 collectmix 依赖登录 cookies 对应账号，不能用于任意账号的收藏集合。

  README 的“Current Limitations”。
• SQLite history 不负责决定增量跳过，真正的磁盘跳过由 increase.post/like/mix/music 控制。

  README 的“Feature Overview”和“Key Config Fields”。
• image-note 不生成转写文件，transcript 只对 video items 生效。

  README 的“Optional Feature: Video Transcription”和 FAQ“Why are transcript files not generated?”。
• progress.quiet_logs 默认示例为 true；调试时 README 指定使用 --show-warnings 或 -v。

  README 的 Minimal Working Config 和 FAQ。

材料未说明

• 材料没有说明抖音接口、cookies 有效期及账号风控规则。 / The materials do not specify Douyin API behavior, cookie lifetime, or account risk-control rules.
• 材料没有给出不同规模下载任务的实际吞吐量、磁盘占用或内存需求。 / The materials provide no throughput, disk-usage, or memory figures for different download scales.
• 材料没有说明 Docker 镜像基础版本、Playwright Chromium 版本或 ffmpeg 的安装方式。 / The materials do not specify the Docker base version, Playwright Chromium version, or how to install ffmpeg.
• 材料没有提供 Desktop App（Douzy）章节、cookies 获取完整流程及免责声明正文。 / The provided materials omit the Desktop App (Douzy) section, the full cookie-acquisition flow, and the disclaimer text.
• 材料没有说明 REST API 的认证、并发上限或生产环境安全配置。 / The materials do not specify REST API authentication, concurrency limits, or production security settings.
• 材料没有给出 2026-09-14 Trending 上榜与 452 个新增星之间的具体因果证据。 / The materials provide no causal evidence linking the 2026-09-14 Trending entry to the 452 new stars.