技能介绍

解决什么问题

微信视频号的分享链接通常能在官方页面播放，但把内容可靠地保存为本地 MP4，涉及登录态、一次性播放凭据、官方媒体链路和文件校验等多个环节。这个技能面向需要从视频号下载自有或已获授权内容的场景，把分散步骤收敛成一次可追踪的调用。

它不会在安装后自动运行，也不会代替用户扫码或登录；用户需要提出明确下载请求，并提供 weixin.qq.com/sph/ 开头的分享链接。

核心工作链路

完整流程按一次调用串起来：校验链接 → 检查腾讯元宝登录 → 必要时显示扫码 → 官方解析 → 下载 → 验证 MP4。未登录时会打开 yuanbao.tencent.com 官方登录页，请用户本人扫码；登录成功后在同一任务内继续，不需要用户再回复“已登录”。

执行时优先解析技能绝对目录，并始终使用脚本绝对路径。首次运行、换机器或排障时先执行 doctor，若沙箱阻止访问系统下载目录，应按正常权限审批重试。随后生成权限受限的临时交接 JSON，保存其中的 share_url 和 profile_file，不猜测路径。

登录环节使用浏览器获取一次性播放凭据，Python 侧只请求 channels.weixin.qq.com 与腾讯媒体域名。默认画质为 auto，优先可确认原画，否则回退到 H.264 兼容格式；只有没有 H.264 时才使用 H.265。macOS 默认保存到 ~/Downloads/视频号，Windows 保存到系统“下载/视频号”。下载完成后会核对文件存在且是 MP4，报告标题、作者、画质、大小和绝对路径。

失败处理与适用边界

遇到权限超时、网络中断、DOWNLOAD_IO_ERROR、DOWNLOAD_HTTP_ERROR 或 INCOMPLETE_DOWNLOAD 时，临时解析文件会保留，并先用同一命令重试一次。YUANBAO_LOGIN_REQUIRED 需要回到官方登录页等待用户本人登录；YUANBAO_PAGE_NOT_READY 可刷新官方页面后重试；PROFILE_LINK_MISMATCH 则重新执行 prepare，不要手工改临时 JSON。

安全边界很明确：只接受视频号分享链接，只在 yuanbao.tencent.com 内使用登录态，不读取、导出或打印 Cookie、Local Storage、密码、验证码、Token 或媒体 URL。只处理用户自有或已获授权的内容，不绕过付费、私密、已删除内容或其他访问控制，也不调用第三方公共解析器或失效的自有服务端点。