第2系列_第3期_.NET AI 插件热加载机制_DLL扫描到Kernel注册

.NET AI 插件热加载机制：从 DLL 扫描到 Kernel 注册

系列： .NET C# Semantic Kernel 集成深度解析 ③/6 难度： ⭐⭐⭐（进阶源码，需.NET基础） 源码仓库： github.com/zongge0812/zonggeAgent 适用环境： .NET 9.0 + WPF

一、引言

在 AI 桌面应用中，插件的意义远超传统软件——SK 的插件系统直接赋予 AI “动手能力”。AI 不是光说不练，而是可以通过插件读取文件、分析代码、生成文档。

zonggeAgent 的插件系统实现了 3 个关键能力：

┌──────────────────────────────────────────────────────────────┐
│ ① 热加载：新插件编译后直接放入目录，应用无需重启即可生效 │
│ ② 自动发现：DLL 扫描 + 反射 + ITools 接口自动匹配 │
│ ③ 权限过滤：聊天模式只读，开发模式全读写（安全隔离） │
└──────────────────────────────────────────────────────────────┘

二、整体架构

插件系统的核心是 PluginLoader 静态类，位于 Tools/Implementations/ 目录下：

PluginLoader（静态类）
│
├── 缓存：_pluginsCache（List<PluginsCache>）
│
├── RegisterPlugin(Kernel) → 入口：将插件注册到SK Kernel
│
├── LoadPluginsFromDirectories() → 核心：多目录扫描 + 反射加载
│ ├── ScanDirectoryForPlugins(baseDir) → 主目录
│ └── ScanDirectoryForPlugins(\”plugins/\”) → 热更新目录
│
├── ClearPluginCache() → 清空缓存，支持热替换时重新加载
│
└── RegisterPluginDependencies() → 注册插件依赖到SK的IServiceCollection

调用位置

在 BaseAIProviderService.SendMessageAsync() 和 SendMessageStreamAsync() 中调用：

// 每次对话都会执行
var chatService = await CreateChatServiceAsync(config);
var kernel = CreateKernel(chatService);

// ⚡ 热加载注册插件工具
PluginLoader.RegisterPlugin(kernel);

// 💬 聊天模式过滤
kernel = ApplyChatModeFilter(kernel, chatService);

这意味着：每次对话都会重新检查插件，热更新后的 DLL 在下一次对话立即生效。

三、DLL 扫描策略

3.1 双目录扫描

private static void LoadPluginsFromDirectories(
Kernel kernel,
string pluginDir = \”plugins\”,
string searchPattern = \”*.dll\”)
{

var scannedAssemblies = new List<Assembly>();
var baseDir = AppDomain.CurrentDomain.BaseDirectory;

// 1️⃣ 扫描程序主目录（bin/Debug/net9.0-windows/）
// 编译后的插件DLL所在位置
ScanDirectoryForPlugins(baseDir, searchPattern, scannedAssemblies);

// 2️⃣ 扫描 plugins/ 子目录（热加载扩展点）
var pluginDirectory = Path.Combine(baseDir, pluginDir);
if (Directory.Exists(pluginDirectory))
{

ScanDirectoryForPlugins(pluginDirectory, searchPattern, scannedAssemblies);
}
else
{

Directory.CreateDirectory(pluginDirectory); // 创建空目录
}
}

3.2 程序集过滤

不是所有 DLL 都是插件——ScanDirectoryForPlugins 内部实现了严格的过滤逻辑：

private static void ScanDirectoryForPlugins(
string directory,
string searchPattern,
List<Assembly> scannedAssemblies)
{

var dllFiles = Directory.GetFiles(directory, searchPattern, SearchOption.TopDirectoryOnly);

foreach (var dllPath in dllFiles)
{

var assemblyName = AssemblyName.GetAssemblyName(dllPath);
var name = assemblyName.Name ?? \”\”;

// 🚫 跳过系统/框架程序集
if (name.StartsWith(\”Microsoft.\”) || name.StartsWith(