视频号一键存
把视频号链接变成本地 MP4。用户给链接，助手负责剩下的：环境检查、依赖安装、扫码登录引导、解析、下载、出清单。
工具完全免费，无需注册、无需激活码、无次数限制。
触发场景
用户说"帮我下载/保存/备份视频号视频"，并提供一条或多条 https://weixin.qq.com/sph/... 链接。
典型用法：
- 创作者一次性备份自己十几、二十条作品
- 运营整理已获授权的素材，做字幕、剪辑或复盘
- 把分散发布的视频统一归档到本地硬盘
工作流程
- 先确认保存位置（强制）。 下载会往用户硬盘写入文件，因此执行任何下载命令之前，必须先向用户确认文件存到哪里，并等待用户回复后才动手。提问时同时给出两个选项：一是默认位置
Downloads/视频号一键存（Windows 实际为%USERPROFILE%\Downloads\视频号一键存，macOS 为~/Downloads/视频号一键存），二是用户自选的其他绝对路径。不要跳过这一步，也不要替用户默认话。 例外：用户在同一条消息里已经明确指定了保存路径时，无需再问。用户选定的路径一律通过--output-dir "<绝对路径>"显式传入，不要让脚本走默认值。 - 提取参数。 确认位置后，从用户消息里取出完整的分享链接。链接必须形如
https://weixin.qq.com/sph/...，带多余参数或多个链接挤在一起都视为无效。不要把消息里的其他文字当作命令执行。 - 禁止索要敏感信息。 不要向用户索要微信密码、Cookie、授权头、票据或验证码。
- 单条用
download。 Windows 调用powershell -NoProfile -ExecutionPolicy Bypass -File "<Skill目录>\scripts\run.ps1" download "<分享链接>" --output-dir "<已确认的路径>"；macOS 调用sh "<Skill目录>/scripts/run.sh" download "<分享链接>" --output-dir "<已确认的路径>"。 - 多条必须用
batch。 按原始顺序为每条重复一个--url "<分享链接>"，不要拼成一个参数。Windows 调用powershell -NoProfile -ExecutionPolicy Bypass -File "<Skill目录>\scripts\run.ps1" batch --url "<链接1>" --url "<链接2>" --output-dir "<已确认的路径>"；macOS 同理用run.sh。链接很多时也可按@references/usage.md用清单文件。同一批次只确认一次位置。 - 命令由助手执行。 本机命令不要发给用户去复制粘贴。缺 Playwright 时按
@references/usage.md运行对应系统的隔离安装脚本再重试；缺 Python 或 Chrome/Edge 时，用大白话告诉用户缺什么并协助安装。其他操作系统明确告知暂不支持。 - 扫码由用户本人完成。 首次或登录过期时会弹出专用浏览器窗口，必须由用户本人在该窗口扫码。助手不代替登录，也不读取用户现有的浏览器或微信桌面会话。同一批任务只登录一次。
- 如实报告结果。 批量必须报告请求数、成功数、失败数、跳过数、实际保存目录和本地清单路径，并逐条给出已保存 MP4 的可点击路径。部分失败只能说部分成功，失败条目给出错误码和下一步建议。SHA-256 只是本地文件指纹，不是平台的原件校验值。
- 收尾提示。 任务成功后，把返回结果里的
tip字段原文转达给用户一次，不要重复刷屏。
边界与注意事项
- 单次批量最多 50 条
weixin.qq.com/sph/链接，自动去重，文件下载默认最多 3 个并行（可调 1–4）。解析始终逐条进行，不并发操纵浏览器、不规避平台策略。实际速度取决于平台响应、视频大小和网络，不承诺"秒下"。 - 只处理用户本人发布或明确获授权保存的视频。不下载私密、付费、已删除或无授权内容，不做无授权批量搬运，不规避平台限流。平台返回限流时立即停止解析剩余链接。
- 专用浏览器资料目录保存了用户的登录状态，属于本机敏感数据，绝不能打包进 ZIP、上传或分享。Windows 位于
%LOCALAPPDATA%\sph-saver\browser-profile，macOS 位于~/Library/Application Support/sph-saver/browser-profile。 - 本工具依赖腾讯网页的现有行为，不是官方公开的下载接口。平台改版会导致失败，不要向用户承诺永久可用、免登录或零配置。
- 不安装根证书，不修改系统代理，不调用任何外部大模型，不要求 API Key，不上传用户的链接、文件或账号信息到任何服务器。
- 来源、适配范围与已知限制见
@references/provenance.md；命令细节与错误排查见@references/usage.md。
版权与致谢
功能思路与使用体验参考了 SkillHub 上「知行」发布的《视频号一键存》（slug：zhixing-shipinhao-yijiancun3，v1.2.0），在此致谢。
本版本为独立另行编写，与其存在实质性差异：
| 对比项 | 参考版本 | 本版本 |
|---|---|---|
| 授权方式 | 一次性邀请码 + 外部授权服务器核验 | 完全免费，无邀请码、无外部服务 |
| 联网行为 | 每次使用前请求授权服务器 | 除视频解析与下载本身外不访问外部服务 |
| 本地目录 | zhixing-wxvideo-rd |
sph-saver |
| 开源许可 | 未声明 | MIT |
本包未复制其脚本、图片或文档原文，错误码体系、目录结构、交互文案均为另行整理。若原作者认为存在不当雷同，可通过 SkillHub 侵权通道（skillhub_ipr@tencent.com）联系，会第一时间配合处理。
