release: v0.3.2

Author: so

README.md

@@ -183,7 +183,7 @@
 - OpenList 批量移动超时时会刷新源/目标目录做二次核验，实际已完成的文件会补成功日志。
 - 任务完成、部分失败、失败或中止后，会复用通知配置发送媒体刮削任务结果。
 
-TMDb API 服务器默认为 `https://api.themoviedb.org`，可选择备用的 `https://api.tmdb.org`，也可输入自定义 HTTP/HTTPS 地址。如果所在网络需要代理，可在 `系统设置 -> 代理服务器` 中填写 `http://host:port` 或 `socks://host:port`；也支持 `user:password` 认证以及 `:password` 形式的仅密码认证。SOCKS5 仅密码认证使用零长度用户名兼容形式，需要代理服务器支持。代理地址保存后默认隐藏认证信息，点击输入框右侧的显示按钮可按需查看完整连接串。代理设置页可使用固定地址 `http://www.google.com/generate_204` 测试代理延迟，当前代理用于后端 TMDb API 请求。
+TMDb API 服务器默认为 `https://api.themoviedb.org`，可选择备用的 `https://api.tmdb.org`，也可输入自定义 HTTP/HTTPS 地址。如果所在网络需要代理，可在 `系统设置 -> 代理服务器` 中填写 `http://host:port` 或 `socks://host:port`；也支持 `user:password` 认证以及 `:password` 形式的仅密码认证。SOCKS5 仅密码认证使用零长度用户名兼容形式，需要代理服务器支持。代理地址保存后默认隐藏认证信息，点击输入框右侧的显示按钮可按需查看完整连接串。代理设置页可使用固定地址 `http://www.google.com/generate_204` 测试延迟；未填写代理地址时会直接连接，当前代理用于后端 TMDb API 请求。
 
 ## 使用方法
 

buildozer.spec

@@ -9,7 +9,7 @@ source.include_exts = py,png,jpg,jpeg,html,js,css,ttf,otf,svg,ico,json,gif,woff,
 source.include_patterns = front/**,locales/**,common/**,controller/**,mapper/**,media_tools/**,service/**,doc/config.ini
 source.exclude_patterns = .git/**,.venv/**,data/**,tests/**,web/**
 
-version = 0.3.1
+version = 0.3.2
 
 requirements = python3,pyjnius,android,tornado,requests,pysocks,urllib3,certifi,chardet,idna,apscheduler,tzlocal,tzdata,setuptools,configparser,pathspec,pyyaml,openssl,sqlite3
 

doc/changelog/v0.3.2.md

@@ -0,0 +1,12 @@
+# v0.3.2（2026-08-01）
+
+变更概述
+
+- 代理服务器：延迟测试允许未填写代理地址时直接连接固定 Google 204 地址；已填写地址时仍使用该代理测试。
+- 代理服务器：移除清除已保存认证信息的按钮、文案和后端处理，保留完整连接串显示、地址修改和认证信息保护。
+- 文档：更新代理延迟测试的直连行为说明。
+
+验证说明
+
+- 已使用源码模式完成 Python 语法、后端单元测试、前端单元测试、ESLint、Vue dev server 和本地服务连通性验证。
+- 未在本地执行前端生产构建、Docker 构建、PyInstaller、StaticX、Android APK 或发布包构建。

service/system/configService.py

@@ -179,14 +179,6 @@ def _safe_proxy_url(url):
     ))
 
 
-def _strip_proxy_credentials(url):
-    if not url:
-        return ''
-    parts = urllib.parse.urlsplit(url)
-    host_port = parts.netloc.rsplit('@', 1)[-1]
-    return urllib.parse.urlunsplit((parts.scheme, host_port, '', '', ''))
-
-
 def _public_proxy_server(proxy):
     url = proxy.get('url') or ''
     parts = urllib.parse.urlsplit(url)
@@ -210,19 +202,13 @@ def _proxy_url_for_test(req):
     if 'url' in req:
         submitted_url = _normalize_proxy_url(req.get('url'))
 
-    if _to_bool(req.get('clearCredentials'), False):
-        proxy_url = _strip_proxy_credentials(
-            current_url if submitted_url is None else submitted_url
-        )
-    elif submitted_url is None:
+    if submitted_url is None:
         proxy_url = current_url
     elif submitted_url == _safe_proxy_url(current_url):
         proxy_url = current_url
     else:
         proxy_url = submitted_url
 
-    if not proxy_url:
-        raise Exception('Proxy server URL is required for latency test')
     return proxy_url
 
 
@@ -304,9 +290,6 @@ def updateConfig(req):
                     else submitted_url
                 )
                 update_proxy = True
-            if _to_bool(update.get('clearCredentials'), False):
-                proxy_url_to_save = _strip_proxy_credentials(proxy_url_to_save)
-                update_proxy = True
             if 'enabled' in update:
                 update_proxy = True
             if proxy_enabled and not proxy_url_to_save:

tests/test_backend_v040.py

@@ -430,7 +430,7 @@ def set_value(key, value):
                 side_effect=lambda key: store.get(key)), mock.patch.object(
                 configService.systemConfigMapper,
                 'setConfigValue',
-                side_effect=set_value) as set_mock:
+                side_effect=set_value):
             result = configService.getConfig()
             self.assertEqual({
                 'enabled': True,
@@ -460,15 +460,6 @@ def set_value(key, value):
             self.assertEqual('*.nfo:@eaDir', result['globalExclude'])
             self.assertEqual(previous_proxy, store[configService.PROXY_SERVER_KEY])
 
-            result = configService.updateConfig({
-                'proxyServer': {'clearCredentials': True},
-            })
-            saved_proxy = json.loads(store[configService.PROXY_SERVER_KEY])
-            self.assertEqual('http://old-proxy.local:8080', saved_proxy['url'])
-            self.assertFalse(result['proxyServer']['passwordSet'])
-            self.assertNotIn('password', result['proxyServer'])
-            self.assertGreaterEqual(set_mock.call_count, 3)
-
     def test_system_config_accepts_proxy_url_auth_variants_and_new_key_wins(self):
         cases = [
             ('http://proxy.local:8080', 'http://proxy.local:8080', False),
@@ -706,6 +697,38 @@ def test_proxy_latency_test_uses_submitted_url_without_persisting(self):
         response.close.assert_called_once_with()
         session.close.assert_called_once_with()
 
+    def test_proxy_latency_test_uses_direct_connection_without_proxy_url(self):
+        response = mock.Mock(status_code=204)
+        session = mock.Mock()
+        session.get.return_value = response
+
+        with mock.patch.object(
+                configService,
+                'getProxyServer',
+                return_value={'enabled': False, 'url': ''}), mock.patch.object(
+                configService.mediaRenamer.requests,
+                'Session',
+                return_value=session), mock.patch.object(
+                configService.time,
+                'monotonic',
+                side_effect=[10.0, 10.123]):
+            result = configService.testProxyServer({})
+
+        self.assertEqual({
+            'url': configService.PROXY_TEST_URL,
+            'latencyMs': 123,
+            'statusCode': 204,
+        }, result)
+        self.assertFalse(session.trust_env)
+        session.get.assert_called_once_with(
+            configService.PROXY_TEST_URL,
+            timeout=configService.PROXY_TEST_TIMEOUT,
+            proxies={},
+            allow_redirects=False,
+        )
+        response.close.assert_called_once_with()
+        session.close.assert_called_once_with()
+
     def test_proxy_latency_test_preserves_saved_credentials_for_redacted_url(self):
         response = mock.Mock(status_code=204)
         session = mock.Mock()

version.txt

@@ -1,4 +1,4 @@
-v0.3.1,latest
+v0.3.2,latest
 
 该文件仅第一行有效，表示打包的版本。
 如果要打包多个，以英文,分隔，例如【v1.0.0,latest】；

web/src/locales/en.yaml

@@ -484,14 +484,10 @@ setting:
   proxyUrlExamples: "Supports http://host:port, http://user:password{'@'}host:port, and socks://:password{'@'}host:port; percent-encode special characters"
   proxyCredentialsStored: Credentials are saved and remain unchanged while the URL is unchanged
   proxyCredentialsReplace: Re-enter the complete credentials when changing the URL
-  proxyClearCredentials: Clear saved credentials
-  proxyCancelClearCredentials: Cancel clearing credentials
-  proxyCredentialsWillClear: The username and password will be cleared when you save
   proxyShowCredentials: Show complete connection string
   proxyHideCredentials: Hide complete connection string
   proxyTest: Test Latency
   proxyTestTarget: "Test URL: http://www.google.com/generate_204"
-  proxyTestUrlRequired: Enter a proxy URL before testing
   proxyTestResult: "{latency} ms · HTTP {status}"
   saveProxy: Save Proxy Settings
   aboutDescription: A focused workspace for directory sync and media naming

web/src/locales/zh-CN.yaml

@@ -484,14 +484,10 @@ setting:
   proxyUrlExamples: "支持 http://host:port、http://user:password{'@'}host:port、socks://:password{'@'}host:port；特殊字符请使用 URL 编码"
   proxyCredentialsStored: 已保存认证信息；地址未修改时将保持不变
   proxyCredentialsReplace: 修改地址时请重新填写完整认证信息
-  proxyClearCredentials: 清除已保存的认证信息
-  proxyCancelClearCredentials: 取消清除认证信息
-  proxyCredentialsWillClear: 保存后将清除用户名和密码
   proxyShowCredentials: 显示完整连接串
   proxyHideCredentials: 隐藏完整连接串
   proxyTest: 测试延迟
   proxyTestTarget: "测试地址：http://www.google.com/generate_204"
-  proxyTestUrlRequired: 测试前请输入代理地址
   proxyTestResult: "{latency} ms · HTTP {status}"
   saveProxy: 保存代理设置
   aboutDescription: 一个专注于目录同步与媒体命名的轻量工作台

web/src/views/pages/setting/ProxyServerSettings.vue

@@ -3,7 +3,7 @@ import { computed, onMounted, ref } from "vue";
 import { getSystemConfig, revealProxyServer, saveSystemConfig, testProxyServer } from "@/api/system";
 import { ElMessage } from "element-plus";
 import { useI18n } from "vue-i18n";
-import { Eye, EyeOff, Gauge, LoaderCircle, Network, Save, Trash2, Undo2 } from "@lucide/vue";
+import { Eye, EyeOff, Gauge, LoaderCircle, Network, Save } from "@lucide/vue";
 
 const { t } = useI18n();
 const formRef = ref();
@@ -20,7 +20,6 @@ const proxy = ref({
   enabled: false,
   url: "",
   passwordSet: false,
-  clearCredentials: false,
 });
 
 const urlChanged = computed(() => proxy.value.url.trim() !== initialUrl.value);
@@ -31,7 +30,6 @@ const applyConfig = (config = {}) => {
     enabled: Boolean(value.enabled),
     url: String(value.url || ""),
     passwordSet: Boolean(value.passwordSet),
-    clearCredentials: false,
   };
   initialUrl.value = proxy.value.url;
   credentialsVisible.value = false;
@@ -76,12 +74,6 @@ const loadConfig = () => {
 };
 
 const onUrlInput = () => {
-  proxy.value.clearCredentials = false;
-  testResult.value = null;
-};
-
-const toggleClearCredentials = () => {
-  proxy.value.clearCredentials = !proxy.value.clearCredentials;
   testResult.value = null;
 };
 
@@ -117,20 +109,12 @@ const buildProxyTestPayload = () => {
   if (urlChanged.value) {
     payload.url = proxy.value.url.trim();
   }
-  if (proxy.value.clearCredentials) {
-    payload.clearCredentials = true;
-  }
   return payload;
 };
 
 const runProxyTest = () => {
   formRef.value.validate((valid) => {
     if (!valid) return;
-    if (!proxy.value.url.trim()) {
-      ElMessage({ message: t("setting.proxyTestUrlRequired"), type: "warning" });
-      return;
-    }
-
     testing.value = true;
     testResult.value = null;
     testProxyServer(buildProxyTestPayload())
@@ -152,9 +136,6 @@ const saveConfig = () => {
     if (urlChanged.value) {
       proxyServer.url = proxy.value.url.trim();
     }
-    if (proxy.value.clearCredentials) {
-      proxyServer.clearCredentials = true;
-    }
 
     saving.value = true;
     testResult.value = null;
@@ -224,24 +205,9 @@ onMounted(loadConfig);
                 </button>
               </template>
             </el-input>
-            <el-tooltip
-              v-if="proxy.passwordSet && !urlChanged"
-              :content="proxy.clearCredentials ? $t('setting.proxyCancelClearCredentials') : $t('setting.proxyClearCredentials')"
-              placement="top"
-            >
-              <el-button
-                class="credential-button"
-                :type="proxy.clearCredentials ? 'default' : 'danger'"
-                :icon="proxy.clearCredentials ? Undo2 : Trash2"
-                :disabled="revealing"
-                :aria-label="proxy.clearCredentials ? $t('setting.proxyCancelClearCredentials') : $t('setting.proxyClearCredentials')"
-                @click="toggleClearCredentials"
-              />
-            </el-tooltip>
           </div>
           <p class="field-tip">{{ $t("setting.proxyUrlExamples") }}</p>
-          <p v-if="proxy.clearCredentials" class="credential-warning">{{ $t("setting.proxyCredentialsWillClear") }}</p>
-          <p v-else-if="proxy.passwordSet && !urlChanged" class="credential-status">{{ $t("setting.proxyCredentialsStored") }}</p>
+          <p v-if="proxy.passwordSet && !urlChanged" class="credential-status">{{ $t("setting.proxyCredentialsStored") }}</p>
           <p v-else-if="proxy.passwordSet && urlChanged" class="credential-warning">{{ $t("setting.proxyCredentialsReplace") }}</p>
         </el-form-item>
 
@@ -383,14 +349,6 @@ onMounted(loadConfig);
   }
 }
 
-.credential-button {
-  width: 42px;
-  height: 42px;
-  flex: 0 0 42px;
-  margin: 0;
-  padding: 0;
-}
-
 .reveal-button {
   width: 28px;
   height: 28px;