context-mode 上下文管理模式：从全量到摘要的工程实践
2026/10/8 14:10:36
MediaBatchTool （抖音视频作品批量下载工具）客户端使用说明书
适用版本：MediaBatchTool 1.0.1
适用对象：客户端普通用户
适用系统：Windows 10 / 11（64 位）
(关注不迷路哈！！！)
文章目录
- MediaBatchTool （抖音视频作品批量下载工具）客户端使用说明书
- 第一章 软件简介
- 1.1 功能概述
- 1.2 授权模式
- 1.3 免责声明
- 第二章 安装与启动
- 2.1 安装
- 2.2 启动方式（三选一）
- 2.3 首次运行：自动安装运行环境
- 第三章 界面介绍
- 3.1 工具栏页面导航
- 3.2 主页区域划分
- 第四章 使用流程
- 4.1 第一步：获取登录 Cookie（必做）
- 方式一：独立网页登录获取 Cookie（推荐）
- 方式二：从剪贴板读取 Cookie
- 4.2 第二步：配置下载参数
- 4.3 第三步：开始下载
- 4.4 下载结果说明
- 第五章 授权与套餐
- 5.1 软件激活（付费用户）
- 授权安全机制
- 5.2 购买套餐
- 5.3 套餐权益对照表
- 5.4 关于页面
- 第六章 配置文件说明
- 第七章 常见问题（FAQ）
第一章 软件简介
1.1 功能概述
MediaBatchTool（抖音视频作品批量下载工具）是一款桌面端短视频作品批量下载工具，主要功能：
- 通过用户主页链接或 UID 批量抓取指定账号的作品列表；
- 支持下载视频、视频转音频（MP3）、视频封面、图文作品图片；
- 支持生成
作品记录.xlsx，记录作品 ID、作品类型、标题、点赞数、评论数、收藏数、发布日期等； - 支持指定单个作品下载（纯数字作品 ID 或带
modal_id的主页链接）； - 内置运行环境自动检测与安装（Node.js、Playwright、Chromium、FFmpeg），无需手动配置；
- 已下载文件智能跳过，重复运行自动增量更新。
1.2 授权模式
软件采用"免费基础版 + 付费套餐"模式：
- 免费基础版：安装即可使用，无需注册码。权益为仅保存视频、并发下载 1、每个账号最多加载 3 个作品、有效期 365 天；
- 付费套餐：按"版本 / 并发数 / 最多加载量 / 有效期"自由组合，联系作者付款后获得注册码激活。
1.3 免责声明
本软件仅供学习和交流参考。使用前请自行核实，遵守平台规则，风险自担。
第二章 安装与启动
2.1 安装
运行安装包MediaBatchTool_1.0.1_Release.exe，按向导提示安装，默认安装到D:\MediaBatchTool。安装后目录结构：
| 文件 / 文件夹 | 说明 |
|---|---|
MediaBatchTool.exe | 主程序 |
config.ini | 用户配置文件（Cookie、保存目录、功能开关等） |
browser_profile\ | 内置浏览器登录数据目录，保存平台登录态；删除后需重新登录 |
Downloads\ | 默认作品保存目录 |
node\、tools\ | 便携 Node.js 运行环境与抓取脚本（首次运行自动安装生成） |
RunLog\ | 运行日志目录 |
unins000.exe | 卸载程序 |
注意：卸载会删除整个安装目录（含已下载作品和配置），卸载前请先备份
Downloads文件夹和config.ini。
2.2 启动方式（三选一）
- 双击桌面上的MediaBatchTool快捷方式；
- 打开开始菜单，点击MediaBatchTool；
- 直接进入安装目录，双击
MediaBatchTool.exe。
2.3 首次运行：自动安装运行环境
首次点击【开始运行】时，软件会自动检测并安装运行环境，全程联网自动完成：
- 便携版Node.js（释放到
node\目录）； - Playwrightnpm 包（安装到
tools\node_modules\）； - Chromium浏览器内核（安装到
tools\ms-playwright\）； - FFmpeg（用于视频转音频）；
- PowerShell 7（脚本执行环境）。
安装日志实时显示在主界面日志区，下载优先使用国内镜像源，失败自动回退备用源。如环境组件损坏（无法执行），软件也能识别并重新安装。安装完成后再次使用无需重复安装。
第三章 界面介绍
3.1 工具栏页面导航
主窗口顶部为工具栏，包含以下页面入口：
| 工具栏按钮 | 页面内容 |
|---|---|
| 主页 | 配置与运行、Cookie 信息、手动获取 Cookie 示意图、下载进度、运行日志 |
| 软件激活 | 查看机器码、粘贴注册码激活、清除本机授权 |
| 购买套餐 | 查看套餐组合与价格、复制购买信息、联系作者 |
| 关于 | 作者联系方式、微信赞赏码、视频号、CSDN 链接、免责声明 |
3.2 主页区域划分
主页自上而下分为四个区域：
- 配置与运行：用户链接、指定作品 ID、保存目录、下载参数和功能开关、开始/停止按钮；
- Cookie 信息：登录 Cookie 的获取与展示；
- 下载进度：按并发数动态生成进度条，两列网格显示线程编号、作品 ID、当前阶段和百分比，下载中 / 完成 / 失败以不同颜色区分；
- 运行日志：全局实时运行日志，同时按日期保存到日志目录。
第四章 使用流程
4.1 第一步：获取登录 Cookie（必做）
下载作品前必须提供有效的平台登录 Cookie。在主页Cookie 信息区域，有两种获取方式：
方式一：独立网页登录获取 Cookie（推荐）
- 点击【独立网页登录获取 Cookie】；
- 程序自动打开内置 Chromium 浏览器（缺少运行环境时会先自动安装）；
- 在浏览器中扫码或账号密码登录平台；
- 登录成功后软件自动提取 Cookie，并同步采集浏览器指纹信息（User-Agent、屏幕、CPU、内存、网络等）写入
config.ini。
登录态保存在browser_profile\目录，下次抓取时自动复用并预热 Cookie。
方式二：从剪贴板读取 Cookie
- 在 Chrome / Edge 浏览器中登录平台网页版，从开发者工具的请求头中复制 Cookie；
- 点击【从剪贴板读取 Cookie】，软件自动整理并保存。
支持直接粘贴：纯 Cookie 串、带
Cookie:前缀的请求头、cURL 命令、插件导出的 JSON，程序会自动整理为可用格式，并同步刷新浏览器指纹配置。主页还附有"手动获取 Cookie 示意图"供参考。
4.2 第二步：配置下载参数
主页【配置与运行】区域各项说明：
| 配置项 | 说明 |
|---|---|
| 用户链接 UID | 粘贴完整用户主页链接（如https://www.douyin.com/user/...），程序自动提取 UID；也可点击【从剪贴板读取 UID】一键提取；还可点击【在线搜索 UID】 |
| 指定作品 ID | 只读框，从用户链接自动识别。链接中带modal_id参数时自动填入，此时仅下载该单个作品；也支持纯数字作品 ID 和/video/{id}链接 |
| 视频保存目录 | 默认D:\MediaBatchTool\Downloads；【选择目录】更换路径，【打开目录】用资源管理器查看已下载文件 |
| 最大并发下载数量 | 1～8，同时下载的任务数（免费版固定为 1，付费套餐按授权限制） |
| 加载提醒阈值 | 抓取作品列表达到该数量时弹窗询问是否继续加载；设为"不限"则一次抓完 |
| 单视频分片数 | 1～8，默认 4。大视频文件使用 Range 分片下载提速，服务器不支持或分片失败时自动回退普通下载 |
| 功能开关 | 【保存视频】【视频转音频】【保存图片】【写入 Excel】四个勾选项，按套餐权益可用 |
配置修改后会保存到config.ini（任务运行期间配置控件会锁定，防止误改）。
特殊模式：只勾选【写入 Excel】而不勾选任何媒体项时，进入"只写 Excel"模式，仅抓取作品信息生成作品记录.xlsx，不下载媒体文件。
4.3 第三步：开始下载
- 确认 Cookie 有效、配置无误后，点击【开始运行】；
- 软件按以下顺序执行：
- 检查运行环境（缺失自动安装）→ 检查 Cookie 信息 → 检测登录态；
- 后台浏览器抓取作品列表（失败时自动回退可视浏览器重试）；
- 持续滚动加载，达到"加载提醒阈值"时询问是否继续；
- 按勾选项生成下载任务，按并发数派发下载；
- 中途点击【停止】可在抓取、登录检测、下载派发等阶段安全停止任务；
- 关闭窗口时若任务仍在运行，会提示确认是否强制取消。
4.4 下载结果说明
- 按账号昵称创建子目录保存，文件名自动清理非法字符，支持中文目录；
- 视频作品保存为 MP4，封面保存为图片；
- 图文作品按作品 ID 创建子目录，图片按序号保存为 JPEG；
- 勾选【视频转音频】时通过 FFmpeg 导出 MP3（仅保存音频时使用临时视频文件，导出后自动清理）；
- 勾选【写入 Excel】时在保存目录生成
作品记录.xlsx，记录作品 ID、作品类型、标题、点赞数、评论数、收藏数、发布日期和记录日期； - 智能跳过：已存在的视频、音频、封面、图文文件自动跳过，重复运行不会重复下载，适合增量更新。
第五章 授权与套餐
5.1 软件激活（付费用户）
免费基础版用户无需激活，可直接使用。付费用户激活步骤：
- 点击工具栏【软件激活】进入激活页，页面顶部显示当前授权状态和本机机器码（
YHS-开头的八组四位十六进制字符）； - 向作者提供机器码并付款后，作者会发放注册码；
- 复制完整注册码，点击【从剪贴板读取注册码】粘贴到注册码框；
- 点击【激活】，页面显示许可证 ID、套餐权益和到期时间即激活成功；
- 如需更换授权，点击【清除本机授权】后重新激活（新码会覆盖旧码）。
授权安全机制
- 授权文件存储在
%AppData%/MediaBatchTool，受Windows DPAPI加密保护，仅同一 Windows 用户在同一设备可读取，复制到其他电脑或账户无效； - 注册码绑定机器码，粘贴其他机器的注册码会提示"注册码不属于当前机器"；
- 系统时间回拨超过 5 分钟会阻止使用，恢复正确时间后即可；
- 任务运行中每约一分钟复核授权，授权失效会自动停止任务并跳转激活页；
- 免费期到期或授权过期后，可回到免费基础版或续费激活。
5.2 购买套餐
点击工具栏【购买套餐】进入购买页，页面分为设备信息、套餐选项和购买操作三个区域：
- 设备信息区：显示当前机器码，可复制；点击【获取当前激活套餐】查看本机已激活的套餐；
- 套餐选项区：四项单选自由组合——
- 版本：基础版（视频）/ 专业版（视频、视频封面、Excel）/ 高级版（视频、视频转音频、视频封面、Excel）；
- 并发下载数：1 / 2 / 4 / 8；
- 最多加载量：3 / 30 / 300 / 不限制（每个账号最多抓取的作品数）；
- 有效期：7 / 30 / 180 / 365 天；
- 价格区：实时显示当前组合的套餐名称、参考价格和权益说明。付费套餐以 ¥2.99 为基础价，所有组合价格唯一；
- 购买操作区：
- 点击【复制购买信息】，将机器码、套餐 ID、套餐名称、金额和权益说明复制到剪贴板；
- 点击【联系作者激活套餐】跳转关于页，添加作者微信，发送购买信息并付款；
- 作者确认付款后发放注册码，回到【软件激活】页面激活。
续费规则：相同机器码购买相同套餐，有效期在剩余时长基础上自动叠加；续期或变更套餐由作者重新签发注册码，新码激活后覆盖旧码。
5.3 套餐权益对照表
| 权益项 | 免费基础版 | 付费基础版 | 专业版 | 高级版 |
|---|---|---|---|---|
| 保存视频 | ✔ | ✔ | ✔ | ✔ |
| 保存封面 / 图文图片 | ✘ | ✘ | ✔ | ✔ |
| 写入 Excel | ✘ | ✘ | ✔ | ✔ |
| 视频转音频 | ✘ | ✘ | ✘ | ✔ |
| 并发下载数 | 1 | 1 / 2 / 4 / 8 可选 | 同左 | 同左 |
| 每账号最多加载作品 | 3 | 3 / 30 / 300 / 不限 可选 | 同左 | 同左 |
| 有效期 | 365 天 | 7 / 30 / 180 / 365 天可选 | 同左 | 同左 |
| 价格 | 免费 | ¥2.99 起 | 按组合计价 | 按组合计价 |
5.4 关于页面
- 微信交流码、微信赞赏码、作者视频号二维码（支持窗口缩放自适应）；
- 【复制微信号】一键复制作者微信号；
- 个人 CSDN 博客链接，点击【打开 CSDN】访问；
- 赞赏入口与免责声明。
第六章 配置文件说明
config.ini位于安装目录，保存所有用户配置：
| 配置段 | 主要字段 | 说明 |
|---|---|---|
[account] | loginCookie、userSecUid | 登录 Cookie 与用户 UID |
[output] | saveVideo、saveAudio、saveImage、saveFolder、isWriteToExcel、excelFileName | 保存开关、保存目录、Excel 文件名 |
[runtime] | downloadConcurrency、videoSegmentCount、maxLoadCount | 并发数、分片数、加载阈值 |
[browser] | userAgent、browserName、screenWidth、cpuCoreNum等 | 浏览器指纹信息，获取 Cookie 时自动采集，请勿手动修改 |
注意：手动把并发数、加载量、功能开关改到超出套餐权益时，启动任务前软件会按当前授权自动修正并提示。
第七章 常见问题（FAQ）
Q1：首次运行卡在运行环境安装？
A：安装需联网下载 Node.js、Chromium、FFmpeg 等组件，默认走国内镜像。网络异常时可取消后重新点击【开始运行】，会从中断处继续；也可查看RunLog\日志定位原因。
Q2：抓取不到作品列表或提示未登录？
A：Cookie 已失效。重新通过【独立网页登录获取 Cookie】登录；若browser_profile\目录被删除，也需要重新登录。后台抓取失败时软件会自动回退可视浏览器重试，请留意弹出的浏览器窗口完成人机验证。
Q3：勾选的音频 / 封面 / Excel 功能运行时被自动取消？
A：当前套餐权益不包含该功能，软件启动前会按授权自动修正。免费版仅支持保存视频，升级套餐请到【购买套餐】页面。
Q4：粘贴链接后没有识别出作品 ID？
A：只有作者主页链接中的modal_id参数才识别为指定作品，单独出现的vid不会识别。精选页链接无法提取作者 UID 时，请先进入作者主页再复制带 UID 和modal_id的链接；或直接填写纯数字作品 ID。
Q5：注册码激活失败提示"签名无效"或"不属于当前机器"？
A：注册码必须完整复制（一个字符都不能少），且与当前电脑机器码绑定。换电脑需联系作者按剩余服务期重发新码。
Q6：提示"系统时间异常"无法使用？
A：软件检测系统时间回拨超过 5 分钟会阻止使用，将系统时间恢复正确后重试即可。
Q7：卸载软件会删除已下载的作品吗？
A：会。卸载程序会删除整个安装目录（含Downloads、config.ini、运行环境）。卸载前请先将Downloads和config.ini备份到其他位置。
本说明书基于 MediaBatchTool 1.0.1 编写。配套文档：《MediaBatchTool_安装使用卸载教程》。