用途:从 X(Twitter)帖子链接保存图片或视频,默认输出到 ~/Downloads,适用于用户分享 X 链接并希望下载其中媒体文件的场景。
主要能力:优先用 yt-dlp 直接下载视频;若为纯图片帖或视频下载失败,则通过 yt-dlp --dump-json 读取 thumbnails 数组提取图片地址,将 name=small 或 name=medium 替换为 name=orig 获取原图,再用 curl 逐一下载,扩展名跟随 URL 的 format 参数(jpg/png/webp)。完成后用 ls -lh 列出文件名、大小和路径。
使用方式:从用户输入中提取 x.com、twitter.com、mobile.twitter.com 的 status 链接,支持带查询参数的 URL;t.co 短链先解析为实际地址。未提供 URL 时向用户询问。视频下载命令示例:yt-dlp -o "~/Downloads/%(uploader)s_%(id)s.%(ext)s" "URL"。若推文无媒体则提示没有可下载内容。
限制与故障处理:依赖已安装的 yt-dlp;遇到登录、需登录或年龄限制报错时,可加 --cookies-from-browser chrome 重试。纯文字推文不含媒体,无法下载;其他错误按实际报错信息处理。平台支持范围、是否需要额外权限或配额等细节暂未提供。