三步开始使用
首次启动会自动在工具文件夹内装好运行环境，之后每次启动只需数秒。
1
下载并解压下载上方 zip，解压到任意目录2
双击启动Mac 双击 启动.commandWindows 双击
windows一键启动.bat3
浏览器使用自动打开 127.0.0.1:8765粘贴链接 → 解析 → 下载
功能特性
下载的文件保存在工具文件夹的 downloads 目录。
🔍
解析真实地址
列出全部清晰度、音轨、文件大小与编码信息，可复制 CDN 直链。
⬇️
一键下载
自动补 Referer / UA 等防盗链请求头，支持断点续传与多线程。
🎞️
高清自动合并
B 站等平台分离的音视频轨，经 ffmpeg 自动合为完整 MP4。
🔒
数据不出本机
纯本地服务，Cookie 与下载记录都只存在你自己的电脑上。
支持的平台（1000+）
yt-dlp 持续更新支持站点，平台改版后更新引擎即可恢复。
哔哩哔哩 B站b23.tv 短链抖音快手微博
小红书西瓜视频YouTubeX / TwitterBBC
以及更多…
安装与启动（按系统）
- 解压 zip，双击
启动.command，首次运行等待自动配置（约 1–3 分钟，取决于网速）。 - 若提示“无法打开，因为无法验证开发者”：在文件上右键 → 打开 → 打开，之后即可正常双击。
- 出现 “✅ ffmpeg 下载完成” 后浏览器自动打开页面，粘贴链接即可使用。
- Apple 芯片（M1/M2/M3/M4）首次运行按提示允许安装 Rosetta 2，或执行
brew install ffmpeg。
前置要求：系统自带或通过
xcode-select --install / python.org 安装 Python 3 即可，启动脚本会引导。- 先安装 Python 3，安装第一屏务必勾选 “Add Python to PATH”。
- 解压 zip，双击
windows一键启动.bat，首次自动安装依赖与 ffmpeg。 - SmartScreen 拦截时点「更多信息 → 仍要运行」；脚本为明文，可右键编辑查看每一步。
- 完成后浏览器自动打开页面即可使用，关闭命令行窗口即停止服务。
- 安装依赖：Debian/Ubuntu 执行
sudo apt install python3 python3-venv ffmpeg；Fedora 执行sudo dnf install python3 ffmpeg。 - 进入解压目录执行：
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt - 启动：
.venv/bin/python app.py，浏览器访问http://127.0.0.1:8765。
1080P+ 高清 / 登录画质
B 站 1080P 高码率、大会员画质等需要登录：用 Cookie 导出扩展（如 Get cookies.txt LOCALLY）导出 Netscape 格式的
cookies.txt，放到工具文件夹（与 app.py 同级）后重启，页面会提示“已加载 cookies.txt”。Cookie 等同登录凭证，切勿发给他人。
常见问题
直链复制到浏览器打开显示 403？
CDN 直链有 Referer 防盗链校验，直接打开会被拒绝。在工具页面点「下载」即可，由程序带上正确请求头。
直链过一段时间失效？
地址含时效签名，重新解析一次即可获得新地址。
首次启动卡在下载 ffmpeg？
多为网络波动，不影响解析和普通画质下载；可稍后重试，或自行安装 ffmpeg（macOS：brew install ffmpeg），重启工具自动识别。
平台改版后解析失败？
在工具目录执行 .venv/bin/pip install -U yt-dlp（Windows：.venv\Scripts\python -m pip install -U yt-dlp）更新解析引擎。
如何完全卸载？
删除整个工具文件夹即可。虚拟环境与 ffmpeg 均装在该文件夹内，不污染系统。
⚖️ 合规提示：请仅下载你依法有权获取和保存的内容（如自有视频、明确允许下载的资源），遵守各平台用户协议与著作权相关法律，勿用于侵权搬运或商业用途。不当使用的责任由使用者自行承担。