ljg-x-download 是一个从 X（Twitter）链接下载图片或视频到 ~/Downloads 的技能。
用途
当用户分享 X/Twitter 链接并希望保存其中的媒体，或说出“下载”“download”等意图时，使用该技能。它面向需要快速保存推文图片或视频的场景。
依赖
需要已安装 yt-dlp。
主要能力
支持从用户输入中提取 X/Twitter URL，兼容以下格式：
- https://x.com/user/status/123456
- https://twitter.com/user/status/123456
- https://mobile.twitter.com/user/status/123456
- 带查询参数的 URL（yt-dlp 自动处理 ?s=20 等追踪参数）
- 缩短链接（t.co），先通过 curl -Ls -o /dev/null -w '%{url_effective}' "SHORT_URL" 解析
如果用户没有提供 URL，会使用 AskUserQuestion 要求提供。
使用方式
-
解析输入：从用户输入中提取 X/Twitter URL，必要时解析缩短链接。
-
尝试直接下载（视频优先）：直接用 yt-dlp 下载，无需先探测：
yt-dlp -o "~/Downloads/%(uploader)s_%(id)s.%(ext)s" "URL"
如果成功（视频推文），完成并跳到步骤 4 汇报结果。
- 视频下载失败时，提取图片：yt-dlp 对纯图片推文可能报错。此时用 --dump-json 提取图片 URL：
yt-dlp --dump-json "URL" 2>&1
判断结果：
- JSON 中有 thumbnails 数组 → 提取图片 URL
- JSON 为空或报错 no video → 推文无媒体，告知用户“该推文不包含可下载的图片或视频”
- 报错含 login / authentication → 需要登录（见故障排除）
- 其他错误 → 报告具体错误信息
图片下载：从 JSON 的 thumbnails 数组提取所有图片 URL，替换 name=small 或 name=medium 为 name=orig 获取原图，然后逐一下载：
curl -L -o ~/Downloads/tweet_ID_1.jpg "https://pbs.twimg.com/media/xxx?format=jpg&name=orig" curl -L -o ~/Downloads/tweet_ID_2.jpg "https://pbs.twimg.com/media/yyy?format=jpg&name=orig"
文件扩展名跟随 URL 中的 format 参数（jpg/png/webp）。
- 汇报结果：下载完成后，用 ls -lh 列出已下载的文件：文件名、大小、路径。
故障排除
需要登录：yt-dlp 报错含 login / Sign in / age-restricted 时，加 --cookies-from-browser chrome：
yt-dlp --cookies-from-browser chrome -o "~/Downloads/%(uploader)s_%(id)s.%(ext)s" "URL"
推文无媒体：纯文字推文没有可下载的媒体，告知用户即可。
适用场景
适用于用户分享 X/Twitter 链接并希望保存其中图片或视频的场合，包括视频推文和纯图片推文。
限制
依赖 yt-dlp；部分推文可能需要登录或受年龄限制，需借助浏览器 cookies；纯文字推文无媒体可下载。