Struct PluginHostManager 

pub struct PluginHostManager {
    pub processes: Arc<DashMap<String, Arc<PluginProcess>>>,
    pub plugins: Arc<DashMap<String, PluginRegistration>>,
    pub data_dir_root: PathBuf,
    pub log_dir_root: PathBuf,
    /* private fields */
}

第三方插件子进程的顶层管理器。

Fields

processes: Arc<DashMap<String, Arc<PluginProcess>>>

已加载插件的子进程映射。

plugins: Arc<DashMap<String, PluginRegistration>>

已加载插件的组件注册包（含 DataSource / Executor / Plugin 适配器）。

data_dir_root: PathBuf

插件数据的根目录。

log_dir_root: PathBuf

插件 stderr 日志的根目录。

Implementations

impl PluginHostManager

pub fn new( plugins_dir: PathBuf, data_dir_root: PathBuf, log_dir_root: PathBuf, ) -> Arc<Self>

pub fn set_builtin_component_ids(&self, ids: HashSet<String>)

注入内置组件 id 集合（冲突预检数据源）。

由 src-tauri 在内置组件注册完毕后调用一次；此后内置组件集合 启动期稳定，不再更新。预检据此识别「与内置组件撞 id」。

pub async fn load( &self, plugin_dir: &Path, host_call_handler: Arc<dyn HostCallHandler>, on_restart: RestartCallback, on_crash: CrashCallback, restart_count: u32, locale: &str, ) -> Result<PluginRegistration, PluginLoadError>

从包含 manifest.toml 的目录加载一个插件。

on_restart 存入重启上下文，崩溃重启成功后被调用， 供调用方（src-tauri）重新注册新适配器。 on_crash 在崩溃检测到的那一刻（任何重启尝试之前）以旧注册包调用， 供调用方解注册 CM/SR 中的过期组件。 restart_count 为已发生的重启次数（初次加载传 0），用于延续崩溃恢复计数。 locale 为宿主当前界面语言，随 initialize 握手下发插件进程。

pub fn plugins_dir(&self) -> &Path

返回插件安装目录（显式存储，非派生）。

pub async fn unload(&self, plugin_id: &str) -> Result<(), PluginLoadError>

卸载插件：关闭子进程、移除全部登记并删除诊断日志（含轮转 .log.1）。 与 teardown（加载失败清理）的区别：teardown 保留日志供故障溯源。

pub fn update_locale(&self, plugin_id: &str, locale: &str)

更新插件重启上下文中的语言快照。

宿主在崩溃回调中调用（崩溃时刻取最新语言），保证崩溃重启的 initialize 握手携带最新 locale，而非首次加载时的快照。 插件不存在（正常卸载等）时静默。

pub fn list_plugin_info( &self, enabled_fn: impl Fn(&PluginRegistration) -> bool, ) -> Vec<InstalledPluginInfo>

为全部已加载适配器构造 InstalledPluginInfo。

enabled_fn 按适配器调用以确定 enabled 字段； 调用方传入查询 ConfigManager::is_enabled 的闭包。

pub fn get_plugin_info( &self, plugin_id: &str, enabled_fn: impl Fn(&PluginRegistration) -> bool, ) -> Option<InstalledPluginInfo>

单个插件的运行时信息（按 id 直查 hm.plugins，不遍历全量列表）。

与 list_plugin_info 共用同一构造逻辑（build_plugin_info）。