feat: add update source preference settings for auto, GitHub, and Gitee

Author: lakernote

src/main/java/com/laker/postman/panel/topmenu/setting/SettingManager.java

@@ -312,6 +312,28 @@ public static void setAutoUpdateStartupDelaySeconds(long seconds) {
         save();
     }
 
+    /**
+     * 更新源偏好设置
+     * 支持的值：
+     * - "auto": 自动选择最快的源（默认）
+     * - "github": 始终使用 GitHub
+     * - "gitee": 始终使用 Gitee
+     */
+    public static String getUpdateSourcePreference() {
+        String val = props.getProperty("update_source_preference");
+        if (val != null && (val.equals("github") || val.equals("gitee") || val.equals("auto"))) {
+            return val;
+        }
+        return "gitee";
+    }
+
+    public static void setUpdateSourcePreference(String preference) {
+        if (preference != null && (preference.equals("auto") || preference.equals("github") || preference.equals("gitee"))) {
+            props.setProperty("update_source_preference", preference);
+            save();
+        }
+    }
+
     // ===== 网络代理设置 =====
 
     /**

src/main/java/com/laker/postman/panel/topmenu/setting/SystemSettingsPanel.java

@@ -22,6 +22,7 @@ public class SystemSettingsPanel extends JPanel {
     private JCheckBox autoUpdateCheckBox;
     private JTextField autoUpdateIntervalField;
     private JTextField autoUpdateStartupDelayField;
+    private JComboBox<String> updateSourceComboBox;
     private JButton saveBtn;
     private JButton cancelBtn;
 
@@ -83,6 +84,30 @@ private void initUI() {
         autoUpdateStartupDelayField.setText(String.valueOf(SettingManager.getAutoUpdateStartupDelaySeconds()));
         autoUpdatePanel.add(autoUpdateStartupDelayField, gbc);
 
+        // 更新源选择
+        gbc.gridx = 0;
+        gbc.gridy = 3;
+        JLabel updateSourceLabel = new JLabel(I18nUtil.getMessage(MessageKeys.SETTINGS_UPDATE_SOURCE_PREFERENCE));
+        updateSourceLabel.setToolTipText(I18nUtil.getMessage(MessageKeys.SETTINGS_UPDATE_SOURCE_PREFERENCE_TOOLTIP));
+        autoUpdatePanel.add(updateSourceLabel, gbc);
+
+        gbc.gridx = 1;
+        String[] sourceOptions = {
+            I18nUtil.getMessage(MessageKeys.SETTINGS_UPDATE_SOURCE_AUTO),
+            I18nUtil.getMessage(MessageKeys.SETTINGS_UPDATE_SOURCE_GITHUB),
+            I18nUtil.getMessage(MessageKeys.SETTINGS_UPDATE_SOURCE_GITEE)
+        };
+        updateSourceComboBox = new JComboBox<>(sourceOptions);
+
+        // 根据当前设置选择对应的选项
+        String currentPreference = SettingManager.getUpdateSourcePreference();
+        switch (currentPreference) {
+            case "github" -> updateSourceComboBox.setSelectedIndex(1);
+            case "gitee" -> updateSourceComboBox.setSelectedIndex(2);
+            default -> updateSourceComboBox.setSelectedIndex(0); // auto
+        }
+        autoUpdatePanel.add(updateSourceComboBox, gbc);
+
         mainPanel.add(autoUpdatePanel);
         mainPanel.add(Box.createVerticalGlue());
 
@@ -183,6 +208,7 @@ public void keyPressed(KeyEvent e) {
         autoUpdateCheckBox.addKeyListener(keyAdapter);
         autoUpdateIntervalField.addKeyListener(keyAdapter);
         autoUpdateStartupDelayField.addKeyListener(keyAdapter);
+        updateSourceComboBox.addKeyListener(keyAdapter);
     }
 
     private void registerListeners() {
@@ -218,6 +244,15 @@ private void saveSettings() {
             SettingManager.setAutoUpdateCheckIntervalHours(autoUpdateInterval);
             SettingManager.setAutoUpdateStartupDelaySeconds(autoUpdateStartupDelay);
 
+            // 保存更新源偏好
+            int selectedIndex = updateSourceComboBox.getSelectedIndex();
+            String preference = switch (selectedIndex) {
+                case 1 -> "github";
+                case 2 -> "gitee";
+                default -> "auto";
+            };
+            SettingManager.setUpdateSourcePreference(preference);
+
             NotificationUtil.showSuccess(I18nUtil.getMessage(MessageKeys.SETTINGS_SAVE_SUCCESS));
 
             Window window = SwingUtilities.getWindowAncestor(this);

src/main/java/com/laker/postman/service/update/VersionChecker.java

@@ -82,16 +82,31 @@ public UpdateInfo checkForUpdate() {
 
     /**
      * 检测最佳源（GitHub 或 Gitee）
-     * 策略：并行测试连接速度，选择响应最快的源
+     * 策略：根据用户偏好设置或并行测试连接速度，选择最合适的源
      */
     private static String detectBestSource() {
+        // 检查用户的更新源偏好设置
+        String preference = com.laker.postman.panel.topmenu.setting.SettingManager.getUpdateSourcePreference();
+
+        // 如果用户指定了固定源，直接使用
+        if ("github".equals(preference)) {
+            log.info("Using user-preferred source: GitHub");
+            cachedBestSource = GITHUB_API_URL;
+            return GITHUB_API_URL;
+        } else if ("gitee".equals(preference)) {
+            log.info("Using user-preferred source: Gitee");
+            cachedBestSource = GITEE_API_URL;
+            return GITEE_API_URL;
+        }
+
+        // auto 模式：自动选择最快的源
         // 如果已有缓存，直接使用
         if (cachedBestSource != null) {
             log.info("Using cached best source: {}", cachedBestSource.contains("github") ? SOURCE_GITHUB : SOURCE_GITEE);
             return cachedBestSource;
         }
 
-        log.info("Detecting best update source...");
+        log.info("Auto-detecting best update source...");
 
         // 并行测试两个源的连接速度
         CompletableFuture<Long> githubTest = CompletableFuture.supplyAsync(() -> testSourceSpeed(GITHUB_API_URL, SOURCE_GITHUB));

src/main/java/com/laker/postman/util/MessageKeys.java

@@ -764,6 +764,11 @@ private MessageKeys() {
     public static final String SETTINGS_AUTO_UPDATE_INTERVAL_TOOLTIP = "settings.auto_update.interval.tooltip";
     public static final String SETTINGS_AUTO_UPDATE_STARTUP_DELAY = "settings.auto_update.startup_delay";
     public static final String SETTINGS_AUTO_UPDATE_STARTUP_DELAY_TOOLTIP = "settings.auto_update.startup_delay.tooltip";
+    public static final String SETTINGS_UPDATE_SOURCE_PREFERENCE = "settings.update_source.preference";
+    public static final String SETTINGS_UPDATE_SOURCE_PREFERENCE_TOOLTIP = "settings.update_source.preference.tooltip";
+    public static final String SETTINGS_UPDATE_SOURCE_AUTO = "settings.update_source.auto";
+    public static final String SETTINGS_UPDATE_SOURCE_GITHUB = "settings.update_source.github";
+    public static final String SETTINGS_UPDATE_SOURCE_GITEE = "settings.update_source.gitee";
     public static final String SETTINGS_VALIDATION_AUTO_UPDATE_INTERVAL_ERROR = "settings.validation.auto_update_interval.error";
     public static final String SETTINGS_VALIDATION_AUTO_UPDATE_STARTUP_DELAY_ERROR = "settings.validation.auto_update_startup_delay.error";
 

src/main/resources/messages_en.properties

@@ -648,6 +648,11 @@ settings.auto_update.interval=Check Interval (hours):
 settings.auto_update.interval.tooltip=Time interval for automatic update checking, in hours
 settings.auto_update.startup_delay=Startup Delay (seconds):
 settings.auto_update.startup_delay.tooltip=How many seconds after application startup to begin checking for updates
+settings.update_source.preference=Update Source:
+settings.update_source.preference.tooltip=Choose the source for checking updates and downloading (Auto-detect, GitHub, or Gitee)
+settings.update_source.auto=Auto-detect (Recommended)
+settings.update_source.github=GitHub (International/VPN)
+settings.update_source.gitee=Gitee (China Mainland)
 settings.validation.auto_update_interval.error=Please enter a valid update check interval (integer greater than 0)
 settings.validation.auto_update_startup_delay.error=Please enter a valid startup delay time (integer greater than or equal to 0)
 settings.ui.title=UI Settings

src/main/resources/messages_zh.properties

@@ -649,6 +649,11 @@ settings.auto_update.interval=检查间隔(小时):
 settings.auto_update.interval.tooltip=自动检查更新的时间间隔，单位为小时
 settings.auto_update.startup_delay=启动延迟(秒):
 settings.auto_update.startup_delay.tooltip=应用启动后多少秒开始检查更新
+settings.update_source.preference=更新源:
+settings.update_source.preference.tooltip=选择检查更新和下载的来源（自动选择、GitHub 或 Gitee）
+settings.update_source.auto=自动选择（推荐）
+settings.update_source.github=GitHub（国外用户/VPN）
+settings.update_source.gitee=Gitee（国内用户）
 settings.validation.auto_update_interval.error=请输入有效的更新检查间隔时间（大于0的整数）
 settings.validation.auto_update_startup_delay.error=请输入有效的启动延迟时间（大于等于0的整数）
 settings.ui.title=界面设置