joeseesun/qiaomu-download
一、一句话定位
一个通过自然语言指令（“下载这个：URL”）自动识别页面视频、更新下载引擎、保存最高画质并验证可播放的通用视频下载工具。
二、核心技术/架构亮点
- 一句话触发 + 多平台统一：无需记忆命令，同一个表达覆盖微信视频号、YouTube、B站、X、抖音等数十个平台。
- 自动更新 yt-dlp：每次任务检查官方稳定版并按包管理器升级，保证 extractor 最新。
- 下载后验真：通过 `ffprobe` 检查视频流/音频流/时长/分辨率，确保文件可用。
- 安全边界明确：不使用 UI 自动化操作微信、小红书等风控平台；仅公开解析，失败后才按需读取本机 Cookie，且不保存打印。
- 微信视频号内置适配器：同一包内包含预检、在线解析、本地捕获、解密、编码验证，无需另装 Skill。
三、适用场景与目标用户
- AI Agent 开发者：希望为智能体添加通用视频下载能力。
- 内容创作者/搬运工：需要批量或按需下载多平台视频，且重视隐私与风控安全。
- 普通用户：不想记命令或找解析网站，只需说一句话即可下载。
四、可动手动作
- 安装试用：`npx skills add joeseesun/qiaomu-download`，然后对 Agent 说“下载这个：URL”。
- 命令行直接使用：`python3 scripts/download.py download 'URL'`，依赖 yt-dlp 和 ffmpeg。
- 借鉴安全策略：在类似工具中采用“公开优先、按需 Cookie、不操作 UI”的设计原则。
- 借鉴自动更新：实现 yt-dlp 的版本检测与包管理器绑定的升级逻辑。
五、学习优先级
P1（排期） – 项目核心思路（一句话触发+验真）有启发，但底层依赖 yt-dlp，若当前无视频下载或 Agent 集成需求，可排期细读安全边界设计与自动更新机制。
六、主题标签
视频下载⌂