67 lines
1.9 KiB
Plaintext
67 lines
1.9 KiB
Plaintext
import { LogWrapper } from '../../../napcat-core/helper/log';
|
|
import { PluginModule, PluginEntry, PluginStatusConfig } from './types';
|
|
/**
|
|
* 插件加载器
|
|
* 负责扫描、加载和导入插件模块
|
|
*/
|
|
export declare class PluginLoader {
|
|
private readonly pluginPath;
|
|
private readonly configPath;
|
|
private readonly logger;
|
|
constructor(pluginPath: string, configPath: string, logger: LogWrapper);
|
|
/**
|
|
* 加载插件状态配置
|
|
*/
|
|
loadPluginStatusConfig(): PluginStatusConfig;
|
|
/**
|
|
* 保存插件状态配置
|
|
*/
|
|
savePluginStatusConfig(config: PluginStatusConfig): void;
|
|
/**
|
|
* 扫描插件目录，收集所有有效插件条目（异步版本，验证模块有效性）
|
|
* 只有包含有效 plugin_init 函数的插件才会被收集
|
|
*/
|
|
scanPlugins(): Promise<PluginEntry[]>;
|
|
/**
|
|
* 扫描单个目录插件
|
|
*/
|
|
private scanDirectoryPlugin;
|
|
/**
|
|
* 查找插件目录的入口文件
|
|
*/
|
|
private findEntryFile;
|
|
/**
|
|
* 动态导入模块
|
|
*/
|
|
importModule(filePath: string): Promise<any>;
|
|
/**
|
|
* 加载插件模块
|
|
*/
|
|
loadPluginModule(entry: PluginEntry): Promise<PluginModule | null>;
|
|
/**
|
|
* 检查模块是否为有效的插件模块
|
|
*/
|
|
isValidPluginModule(module: any): module is PluginModule;
|
|
/**
|
|
* 验证插件入口文件是否包含有效的 plugin_init 函数
|
|
* 用于扫描阶段快速验证
|
|
*/
|
|
validatePluginEntry(entryPath: string): Promise<{
|
|
valid: boolean;
|
|
error?: string;
|
|
}>;
|
|
/**
|
|
* 重新扫描单个插件
|
|
*/
|
|
rescanPlugin(dirname: string): PluginEntry | null;
|
|
/**
|
|
* 通过 ID 查找插件目录名
|
|
*/
|
|
findPluginDirById(pluginId: string): string | null;
|
|
/**
|
|
* 清除插件文件的 require 缓存
|
|
* 用于确保卸载插件时清理 CJS 模块缓存
|
|
*/
|
|
clearCache(pluginPath: string): void;
|
|
}
|