01video_info.variants：X 视频画质的码率阶梯
X 在每条视频推文的 extended_entities 里给出一个 variants 数组：通常包含一条 application/x-mpegURL 的 HLS m3u8 播放清单，和三到四条不同码率的 video/mp4 直链——典型阶梯是 320×568（约 632kbps）、540×960（约 950kbps）、720×1280（约 2Mbps）、1080×1920（约 10Mbps，仅部分上传保留）。网页播放器走 HLS 按网速切档，所以你在时间线上看到的画质是浮动的；而下载场景要的是确定的最高画质。DownForge 解析 variants 后按 bitrate 字段降序排列，直接取最高码率的 progressive mp4 整文件下载——不碰 m3u8 切片，无需拼接转码，拿到的就是 X 转码管线输出的最高档原文件。结果页同时列出全部档位供手动切换，给网速受限的场景留出余地。
02本工具识别的 X / Twitter 链接形态
品牌从 Twitter 改为 X 之后，新旧两套域名长期并存，工具全部归一化处理：
标准推文：x.com/<handle>/status/<id>，旧域名 twitter.com/<handle>/status/<id> 同样有效
匿名形态：x.com/i/status/<id>，不带用户名也能定位推文
t.co 短链：X 对外分享统一包装的跳转链，自动展开到真实推文地址
移动端：mobile.twitter.com 与 App 内复制的链接一律跳主域解析
带定位参数：/status/<id>/video/1 与 ?s=20&t= 追踪参数会被剥除后解析
嵌入推文：platform.twitter.com 嵌入代码中的推文 id 同样可提取
推特 GIF 实为无声循环 mp4，可转码为真 .gif03推特「GIF」的真相：无声循环 mp4
你在 X 上看到的所有「GIF」都不是 GIF 文件。上传 .gif 时 X 会立刻把它转码成无声的 H.264 mp4（托管在 video.twimg.com/tweet_video/ 路径下），播放器循环播放并贴上 GIF 角标——这样体积只有原 GIF 的几分之一。这带来一个下载工具常见的坑：按「图片」逻辑去抓只能拿到一帧封面 jpg。DownForge 识别 animated_gif 媒体类型后直接取 tweet_video 的 mp4 原文件，并提供两种导出：①保留 mp4（体积小、画质好，适合再发到其他平台）；②用调色板优化转码为真正的 .gif 文件（适合需要 GIF 格式的 IM 表情、文档嵌入场景）。转 .gif 时帧率与尺寸可调，避免转出几十 MB 的庞然大物。
04多媒体推文与引用推：一条链接，最多两层媒体
一条推文最多可挂 4 个媒体位，且自 2022 年起允许图片、视频、GIF 混排——这意味着单条链接背后可能藏着 2 个视频加 2 张图。只解析首个媒体位的工具会让你漏掉一半内容。DownForge 展开 extended_entities.media 的全部条目，按媒体位顺序编号导出（01.mp4、02.jpg……）。另一层经常被忽略的媒体在引用推文里：转评（Quote）形成「外层评论 + 内层被引推文」的嵌套结构，很多人想下载的视频其实在内层。工具检测到 quoted_status 时会把两层媒体分组列出，由你勾选只要外层、只要内层还是全都要——不必再手动点进被引推文复制第二条链接。
05受保护账号与敏感内容标记
X 的访问控制有两套互相独立的机制，对下载的影响完全不同。受保护账号（小锁图标）的推文只有被批准的关注者可见，属于硬性访问控制，工具不解析——这与私密小组、私密账号在其他平台的处理一致。敏感内容标记（possibly_sensitive）则只是一层展示层的警示遮罩：内容本身仍是公开的，任何人点击「显示」都能看到。对这类公开但带标记的推文，工具按正常公开内容解析，但会在结果页透传该标记，提醒你下载的素材在再次使用时可能需要同样的提示处理。年龄限制内容（需登录并验证年龄才能查看的层级）不在解析范围内。
06下载步骤
从一条推文链接到本地文件，路径如下：
点推文右下角分享图标 → 「复制链接」（限自己的推文或已获授权内容）
粘贴到本页输入框，t.co 短链与 twitter.com 旧域名自动归一化，?s= 追踪参数剥除
多媒体推勾选需要的媒体位，引用推按外层 / 内层分组选择，视频选码率档
下载最高码率 mp4；GIF 媒体可选 mp4 原文件或转码 .gif
07X 解析常见错误与排查
解析不成功时，按下面的清单逐项核对：
「推文不存在」：被作者删除、账号被冻结，或推文 id 复制不完整
受保护账号：小锁账号的推文不解析，请通过本人账号的官方归档导出
只有低码率档：源端 variants 没有 1080p 条目，多为早年上传或低分辨率原片
t.co 展开失败：链接已失效或指向站外内容，请直接复制推文详情页地址
年龄限制内容：需登录验证才能查看的层级不在解析范围内
限频：X 自 2023 年起对未登录读取卡得很紧，触发后稍候重试即可，工具会自动指数退避
08典型使用场景
推文随时可能被删除或限流，这决定了 X 下载的三类主流场景：
创作者归档自有内容：把自己发布的视频、GIF 以最高码率落地备份，账号风险或误删时不丢失
品牌与媒体监测：留存自己投放的推广视频与合作内容，用于结案报告与合规审计