用途 本技能面向“已知链接 → 已验证本地媒体”的场景:用户给出一个公开且有权保存的社交平台内容链接,技能识别平台、复用已有授权、下载原始媒体,并交付文件与 JSON 验证报告。触发条件包括用户要求下载视频链接、保存视频号内容,或直接给出 weixin.qq.com/sph/...、抖音、小红书、快手、B站、微博、贴吧、知乎链接并要求本地文件。不适用于仅给片名要求搜索影片、比较版本或下载种子;也不适用于已有素材的剪辑、混音、转码与成片制作;批量抓取账号、评论或用户资料,以及无权访问的私密、付费、地域受限内容同样不在范围内。
主要能力 支持视频号、小红书、抖音、快手、B站、微博、贴吧与知乎;直接媒体 URL 跳过浏览器与爬虫进入传输层。视频号路径先通过腾讯元宝解析分享链接,再由视频号接口取得 CDN 地址;元宝鉴权通过但返回空 wx_export_id 时属于 resolver_failed,可回退到本机微信客户端取流(macOS,依赖 wx_channels_download 固定版本并由脚本下载校验,启动需管理员权限且微信 PC 端已登录)。其他平台可走 MediaCrawler 路径,适配器固定已验证 commit、关闭评论抓取、只抓指定内容,并从 9333 起选择可用调试端口启动独立 Chrome Profile。传输层优先 aria2 多连接与断点续传,无 aria2 时用 curl 续传、重试与进度条。
使用方式 按固定流程执行:先解析 SKILL_DIR、读取用户 Profile、确认脚本与参考文件存在,并运行 doctor --json 检查可选依赖;再核对链接、权限与目标,用 probe 探测,探测阶段不创建伪成功文件;然后按平台矩阵选择最短可用路径;下载时指定输出目录、连接数与 JSON 报告路径;最后验证成品并报告结果。输出默认落到用户显式目录、Profile 的 records.output_dir、项目输出目录,最后才是 downloads/,不覆盖已有成品。文件名冲突时生成稳定后缀。失败保留可续传的 .part 文件。
验证与报告 完成条件不是 HTTP 200:文件须存在且非零、响应不是 HTML/JSON 错误页;MP4/MOV 检查 ftyp,WebM/MKV 检查 EBML,图片检查 PNG/JPEG/GIF/WebP 魔数;视频可用时再用 ffprobe 验证流、时长、编码与分辨率;实际字节数与 Content-Length 一致。JSON 报告包含 status、platform、source_url、output_path、bytes、elapsed_seconds、average_mbps、verification 与 context_id。只有标题/封面而无视频流时,状态须为 authorization_required 或 resolver_failed,不得写成 downloaded。报告首句给出成功/失败与本地路径,成功补充大小、耗时、平均速度、平台与验证结果,失败给出错误码、context_id、缺失条件和一条可复制的下一步命令。
适用场景与限制 适合单条或少量明确列出的公开链接下载与本地归档,以及需要可验证产物和诊断报告的场景。技能只处理用户有权访问与保存的内容,不绕过访问控制;公共 Worker 默认禁用,仅在用户明确接受把公开分享链接发送给该服务时才使用 --allow-public-resolver,并优先使用用户自建 --worker-url。Cookie、Token、代理密码与浏览器登录态不写入 Profile。MediaCrawler 代码与使用受上游非商业学习许可证约束,需用户先确认。依赖方面,必需 Python 3.9+ 与 curl,推荐 aria2 与 ffprobe;视频号一次性授权需要 Playwright Python 包与 Chrome。平台边界、上游许可证与故障码分别见对应参考文档。