平时刷微信，看到干货满满的视频号内容，第一反应往往是“先收藏再说”。但结果就是，收藏夹里的视频越来越多，找起来极其麻烦，而且有些视频作者一旦删除或隐藏，你的收藏就直接失效了。
想下载到本地？微信官方压根没提供下载按钮。去网上搜“视频号解析”，跳出来的要么是收费的灰产网站，要么是需要下载流氓软件的客户端，甚至还要冒着微信号被封的风险去搞“抓包逆向”。
今天，给大家安利一款干净、免费、开源的命令行神器——wx-downloader。它另辟蹊径，通过“腾讯元宝”的登录态来解析视频号链接，让你优雅、批量地把视频无水印保存到本地。
1. 为什么是“腾讯元宝”？（巧妙的降维打击）
以前下载视频号，要么需要 Hook 微信客户端（极易封号），要么需要抓包分析复杂的加密参数。
wx-downloader 的作者非常聪明地绕开了微信本体，利用了腾讯官方的 AI 助手“腾讯元宝”的网页版/PC端接口。
因为元宝本身具备解析和读取微信生态内容的能力，wx-downloader 只需要在本地唤起一个干净的浏览器，让你扫码或手机号登录元宝，获取完整的 Cookie，就能顺理成章地调用接口解析出视频号的真实 MP4 地址。
主打一个：官方接口、不碰微信客户端、安全且稳定。
2. 核心亮点：不只是“能下”那么简单
作为一个成熟的 CLI（命令行）工具，wx-downloader 在工程细节上做得非常优雅：
- 批量与去重：支持直接传入多个链接，或者读取 JSON 文件批量下载。它会自动校验本地文件，已下载且大小一致的文件会自动跳过，绝不浪费带宽。
- 编码偏好：支持配置优先下载
H.264或H.265编码，如果首选缺失会自动回退，保证下载成功率。 - 目录隔离：你可以独立配置“成品目录”和“临时缓存目录”。视频会先下载到缓存区（
.part文件），校验 MP4 文件头无误后，再移动到成品区，彻底告别“下载到 99% 损坏”的崩溃。 - 隐私安全：登录凭据（Cookie）以
0600权限原子写入本地配置文件，绝不会上传到任何第三方服务器，且下载视频时不会携带元宝 Cookie，保护你的账号安全。
3. 保姆级实操指南（抄作业时间）
wx-downloader 已经发布到官方 PyPI，安装和使用极其简单。你需要准备 Python 3.10+ 环境，推荐使用 uv 来管理工具。
第一步：安装工具
# 使用 uv 安装（推荐）
uv tool install wx-downloader
# 或者使用 pip
pip install wx-downloader
(注：如果你没装 Chrome，可以用 wx-downloader config set browser chromium 切换为 Playwright 内置浏览器。)
第二步：登录元宝
在终端输入以下命令，程序会自动弹出一个干净的浏览器窗口：
wx-downloader login
在弹出的窗口中，使用微信扫码或手机号登录腾讯元宝。登录成功后，程序会自动抓取凭据并关闭窗口。
第三步：开始下载
# 单个下载
wx-downloader download 'https://weixin.qq.com/sph/你的分享链接'
# 批量下载（直接传多个链接）
wx-downloader download '链接1' '链接2'
默认情况下，视频会被保存到你的 ~/Downloads/wx-channels 目录下，文件名会自动带上视频标题和哈希值，清清爽爽。
4. 进阶玩法：JSON 批量与 AI Skill
如果你有一个长长的视频号列表，可以将其保存为 links.json：
{
"links": [
"https://weixin.qq.com/sph/ID1",
{"url": "https://weixin.qq.com/sph/ID2", "title": "可选备注"}
]
}
然后直接运行：
wx-downloader download --input links.json
程序会先验证所有输入，然后并发/串行下载，单项失败也不会影响后续任务。
🤖 AI 玩家专属彩蛋：
如果你在使用 Cursor、Claude Code 等支持 SKILL.md 的 AI 编程助手，可以将仓库中的 wx-downloader Skill 复制到你的 ~/.codex/skills/ 目录下。之后，你就可以直接在 AI 对话框里用自然语言命令：“用 wx-downloader 帮我把这个视频号链接下载下来”，AI 会自动帮你调用 CLI 执行！
5. 避坑与旧版迁移指南
⚠️ 接口稳定性预警：
必须说明的是，腾讯元宝和视频号的接口并非官方公开的 stable API。如果腾讯那边改了接口或加了风控，工具可能会暂时失效。但好在项目是开源的，社区和作者通常会很快跟进修复。你可以随时通过 uv tool upgrade wx-downloader 来获取最新版。
🔄 旧版用户迁移：
如果你之前安装过早期版本，可能会发现命令拼写错误（wx-downloder 漏了个 a），或者用过更早的 wx-channels-cli。
作者已经在 0.1.2 版本中修正了包名。请务必先安装新版，验证无误后，再卸载旧版：
uv tool install wx-downloader
# 验证后卸载旧版
uv tool uninstall wx-downloder
uv tool uninstall wx-channels-cli
(放心，配置目录和登录凭据是兼容的，迁移不需要重新扫码。)
如果你也有囤积优质视频号内容的需求，不妨花 5 分钟配置一下这个工具，让你的数字资产真正落入自己的口袋。
