doracoin revidoval tento gist . Přejít na revizi
1 file changed, 676 insertions
twitter-media-downloader.user.js(vytvořil soubor)
| @@ -0,0 +1,676 @@ | |||
| 1 | + | // ==UserScript== | |
| 2 | + | // @name Twitter/X Media Downloader (Maintained) | |
| 3 | + | // @namespace community.twitter-media-downloader | |
| 4 | + | // @version 1.28.0 | |
| 5 | + | // @description Download original photos and the highest-bitrate MP4 from posts; batch download media already loaded on a profile's Media page. | |
| 6 | + | // @author AMANE (original); community-maintained fork | |
| 7 | + | // @license MIT | |
| 8 | + | // @copyright 2021 AMANE; community-maintained modifications | |
| 9 | + | // @match https://x.com/* | |
| 10 | + | // @match https://www.x.com/* | |
| 11 | + | // @match https://twitter.com/* | |
| 12 | + | // @match https://mobile.twitter.com/* | |
| 13 | + | // @match https://mobile.x.com/* | |
| 14 | + | // @grant GM_download | |
| 15 | + | // @grant GM_getValue | |
| 16 | + | // @grant GM_setValue | |
| 17 | + | // @grant GM_registerMenuCommand | |
| 18 | + | // @connect pbs.twimg.com | |
| 19 | + | // @connect video.twimg.com | |
| 20 | + | // @connect x.com | |
| 21 | + | // @connect twitter.com | |
| 22 | + | // ==/UserScript== | |
| 23 | + | ||
| 24 | + | /* | |
| 25 | + | * Community-maintained fork of AMANE's Twitter Media Downloader. | |
| 26 | + | * Upstream: https://greasyfork.org/scripts/423001-twitter-media-downloader | |
| 27 | + | * | |
| 28 | + | * The upstream script is MIT-licensed. This fork keeps the attribution and | |
| 29 | + | * license while repairing the TweetDetail timeline parser and adding a batch | |
| 30 | + | * panel for media cards already discovered on a profile's /media page. | |
| 31 | + | * | |
| 32 | + | * MIT License | |
| 33 | + | * Copyright (c) 2021 AMANE | |
| 34 | + | * | |
| 35 | + | * Permission is hereby granted, free of charge, to any person obtaining a copy | |
| 36 | + | * of this software and associated documentation files (the "Software"), to | |
| 37 | + | * deal in the Software without restriction, including without limitation the | |
| 38 | + | * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or | |
| 39 | + | * sell copies of the Software, and to permit persons to whom the Software is | |
| 40 | + | * furnished to do so, subject to the following conditions: | |
| 41 | + | * | |
| 42 | + | * The above copyright notice and this permission notice shall be included in | |
| 43 | + | * all copies or substantial portions of the Software. | |
| 44 | + | * | |
| 45 | + | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
| 46 | + | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
| 47 | + | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
| 48 | + | * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
| 49 | + | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | |
| 50 | + | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS | |
| 51 | + | * IN THE SOFTWARE. | |
| 52 | + | */ | |
| 53 | + | ||
| 54 | + | (function () { | |
| 55 | + | 'use strict'; | |
| 56 | + | ||
| 57 | + | const VERSION = '1.28.0'; | |
| 58 | + | // Operation ID observed in X's current TweetDetail request on 2026-10-21. | |
| 59 | + | // X rotates internal GraphQL operation IDs; update this when the endpoint changes. | |
| 60 | + | const TWEET_DETAIL_OPERATION = '3BlMtudy4N-d78ch7zTLZQ'; | |
| 61 | + | const BEARER_TOKEN = 'AAAAAAAAAAAAAAAAAAAAANRILgAAAAAAnNwIzUejRCOuH5E6I8xnZz4puTs%3D1Zv7ttfk8LF81IUq16cHjhLTvJu4FA33AGWWjCpTnA'; | |
| 62 | + | const DEFAULT_FILENAME = 'twitter_{user-name}(@{user-id})_{date-time}_{status-id}_{file-type}'; | |
| 63 | + | const HISTORY_KEY = 'tmd_download_history_v128'; | |
| 64 | + | const FILENAME_KEY = 'tmd_filename_v128'; | |
| 65 | + | const PANEL_ID = 'tmd-batch-panel'; | |
| 66 | + | const MAX_MEDIA_PER_POST = 16; | |
| 67 | + | const DOWNLOAD_GAP_MS = 350; | |
| 68 | + | const discoveredPosts = new Map(); | |
| 69 | + | let panelStatus; | |
| 70 | + | let panelCount; | |
| 71 | + | let panelButton; | |
| 72 | + | let batchState = null; | |
| 73 | + | const completedBatchPosts = new Set(); | |
| 74 | + | ||
| 75 | + | const sleep = (ms) => new Promise((resolve) => window.setTimeout(resolve, ms)); | |
| 76 | + | ||
| 77 | + | function readCookie(name) { | |
| 78 | + | const part = document.cookie.split('; ').find((item) => item.startsWith(`${name}=`)); | |
| 79 | + | return part ? decodeURIComponent(part.slice(name.length + 1)) : ''; | |
| 80 | + | } | |
| 81 | + | ||
| 82 | + | function sanitizeFilename(value) { | |
| 83 | + | return String(value || '') | |
| 84 | + | .replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_') | |
| 85 | + | .replace(/[. ]+$/g, '') | |
| 86 | + | .trim() | |
| 87 | + | .slice(0, 160) || 'twitter-media'; | |
| 88 | + | } | |
| 89 | + | ||
| 90 | + | function getStatusId(href) { | |
| 91 | + | try { | |
| 92 | + | return new URL(href, location.href).pathname.match(/\/status\/(\d+)/)?.[1] || ''; | |
| 93 | + | } catch { | |
| 94 | + | return ''; | |
| 95 | + | } | |
| 96 | + | } | |
| 97 | + | ||
| 98 | + | function getTweetEntry(response, statusId) { | |
| 99 | + | const instructions = response?.data?.threaded_conversation_with_injections_v2?.instructions; | |
| 100 | + | if (!Array.isArray(instructions)) { | |
| 101 | + | throw new Error('TweetDetail 响应中没有 instructions;X 可能已更改接口结构。'); | |
| 102 | + | } | |
| 103 | + | ||
| 104 | + | // X may prepend TimelineClearCache (without entries) before TimelineAddEntries. | |
| 105 | + | // Never assume instructions[0] contains the timeline entries. | |
| 106 | + | const entries = instructions.flatMap((instruction) => | |
| 107 | + | Array.isArray(instruction?.entries) ? instruction.entries : [] | |
| 108 | + | ); | |
| 109 | + | const entry = entries.find((item) => item?.entryId === `tweet-${statusId}`); | |
| 110 | + | if (!entry) { | |
| 111 | + | throw new Error(`TweetDetail 响应中找不到推文 ${statusId}。`); | |
| 112 | + | } | |
| 113 | + | ||
| 114 | + | const result = entry?.content?.itemContent?.tweet_results?.result; | |
| 115 | + | if (!result) { | |
| 116 | + | throw new Error('找到推文条目,但 tweet_results.result 不存在;X 可能已更改字段结构。'); | |
| 117 | + | } | |
| 118 | + | return result.tweet || result; | |
| 119 | + | } | |
| 120 | + | ||
| 121 | + | async function fetchTweet(statusId) { | |
| 122 | + | const variables = { | |
| 123 | + | focalTweetId: statusId, | |
| 124 | + | with_rux_injections: false, | |
| 125 | + | includePromotedContent: true, | |
| 126 | + | withCommunity: true, | |
| 127 | + | withQuickPromoteEligibilityTweetFields: true, | |
| 128 | + | withBirdwatchNotes: true, | |
| 129 | + | withVoice: true, | |
| 130 | + | withV2Timeline: true, | |
| 131 | + | }; | |
| 132 | + | const features = { | |
| 133 | + | rweb_lists_timeline_redesign_enabled: true, | |
| 134 | + | responsive_web_graphql_exclude_directive_enabled: true, | |
| 135 | + | verified_phone_label_enabled: false, | |
| 136 | + | creator_subscriptions_tweet_preview_api_enabled: true, | |
| 137 | + | responsive_web_graphql_timeline_navigation_enabled: true, | |
| 138 | + | responsive_web_graphql_skip_user_profile_image_extensions_enabled: false, | |
| 139 | + | tweetypie_unmention_optimization_enabled: true, | |
| 140 | + | responsive_web_edit_tweet_api_enabled: true, | |
| 141 | + | graphql_is_translatable_rweb_tweet_is_translatable_enabled: true, | |
| 142 | + | view_counts_everywhere_api_enabled: true, | |
| 143 | + | longform_notetweets_consumption_enabled: true, | |
| 144 | + | responsive_web_twitter_article_tweet_consumption_enabled: false, | |
| 145 | + | tweet_awards_web_tipping_enabled: false, | |
| 146 | + | freedom_of_speech_not_reach_fetch_enabled: true, | |
| 147 | + | standardized_nudges_misinfo: true, | |
| 148 | + | tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true, | |
| 149 | + | longform_notetweets_rich_text_read_enabled: true, | |
| 150 | + | longform_notetweets_inline_media_enabled: true, | |
| 151 | + | responsive_web_media_download_video_enabled: false, | |
| 152 | + | responsive_web_enhance_cards_enabled: false, | |
| 153 | + | }; | |
| 154 | + | ||
| 155 | + | const url = new URL(`/i/api/graphql/${TWEET_DETAIL_OPERATION}/TweetDetail`, location.origin); | |
| 156 | + | url.searchParams.set('variables', JSON.stringify(variables)); | |
| 157 | + | url.searchParams.set('features', JSON.stringify(features)); | |
| 158 | + | ||
| 159 | + | const csrfToken = readCookie('ct0'); | |
| 160 | + | const headers = { | |
| 161 | + | authorization: `Bearer ${BEARER_TOKEN}`, | |
| 162 | + | 'x-twitter-active-user': 'yes', | |
| 163 | + | 'x-twitter-client-language': readCookie('lang') || document.documentElement.lang || 'en', | |
| 164 | + | }; | |
| 165 | + | if (csrfToken) headers['x-csrf-token'] = csrfToken; | |
| 166 | + | const guestToken = readCookie('gt'); | |
| 167 | + | if (guestToken) headers['x-guest-token'] = guestToken; | |
| 168 | + | ||
| 169 | + | const response = await fetch(url, { headers, credentials: 'same-origin' }); | |
| 170 | + | const body = await response.text(); | |
| 171 | + | let json; | |
| 172 | + | try { | |
| 173 | + | json = JSON.parse(body); | |
| 174 | + | } catch { | |
| 175 | + | throw new Error(`TweetDetail 返回了非 JSON 内容(HTTP ${response.status})。`); | |
| 176 | + | } | |
| 177 | + | if (!response.ok) { | |
| 178 | + | const apiMessage = json?.errors?.map((error) => error.message).filter(Boolean).join('; '); | |
| 179 | + | throw new Error(`TweetDetail 请求失败(HTTP ${response.status})${apiMessage ? `:${apiMessage}` : ''}`); | |
| 180 | + | } | |
| 181 | + | return getTweetEntry(json, statusId); | |
| 182 | + | } | |
| 183 | + | ||
| 184 | + | function getMedia(tweet) { | |
| 185 | + | const media = tweet?.legacy?.extended_entities?.media | |
| 186 | + | || tweet?.extended_entities?.media | |
| 187 | + | || tweet?.legacy?.entities?.media | |
| 188 | + | || []; | |
| 189 | + | if (!Array.isArray(media) || !media.length) { | |
| 190 | + | throw new Error('该推文没有可下载的媒体,或媒体字段未返回。'); | |
| 191 | + | } | |
| 192 | + | return media.slice(0, MAX_MEDIA_PER_POST); | |
| 193 | + | } | |
| 194 | + | ||
| 195 | + | function userInfo(tweet) { | |
| 196 | + | const result = tweet?.core?.user_results?.result || {}; | |
| 197 | + | // Newer TweetDetail responses use User.core; older responses used User.legacy. | |
| 198 | + | const user = result.legacy || result.core || result; | |
| 199 | + | return { | |
| 200 | + | name: user.name || user.screen_name || 'twitter-user', | |
| 201 | + | handle: user.screen_name || 'unknown', | |
| 202 | + | }; | |
| 203 | + | } | |
| 204 | + | ||
| 205 | + | function buildMediaUrl(media) { | |
| 206 | + | if (media.type === 'photo') { | |
| 207 | + | if (!media.media_url_https) throw new Error('图片媒体没有 media_url_https。'); | |
| 208 | + | return { url: `${media.media_url_https}:orig`, extension: 'jpg', type: 'photo' }; | |
| 209 | + | } | |
| 210 | + | ||
| 211 | + | const variants = media.video_info?.variants; | |
| 212 | + | if (!Array.isArray(variants)) throw new Error(`媒体类型 ${media.type || 'unknown'} 没有视频变体。`); | |
| 213 | + | const mp4s = variants | |
| 214 | + | .filter((variant) => variant?.content_type === 'video/mp4' && variant.url) | |
| 215 | + | .sort((a, b) => (b.bitrate || 0) - (a.bitrate || 0)); | |
| 216 | + | if (!mp4s.length) throw new Error('没有找到可下载的 MP4 变体。'); | |
| 217 | + | return { url: mp4s[0].url, extension: 'mp4', type: media.type === 'animated_gif' ? 'gif' : 'video' }; | |
| 218 | + | } | |
| 219 | + | ||
| 220 | + | async function buildDownloadItems(statusId, tweet) { | |
| 221 | + | const legacy = tweet.legacy || tweet; | |
| 222 | + | const user = userInfo(tweet); | |
| 223 | + | const mediaList = getMedia(tweet); | |
| 224 | + | const pattern = await GM_getValue(FILENAME_KEY, DEFAULT_FILENAME); | |
| 225 | + | return mediaList.map((media, index) => { | |
| 226 | + | const item = buildMediaUrl(media); | |
| 227 | + | const sequence = mediaList.length > 1 ? `-${String(index + 1).padStart(2, '0')}` : ''; | |
| 228 | + | const values = { | |
| 229 | + | 'user-name': user.name, | |
| 230 | + | 'user-id': user.handle, | |
| 231 | + | 'date-time': formatTimestamp(legacy.created_at), | |
| 232 | + | 'status-id': statusId, | |
| 233 | + | 'file-type': item.type, | |
| 234 | + | 'file-name': item.url.split('/').pop().split(/[?:]/)[0], | |
| 235 | + | }; | |
| 236 | + | const baseName = pattern.replace(/\{([^{}]+)\}/g, (match, key) => values[key] ?? match); | |
| 237 | + | return { ...item, statusId, filename: `${sanitizeFilename(baseName)}${sequence}.${item.extension}` }; | |
| 238 | + | }); | |
| 239 | + | } | |
| 240 | + | ||
| 241 | + | async function downloadFile(url, filename) { | |
| 242 | + | if (typeof GM_download !== 'function') throw new Error('GM_download 不可用,请检查用户脚本管理器权限。'); | |
| 243 | + | return new Promise((resolve, reject) => { | |
| 244 | + | GM_download({ | |
| 245 | + | url, | |
| 246 | + | name: filename, | |
| 247 | + | saveAs: false, | |
| 248 | + | timeout: 60000, | |
| 249 | + | onload: resolve, | |
| 250 | + | onerror: (error) => reject(new Error(error?.error || error?.details?.current || '下载失败')), | |
| 251 | + | ontimeout: () => reject(new Error('下载超时')), | |
| 252 | + | }); | |
| 253 | + | }); | |
| 254 | + | } | |
| 255 | + | ||
| 256 | + | function formatTimestamp(dateString) { | |
| 257 | + | const date = new Date(dateString); | |
| 258 | + | if (Number.isNaN(date.getTime())) return new Date().toISOString().replace(/[-:TZ.]/g, '').slice(0, 14); | |
| 259 | + | return date.toISOString().replace(/[-:TZ.]/g, '').slice(0, 14); | |
| 260 | + | } | |
| 261 | + | ||
| 262 | + | async function downloadStatus(statusId, onProgress) { | |
| 263 | + | const tweet = await fetchTweet(statusId); | |
| 264 | + | const items = await buildDownloadItems(statusId, tweet); | |
| 265 | + | const history = await GM_getValue(HISTORY_KEY, []); | |
| 266 | + | const results = []; | |
| 267 | + | let succeeded = 0; | |
| 268 | + | ||
| 269 | + | for (let index = 0; index < items.length; index += 1) { | |
| 270 | + | const item = items[index]; | |
| 271 | + | onProgress?.({ index: index + 1, total: items.length, filename: item.filename }); | |
| 272 | + | try { | |
| 273 | + | await downloadFile(item.url, item.filename); | |
| 274 | + | succeeded += 1; | |
| 275 | + | results.push({ filename: item.filename, url: item.url, success: true }); | |
| 276 | + | } catch (error) { | |
| 277 | + | results.push({ filename: item.filename, url: item.url, success: false, error: error.message }); | |
| 278 | + | } | |
| 279 | + | if (index < items.length - 1) await sleep(DOWNLOAD_GAP_MS); | |
| 280 | + | } | |
| 281 | + | ||
| 282 | + | if (succeeded === items.length && !history.includes(statusId)) { | |
| 283 | + | history.push(statusId); | |
| 284 | + | await GM_setValue(HISTORY_KEY, history); | |
| 285 | + | } | |
| 286 | + | return { tweet, results, succeeded, failed: items.length - succeeded }; | |
| 287 | + | } | |
| 288 | + | ||
| 289 | + | const ICON_PATHS = { | |
| 290 | + | download: 'M5 20h14v-2H5v2zm7-18a1 1 0 0 0-1 1v8H7l5 5 5-5h-4V3a1 1 0 0 0-1-1z', | |
| 291 | + | completed: 'M9 16.2 4.8 12l-1.4 1.4L9 19l12-12-1.4-1.4z', | |
| 292 | + | failed: 'M19 6.4 17.6 5 12 10.6 6.4 5 5 6.4 10.6 12 5 17.6 6.4 19 12 13.4 17.6 19 19 17.6 13.4 12z', | |
| 293 | + | loading: 'M12 2a10 10 0 1 0 10 10h-2a8 8 0 1 1-8-8V2zm1-1v6l5-3-5-3z', | |
| 294 | + | }; | |
| 295 | + | ||
| 296 | + | function setButtonState(button, state, title) { | |
| 297 | + | button.dataset.state = state; | |
| 298 | + | const label = title || ({ download: '下载此推文媒体', loading: '正在下载…', completed: '下载完成(仍可再次点击)', failed: '下载失败;点击重试' }[state]); | |
| 299 | + | let svg = button.querySelector('svg'); | |
| 300 | + | if (!svg) { | |
| 301 | + | svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg'); | |
| 302 | + | svg.setAttribute('viewBox', '0 0 24 24'); | |
| 303 | + | button.append(svg); | |
| 304 | + | } | |
| 305 | + | svg.innerHTML = `<path fill="currentColor" d="${ICON_PATHS[state] || ICON_PATHS.download}"></path>`; | |
| 306 | + | button.title = label; | |
| 307 | + | button.setAttribute('aria-label', label); | |
| 308 | + | button.setAttribute('role', 'button'); | |
| 309 | + | if (!button.hasAttribute('tabindex')) button.tabIndex = 0; | |
| 310 | + | button.setAttribute('aria-disabled', state === 'loading' ? 'true' : 'false'); | |
| 311 | + | } | |
| 312 | + | ||
| 313 | + | async function runSingleDownload(button, statusId) { | |
| 314 | + | if (button.dataset.state === 'loading') return; | |
| 315 | + | setButtonState(button, 'loading'); | |
| 316 | + | try { | |
| 317 | + | const result = await downloadStatus(statusId, ({ index, total, filename }) => { | |
| 318 | + | button.title = `正在下载 ${index}/${total}:${filename}`; | |
| 319 | + | }); | |
| 320 | + | if (result.failed) { | |
| 321 | + | const failed = result.results.filter((item) => !item.success).map((item) => `${item.filename}: ${item.error}`).join('\n'); | |
| 322 | + | setButtonState(button, 'failed', failed || '部分媒体下载失败;点击重试'); | |
| 323 | + | } else { | |
| 324 | + | setButtonState(button, 'completed'); | |
| 325 | + | } | |
| 326 | + | } catch (error) { | |
| 327 | + | console.error('[Twitter Media Downloader]', error); | |
| 328 | + | setButtonState(button, 'failed', error.message || '下载失败;点击重试'); | |
| 329 | + | } | |
| 330 | + | } | |
| 331 | + | ||
| 332 | + | function isMediaArticle(article) { | |
| 333 | + | return Boolean(article.querySelector( | |
| 334 | + | 'a[href*="/photo/"], [data-testid="tweetPhoto"], [data-testid="videoPlayer"], video, div[role="progressbar"], div[data-testid="playButton"]' | |
| 335 | + | )); | |
| 336 | + | } | |
| 337 | + | ||
| 338 | + | function addTweetButton(article) { | |
| 339 | + | if (!(article instanceof HTMLElement) || article.dataset.tmdButton === 'true' || !isMediaArticle(article)) return; | |
| 340 | + | const statusLink = article.querySelector('a[href*="/status/"]'); | |
| 341 | + | const actionGroup = article.querySelector('div[role="group"]'); | |
| 342 | + | const statusId = statusLink && getStatusId(statusLink.href); | |
| 343 | + | if (!statusId || !actionGroup) return; | |
| 344 | + | ||
| 345 | + | const originalAction = Array.from(actionGroup.querySelectorAll(':scope > div > div')).pop()?.parentNode; | |
| 346 | + | const button = originalAction?.cloneNode(true) || document.createElement('button'); | |
| 347 | + | button.classList.add('tmd-maintained-button'); | |
| 348 | + | button.removeAttribute('id'); | |
| 349 | + | button.removeAttribute('data-testid'); | |
| 350 | + | button.querySelectorAll('[data-testid]').forEach((node) => node.removeAttribute('data-testid')); | |
| 351 | + | setButtonState(button, 'download'); | |
| 352 | + | const activate = (event) => { | |
| 353 | + | event.preventDefault(); | |
| 354 | + | event.stopPropagation(); | |
| 355 | + | runSingleDownload(button, statusId); | |
| 356 | + | }; | |
| 357 | + | button.addEventListener('click', activate); | |
| 358 | + | button.addEventListener('keydown', (event) => { | |
| 359 | + | if (event.key === 'Enter' || event.key === ' ') activate(event); | |
| 360 | + | }); | |
| 361 | + | actionGroup.append(button); | |
| 362 | + | article.dataset.tmdButton = 'true'; | |
| 363 | + | } | |
| 364 | + | ||
| 365 | + | function queuePostForBatch(statusId) { | |
| 366 | + | const state = batchState; | |
| 367 | + | if (!state?.active || state.queuedPosts.has(statusId) || completedBatchPosts.has(statusId)) return; | |
| 368 | + | state.queuedPosts.add(statusId); | |
| 369 | + | state.postQueue.push(statusId); | |
| 370 | + | } | |
| 371 | + | ||
| 372 | + | function updateBatchPanel() { | |
| 373 | + | if (!panelCount || !panelButton) return; | |
| 374 | + | const eligiblePosts = Array.from(discoveredPosts.keys()).filter((id) => !completedBatchPosts.has(id)); | |
| 375 | + | panelCount.textContent = batchState?.active | |
| 376 | + | ? `已发现 ${discoveredPosts.size} 条推文,已识别 ${batchState.scheduledFiles} 个媒体文件` | |
| 377 | + | : `已发现 ${discoveredPosts.size} 条媒体推文(已加载)`; | |
| 378 | + | if (batchState?.active) { | |
| 379 | + | panelButton.disabled = false; | |
| 380 | + | panelButton.textContent = batchState.paused ? '继续下载' : '暂停下载'; | |
| 381 | + | const queuedPosts = batchState.postQueue.length; | |
| 382 | + | const queuedFiles = batchState.mediaQueue.length; | |
| 383 | + | const running = batchState.currentMedia ? `;当前文件:${batchState.currentMedia.filename}` : batchState.currentPost ? `;正在读取推文 ${batchState.currentPost}` : ''; | |
| 384 | + | const pauseLabel = batchState.paused && batchState.currentMedia ? '正在暂停(当前文件完成后停止)' : batchState.paused ? '已暂停' : '下载中'; | |
| 385 | + | panelStatus.textContent = `${pauseLabel}:待读取推文 ${queuedPosts} 条,待下载媒体 ${queuedFiles} 个,成功 ${batchState.succeeded},失败 ${batchState.failed}${running}`; | |
| 386 | + | } else { | |
| 387 | + | panelButton.disabled = eligiblePosts.length === 0; | |
| 388 | + | panelButton.textContent = eligiblePosts.length | |
| 389 | + | ? '下载已加载媒体' | |
| 390 | + | : discoveredPosts.size ? '已下载当前媒体' : '等待媒体加载'; | |
| 391 | + | if (panelStatus && !batchState?.finished) panelStatus.textContent = '不会自动滚动页面;滚动加载更多后会继续收集。'; | |
| 392 | + | } | |
| 393 | + | } | |
| 394 | + | ||
| 395 | + | function collectLoadedMediaPosts() { | |
| 396 | + | const anchors = document.querySelectorAll('main a[href*="/status/"]'); | |
| 397 | + | for (const anchor of anchors) { | |
| 398 | + | const href = anchor.href || ''; | |
| 399 | + | if (!/\/status\/\d+\/(?:photo|video)\/\d+/i.test(href)) continue; | |
| 400 | + | const statusId = getStatusId(href); | |
| 401 | + | if (statusId && !discoveredPosts.has(statusId)) { | |
| 402 | + | discoveredPosts.set(statusId, true); | |
| 403 | + | queuePostForBatch(statusId); | |
| 404 | + | } | |
| 405 | + | } | |
| 406 | + | updateBatchPanel(); | |
| 407 | + | return Array.from(discoveredPosts.keys()); | |
| 408 | + | } | |
| 409 | + | ||
| 410 | + | function createBatchPanel() { | |
| 411 | + | if (!/\/media\/?$/.test(location.pathname) || document.getElementById(PANEL_ID)) return; | |
| 412 | + | const panel = document.createElement('section'); | |
| 413 | + | panel.id = PANEL_ID; | |
| 414 | + | panel.innerHTML = ` | |
| 415 | + | <header><strong>X 媒体批量下载</strong><button type="button" class="tmd-collapse" aria-label="收起">−</button></header> | |
| 416 | + | <div class="tmd-panel-body"> | |
| 417 | + | <div class="tmd-batch-count">正在扫描已加载媒体…</div> | |
| 418 | + | <button type="button" class="tmd-batch-download" disabled>下载已加载媒体</button> | |
| 419 | + | <div class="tmd-batch-status" role="status">不会自动滚动页面;滚动加载更多后会继续收集。</div> | |
| 420 | + | </div>`; | |
| 421 | + | document.body.append(panel); | |
| 422 | + | panelCount = panel.querySelector('.tmd-batch-count'); | |
| 423 | + | panelStatus = panel.querySelector('.tmd-batch-status'); | |
| 424 | + | panelButton = panel.querySelector('.tmd-batch-download'); | |
| 425 | + | panel.querySelector('.tmd-collapse').addEventListener('click', () => { | |
| 426 | + | panel.classList.toggle('collapsed'); | |
| 427 | + | panel.querySelector('.tmd-collapse').textContent = panel.classList.contains('collapsed') ? '+' : '−'; | |
| 428 | + | }); | |
| 429 | + | panelButton.addEventListener('click', handleBatchButton); | |
| 430 | + | collectLoadedMediaPosts(); | |
| 431 | + | } | |
| 432 | + | ||
| 433 | + | function safeText(value) { | |
| 434 | + | return String(value || '').replace(/[\r\n\t]+/g, ' ').trim(); | |
| 435 | + | } | |
| 436 | + | ||
| 437 | + | function batchFolderName() { | |
| 438 | + | const handle = location.pathname.split('/').filter(Boolean)[0] || 'X'; | |
| 439 | + | const runId = Math.random().toString(36).slice(2, 6); | |
| 440 | + | return sanitizeFilename(`${handle}_media_${formatTimestamp(new Date().toISOString())}_${runId}`); | |
| 441 | + | } | |
| 442 | + | ||
| 443 | + | function createBatchInfoBlob(state) { | |
| 444 | + | const lines = [ | |
| 445 | + | 'Twitter/X Media Downloader — batch report', | |
| 446 | + | `Profile: ${location.origin}/${state.handle}/media`, | |
| 447 | + | `Started: ${state.startedAt}`, | |
| 448 | + | `Finished: ${new Date().toLocaleString()}`, | |
| 449 | + | `Posts initially queued: ${state.discoveredCountAtStart} (newly discovered posts during the run are included)`, | |
| 450 | + | `Files succeeded: ${state.succeeded}`, | |
| 451 | + | `Files failed: ${state.failed}`, | |
| 452 | + | '', | |
| 453 | + | 'Results:', | |
| 454 | + | ]; | |
| 455 | + | state.results.forEach((item) => { | |
| 456 | + | lines.push(`- ${item.success ? 'SUCCESS' : 'FAILED'}: ${safeText(item.filename || item.statusId)}`); | |
| 457 | + | if (item.statusId) lines.push(` Post: https://x.com/${state.handle}/status/${item.statusId}`); | |
| 458 | + | if (item.url) lines.push(` Media URL: ${item.url}`); | |
| 459 | + | if (item.error) lines.push(` Error: ${safeText(item.error)}`); | |
| 460 | + | }); | |
| 461 | + | return new Blob([`\uFEFF${lines.join('\n')}\n`], { type: 'text/plain;charset=utf-8' }); | |
| 462 | + | } | |
| 463 | + | ||
| 464 | + | async function startBatchDownload() { | |
| 465 | + | collectLoadedMediaPosts(); | |
| 466 | + | const eligible = Array.from(discoveredPosts.keys()).filter((id) => !completedBatchPosts.has(id)); | |
| 467 | + | if (!eligible.length) return; | |
| 468 | + | const handle = location.pathname.split('/').filter(Boolean)[0] || 'X'; | |
| 469 | + | batchState = { | |
| 470 | + | active: true, | |
| 471 | + | paused: false, | |
| 472 | + | pumping: false, | |
| 473 | + | handle, | |
| 474 | + | folder: batchFolderName(), | |
| 475 | + | startedAt: new Date().toLocaleString(), | |
| 476 | + | discoveredCountAtStart: eligible.length, | |
| 477 | + | postQueue: [], | |
| 478 | + | queuedPosts: new Set(), | |
| 479 | + | mediaQueue: [], | |
| 480 | + | queuedMedia: new Set(), | |
| 481 | + | postProgress: new Map(), | |
| 482 | + | currentPost: '', | |
| 483 | + | currentMedia: null, | |
| 484 | + | succeeded: 0, | |
| 485 | + | failed: 0, | |
| 486 | + | scheduledFiles: 0, | |
| 487 | + | results: [], | |
| 488 | + | finished: false, | |
| 489 | + | }; | |
| 490 | + | eligible.forEach(queuePostForBatch); | |
| 491 | + | updateBatchPanel(); | |
| 492 | + | void pumpBatch(batchState); | |
| 493 | + | } | |
| 494 | + | ||
| 495 | + | function handleBatchButton() { | |
| 496 | + | if (!batchState?.active) { | |
| 497 | + | void startBatchDownload(); | |
| 498 | + | return; | |
| 499 | + | } | |
| 500 | + | if (!batchState.paused) { | |
| 501 | + | batchState.paused = true; | |
| 502 | + | panelStatus.textContent = batchState.currentMedia | |
| 503 | + | ? `正在暂停:当前文件完成后暂停,后续文件不会启动。` | |
| 504 | + | : '已暂停;继续后会处理剩余媒体及暂停期间新发现的推文。'; | |
| 505 | + | updateBatchPanel(); | |
| 506 | + | return; | |
| 507 | + | } | |
| 508 | + | batchState.paused = false; | |
| 509 | + | updateBatchPanel(); | |
| 510 | + | void pumpBatch(batchState); | |
| 511 | + | } | |
| 512 | + | ||
| 513 | + | async function finishBatch(state) { | |
| 514 | + | if (state.finished) return; | |
| 515 | + | state.finished = true; | |
| 516 | + | try { | |
| 517 | + | await downloadFile(createBatchInfoBlob(state), `${state.folder}/info.txt`); | |
| 518 | + | state.infoSaved = true; | |
| 519 | + | } catch (error) { | |
| 520 | + | state.infoSaved = false; | |
| 521 | + | console.warn('[Twitter Media Downloader] info.txt download failed', error); | |
| 522 | + | } | |
| 523 | + | if (batchState === state) { | |
| 524 | + | panelStatus.textContent = `完成:成功 ${state.succeeded} 个媒体,失败 ${state.failed} 个;${state.infoSaved ? 'info.txt 已保存' : 'info.txt 保存失败'}。`; | |
| 525 | + | updateBatchPanel(); | |
| 526 | + | } | |
| 527 | + | } | |
| 528 | + | ||
| 529 | + | async function pumpBatch(state) { | |
| 530 | + | if (!state?.active || state.paused || state.pumping) return; | |
| 531 | + | state.pumping = true; | |
| 532 | + | try { | |
| 533 | + | while (state.active && !state.paused) { | |
| 534 | + | if (state.mediaQueue.length) { | |
| 535 | + | const item = state.mediaQueue.shift(); | |
| 536 | + | state.currentMedia = item; | |
| 537 | + | updateBatchPanel(); | |
| 538 | + | let success = false; | |
| 539 | + | let errorMessage = ''; | |
| 540 | + | try { | |
| 541 | + | await downloadFile(item.url, `${state.folder}/${item.filename}`); | |
| 542 | + | success = true; | |
| 543 | + | state.succeeded += 1; | |
| 544 | + | } catch (error) { | |
| 545 | + | errorMessage = error.message || '下载失败'; | |
| 546 | + | state.failed += 1; | |
| 547 | + | } | |
| 548 | + | state.results.push({ statusId: item.statusId, filename: item.filename, url: item.url, success, error: errorMessage }); | |
| 549 | + | const progress = state.postProgress.get(item.statusId); | |
| 550 | + | if (progress) { | |
| 551 | + | progress.remaining -= 1; | |
| 552 | + | if (!success) progress.failed = true; | |
| 553 | + | if (progress.remaining === 0 && !progress.failed) completedBatchPosts.add(item.statusId); | |
| 554 | + | } | |
| 555 | + | state.currentMedia = null; | |
| 556 | + | updateBatchPanel(); | |
| 557 | + | await sleep(DOWNLOAD_GAP_MS); | |
| 558 | + | continue; | |
| 559 | + | } | |
| 560 | + | ||
| 561 | + | if (state.postQueue.length) { | |
| 562 | + | const statusId = state.postQueue.shift(); | |
| 563 | + | state.currentPost = statusId; | |
| 564 | + | updateBatchPanel(); | |
| 565 | + | try { | |
| 566 | + | const tweet = await fetchTweet(statusId); | |
| 567 | + | const items = await buildDownloadItems(statusId, tweet); | |
| 568 | + | const freshItems = items.filter((item) => { | |
| 569 | + | if (state.queuedMedia.has(item.url)) return false; | |
| 570 | + | state.queuedMedia.add(item.url); | |
| 571 | + | return true; | |
| 572 | + | }); | |
| 573 | + | if (!freshItems.length) { | |
| 574 | + | completedBatchPosts.add(statusId); | |
| 575 | + | state.results.push({ statusId, filename: '', success: true, error: '重复媒体,已跳过' }); | |
| 576 | + | } else { | |
| 577 | + | state.postProgress.set(statusId, { remaining: freshItems.length, failed: false }); | |
| 578 | + | state.scheduledFiles += freshItems.length; | |
| 579 | + | state.mediaQueue.push(...freshItems); | |
| 580 | + | } | |
| 581 | + | } catch (error) { | |
| 582 | + | state.failed += 1; | |
| 583 | + | state.results.push({ statusId, filename: '', success: false, error: error.message || '读取推文失败' }); | |
| 584 | + | console.warn('[Twitter Media Downloader] batch post failed', statusId, error); | |
| 585 | + | } | |
| 586 | + | state.currentPost = ''; | |
| 587 | + | updateBatchPanel(); | |
| 588 | + | continue; | |
| 589 | + | } | |
| 590 | + | ||
| 591 | + | state.active = false; | |
| 592 | + | } | |
| 593 | + | } finally { | |
| 594 | + | state.pumping = false; | |
| 595 | + | if (state.active && !state.paused && (state.postQueue.length || state.mediaQueue.length)) { | |
| 596 | + | void pumpBatch(state); | |
| 597 | + | } else if (!state.active) { | |
| 598 | + | await finishBatch(state); | |
| 599 | + | } | |
| 600 | + | updateBatchPanel(); | |
| 601 | + | } | |
| 602 | + | } | |
| 603 | + | ||
| 604 | + | function installStyles() { | |
| 605 | + | if (document.getElementById('tmd-maintained-style')) return; | |
| 606 | + | const style = document.createElement('style'); | |
| 607 | + | style.id = 'tmd-maintained-style'; | |
| 608 | + | style.textContent = ` | |
| 609 | + | #${PANEL_ID}{position:fixed;z-index:2147483647;right:20px;bottom:24px;width:285px;color:#202124;background:var(--background-primary,#fff); | |
| 610 | + | border:1px solid #d9dde3;border-radius:12px;box-shadow:0 4px 18px #0002;font:14px/1.5 system-ui,sans-serif} | |
| 611 | + | #${PANEL_ID} header{display:flex;align-items:center;justify-content:space-between;padding:10px 12px;border-bottom:1px solid #eee} | |
| 612 | + | #${PANEL_ID} button{font:inherit;cursor:pointer}#${PANEL_ID} .tmd-collapse{border:0;background:transparent;font-size:20px;color:#666} | |
| 613 | + | #${PANEL_ID} .tmd-panel-body{padding:11px 12px 12px}#${PANEL_ID} .tmd-batch-count{margin-bottom:9px;color:#536471} | |
| 614 | + | #${PANEL_ID} .tmd-batch-download{width:100%;padding:8px;border:0;border-radius:999px;background:#1d9bf0;color:white;font-weight:700} | |
| 615 | + | #${PANEL_ID} .tmd-batch-download:hover{background:#1a8cd8}#${PANEL_ID} .tmd-batch-download:disabled{opacity:.55;cursor:default} | |
| 616 | + | #${PANEL_ID} .tmd-batch-status{min-height:20px;margin-top:8px;color:#536471;font-size:12px} | |
| 617 | + | #${PANEL_ID}.collapsed{width:auto}#${PANEL_ID}.collapsed .tmd-panel-body{display:none} | |
| 618 | + | .tmd-maintained-button{display:inline-flex!important;align-items:center;justify-content:center;width:34px;height:34px;margin-left:4px;padding:0; | |
| 619 | + | color:rgb(83,100,113);background:transparent;border:0;border-radius:999px;cursor:pointer} | |
| 620 | + | .tmd-maintained-button:hover{color:rgb(29,155,240);background:rgba(29,155,240,.1)} | |
| 621 | + | .tmd-maintained-button svg{display:block;width:18px;height:18px;fill:currentColor} | |
| 622 | + | .tmd-maintained-button[data-state="completed"]{color:rgb(29,155,240)} | |
| 623 | + | .tmd-maintained-button[data-state="failed"]{color:rgb(244,33,46)} | |
| 624 | + | .tmd-maintained-button[data-state="loading"] svg{animation:tmd-spin 1s linear infinite} | |
| 625 | + | @keyframes tmd-spin{to{transform:rotate(360deg)}}`; | |
| 626 | + | document.head.append(style); | |
| 627 | + | } | |
| 628 | + | ||
| 629 | + | function installSettings() { | |
| 630 | + | if (typeof GM_registerMenuCommand !== 'function') return; | |
| 631 | + | GM_registerMenuCommand('下载设置:文件名格式', async () => { | |
| 632 | + | const current = await GM_getValue(FILENAME_KEY, DEFAULT_FILENAME); | |
| 633 | + | const next = window.prompt('文件名格式,可用 {user-name} {user-id} {date-time} {status-id} {file-type} {file-name}', current); | |
| 634 | + | if (next !== null && next.trim()) await GM_setValue(FILENAME_KEY, next.trim()); | |
| 635 | + | }); | |
| 636 | + | GM_registerMenuCommand(`Twitter Media Downloader ${VERSION}`, () => { | |
| 637 | + | window.alert('AMANE 原脚本的社区维护版。支持单条下载及媒体页已加载内容批量下载。'); | |
| 638 | + | }); | |
| 639 | + | } | |
| 640 | + | ||
| 641 | + | function scanPage() { | |
| 642 | + | const isMediaPage = /\/media\/?$/.test(location.pathname); | |
| 643 | + | const panel = document.getElementById(PANEL_ID); | |
| 644 | + | if (!isMediaPage && panel && !batchState?.active) { | |
| 645 | + | panel.remove(); | |
| 646 | + | panelCount = null; | |
| 647 | + | panelStatus = null; | |
| 648 | + | panelButton = null; | |
| 649 | + | discoveredPosts.clear(); | |
| 650 | + | } | |
| 651 | + | document.querySelectorAll('article').forEach(addTweetButton); | |
| 652 | + | if (isMediaPage) { | |
| 653 | + | if (!document.getElementById(PANEL_ID)) createBatchPanel(); | |
| 654 | + | collectLoadedMediaPosts(); | |
| 655 | + | } | |
| 656 | + | } | |
| 657 | + | ||
| 658 | + | function start() { | |
| 659 | + | installStyles(); | |
| 660 | + | installSettings(); | |
| 661 | + | createBatchPanel(); | |
| 662 | + | scanPage(); | |
| 663 | + | let scanTimer; | |
| 664 | + | const observer = new MutationObserver(() => { | |
| 665 | + | window.clearTimeout(scanTimer); | |
| 666 | + | scanTimer = window.setTimeout(() => { | |
| 667 | + | scanPage(); | |
| 668 | + | if (!document.getElementById(PANEL_ID)) createBatchPanel(); | |
| 669 | + | }, 120); | |
| 670 | + | }); | |
| 671 | + | observer.observe(document.body, { childList: true, subtree: true }); | |
| 672 | + | } | |
| 673 | + | ||
| 674 | + | if (document.body) start(); | |
| 675 | + | else document.addEventListener('DOMContentLoaded', start, { once: true }); | |
| 676 | + | })(); | |
Novější
Starší