技能介绍

解决什么问题

微信视频号没有公开的批量下载入口，用户通常只能手动保存到手机相册，再转到电脑；若拿到 https://weixin.qq.com/sph/... 分享链接，也很难直接获得可下载地址。这个技能面向工程师和自动化场景，把“下载视频号视频”拆成三类可用路径：解析分享链接、整理本地已保存文件、批量处理多条链接。它不处理 B 站、抖音、YouTube 等平台。

如何工作

核心脚本是 scripts/wx_channels.py。对分享链接，技能会用 Playwright 打开一个隔离浏览器配置，让用户一次性登录腾讯元宝；随后调用元宝解析接口把 sph/... 换为可播放信息，并进一步获取真实 videoUrl。下载过程用标准库流式写入 mp4，并校验文件头，避免保存半成品。

常见命令包括：

doctor：检查浏览器与登录状态，不打印密钥
resolve：只解析直链和元信息
download：下载视频，并可加 --transcribe 联动 media2text 生成逐字稿和二创稿
batch：从参数或 urls.txt 批量下载，整批只登录一次，并输出汇总 JSON

v1.1.0 起，下载后还会尽量生成同名 .json 元数据和 .jpg 封面图，方便归档和脚本消费。

适用边界与注意点

该技能依赖腾讯元宝接口，接口可能随版本调整失效；失效时可退回“手机保存到本地 → 传本地文件路径”的方式。它不安装系统根证书、不修改系统代理，也不读取日常浏览器 profile；脚本只输出结构化 JSON，不向外打印 cookie、token 或媒体直链。若只需下载，不需要安装额外依赖；若要链接解析，才需要 Playwright 浏览器和一次元宝登录。