Twitter/X Media Downloader

这是一个用于 Twitter/X 的 Userscript (用户脚本)，可以让你一键下载推文中的图片和视频，并提供自定义文件名、快捷键与完整的下载历史记录功能。

主要功能

• 一键下载媒体 在推文右下方的操作列 (或单张图片右下角) 新增专属下载按钮，支持下载最高画质的图片、视频与 GIF。
• 自定义文件名格式 在设置界面中，可以自由决定下载后的文件名称。

• 标签模式：通过鼠标拖拽标签 (如：用户名称、推特 ID、上传日期等) 来组合文件名。
• 自定义模式：保留传统的文字输入方式，提供更进阶的命名规则设置。

安装方式

1. 首先需要在浏览器中安装用户脚本管理器，例如 Tampermonkey 或 Violentmonkey。
2. 点击本项目的安装链接，或是将脚本源代码复制并添加到管理器中即可完成安装。

使用说明

• 执行下载：脚本加载后，推文底部的 喜欢 (爱心) 按钮旁边会出现下载图标，点击即可下载。如果推文包含多张图片，单张图片的右下角也会有独立的下载按钮。
• 开启设置与记录：点击网页左下角带有数字的浮动按钮，即可开启历史记录与设置面板。
• 更改快捷键：在设置面板中，找到 快捷键设定 栏位，输入您想要的英文字母后点击保存即可。

支持的文件名变量 (自定义模式)

如果您选择使用自定义模式，可以在输入框中使用以下变量：

• {user-name} : 推主的显示名称
• {user-id} : 推主的账号 ID
• {status-id} : 推文的数字 ID
• {date-time-local} : 推文发布的本地时间
• {file-type} : 媒体类型 (photo, video)
• {file-name} : 原始文件名称
• {index} : 多图时的排序序号
• {full-text} : 推文內文

注意事项

• 抓取文件大小等功能可能会因为网络环境因素而显示为 Unknown，此为正常现象，不影响实际下载。
• 当 Twitter/X 更新网页结构时，可能会导致按钮短暂失效。