技能介绍

要解决什么问题

做素材整理、竞品分析或本地归档时，你往往手里是一堆分享链接：有的在 Excel 里混着文案，有的是 TXT 逐行 URL，还有的是聊天里随手甩的一条 v.douyin.com 短链。各平台页面结构不同，直链藏在接口或前端请求里，手工找原片地址既慢又容易下到错误页（403、HTML 伪装成视频）。本技能面向公开可访问的短视频链接，把「读链接 → 识别平台 → 解析真实视频 URL → 落盘」做成一条可重复执行的流水线。

技能如何工作

输入上三选一：--excel（.xlsx，纯 URL 列或文案+URL 混合）、--txt（每行 URL 或含 URL 的文本）、--url（单条或多条，逗号/空格/换行分隔）。一条 URL 即单条，多条即批量，逻辑统一。

平台侧采用注册器 + 提取器路由：按域名把请求交给抖音、快手、小红书、B 站等已验证实现；识别为未知平台时切到 extract_generic()，拦截网络响应（Content-Type 含 video、JSON 里递归搜视频字段、<video> 的 src），并把特征写入 unknown_platform_log.json 便于后续适配。

下载阶段对每条资源做四重校验：HTTP 200、Content-Type 含 video/octet-stream、体积 ≥ 10KB、文件头符合 MP4/FLV 且拒绝 HTML。失败不写入磁盘，并按 30s→45s→60s 递增超时、5s→8s 间隔最多重试 3 次。video_mapping.json 记录已下条目，重复运行默认跳过；--fresh 会清映射强制重下（使用前需确认）。输出为 001_视频标题.mp4 这类顺序命名，并附带映射与 下载报告.txt。

适用边界与注意

依赖 Playwright Chromium（需单独安装浏览器）；快手、小红书、B 站、微视为已知 API 结构实现，大规模实测有限，失败时通用提取器作后备但不保证成功率。不支持私密/付费内容；文件名超 80 字符会截断；B 站需 Referer（脚本已处理）。请遵守各平台协议与版权，内容仅限个人学习用途。