📖 短视频去水印下载 Pro 使用说明书

✨ 功能概述

「短视频去水印下载 Pro」是一款专为抖音网页版（douyin.com）设计的高级下载助手脚本。它采用 DOM 元素稳定提取 与 网络请求智能捕获 双重保障机制，能够精准、稳定地获取当前播放的视频或图文内容，并提供一键下载功能。

核心特性

1. 智能识别与提取：自动识别网页中当前正在观看的视频或图文内容，无需手动复制链接。
2. 双重保障机制：
   • DOM 提取：直接从页面视频元素中获取高清链接。
   • 网络拦截：监听页面网络请求，捕获视频流地址，作为备用或回退方案。
3. 图文笔记支持：完美支持抖音图文笔记，可预览并单独或批量下载所有图片。
4. 信息全面展示：清晰展示作者昵称、ID、发布时间、文案、话题标签和封面图。
5. 灵活保存方式：
   • 浏览器默认下载：直接触发浏览器下载功能。
   • 目录选择保存：支持选择本地文件夹，将文件直接保存到指定目录（需浏览器支持 File System Access API）。
6. 便捷的操作面板：提供悬浮式控制面板，可最小化、关闭、拖拽，不干扰正常浏览。

---

🚀 安装指南

1. 安装用户脚本管理器
   首先，确保您的浏览器已安装 Tampermonkey（油猴）或 Violentmonkey（暴力猴）等用户脚本管理器扩展。
2. 安装本脚本
   将您提供的脚本代码复制，在脚本管理器中点击“创建新脚本”，粘贴代码并保存。确保脚本处于“已启用”状态。
3. 访问抖音网页版
   脚本仅在匹配 *://*.douyin.com/* 的域名下生效。打开 抖音网页版，刷新页面即可看到脚本加载。

---

🎮 使用说明

一、界面概览

脚本加载后，页面右侧会显示一个悬浮的控制面板，包含以下主要区域：

• 标题栏：显示“短视频下载 Pro”，并包含最小化（─）和关闭（✕）按钮。
• 保存路径设置区：用于选择和管理文件保存目录。
• 状态条：显示当前视频链接的捕获状态。
• 刷新按钮：手动触发脚本重新读取当前视频信息。
• 信息展示区：以表格形式展示提取到的视频/图文详细信息。
• 操作按钮区：提供“下载视频”和“下载封面”两个主要操作按钮。
• 底部状态区：显示当前下载进度和操作反馈信息。

关闭面板后，右下角会出现一个粉色下载图标按钮，点击可重新打开面板。

二、详细操作步骤

步骤 1️⃣：选择保存目录（可选但推荐）

• 点击面板中的 「📂 选择目录」 按钮。
• 浏览器会弹出一个授权窗口，请选择一个您希望保存下载文件的本地文件夹，并点击“确认”。
• 授权成功后，按钮上方会显示 📁 您的文件夹名称。
  • 提示：此功能需要浏览器支持 File System Access API（如 Chrome、Edge 等）。若不支持或您选择取消，文件将使用浏览器默认下载方式。

步骤 2️⃣：获取视频/图文信息

脚本会自动检测当前正在播放的视频。您也可以通过以下方式手动获取：

• 自动获取：当您滚动切换视频或页面URL发生变化时，脚本会自动重新分析。
• 手动刷新：点击面板中的 「🔄 刷新 / 读取当前视频信息」 按钮。

信息提取成功后，面板将显示：

• 作者信息：昵称、ID 和头像。
• 作品内容：文案、话题标签、封面图。
• 媒体预览：视频播放器预览或图文图片网格。

步骤 3️⃣：执行下载

• 下载视频：点击 「⬇ 下载视频」 按钮。
  • 视频：脚本会解析出无水印的视频地址并开始下载。文件名格式为 作者昵称-文案前25字.mp4。
  • 图文：若为图文笔记，此按钮将禁用。您可以直接点击每张图片右下角的下载图标，或点击 「⬇ 全部下载」 按钮进行批量下载。文件名格式为 作者昵称-图文第N张.jpg。
• 下载封面：点击 「🖼 下载封面」 按钮，将作品的高清封面图保存到本地。文件名格式为 作者昵称-封面.jpg。

---

⚙️ 高级功能与细节说明

功能点	说明
面板拖拽	按住控制面板的标题栏（显示“短视频下载 Pro”的区域）不放，即可自由拖拽面板到屏幕任意位置。
最小化/关闭	点击标题栏的 ─ 按钮可将面板收起，只保留标题栏；点击 ✕ 按钮关闭面板，之后可通过右下角的粉色图标重新打开。
实时链接捕获	顶部状态条的圆点会在捕获到视频流地址时变为绿色并闪烁，指示脚本正在后台工作。
图文图片预览	图文笔记的图片会以网格形式展示，鼠标悬停在图片上会显示下载按钮，方便单独保存。
链接显示	信息展示区最下方会显示提取到的视频直链地址，方便有需要的用户自行复制使用。

---

❓ 常见问题（FAQ）

Q1：为什么点击“下载视频”后提示“未找到视频链接，请确保视频正在播放”？
A： 这种情况通常发生在脚本还未完全捕获到视频流地址时。请确保视频已经开始播放（不是暂停或缓冲状态），稍等片刻（观察顶部状态条是否变绿），然后再次尝试下载。如果问题持续，可点击「刷新」按钮后重试。

Q2：下载的视频文件名为什么是乱码或不符合预期？
A： 脚本会将文件名中的特殊字符（如 \ / : * ? " < > | 等）替换为下划线 _，以确保文件能被操作系统正确保存。这是为了避免文件系统命名规则冲突。

Q3：选择目录后，文件仍然通过浏览器下载了，没有存到我选的文件夹里？
A： 这可能是因为：

1. 您的浏览器不支持 File System Access API（如部分旧版浏览器）。
2. 您在选择目录的弹窗中点击了取消或未授予完整权限。
3. 如果授权成功，但下载大文件时失败，脚本会自动回退到浏览器下载模式以确保文件能保存。

Q4：脚本对抖音图文笔记的支持怎么样？
A： 支持良好。脚本会智能识别图文内容，并将“视频”标签替换为“图片”。您可以在预览区看到所有图片的网格，并可以选择单独下载或一键批量下载。

Q5：为什么有时候状态条显示捕获到多条视频链接？
A： 脚本会拦截页面发出的多个网络请求。它通过一套评分机制（scoreVideoUrl 函数）筛选出最可能是无水印原片的那一条链接，您无需担心，脚本会自动做出最优选择。

---

⚠️ 注意事项

• 本脚本仅供个人学习、研究、欣赏之用，请勿用于任何商业或非法用途。下载他人作品时，请尊重原创作者的版权。
• 由于抖音网页版的 DOM 结构和 API 接口可能会不定期更新，如脚本出现失效情况，请关注后续更新版本。
• 如果在使用过程中遇到任何问题，可以尝试刷新页面或重启浏览器。