抖音授权下载项目

项目定位

这是 D:\code\Scrapling\projects\douyin_authorized\ 下的独立授权下载项目。

当前实现采用：

• 本地 Tkinter 图形界面
• 原生 playwright.sync_api 长生命周期浏览器会话
• scripts/ 目录下的兼容入口转发

当前已实现功能

• 设置起始 URL
• 设置收藏夹名称
• 设置输出目录
• 设置浏览器配置目录
• 切换 download / play
• 切换：
  • 只保存元数据
  • 无头模式
  • 只在点赞时保存
  • 自动打开首条视频
  • 下载完成后删除 JSON
• 设置：
  • 登录等待秒数
  • 超时秒数
  • 最多保存条数
  • 最大并发下载
• 一键切换预设：
  • 点赞无限预设
  • 普通单条预设
  • 收藏夹预设
• 一键读取收藏夹列表
• 收藏夹下拉选择
• 实时查看运行日志
• 总体进度条
• 每个任务的单独进度条
• 停止当前任务
• 打开输出目录和浏览器配置目录
• 自动保存上一次使用的参数
• 命令行模式运行下载器
• 收藏夹下载断点续抓
• 已下载作品自动去重
• 重置当前收藏夹或全部收藏夹下载记录

目录结构

projects/douyin_authorized/
  README.md
  src/
    douyin_authorized_gui.py
    douyin_authorized_downloader.py
    douyin_authorized_gui_app.py
    douyin_authorized_downloader_core.py
    douyin_authorized_models.py
    douyin_authorized_config.py
    douyin_authorized_paths.py
  config/
  runtime/
  outputs/
  tests/

启动方式

图形界面：

cd D:\code\Scrapling
python scripts\douyin_authorized_gui.py

命令行：

cd D:\code\Scrapling
python scripts\douyin_authorized_downloader.py --url "https://www.douyin.com/video/123" --limit 1

如果你希望双击启动，也可以使用：

• D:\code\Scrapling\launch_douyin_gui.bat

相关文件

• 兼容 GUI 入口：D:\code\Scrapling\scripts\douyin_authorized_gui.py
• 兼容 CLI 入口：D:\code\Scrapling\scripts\douyin_authorized_downloader.py
• 中文说明文档：D:\code\Scrapling\docs\DOUYIN_AUTHORIZED_DOWNLOAD_CN.md

注意事项

• 这是“已授权内容处理工具”，不是全站通用抓取器。
• 收藏夹接口和抖音网页请求参数存在变动风险；当前实现优先复用真实浏览器登录态和页面环境来提高稳定性。
• 推荐流、点赞保存、收藏夹批量下载都依赖浏览器会话处于有效登录状态。
• 收藏夹断点记录默认保存在 D:\code\Scrapling\projects\douyin_authorized\runtime\favorite_progress.json