视频号直链解析

痛点：拿到视频号原链并不直接

拿到 https://weixin.qq.com/sph/... 分享链接后，下一步往往不清晰：页面适合播放，但回到开发环境再下载或入库并不方便。手动复制、抓包或拼代理，不仅节拍慢，也容易触碰权限边界。这个技能只做一件事：在合规前提下，把分享链接解析成可复制的腾讯原始直链。

工作方式

核心脚本是 scripts/wechat_video.mjs，流程围绕 API Key 状态、登录态、解析结果 三步推进：

• 先运行 node scripts/wechat_video.mjs key-status；若返回 configured 为 true，直接使用；若为 false，再索取 wv_... Key，并通过 key-save 保存。Key 只保存在当前系统用户可读的位置，回复、日志和结果中都不回显。
• 接着运行 status。未登录时运行 login，把 loginUrl 交给用户扫码；确认后再查 status，避免重复索取 Key。
• 登录有效后运行 resolve ''。输出只保留每个格式的 variants[].url 腾讯原始直链和剩余次数，不生成 /v1/download/ 或 localhost 代理地址。

适用边界与注意点

适合已有明确授权的采集、备份或内部转存场景。需要用户确认有权下载；遇到 SESSION_REQUIRED 或 SESSION_EXPIRED，应重新走扫码流程。返回给用户的是原始直链，链接本身有时效，复制到浏览器打开即可，不要改写或套代理。

凭证异常按类型处理：INVALID_API_KEY、API_KEY_EXPIRED 才更换 Key；QUOTA_EXHAUSTED 时不换 Key，直接把脚本返回的 purchaseUrl 作为可点击链接给出。退出登录用 logout，它不会清除已保存的 API Key。