feat(doctor): enhance doctor check functionality with previews and update notes

Author: qianlifeng

wox.core/plugin/doctor.go

@@ -4,6 +4,7 @@ import (
 	"context"
 	"fmt"
 	"sort"
+	"wox/common"
 	"wox/i18n"
 	"wox/updater"
 	"wox/util"
@@ -24,6 +25,7 @@ type DoctorCheckResult struct {
 	Description string
 	ActionName  string
 	Action      func(ctx context.Context)
+	Preview     WoxPreview // Preview content for the check result
 }
 
 // RunDoctorChecks runs all doctor checks
@@ -45,56 +47,89 @@ func RunDoctorChecks(ctx context.Context) []DoctorCheckResult {
 }
 
 func checkWoxVersion(ctx context.Context) DoctorCheckResult {
-	updateStatus := updater.CheckUpdate(ctx)
-	if updateStatus.Status == updater.UpdateStatusError {
+	updateInfo := updater.GetUpdateInfo()
+	if updateInfo.Status == updater.UpdateStatusError {
 		return DoctorCheckResult{
 			Name:        "i18n:plugin_doctor_version",
 			Type:        DoctorCheckUpdate,
 			Passed:      false,
-			Description: updateStatus.UpdateError.Error(),
+			Description: updateInfo.UpdateError.Error(),
 			ActionName:  "",
 			Action: func(ctx context.Context) {
 			},
+			Preview: WoxPreview{
+				PreviewType:       WoxPreviewTypeText,
+				PreviewData:       updateInfo.UpdateError.Error(),
+				PreviewProperties: map[string]string{},
+				ScrollPosition:    WoxPreviewScrollPositionBottom,
+			},
 		}
 	}
 
-	if !updateStatus.HasUpdate {
+	if !updateInfo.HasUpdate {
 		return DoctorCheckResult{
 			Name:        "i18n:plugin_doctor_version",
 			Type:        DoctorCheckUpdate,
 			Passed:      true,
-			Description: fmt.Sprintf(i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_latest"), updateStatus.LatestVersion),
+			Description: fmt.Sprintf(i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_latest"), updateInfo.LatestVersion),
 			ActionName:  "",
 			Action: func(ctx context.Context) {
 			},
+			Preview: WoxPreview{
+				PreviewType:       WoxPreviewTypeText,
+				PreviewData:       fmt.Sprintf(i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_latest"), updateInfo.LatestVersion),
+				PreviewProperties: map[string]string{},
+				ScrollPosition:    WoxPreviewScrollPositionBottom,
+			},
 		}
 	} else {
 		actionName := "i18n:plugin_doctor_version_download"
-		if updateStatus.Status == updater.UpdateStatusReady {
+		if updateInfo.Status == updater.UpdateStatusReady {
 			actionName = "i18n:plugin_doctor_version_apply_update"
 		}
 
+		// Create preview with release notes
+		previewData := fmt.Sprintf("# %s\n\n%s",
+			i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_update_notes"),
+			updateInfo.ReleaseNotes)
+
+		if updateInfo.ReleaseNotes == "" {
+			previewData = i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_no_release_notes")
+		}
+
 		return DoctorCheckResult{
 			Name:        "i18n:plugin_doctor_version",
 			Type:        DoctorCheckUpdate,
 			Passed:      false,
-			Description: fmt.Sprintf(i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_update_available"), updateStatus.CurrentVersion, updateStatus.LatestVersion, updateStatus.Status),
+			Description: fmt.Sprintf(i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_version_update_available"), updateInfo.CurrentVersion, updateInfo.LatestVersion, updateInfo.Status),
 			ActionName:  actionName,
 			Action: func(ctx context.Context) {
 				updateStatus := updater.GetUpdateInfo()
 				if updateStatus.Status == updater.UpdateStatusReady {
 					updater.ApplyUpdate(ctx)
-				}
-				if updateStatus.Status == updater.UpdateStatusError {
-					updater.DownloadUpdate(ctx)
+				} else if updateStatus.Status == updater.UpdateStatusError {
+					GetPluginManager().GetUI().Notify(ctx, common.NotifyMsg{
+						Text:           updateStatus.UpdateError.Error(),
+						DisplaySeconds: 3,
+					})
 				}
 			},
+			Preview: WoxPreview{
+				PreviewType:       WoxPreviewTypeMarkdown,
+				PreviewData:       previewData,
+				PreviewProperties: map[string]string{},
+				ScrollPosition:    WoxPreviewScrollPositionBottom,
+			},
 		}
 	}
 }
 
 func checkAccessibilityPermission(ctx context.Context) DoctorCheckResult {
 	hasPermission := permission.HasAccessibilityPermission(ctx)
+
+	// Create preview with accessibility permission explanation
+	previewData := i18n.GetI18nManager().TranslateWox(ctx, "plugin_doctor_accessibility_explanation")
+
 	if !hasPermission {
 		return DoctorCheckResult{
 			Name:        "i18n:plugin_doctor_accessibility",
@@ -105,6 +140,12 @@ func checkAccessibilityPermission(ctx context.Context) DoctorCheckResult {
 			Action: func(ctx context.Context) {
 				permission.GrantAccessibilityPermission(ctx)
 			},
+			Preview: WoxPreview{
+				PreviewType:       WoxPreviewTypeMarkdown,
+				PreviewData:       previewData,
+				PreviewProperties: map[string]string{},
+				ScrollPosition:    WoxPreviewScrollPositionBottom,
+			},
 		}
 	}
 
@@ -116,5 +157,11 @@ func checkAccessibilityPermission(ctx context.Context) DoctorCheckResult {
 		ActionName:  "",
 		Action: func(ctx context.Context) {
 		},
+		Preview: WoxPreview{
+			PreviewType:       WoxPreviewTypeMarkdown,
+			PreviewData:       previewData,
+			PreviewProperties: map[string]string{},
+			ScrollPosition:    WoxPreviewScrollPositionBottom,
+		},
 	}
 }

wox.core/plugin/system/doctor.go

@@ -49,7 +49,7 @@ func (r *DoctorPlugin) Query(ctx context.Context, query plugin.Query) (results [
 			icon = plugin.CorrectIcon
 		}
 
-		results = append(results, plugin.QueryResult{
+		result := plugin.QueryResult{
 			Title:    check.Name,
 			SubTitle: check.Description,
 			Icon:     icon,
@@ -61,7 +61,12 @@ func (r *DoctorPlugin) Query(ctx context.Context, query plugin.Query) (results [
 					},
 				},
 			},
-		})
+		}
+
+		// Add preview
+		result.Preview = check.Preview
+
+		results = append(results, result)
 	}
 
 	return results

wox.core/resource/lang/en_US.json

@@ -224,10 +224,13 @@
   "plugin_doctor_version_update_available": "New version available, current: %s, latest: %s, status: %s",
   "plugin_doctor_version_download": "Go to download page",
   "plugin_doctor_version_apply_update": "Apply update",
+  "plugin_doctor_version_update_notes": "Update Notes",
+  "plugin_doctor_version_no_release_notes": "No release notes available for this update.",
   "plugin_doctor_accessibility": "Accessibility",
   "plugin_doctor_accessibility_required": "You need to grant Wox Accessibility permission to use this plugin",
   "plugin_doctor_accessibility_open_settings": "Open Accessibility Settings",
   "plugin_doctor_accessibility_granted": "You have granted Wox Accessibility permission",
+  "plugin_doctor_accessibility_explanation": "# Why Wox Needs Accessibility Permission\n\nWox requires accessibility permission to perform the following functions:\n\n- **Global Hotkeys**: Allow you to activate Wox from anywhere using keyboard shortcuts\n- **Window Management**: Get information about active windows to provide context-aware results\n- **Keyboard Simulation**: Enable features like pasting results directly into applications\n\nWithout this permission, some features of Wox will be limited or unavailable.",
   "plugin_query_history_use": "Use",
   "plugin_browser_open_tab": "Open",
   "plugin_browser_server_port": "Server Port",

wox.core/resource/lang/pt_BR.json

@@ -222,10 +222,13 @@
   "plugin_doctor_version_update_available": "Nova versão disponível, atual: %s, mais recente: %s, status: %s",
   "plugin_doctor_version_download": "Ir para a página de download",
   "plugin_doctor_version_apply_update": "Aplicar atualização",
+  "plugin_doctor_version_update_notes": "Notas da Atualização",
+  "plugin_doctor_version_no_release_notes": "Não há notas de lançamento disponíveis para esta atualização.",
   "plugin_doctor_accessibility": "Acessibilidade",
   "plugin_doctor_accessibility_required": "Você precisa conceder permissão de Acessibilidade ao Wox para usar este plugin",
   "plugin_doctor_accessibility_open_settings": "Abrir configurações de acessibilidade",
   "plugin_doctor_accessibility_granted": "Você concedeu permissão de Acessibilidade ao Wox",
+  "plugin_doctor_accessibility_explanation": "# Por que o Wox precisa de permissão de Acessibilidade\n\nO Wox requer permissão de acessibilidade para realizar as seguintes funções:\n\n- **Teclas de atalho globais**: Permite ativar o Wox de qualquer lugar usando atalhos de teclado\n- **Gerenciamento de janelas**: Obter informações sobre janelas ativas para fornecer resultados contextuais\n- **Simulação de teclado**: Habilitar recursos como colar resultados diretamente em aplicativos\n\nSem essa permissão, alguns recursos do Wox serão limitados ou indisponíveis.",
   "plugin_query_history_use": "Usar",
   "plugin_browser_open_tab": "Abrir",
   "plugin_browser_server_port": "Porta do servidor",

wox.core/resource/lang/ru_RU.json

@@ -222,10 +222,13 @@
   "plugin_doctor_version_update_available": "Доступна новая версия, текущая: %s, последняя: %s, статус: %s",
   "plugin_doctor_version_download": "Перейти на страницу загрузки",
   "plugin_doctor_version_apply_update": "Применить обновление",
+  "plugin_doctor_version_update_notes": "Примечания к обновлению",
+  "plugin_doctor_version_no_release_notes": "Для этого обновления нет доступных примечаний к выпуску.",
   "plugin_doctor_accessibility": "Доступность",
   "plugin_doctor_accessibility_required": "Вам нужно предоставить Wox разрешение на доступность для использования этого плагина",
   "plugin_doctor_accessibility_open_settings": "Открыть настройки доступности",
   "plugin_doctor_accessibility_granted": "Вы предоставили Wox разрешение на доступность",
+  "plugin_doctor_accessibility_explanation": "# Почему Wox нуждается в разрешении на доступность\n\nWox требует разрешение на доступность для выполнения следующих функций:\n\n- **Глобальные горячие клавиши**: Позволяют активировать Wox из любого места с помощью сочетаний клавиш\n- **Управление окнами**: Получение информации об активных окнах для предоставления контекстно-зависимых результатов\n- **Эмуляция клавиатуры**: Включение функций, таких как вставка результатов непосредственно в приложения\n\nБез этого разрешения некоторые функции Wox будут ограничены или недоступны.",
   "plugin_query_history_use": "Использовать",
   "plugin_browser_open_tab": "Открыть",
   "plugin_browser_server_port": "Порт сервера",

wox.core/resource/lang/zh_CN.json

@@ -221,10 +221,13 @@
   "plugin_doctor_version_update_available": "发现新版本，当前版：%s，最新版本：%s, 更新状态：%s",
   "plugin_doctor_version_download": "前往下载页面",
   "plugin_doctor_version_apply_update": "应用更新",
+  "plugin_doctor_version_update_notes": "更新说明",
+  "plugin_doctor_version_no_release_notes": "此更新没有提供更新说明。",
   "plugin_doctor_accessibility": "辅助功能",
   "plugin_doctor_accessibility_required": "您需要授予 Wox 辅助功能权限才能使用此插件",
   "plugin_doctor_accessibility_open_settings": "打开辅助功能设置",
   "plugin_doctor_accessibility_granted": "您已授予 Wox 辅助功能权限",
+  "plugin_doctor_accessibility_explanation": "# 为什么 Wox 需要辅助功能权限\n\nWox 需要辅助功能权限来执行以下功能：\n\n- **全局快捷键**：允许您通过键盘快捷键从任何地方激活 Wox\n- **窗口管理**：获取活动窗口的信息，以提供上下文相关的结果\n- **键盘模拟**：启用直接将结果粘贴到应用程序等功能\n\n如果没有此权限，Wox 的某些功能将受到限制或不可用。",
   "plugin_query_history_use": "使用",
   "plugin_url_open": "打开",
   "plugin_url_remove": "从历史记录中移除",