X/Twitter 媒体批量下载器（支持 iPhone/Android）用户指南
文件以用户 ID 和帖子 ID 命名保存。对于多个媒体文件，PC 端会分别保存，而移动端则以 ZIP 文件批量下载。（视频以最高可用质量下载，图片以原始尺寸下载。）您可以通过编辑代码中的 generateFilename 函数来自定义下载文件的文件名。可用于文件名的元素包括用户 ID，用户名，帖子 ID 和发布时间。下载历史也会自动保存。此外，可以选择利用 X/Twitter 的书签功能来实现在线同步下载历史记录。
只要使用最新的浏览器，无论在 PC 端还是移动端均可正常使用。
⚠️ 关于Twitter视频的重要通知（2025年7月）- 音视频不同步
- 在某些播放器中（如WMP、VLC等）画面卡顿或冻结
✅ 对策：
ffmpeg -i input.mp4 -fflags +genpts output_fixed.mp4
使用说明
适用于 Windows/Mac在浏览器中添加 Tampermonkey 并安装此脚本。
适用于 iPhone/iPad从 App Store 下载 Userscripts 应用（链接），并在 Safari 中安装此脚本。
• 如果有多个媒体文件，则以 ZIP 文件形式下载。
适用于 Android在支持扩展的浏览器（如 Edge Canary、Firefox 等）中添加 Tampermonkey 并安装此脚本。
• 如果有多个媒体文件，则以 ZIP 文件形式下载。
补充说明
如何使用 iPhone/iPad 快捷方式当包含多个媒体文件的 ZIP 文件被下载后，您可以使用我们专为 iPhone/iPad 提供的快捷方式轻松解压并整理这些媒体文件。请按照以下步骤操作：
-
从 此链接获取快捷方式，并将其添加到您 iPhone/iPad 上的 “快捷方式” 应用中。
从此以后，每次运行该快捷方式都会自动解压并保存下载的 ZIP 文件。
如何更改下载文件的名称您可以任意更改下载文件的名称，使用用户ID、用户名、帖子ID和发布时间。要更改名称，请编辑代码中的 generateFilename 函数。您也可以更改发布时间的格式。有关详细信息，请查看 dayjs 的参考文档。下面显示了默认设置和其他示例。
例1：使用用户ID、帖子ID和发布时间的名称（YYYYMMDD_HHmmss 格式）const formattedPostTime = dayjs(postTime).format('YYYYMMDD_HHmmss');return `$_$-$-$$.$`;
关于通过书签同步在线下载历史记录此脚本提供一个可选功能，可以使用 X/Twitter 的书签功能在线同步您的下载历史记录。
- 如何启用： 请将代码中的 enableDownloadHistorykSync 的值从 false 更改为 true 。
- 工作原理：
- 启用后，您下载了媒体的帖子将自动添加到您的 X/Twitter 书签中。
- 已存在于您书签中的帖子将被视为“已下载”。这些帖子的下载按钮将显示完成状态，以防止重复下载。
- 这使您可以通过书签，在多个设备（如电脑和智能手机）及不同浏览器之间共享和同步您已下载帖子的历史记录。
常见问题 (FAQ)
Q: 如果下载按钮没有出现，我该怎么办？ Q: 我不知道如何解压 ZIP 文件。A: 在 iPhone/iPad 上，您可以使用提供的快捷方式或文件管理应用解压；在 Android 上，您可以使用内置的文件管理器解压 ZIP 文件。
Q: 如果下载过程中出现错误，我该怎么办？A: 请检查您的网络环境，或注意 X/Twitter 的规格可能已更改。稍后再试。
Q: 多个媒体文件下载与单个下载哪个优先？A: 如果只有一个媒体文件，则会单独下载；如果有多个文件，则会根据操作系统的不同，以批量 ZIP 文件或单独下载的方式进行。
Q: 如何在 iPhone 上编辑代码？A: 可以使用第三方应用程序进行编辑。例如，您可以使用名为 Documents 的应用程序（链接）。
Q: 如何清除下载历史记录？A: 请使用浏览器的开发者工具删除IndexedDB中的DownloadHistoryDB。如果无法做到这一点，例如在移动浏览器等情况下，请从浏览器设置中清除站点数据。
Q: 如果遇到问题或有疑问，我该怎么办？许可协议
此脚本采用 MIT 许可协议发布。
© 2025 Azuki. All rights reserved.