joeseesun/qiaomu-download

解决的问题

通过允许用户向 AI 代理发送简单的自然语言命令（例如："下载这个：[URL]"），简化了从各种在线平台下载媒体的过程，无需记住复杂的命令、使用第三方解析网站或手动选择音视频流。

工作原理

该项目作为 AI 代理的「技能」，利用 yt-dlp 进行通用媒体提取，并为 WeChat Channels 和 Spotify 等平台提供专用适配器。遵循「优先公开」的隐私策略，先尝试匿名解析，再请求浏览器 Cookie。为确保质量，使用 ffprobe 验证下载的文件是否可播放，并包含预期的音视频流、分辨率和时长，确认成功后才完成操作。项目还包含自动更新机制，会检查最新的 yt-dlp 稳定版本，以保持与不断变化的网站结构兼容。

适用人群

希望以流畅、代理驱动的方式从 YouTube、Bilibili、X（Twitter）、TikTok、Instagram 和 WeChat 等平台保存视频、音频或字幕，而无需处理手动命令行工具或高风险的 UI 自动化操作的用户。

主要亮点

• 一句话触发：支持“下载这个”或“保存这个”等简单短语后接 URL 的用法。
• 广泛平台支持：集成支持数十个网站，包括 YouTube、Bilibili、X、TikTok 和 Instagram。
• 下载后验证：使用 ffprobe 验证文件完整性与播放能力。
• 安全优先策略：明确避免对 WeChat 和 Xiaohongshu 等敏感平台使用 UI 自动化（计算机使用），防止账号被封禁。
• Spotify 集成：高置信度地将 Spotify 轨道元数据与 YouTube 上的公开音频源匹配。
• 自动更新引擎：新版本发布时，通过系统包管理器自动升级 yt-dlp。