feat: enhance tooltip descriptions for query hotkeys and add Wox Chrome extension link #4333

qianlifeng · qianlifeng · commit be50a34bca51 · 2026-02-10T13:20:02.000+08:00
diff --git a/wox.core/resource/lang/en_US.json b/wox.core/resource/lang/en_US.json
@@ -115,7 +115,7 @@
   "ui_query_hotkeys_hotkey": "Hotkey",
   "ui_query_hotkeys_hotkey_tooltip": "The hotkey to trigger the query.",
   "ui_query_hotkeys_query": "Query",
-  "ui_query_hotkeys_query_tooltip": "The query when the hotkey is triggered. Following variables are supported:\n\n{wox:selected_text} represent the selected text.\n{wox:active_browser_url} represent the url of active browser tab.\n{wox:file_explorer_path} represent the path of the currently open folder in the file explorer (if available).",
+  "ui_query_hotkeys_query_tooltip": "The query when the hotkey is triggered. Following variables are supported:\n\n - {wox:selected_text} represent the selected text.\n - {wox:active_browser_url} represent the url of active browser tab. To use this, you need to install the Wox Chrome extension [Install Wox Chrome extension](https://chromewebstore.google.com/detail/wox/bjbkdpjdnagiongdfemjhepkkglnailh)\n- {wox:file_explorer_path} represent the path of the currently open folder in the file explorer (if available).",
   "ui_query_hotkeys_silent": "Silent",
   "ui_query_hotkeys_silent_tooltip": "When selected, if the count of query result is 1, Wox will execute the query directly without showing the result list.\n\nThis is useful when you have a query that always return one result and you want to execute it directly.\nNote: This option is only available when the query result count is 1. Otherwise it will be ignored and notify a warning.",
   "ui_disabled": "Disabled",
@@ -865,4 +865,4 @@
   "ui_ai_chat_history_history": "History",
   "ui_ai_chat_failed_to_chat": "Failed to chat, please try again",
   "ui_ai_chat_error": "Error: %s"
-}
+}
diff --git a/wox.core/resource/lang/pt_BR.json b/wox.core/resource/lang/pt_BR.json
@@ -112,7 +112,7 @@
   "ui_query_hotkeys_hotkey": "Tecla de atalho",
   "ui_query_hotkeys_hotkey_tooltip": "A tecla de atalho para disparar a consulta.",
   "ui_query_hotkeys_query": "Consulta",
-  "ui_query_hotkeys_query_tooltip": "A consulta quando a tecla de atalho acionada. As seguintes variáveis são suportadas:\n\n{wox:selected_text} representa o texto selecionado.\n{wox:active_browser_url} representa o URL da guia do navegador ativo.\n{wox:file_explorer_path} representa o caminho da pasta atualmente aberta no explorador de arquivos (se disponível).",
+  "ui_query_hotkeys_query_tooltip": "A consulta quando a tecla de atalho acionada. As seguintes variáveis são suportadas:\n\n- {wox:selected_text} representa o texto selecionado.\n- {wox:active_browser_url} representa o URL da guia do navegador ativo. Para usar, instale a extensão Wox para Chrome: [Instalar extensão Wox para Chrome](https://chromewebstore.google.com/detail/wox/bjbkdpjdnagiongdfemjhepkkglnailh)\n- {wox:file_explorer_path} representa o caminho da pasta atualmente aberta no explorador de arquivos (se disponível).",
   "ui_query_hotkeys_silent": "Silencioso",
   "ui_query_hotkeys_silent_tooltip": "Quando selecionado, se o número de resultados da consulta for 1, o Wox executar a consulta diretamente sem mostrar a lista de resultados.\n\nIssotil quando você tem uma consulta que sempre retorna um resultado e deseja execut-la diretamente.\nNota: Esta opção s est disponível quando o número de resultados da consulta 1. Caso contrário, ser ignorado e notificar um aviso.",
   "ui_disabled": "Desativado",
@@ -852,4 +852,4 @@
   "ui_ai_chat_history_history": "Histórico",
   "ui_ai_chat_failed_to_chat": "Falha ao conversar, tente novamente",
   "ui_ai_chat_error": "Erro: %s"
-}
+}
diff --git a/wox.core/resource/lang/ru_RU.json b/wox.core/resource/lang/ru_RU.json
@@ -112,7 +112,7 @@
   "ui_query_hotkeys_hotkey": "Горячая клавиша",
   "ui_query_hotkeys_hotkey_tooltip": "Горячая клавиша для запроса",
   "ui_query_hotkeys_query": "Запрос",
-  "ui_query_hotkeys_query_tooltip": "Запрос при нажатии горячей клавиши. Поддерживаются следующие переменные:\n\n{wox:selected_text} представляет выделенный текст.\n{wox:active_browser_url} представляет URL активной вкладки браузера.\n{wox:file_explorer_path} представляет путь к текущей открытой папке в проводнике (если доступно).",
+  "ui_query_hotkeys_query_tooltip": "Запрос при нажатии горячей клавиши. Поддерживаются следующие переменные:\n\n- {wox:selected_text} представляет выделенный текст.\n- {wox:active_browser_url} представляет URL активной вкладки браузера. Чтобы использовать, установите расширение Wox для Chrome: [Установить расширение Wox для Chrome](https://chromewebstore.google.com/detail/wox/bjbkdpjdnagiongdfemjhepkkglnailh)\n- {wox:file_explorer_path} представляет путь к текущей открытой папке в проводнике (если доступно).",
   "ui_query_hotkeys_silent": "Сильный",
   "ui_query_hotkeys_silent_tooltip": "Если выбран, и количество результатов запроса равно 1, Wox выполнит запрос непосредственно без отображения списка результатов.\n\nЭто полезно, когда у вас есть запрос, который всегда возвращает один результат, и вы хотите выполнить его непосредственно.\nПримечание: Эта опция доступна только в том случае, если количество результатов запроса равно 1. В противном случае она будет проигнорирована и будет выведено предупреждение.",
   "ui_disabled": "Отключено",
@@ -853,4 +853,4 @@
   "ui_ai_chat_history_history": "История",
   "ui_ai_chat_failed_to_chat": "Не удалось отправить сообщение, попробуйте еще раз",
   "ui_ai_chat_error": "Ошибка: %s"
-}
+}
diff --git a/wox.core/resource/lang/zh_CN.json b/wox.core/resource/lang/zh_CN.json
@@ -115,7 +115,7 @@
   "ui_query_hotkeys_hotkey": "快捷键",
   "ui_query_hotkeys_hotkey_tooltip": "用于触发查询的快捷键",
   "ui_query_hotkeys_query": "查询",
-  "ui_query_hotkeys_query_tooltip": "当快捷键被触发时，查询的内容。支持以下变量：\n\n{wox:selected_text} 代表选中的文本\n{wox:active_browser_url} 代表活动的浏览器标签页的URL\n{wox:file_explorer_path} 代表当前文件管理器中打开的文件夹路径（如果有）",
+  "ui_query_hotkeys_query_tooltip": "当快捷键被触发时，查询的内容。支持以下变量：\n\n- {wox:selected_text} 代表选中的文本\n- {wox:active_browser_url} 代表活动的浏览器标签页的URL。请安装 Wox Chrome 扩展来使用这个变量：[安装 Wox Chrome 扩展](https://chromewebstore.google.com/detail/wox/bjbkdpjdnagiongdfemjhepkkglnailh)\n- {wox:file_explorer_path} 代表当前文件管理器中打开的文件夹路径（如果有）",
   "ui_query_hotkeys_silent": "静默",
   "ui_query_hotkeys_silent_tooltip": "当选中时，如果查询结果数量为1，Wox将直接执行查询而不显示结果列表。\n\n这在您有一个总是返回一个结果的查询并且您希望直接执行它时非常有用。\n注意：此选项仅在查询结果数量为1时可用。否则将忽略并通知警告。",
   "ui_disabled": "禁用",
@@ -865,4 +865,4 @@
   "ui_ai_chat_history_history": "历史",
   "ui_ai_chat_failed_to_chat": "对话失败,请重试",
   "ui_ai_chat_error": "错误：%s"
-}
+}
diff --git a/wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_table_update_view.dart b/wox.ui.flutter/wox/lib/components/plugin/wox_setting_plugin_table_update_view.dart
@@ -14,6 +14,7 @@ import 'package:wox/components/wox_image_view.dart';
 import 'package:wox/components/wox_textfield.dart';
 import 'package:wox/components/wox_checkbox.dart';
 import 'package:wox/components/wox_checkbox_tile.dart';
+import 'package:wox/components/wox_markdown.dart';
 import 'package:wox/components/wox_path_finder.dart';
 import 'package:wox/controllers/wox_setting_controller.dart';
 import 'package:wox/entity/setting/wox_plugin_setting_table.dart';
@@ -683,7 +684,14 @@ class _WoxSettingPluginTableUpdateState extends State<WoxSettingPluginTableUpdat
                               if (column.tooltip != "")
                                 Padding(
                                   padding: EdgeInsets.only(top: 4, left: maxLabelWidth + 10),
-                                  child: Text(tr(column.tooltip), style: TextStyle(color: textColor.withOpacity(0.6), fontSize: 12)),
+                                  child: WoxMarkdownView(
+                                    data: tr(column.tooltip),
+                                    fontColor: textColor.withOpacity(0.6),
+                                    fontSize: 12,
+                                    linkColor: accentColor,
+                                    linkHoverColor: accentColor.withOpacity(0.8),
+                                    selectable: true,
+                                  ),
                                 ),
                             ],
                           ),
diff --git a/wox.ui.flutter/wox/lib/components/wox_markdown.dart b/wox.ui.flutter/wox/lib/components/wox_markdown.dart
@@ -5,22 +5,30 @@ import 'package:gpt_markdown/custom_widgets/custom_error_image.dart';
 import 'package:gpt_markdown/custom_widgets/markdown_config.dart';
 import 'package:gpt_markdown/custom_widgets/unordered_ordered_list.dart';
 import 'package:gpt_markdown/gpt_markdown.dart';
+import 'package:url_launcher/url_launcher.dart';
 import 'package:wox/utils/colors.dart';
 
 class WoxMarkdownView extends StatelessWidget {
   final String data;
   final Color fontColor;
+  final double fontSize;
+  final Color? linkColor;
+  final Color? linkHoverColor;
+  final bool selectable;
 
-  const WoxMarkdownView({super.key, required this.fontColor, required this.data});
+  const WoxMarkdownView({super.key, required this.fontColor, required this.data, this.fontSize = 14, this.linkColor, this.linkHoverColor, this.selectable = true});
 
   @override
   Widget build(BuildContext context) {
-    const baseTextStyle = TextStyle(fontSize: 14);
+    final baseTextStyle = TextStyle(fontSize: fontSize);
     final fontTextStyle = baseTextStyle.copyWith(color: fontColor);
     final bool isDarkFont = fontColor.computeLuminance() < 0.5;
     final codeBackgroundColor = isDarkFont ? Colors.black.withValues(alpha: 0.06) : Colors.white.withValues(alpha: 0.08);
     final codeTextStyle = fontTextStyle.copyWith(fontSize: 13, color: fontColor);
     final dividerColor = getThemeDividerColor();
+    final effectiveLinkColor = linkColor ?? fontColor;
+    final effectiveLinkHoverColor = linkHoverColor ?? fontColor.withValues(alpha: 0.85);
+
     final themeData = GptMarkdownThemeData(
       brightness: isDarkFont ? Brightness.light : Brightness.dark,
       highlightColor: codeBackgroundColor,
@@ -32,68 +40,75 @@ class WoxMarkdownView extends StatelessWidget {
       h6: baseTextStyle,
       hrLineThickness: 1.5,
       hrLineColor: dividerColor,
-      linkColor: fontColor,
-      linkHoverColor: fontColor.withValues(alpha: 0.85),
+      linkColor: effectiveLinkColor,
+      linkHoverColor: effectiveLinkHoverColor,
     );
 
     final normalizedData = normalizeMarkdownImages(data);
 
-    return DefaultTextStyle.merge(
-      style: fontTextStyle,
-      child: SelectionArea(
-        child: GptMarkdownTheme(
-          gptThemeData: themeData,
-          child: GptMarkdown(
-            normalizedData,
-            style: baseTextStyle,
-            textDirection: Directionality.of(context),
-            imageBuilder: (context, url) => buildImage(context, url),
-            inlineComponents: [
-              ATagMd(),
-              WoxImageMd(),
-              TableMd(),
-              StrikeMd(),
-              BoldMd(),
-              ItalicMd(),
-              UnderLineMd(),
-              LatexMath(),
-              LatexMathMultiLine(),
-              HighlightedText(),
-              SourceTag(),
-            ],
-            unOrderedListBuilder: (context, child, config) {
-              final itemText = child is MdWidget ? child.exp.trimLeft() : '';
-              if (RegExp(r'^\[(?:x|X| )\]\s+').hasMatch(itemText)) {
-                return UnorderedListView(padding: 0, spacing: 0, bulletSize: 0, textDirection: config.textDirection, child: child);
-              }
-              final bulletColor = config.style?.color ?? DefaultTextStyle.of(context).style.color;
-              final fontSize = config.style?.fontSize ?? DefaultTextStyle.of(context).style.fontSize ?? 14;
-              return UnorderedListView(bulletColor: bulletColor, padding: 7, spacing: 10, bulletSize: 0.3 * fontSize, textDirection: config.textDirection, child: child);
-            },
-            codeBuilder: (context, name, code, closed) {
-              final trimmedName = name.trim();
-              final borderRadius = BorderRadius.circular(closed ? 4 : 0);
-              return Container(
-                margin: const EdgeInsets.symmetric(vertical: 6),
-                decoration: BoxDecoration(color: codeBackgroundColor, borderRadius: borderRadius),
-                child: Column(
-                  crossAxisAlignment: CrossAxisAlignment.stretch,
-                  children: [
-                    if (trimmedName.isNotEmpty)
-                      Padding(
-                        padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 6),
-                        child: Text(trimmedName, style: codeTextStyle.copyWith(fontSize: 12, fontWeight: FontWeight.w600)),
-                      ),
-                    if (trimmedName.isNotEmpty) Divider(height: 1, color: dividerColor.withValues(alpha: 0.4)),
-                    SingleChildScrollView(scrollDirection: Axis.horizontal, padding: const EdgeInsets.all(8), child: Text(code, style: codeTextStyle)),
-                  ],
-                ),
-              );
-            },
-          ),
-        ),
+    final markdownBody = GptMarkdownTheme(
+      gptThemeData: themeData,
+      child: GptMarkdown(
+        normalizedData,
+        style: baseTextStyle,
+        textDirection: Directionality.of(context),
+        linkBuilder: (context, text, url, style) {
+          TextSpan? span;
+          if (text is TextSpan) {
+            span = TextSpan(
+              text: text.text,
+              children: text.children,
+              style: (text.style ?? style).copyWith(decoration: TextDecoration.underline, decorationColor: (text.style?.color ?? style.color)),
+            );
+          }
+          final linkText = Text.rich(span ?? text, style: style);
+          final linkWidget = MouseRegion(cursor: SystemMouseCursors.click, child: linkText);
+          if (!selectable) {
+            return linkWidget;
+          }
+          return SelectionContainer.disabled(child: linkWidget);
+        },
+        onLinkTap: (String url, String title) {
+          final uri = Uri.tryParse(url);
+          if (uri != null) {
+            launchUrl(uri);
+          }
+        },
+        imageBuilder: (context, url) => buildImage(context, url),
+        inlineComponents: [ATagMd(), WoxImageMd(), TableMd(), StrikeMd(), BoldMd(), ItalicMd(), UnderLineMd(), LatexMath(), LatexMathMultiLine(), HighlightedText(), SourceTag()],
+        unOrderedListBuilder: (context, child, config) {
+          final itemText = child is MdWidget ? child.exp.trimLeft() : '';
+          if (RegExp(r'^\[(?:x|X| )\]\s+').hasMatch(itemText)) {
+            return UnorderedListView(padding: 0, spacing: 0, bulletSize: 0, textDirection: config.textDirection, child: child);
+          }
+          final bulletColor = config.style?.color ?? DefaultTextStyle.of(context).style.color;
+          final fontSize = config.style?.fontSize ?? DefaultTextStyle.of(context).style.fontSize ?? 14;
+          return UnorderedListView(bulletColor: bulletColor, padding: 7, spacing: 10, bulletSize: 0.3 * fontSize, textDirection: config.textDirection, child: child);
+        },
+        codeBuilder: (context, name, code, closed) {
+          final trimmedName = name.trim();
+          final borderRadius = BorderRadius.circular(closed ? 4 : 0);
+          return Container(
+            margin: const EdgeInsets.symmetric(vertical: 6),
+            decoration: BoxDecoration(color: codeBackgroundColor, borderRadius: borderRadius),
+            child: Column(
+              crossAxisAlignment: CrossAxisAlignment.stretch,
+              children: [
+                if (trimmedName.isNotEmpty)
+                  Padding(
+                    padding: const EdgeInsets.symmetric(horizontal: 8, vertical: 6),
+                    child: Text(trimmedName, style: codeTextStyle.copyWith(fontSize: 12, fontWeight: FontWeight.w600)),
+                  ),
+                if (trimmedName.isNotEmpty) Divider(height: 1, color: dividerColor.withValues(alpha: 0.4)),
+                SingleChildScrollView(scrollDirection: Axis.horizontal, padding: const EdgeInsets.all(8), child: Text(code, style: codeTextStyle)),
+              ],
+            ),
+          );
+        },
       ),
     );
+
+    return DefaultTextStyle.merge(style: fontTextStyle, child: selectable ? SelectionArea(child: markdownBody) : markdownBody);
   }
 
   String normalizeMarkdownImages(String input) {
diff --git a/wox.ui.flutter/wox/lib/modules/setting/views/wox_setting_general_view.dart b/wox.ui.flutter/wox/lib/modules/setting/views/wox_setting_general_view.dart
@@ -227,7 +227,7 @@ class WoxSettingGeneralView extends WoxSettingBaseView {
                       ],
                     },
                     {"Key": "IsSilentExecution", "Label": "i18n:ui_query_hotkeys_silent", "Tooltip": "i18n:ui_query_hotkeys_silent_tooltip", "Width": 40, "Type": "checkbox"},
-                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 50, "Type": "checkbox"},
+                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 60, "Type": "checkbox"},
                   ],
                   "SortColumnKey": "Query",
                 }),
@@ -267,7 +267,7 @@ class WoxSettingGeneralView extends WoxSettingBaseView {
                         {"Type": "not_empty"},
                       ],
                     },
-                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 50, "Type": "checkbox"},
+                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 60, "Type": "checkbox"},
                   ],
                   "SortColumnKey": "Query",
                 }),
@@ -298,7 +298,7 @@ class WoxSettingGeneralView extends WoxSettingBaseView {
                       ],
                     },
                     {"Key": "Width", "Label": "i18n:ui_tray_queries_width", "Tooltip": "i18n:ui_tray_queries_width_tooltip", "Type": "text", "Width": 90, "TextMaxLines": 1},
-                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 50, "Type": "checkbox"},
+                    {"Key": "Disabled", "Label": "i18n:ui_disabled", "Tooltip": "i18n:ui_disabled_tooltip", "Width": 60, "Type": "checkbox"},
                   ],
                   "SortColumnKey": "",
                 }),
diff --git a/wox.ui.flutter/wox/macos/Podfile.lock b/wox.ui.flutter/wox/macos/Podfile.lock
