fix: 优化转换器下载源的默认设置，使用最快的下载源。并在设置界面添加一个选择最快源的按钮

Author: l0o0

addon/chrome/content/preferences-main.xhtml

@@ -132,6 +132,10 @@
         />
       </menupopup>
     </menulist>
+    <button
+      id="zotero-prefpane-__addonRef__-best-speed-button"
+      data-l10n-id="label-best-speed"
+    ></button>
     <image
       class="help-icon"
       src="chrome://jasminum/content/icons/help.svg"

addon/locale/en-US/addon.ftl

@@ -8,6 +8,8 @@ tabpanel-reader-tab-label = Reader Tab
 select-download-folder = Select download folder
 get-Chinese-styles = Get Chinese community styles…
 info-translators-cn-updaing = Chinese translators are under updating.
+info-best-speed-source-updated = Updated to fastest source: { $source }
+info-best-speed-source-failed = Failed to select fastest source, please check network connection
 
 
 # Preference translator table

addon/locale/en-US/preferences-main.ftl

@@ -39,8 +39,9 @@ namepattern-desc =
 # Transator Settings
 pref-group-translators = Chinese Translator Settings
 label-translator-source = Translator Download Source
+label-best-speed = Choose Fastest Source
 translatorSource-desc =
-  .tooltiptext = Select the translator download source. Generally, there is no need to switch. If you cannot download the Chinese translator, you can try other sources.
+  .tooltiptext = Select the translator download source. Generally, there is no need to switch. If you cannot download the Chinese translator, you can try other sources or click the "Choose Fastest Source" button.
 label-auto-update-translators =
   .label = Automatically Update Translators
 label-translators-force-update =

addon/locale/zh-CN/addon.ftl

@@ -9,6 +9,8 @@ tabpanel-reader-tab-label = 阅读器标签
 select-download-folder = 选择下载文件保存目录
 get-Chinese-styles = 获取中文社区样式…
 info-translators-cn-updaing = 中文转换器正在更新中
+info-best-speed-source-updated = 已更新为最快源：{ $source }
+info-best-speed-source-failed = 选择最快源失败，请检查网络连接
 
 # Preference translator table
 th-filename = 文件名

addon/locale/zh-CN/preferences-main.ftl

@@ -60,8 +60,9 @@ action-after-import-desc =
 # 转换器设置
 pref-group-translators = 中文转换器设置
 label-translator-source = 转换器下载源
+label-best-speed = 选择最快源
 translatorSource-desc =
-  .tooltiptext = 选择转换器下载源，一般情况下不用切换。如果您无法下载中文转换器，可选择尝试其他源。
+  .tooltiptext = 选择转换器下载源，一般情况下不用切换。如果您无法下载中文转换器，可选择尝试其他源或点击 选择最快源 按钮。
 label-auto-update-translators = 
   .label = 自动更新转换器
 label-translators-force-update = 

addon/locale/zh-TW/addon.ftl

@@ -9,6 +9,8 @@ tabpanel-reader-tab-label = 閱讀器標籤
 select-download-folder = 選擇下載檔案儲存目錄
 get-Chinese-styles = 取得中文社群樣式…
 info-translators-cn-updaing = 中文轉換器正在更新中
+info-best-speed-source-updated = 已更新為最快源：{ $source }
+info-best-speed-source-failed = 選擇最快源失敗，請檢查網路連接
 
 # Preference translator table
 th-filename = 檔案名稱

addon/locale/zh-TW/preferences-main.ftl

@@ -39,8 +39,9 @@ namepattern-desc =
 # 轉換器設定
 pref-group-translators = 中文轉換器設定
 label-translator-source = 轉換器下載源
+label-best-speed = 選擇最快源
 translatorSource-desc =
-  .tooltiptext = 選擇轉換器下載源，一般情況下不用切換。如果您無法下載中文轉換器，可選擇嘗試其他源。
+  .tooltiptext = 選擇轉換器下載源，一般情況下不用切換。如果您無法下載中文轉換器，可選擇嘗試其他源或點擊「選擇最快源」按鈕。
 label-auto-update-translators = 
   .label = 自動更新轉換器
 label-translators-force-update = 

src/modules/preferences/main.ts

@@ -2,7 +2,7 @@ import { config } from "../../../package.json";
 import { isMainlandChina } from "../../utils/http";
 import { getString } from "../../utils/locale";
 import { getPref, setPref } from "../../utils/prefs";
-import { updateTranslators, randomBaseUrl } from ".././translators";
+import { updateTranslators, bestSpeedBaseUrl } from ".././translators";
 import type { PluginPrefsMap } from "../../utils/prefs";
 import { onShowTable } from "./translators";
 
@@ -62,7 +62,7 @@ export async function initPrefs() {
   }
 
   if (!getPref("translatorSource")) {
-    setPref("translatorSource", randomBaseUrl());
+    setPref("translatorSource", await bestSpeedBaseUrl());
   }
 
   const translatortUpdateTime = getPref("translatorUpdateTime");
@@ -186,6 +186,29 @@ function bindPrefEvents(doc: Document) {
       onShowTable();
     });
 
+  doc
+    .getElementById(`zotero-prefpane-${config.addonRef}-best-speed-button`)
+    ?.addEventListener("click", async (event) => {
+      const button = event.target as HTMLButtonElement;
+      button.disabled = true;
+      try {
+        const bestUrl = await bestSpeedBaseUrl();
+        setPref("translatorSource", bestUrl);
+        addon.data.prefs?.window.alert(
+          getString("info-best-speed-source-updated", {
+            args: { source: bestUrl },
+          }),
+        );
+      } catch (error) {
+        ztoolkit.log(`select best speed source failed: ${error}`);
+        addon.data.prefs?.window.alert(
+          getString("info-best-speed-source-failed"),
+        );
+      } finally {
+        button.disabled = false;
+      }
+    });
+
   // metadata source dropdown
   // doc
   //   .querySelector(`#zotero-prefpane-${config.addonRef}-metadata-source-button`)

src/modules/translators.ts

@@ -1,15 +1,37 @@
 import { getString } from "../utils/locale";
 import { getPref, setPref } from "../utils/prefs";
 
-export function randomBaseUrl() {
+export async function bestSpeedBaseUrl() {
   const baseUrls = [
     "https://ftp.linxingzhong.top/translators_CN",
     "https://oss.wwang.de/translators_CN",
     "https://www.wieke.cn/translators_CN",
   ];
-  const baseUrl = baseUrls[Math.floor(Math.random() * baseUrls.length)];
-  ztoolkit.log(`use base url: ${baseUrl}`);
-  return baseUrl;
+
+  const testUrl = async (
+    url: string,
+  ): Promise<{ url: string; time: number }> => {
+    const startTime = Date.now();
+    try {
+      await Zotero.HTTP.request("HEAD", `${url}/data/translators.json`, {
+        timeout: 5000,
+      });
+      const time = Date.now() - startTime;
+      ztoolkit.log(`${url} response time: ${time}ms`);
+      return { url, time };
+    } catch (error) {
+      ztoolkit.log(`${url} request failed: ${error}`);
+      return { url, time: Infinity };
+    }
+  };
+
+  const results = await Promise.all(baseUrls.map(testUrl));
+  const fastest = results.reduce((prev, curr) =>
+    curr.time < prev.time ? curr : prev,
+  );
+
+  ztoolkit.log(`use fastest base url: ${fastest.url} (${fastest.time}ms)`);
+  return fastest.url;
 }
 
 /**

typings/i10n.d.ts

@@ -24,6 +24,8 @@ export type FluentMessageId =
   | 'how-to-update-translators'
   | 'import-attachments-success'
   | 'importing-attachments-is-running'
+  | 'info-best-speed-source-failed'
+  | 'info-best-speed-source-updated'
   | 'info-translators-cn-updaing'
   | 'item-section-example1-head-text'
   | 'item-section-example1-sidenav-tooltip'
@@ -33,6 +35,7 @@ export type FluentMessageId =
   | 'label-auto-split-name'
   | 'label-auto-update-translators'
   | 'label-autoupdate-metadata'
+  | 'label-best-speed'
   | 'label-choose-folder'
   | 'label-choose-namepattern'
   | 'label-choose-source'