首页
/ EverythingToolbar插件开发指南：从架构设计到功能落地

EverythingToolbar插件开发指南：从架构设计到功能落地

2026-04-07 11:07:05作者：庞眉杨Will
EverythingToolbar
Everything integration for the Windows taskbar.
项目地址：https://gitcode.com/gh_mirrors/eve/EverythingToolbar

探索高效文件搜索扩展能力的实现路径

EverythingToolbar作为一款Windows任务栏集成的文件搜索工具，通过插件化架构设计提供了强大的扩展能力。本文将系统讲解其插件开发的全流程，从核心原理到实战开发，再到场景化应用，帮助开发者快速掌握插件开发技术，打造个性化的搜索体验。

一、核心原理：插件系统架构解析

EverythingToolbar的插件系统采用分层架构设计，通过清晰的接口定义和灵活的扩展机制，使开发者能够方便地扩展搜索功能、添加自定义过滤器和实现特定的文件操作逻辑。

1.1 插件架构概览

EverythingToolbar插件系统采用四层架构设计，各层职责明确且相互协作：

graph TD
    A[核心接口层] -->|定义交互规范| B[服务提供层]
    B -->|提供基础能力| C[插件实现层]
    C -->|管理生命周期| D[配置管理层]
    
    A --> A1[搜索提供者接口]
    A --> A2[过滤器提供者接口]
    A --> A3[结果处理器接口]
    
    B --> B1[Everything SDK]
    B --> B2[Windows Shell API]
    B --> B3[WPF UI框架]
    
    C --> C1[搜索插件]
    C --> C2[过滤器插件]
    C --> C3[结果处理插件]
    
    D --> D1[插件注册]
    D --> D2[配置存储]
    D --> D3[用户设置]

核心接口层定义了插件与主程序交互的标准，确保不同插件能够统一地与主程序通信；服务提供层提供基础能力支持，如Everything搜索功能、Windows系统集成等；插件实现层是开发者实际编写代码的地方，实现具体的插件功能；配置管理层负责插件的注册、配置存储和用户设置管理。

1.2 插件生命周期

插件从加载到卸载的完整生命周期如下：

sequenceDiagram
    participant 主程序
    participant 插件管理器
    participant 插件实例
    
    主程序->>插件管理器: 初始化插件系统
    插件管理器->>插件管理器: 扫描插件目录
    插件管理器->>插件实例: 加载插件程序集
    插件实例->>插件管理器: 实现核心接口
    插件管理器->>主程序: 注册可用插件
    主程序->>插件实例: 调用Initialize()
    插件实例->>主程序: 初始化完成
    loop 插件运行中
        主程序->>插件实例: 触发事件/调用方法
        插件实例->>主程序: 返回结果/触发回调
    end
    主程序->>插件实例: 调用Dispose()
    插件实例->>主程序: 资源释放完成
    插件管理器->>插件实例: 卸载插件

插件的生命周期包括加载、初始化、运行和卸载四个阶段。在初始化阶段，插件需要完成必要的资源分配和配置加载；运行阶段则响应主程序的事件和方法调用；卸载阶段需要释放所有占用的资源，确保系统稳定性。

1.3 核心能力接口速查表

接口名称 主要方法 功能描述 应用场景
ISearchProvider QueryAsync()
CancelSearch()		 处理搜索请求和结果返回 实现自定义搜索逻辑，如网络搜索、数据库查询
GetStatistics() 获取搜索统计信息 性能监控、使用分析
SearchStarted事件
ResultsUpdated事件		 通知搜索状态变化 实时更新UI、进度显示
IFilterProvider GetAllFilters()
AddFilter()		 管理搜索过滤器 自定义文件类型过滤、高级搜索条件
GetDefaultFilter()
FindFilter()		 获取和查找过滤器 快速切换常用过滤条件
IResultHandler OpenItem()
OpenContainingFolder()		 处理搜索结果操作 自定义文件打开方式、集成第三方程序
CopyPathToClipboard()
ShowFileProperties()		 提供文件操作功能 增强文件管理能力

二、实战开发：插件开发全流程

2.1 开发环境准备

开发环境要求：

  • 操作系统：Windows 10/11
  • 开发工具：Visual Studio 2022或更高版本
  • 框架依赖：.NET Framework 4.8或更高版本
  • 版本控制：Git

环境配置步骤：

  1. 克隆项目代码库：

    git clone https://gitcode.com/gh_mirrors/ev/EverythingToolbar

  2. 打开解决方案：

    EverythingToolbar.sln

  3. 还原项目依赖： 在Visual Studio中右键解决方案，选择"还原NuGet包"

  4. 构建项目： 选择"生成" -> "生成解决方案"，确保项目能正常编译

2.2 插件项目结构

推荐的插件项目结构如下：

MyPlugin/
├── MyPlugin.csproj           # 项目文件
├── Properties/               # 项目属性
│   └── AssemblyInfo.cs       # 程序集信息
├── Implementations/          # 接口实现
│   ├── MySearchProvider.cs   # 搜索提供者实现
│   ├── MyFilterProvider.cs   # 过滤器提供者实现
│   └── MyResultHandler.cs    # 结果处理器实现
├── Models/                   # 数据模型
│   └── MyCustomModel.cs      # 自定义数据模型
├── Resources/                # 资源文件
│   ├── Icons/                # 图标资源
│   └── Strings.resx          # 字符串资源
└── Plugin.cs                 # 插件入口类

2.3 插件开发示例一：自定义搜索过滤器

下面实现一个过滤特定文件类型的自定义过滤器插件：

/// <summary>
/// 图片文件过滤器插件
/// 功能：只显示指定格式的图片文件
/// </summary>
public class ImageFilterProvider : IFilterProvider
{
    private ObservableCollection<Filter> _filters;
    
    public ImageFilterProvider()
    {
        // 初始化过滤器集合
        _filters = new ObservableCollection<Filter>();
        LoadCustomFilters();
    }
    
    /// <summary>
    /// 加载自定义图片过滤器
    /// </summary>
    private void LoadCustomFilters()
    {
        // 添加常见图片格式过滤器
        _filters.Add(new Filter
        {
            Name = "常用图片",
            Icon = "\uE3F4",  // 使用系统图标
            IsMatchCase = false,
            IsMatchPath = false,
            Search = "ext:jpg;jpeg;png;gif",  // 支持的图片格式
            Macro = "images"
        });
        
        // 添加高分辨率图片过滤器
        _filters.Add(new Filter
        {
            Name = "高分辨率图片",
            Icon = "\uE3F4",
            IsMatchCase = false,
            IsMatchPath = false,
            Search = "ext:jpg;jpeg;png size:>2MB",  // 大于2MB的图片
            Macro = "highresimages"
        });
    }
    
    // 实现IFilterProvider接口的其他方法
    public ObservableCollection<Filter> GetAllFilters() => _filters;
    public Filter GetDefaultFilter() => _filters.FirstOrDefault();
    public ObservableCollection<Filter> GetUserFilters() => _filters;
    
    public void AddFilter(Filter filter)
    {
        if (!_filters.Any(f => f.Name == filter.Name))
        {
            _filters.Add(filter);
            // 保存到配置文件
            SaveFilters();
        }
    }
    
    // 其他接口方法实现...
    
    /// <summary>
    /// 保存过滤器配置到文件
    /// </summary>
    private void SaveFilters()
    {
        // 实现配置保存逻辑
        var configPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
            "EverythingToolbar", "ImageFilters.json");
            
        // 确保目录存在
        Directory.CreateDirectory(Path.GetDirectoryName(configPath));
        
        // 序列化并保存
        var json = JsonConvert.SerializeObject(_filters);
        File.WriteAllText(configPath, json);
    }
}

2.4 插件开发示例二：搜索结果处理器

下面实现一个将搜索结果导出为CSV文件的结果处理器：

/// <summary>
/// CSV导出结果处理器
/// 功能：将搜索结果导出为CSV格式文件
/// </summary>
public class CsvExportResultHandler : IResultHandler
{
    private readonly string _exportPath;
    
    public CsvExportResultHandler()
    {
        // 设置默认导出路径
        _exportPath = Path.Combine(
            Environment.GetFolderPath(Environment.SpecialFolder.Desktop),
            "EverythingSearchResults.csv");
    }
    
    /// <summary>
    /// 导出搜索结果到CSV文件
    /// </summary>
    /// <param name="results">要导出的搜索结果集合</param>
    /// <param name="exportPath">导出文件路径，为null则使用默认路径</param>
    /// <returns>导出是否成功</returns>
    public bool ExportResultsToCsv(IEnumerable<SearchResult> results, string exportPath = null)
    {
        try
        {
            var path = exportPath ?? _exportPath;
            
            // 创建CSV内容
            var csv = new StringBuilder();
            // 添加表头
            csv.AppendLine("文件名,完整路径,修改日期,文件大小,文件类型");
            
            // 添加数据行
            foreach (var result in results)
            {
                // 处理CSV特殊字符
                var fileName = EscapeCsvValue(result.HighlightedFileName);
                var fullPath = EscapeCsvValue(result.FullPathAndFileName);
                var dateModified = result.DateModified.ToString("yyyy-MM-dd HH:mm:ss");
                var fileSize = FormatFileSize(result.FileSize);
                var fileType = EscapeCsvValue(result.FileType);
                
                csv.AppendLine($"{fileName},{fullPath},{dateModified},{fileSize},{fileType}");
            }
            
            // 写入文件
            File.WriteAllText(path, csv.ToString(), Encoding.UTF8);
            
            // 显示导出成功消息
            ShowNotification("导出成功", $"搜索结果已导出至:\n{path}");
            
            return true;
        }
        catch (Exception ex)
        {
            // 记录错误日志
            ToolbarLogger.GetLogger("CsvExport").Error(ex, "导出CSV失败");
            ShowNotification("导出失败", $"无法导出搜索结果:\n{ex.Message}");
            return false;
        }
    }
    
    // 实现IResultHandler接口方法...
    
    /// <summary>
    /// 格式化文件大小显示
    /// </summary>
    private string FormatFileSize(long bytes)
    {
        if (bytes < 1024) return $"{bytes} B";
        if (bytes < 1048576) return $"{bytes / 1024:F1} KB";
        if (bytes < 1073741824) return $"{bytes / 1048576:F1} MB";
        return $"{bytes / 1073741824:F1} GB";
    }
    
    /// <summary>
    /// 转义CSV特殊字符
    /// </summary>
    private string EscapeCsvValue(string value)
    {
        if (value == null) return "";
        if (value.Contains(",") || value.Contains("\"") || value.Contains("\n"))
        {
            return $"\"{value.Replace("\"", "\"\"")}\"";
        }
        return value;
    }
    
    /// <summary>
    /// 显示系统通知
    /// </summary>
    private void ShowNotification(string title, string message)
    {
        // 实现系统通知逻辑
        // ...
    }
}

2.5 插件注册与部署

插件开发完成后，需要进行注册才能被EverythingToolbar识别：

  1. 创建插件描述文件（Plugin.json）：
{
  "Id": "CsvExportResultHandler",
  "Name": "CSV导出工具",
  "Description": "将搜索结果导出为CSV格式文件",
  "Author": "Your Name",
  "Version": "1.0.0",
  "EntryPoint": "MyPlugin.CsvExportResultHandler",
  "Dependencies": [],
  "SupportedApiVersions": ["1.0", "1.1"]
}
  1. 部署插件：
    • 创建插件目录：%APPDATA%\EverythingToolbar\Plugins\CsvExport
    • 复制插件文件：将编译好的DLL和Plugin.json复制到上述目录
    • 重启EverythingToolbar，插件将被自动加载

三、场景应用：插件功能落地实践

3.1 企业文档管理系统集成

应用场景：在企业环境中，将EverythingToolbar与内部文档管理系统集成，实现快速搜索和访问公司文档。

实现方案：

  1. 开发自定义ISearchProvider实现，连接企业文档数据库
  2. 实现IFilterProvider提供部门、文档类型等过滤条件
  3. 通过IResultHandler添加"签出文档"、"查看版本历史"等企业特有的操作

关键代码片段：

public class EnterpriseDocumentSearchProvider : ISearchProvider
{
    private readonly IDocumentService _documentService;
    
    public EnterpriseDocumentSearchProvider()
    {
        // 初始化企业文档服务客户端
        _documentService = new DocumentServiceClient(
            Properties.Settings.Default.DocumentServiceUrl);
    }
    
    public async Task<SearchResultsCollection> QueryAsync(
        string searchTerm, Filter currentFilter, SearchOptions options)
    {
        var results = new SearchResultsCollection();
        
        try
        {
            // 调用企业文档服务搜索API
            var docResults = await _documentService.SearchDocumentsAsync(
                searchTerm,
                currentFilter?.Search,
                options.MaxResults);
            
            // 转换为EverythingToolbar搜索结果格式
            foreach (var doc in docResults)
            {
                results.Add(new SearchResult
                {
                    HighlightedFileName = doc.Title,
                    FullPathAndFileName = doc.DocumentId,
                    IsFile = true,
                    DateModified = doc.LastModified,
                    FileSize = doc.Size,
                    FileType = doc.DocumentType,
                    // 添加自定义属性
                    AdditionalProperties = new Dictionary<string, object>
                    {
                        { "DocumentId", doc.DocumentId },
                        { "Version", doc.Version },
                        { "Department", doc.Department }
                    }
                });
            }
        }
        catch (Exception ex)
        {
            ToolbarLogger.GetLogger("EnterpriseSearch").Error(ex, "文档搜索失败");
        }
        
        return results;
    }
    
    // 其他接口方法实现...
}

3.2 开发资源快速访问工具

应用场景：为开发人员提供快速搜索和打开代码文件、API文档的功能。

实现方案：

  1. 创建基于文件路径和内容的自定义搜索提供者
  2. 添加编程语言、框架类型等专业过滤器
  3. 实现快速打开IDE、跳转到代码行等开发特定操作

3.3 插件开发最佳实践

性能优化：

  • 实现结果缓存机制，避免重复搜索相同内容
  • 使用异步编程模型，避免UI线程阻塞
  • 对大量数据采用分页加载策略

兼容性处理：

  • 检查API版本兼容性，处理不同版本EverythingToolbar的差异
  • 提供降级处理方案，确保在低版本系统上也能运行

用户体验：

  • 添加详细的错误提示和帮助信息
  • 提供配置界面，允许用户自定义插件行为
  • 支持快捷键操作，提高使用效率

EverythingToolbar固定到任务栏

图：EverythingToolbar固定到任务栏的界面展示，用户可以方便地从任务栏直接访问搜索功能

四、术语表

术语 解释
ISearchProvider 搜索提供者接口，定义搜索功能的实现规范
IFilterProvider 过滤器提供者接口，管理搜索过滤条件
IResultHandler 结果处理器接口，定义搜索结果的操作方法
Filter 过滤器对象，包含搜索条件和匹配规则
SearchResult 搜索结果对象，包含文件的详细信息
Plugin.json 插件描述文件，包含插件的元数据和注册信息

通过本文的介绍，相信开发者已经对EverythingToolbar插件开发有了全面的了解。无论是实现简单的自定义过滤器，还是开发复杂的企业集成插件，都可以基于这套插件系统架构来完成。随着插件生态的不断丰富，EverythingToolbar将成为更加灵活和强大的文件搜索工具。

EverythingToolbar
Everything integration for the Windows taskbar.
项目地址：https://gitcode.com/gh_mirrors/eve/EverythingToolbar
登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
27
14
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
659
4.26 K
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.54 K
894
pytorchpytorch
Ascend Extension for PyTorch
Python
503
609
kernelkernel
openEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。
C
391
285
flutter_flutterflutter_flutter
暂无简介
Dart
905
218
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解
Java
69
21
MindSpeed-LLMMindSpeed-LLM
昇腾LLM分布式训练框架
Python
142
168
ops-mathops-math
本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。
C++
939
862
cherry-studiocherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端
TypeScript
1.33 K
108