视频号一键存
“一键存”指用户给出链接与保存位置后,由助手完成检查、解析和保存;首次使用可能需要用户本人扫码,平台限制也可能导致失败。此 Skill 仅处理用户自己发布或明确获授权保存的视频。
触发场景
用户说“帮我下载/保存/备份视频号视频”,并提供一条或多条 https://weixin.qq.com/sph/... 链接。适合创作者一次备份十几、二十条自己的视频,或授权运营人员整理可保存的素材,再拿本地 MP4 做字幕、剪辑或复盘。
工作流程
- 确认用户有权保存每条视频;若尚未说明,只简短追问一次,不能把用户提供链接视为自动授权。若未指定目录,批量模式默认保存到当前用户的
Downloads/视频号一键存。不要索要微信/元宝密码、Cookie、授权头、票据。 - 先识别操作系统。Windows 执行
powershell -NoProfile -ExecutionPolicy Bypass -File "<Skill目录>\scripts\run.ps1" doctor;macOS 执行sh "<Skill目录>/scripts/run.sh" doctor。若返回needs_setup,说明需要 Python 3.10+、Edge 或 Chrome、Playwright;征得同意后按@references/usage.md运行对应系统的隔离安装脚本。其他系统明确告知尚不支持。 - 单条链接仍用
download:Windows 执行powershell -NoProfile -ExecutionPolicy Bypass -File "<Skill目录>\scripts\run.ps1" download "<分享链接>" --output-dir "<保存目录>" --confirm-rights;macOS 执行sh "<Skill目录>/scripts/run.sh" download "<分享链接>" --output-dir "<保存目录>" --confirm-rights。 - 多条链接用
batch。从用户消息中提取每条完整链接,按原顺序为每条重复一个--url "<分享链接>"参数,不把十几条链接拼成一个参数。Windows 执行powershell -NoProfile -ExecutionPolicy Bypass -File "<Skill目录>\scripts\run.ps1" batch --url "<链接1>" --url "<链接2>" --confirm-rights;macOS 执行sh "<Skill目录>/scripts/run.sh" batch --url "<链接1>" --url "<链接2>" --confirm-rights。实际执行时继续添加其余链接,不保留示例占位符。也可按@references/usage.md使用 UTF-8 清单文件。若用户指定保存目录,附加--output-dir "<绝对路径>"。若doctor未就绪,先处理依赖。 - 若弹出浏览器,由用户本人在专用窗口扫码。批量任务只打开一次隔离浏览器并复用同一登录;助手不代替登录、不读取现有浏览器/微信桌面会话。
- 批量结果必须报告请求数、成功数、失败数、跳过数和本地清单路径;逐条给出已保存 MP4 的可点击路径。部分失败时只对成功的条目说“已保存”,失败条目给出错误码和下一步。SHA-256 只是本地文件指纹。
边界与注意事项
- 单次批量最多 50 条
weixin.qq.com/sph/链接;自动去重,默认最多 3 个文件并行下载(可设 1–4)。解析仍逐条进行,避免同时操纵浏览器或规避平台限制;实际速度取决于平台响应、视频大小和网络,不保证“秒下”。 - 只保存用户本人发布或明确获授权的视频;不下载私密、付费、删除或无授权内容,不做无授权批量搬运、不规避平台限流。平台返回限流时停止继续解析。
- 专用浏览器资料目录会保留登录状态,是本机敏感数据,绝不纳入 ZIP 或上传。详见
@references/usage.md。 - 当前实现依赖腾讯网页的内部行为,不是官方公开下载 API;接口变化会导致失败。不得宣称永久可用、免登录或零配置。
- 不安装根证书、不修改系统代理,也不调用外部模型或要求模型 API Key。
- 来源、适配与风险见
@references/provenance.md。