feat(script): 支持设置视频下载偏好

Author: JoeanAmier

static/Release_Notes.md

@@ -12,12 +12,13 @@
 
 **用户脚本更新内容：**
 
-**版本号：2.4.2**
+**版本号：2.4.3**
 
 1. 修复部分视频下载失败的问题
 2. 优化视频下载链接提取逻辑
 3. 优化显示位置，避免遮挡内容
 4. 支持自定义文件名称格式
-5. 脚本图标支持移动位置
-6. 新增对 RedNote 的支持
-7. 调整图标显示位置
+5. 支持设置视频下载偏好
+6. 脚本图标支持移动位置
+7. 新增对 RedNote 的支持
+8. 调整图标显示位置

static/XHS-Downloader.js

@@ -2,7 +2,7 @@
 // @name           XHS-Downloader
 // @namespace      xhs_downloader
 // @homepage       https://github.com/JoeanAmier/XHS-Downloader
-// @version        2.4.2
+// @version        2.4.3
 // @tag            小红书
 // @tag            RedNote
 // @tag            XiaoHongShu
@@ -130,6 +130,13 @@ KS-Downloader（快手、KuaiShou）：https://github.com/JoeanAmier/KS-Download
             scriptServerSwitchDesc: '启用后，可以把作品下载任务推送至服务器',
             imageDownloadFormatLabel: '图片下载格式',
             imageDownloadFormatDesc: '图文作品文件下载格式',
+            videoPreferenceLabel: '视频下载偏好',
+            videoPreferenceDesc: '视频作品文件下载策略',
+            videoPreferenceOptions: {
+                resolution: '分辨率优先',
+                bitrate: '码率优先',
+                size: '文件大小优先',
+            },
             fileNameFormatLabel: '作品文件名称格式',
             fileNameFormatDesc: '点击可选字段添加，拖拽已选字段调整顺序',
             fileNameSelectedLabel: '已选字段',
@@ -286,6 +293,13 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
             scriptServerSwitchDesc: 'When enabled, download tasks can be pushed to the server',
             imageDownloadFormatLabel: 'Image Download Format',
             imageDownloadFormatDesc: 'Preferred file format for downloading images',
+            videoPreferenceLabel: 'Video download preferences',
+            videoPreferenceDesc: 'Video Notes File Download Strategy',
+            videoPreferenceOptions: {
+                resolution: 'Resolution priority',
+                bitrate: 'Bitrate priority',
+                size: 'File size priority',
+            },
             fileNameFormatLabel: 'Note File Name Format',
             fileNameFormatDesc: 'Click available fields to add them. Drag selected fields to reorder.',
             fileNameSelectedLabel: 'Selected Fields',
@@ -420,6 +434,7 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         linkCheckboxSwitch: GM_getValue("linkCheckboxSwitch", true),
         imageCheckboxSwitch: GM_getValue("imageCheckboxSwitch", true),
         imageDownloadFormat: GM_getValue("imageDownloadFormat", "jpeg"),
+        videoPreference: GM_getValue("videoPreference", "resolution"),
         scriptServerURL: GM_getValue("scriptServerURL", defaultsWebSocketURL),
         scriptServerSwitch: GM_getValue("scriptServerSwitch", false),
         fileNameFormatKeys: storedFileNameFormatKeys,
@@ -560,6 +575,11 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         GM_setValue("imageDownloadFormat", config.imageDownloadFormat);
     }
 
+    const updateVideoPreference = (value) => {
+        config.videoPreference = value;
+        GM_setValue("videoPreference", value);
+    };
+
     // 更新文件名格式配置。
     const updateFileNameFormat = (value) => {
         config.fileNameFormatKeys = parseFileNameFormat(value);
@@ -592,13 +612,21 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         }
     }
 
+    const preferenceKey = {
+        resolution: "height",
+        bitrate: "videoBitrate",
+        size: "size",
+    };
+
     const generateVideoUrl = note => {
         try {
             const key = note.video?.consumer?.originVideoKey;
             if (key) return [`https://sns-video-bd.xhscdn.com/${key}`];
             const allStreams = Object.values(note.video.media.stream).flat();
-            sortArray(allStreams, "height");
-            return [allStreams[0].backupUrls[0] || allStreams[0].masterUrl];
+            if (allStreams.length === 0) return [];
+            sortArray(allStreams, preferenceKey[config.videoPreference]);
+            const stream = allStreams[0];
+            return [stream.backupUrls[0] || stream.masterUrl];
         } catch (error) {
             console.error("Error deal video URL:", error);
             return [];
@@ -1442,7 +1470,8 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         box-shadow: 0 0 4px rgba(33, 150, 243, 0.3);
     }
     .select-input {
-        width: 100px;
+        min-width: 130px;
+        width: auto;
         padding: 8px 12px;
         border: 1px solid #ddd;
         border-radius: 4px;
@@ -1919,8 +1948,11 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         item.style.opacity = disabled ? 0.6 : 1;
 
         // 生成选项HTML
-        const optionsHtml = options.map(
-            option => `<option value="${option}" ${option === value ? 'selected' : ''}>${option}</option>`).join('');
+        const optionsHtml = options.map(option => {
+            const optionValue = typeof option === 'object' ? option.value : option;
+            const optionLabel = typeof option === 'object' ? option.label : option;
+            return `<option value="${optionValue}" ${optionValue === value ? 'selected' : ''}>${optionLabel}</option>`;
+        }).join('');
 
         item.innerHTML = `
             <label>
@@ -2033,6 +2065,17 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
                                                              .toUpperCase(),
                                                      });
 
+        const videoPreference = createSelectItem({
+                                                     label: t.videoPreferenceLabel,
+                                                     description: t.videoPreferenceDesc,
+                                                     options: Object.entries(t.videoPreferenceOptions)
+                                                                    .map(([value, label]) => ({
+                                                                        value,
+                                                                        label,
+                                                                    })),
+                                                     value: config.videoPreference,
+                                                 });
+
         const nameFormat = createFileNameFormatEditor({
                                                           label: t.fileNameFormatLabel,
                                                           description: t.fileNameFormatDesc,
@@ -2068,7 +2111,7 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
         // 组合内容
         body.appendChild(createSettingsGroup(
             t.downloadSettingsGroup,
-            [filePack, imageCheckboxSwitch, imageDownloadFormat, nameFormat],
+            [filePack, imageCheckboxSwitch, imageDownloadFormat, videoPreference, nameFormat],
             true
         ));
         body.appendChild(createSettingsGroup(t.extractSettingsGroup, [autoScroll, scrollCount, linkCheckboxSwitch]));
@@ -2105,6 +2148,7 @@ Discord Community: https://discord.com/invite/ZYtmgKud9Y
             updateScriptServerURL(scriptServerURL.querySelector('.text-input').value.trim() || defaultsWebSocketURL);
             updateScriptServerSwitch(scriptServerSwitch.querySelector('input').checked);
             updateImageDownloadFormat(imageDownloadFormat.querySelector('select').value.trim() || "jpeg");
+            updateVideoPreference(videoPreference.querySelector('select').value);
             updateFileNameFormat(nameFormat.getFileNameFormatKeys());
             closeSettingsModal();
         });