mm_machine 2.2.4 → 2.2.6

package/index.js

@@ -1,641 +1,488 @@
-/**
- * @file 机制构建帮助类函数
- * @author <a href="http://qww.elins.cn">邱文武</a>
- * @version 1.6
- */
-const { Item } = require('./item.js');
-
-/**
- * @class Index索引类
- */
-class Index {
-  /**
-   * 构造函数
-   * @param {object} scope 作用域
-   * @param {string} dir_base 模块目录
-   * @class
-   */
-  constructor(scope, dir_base) {
-    // 作用域（同时作为检索的后缀名）
-    this.scope = scope || ($.val && $.val.scope) ? $.val.scope + '' : '';
-    // Index接口列表
-    this.list = [];
-
-    /**
-     * 机制类型
-     */
-    this.type = '';
-
-    /**
-     * 排序项
-     */
-    this.sort_key = 'sort';
-
-    /**
-     * 模块目录
-     */
-    this.dir_base = dir_base;
-
-    /**
-     * 模式
-     * 1.生产模式，改变文件不会重新加载
-     * 2.热更新模式，改变配置文件会重新加载配置，不重新加载脚本
-     * 3.热重载模式，改变配置文件都会加载配置和脚本
-     * 4.重载模式，执行完后重新加载脚本，避免变量污染
-     * 5.热更新+重载模式，改变配置文件重新加载配置和脚本，执行完后重新加载脚本
-     */
-    this.mode = 1;
-
-    /**
-     * 日志输出
-     */
-    this._logger = $.log || console;
-  }
-}
-
-/**
- * 日志输出
- * @param {string} level - 日志级别(debug/info/warn/error)
- * @param {string} message - 日志消息
- * @param {...*} args - 可选参数
- */
-Index.prototype.log = function (level, message, ...args) {
-  this._logger[level](`[${this.constructor.name}.${this.type}] ${message}`, ...args);
-};
-
-/**
- * 清除接口缓存
- */
-Index.prototype.clear = function () {
-  this.list = [];
-};
-
-/**
- * 默认驱动
- */
-Index.prototype.Drive = Item;
-
-/**
- * 私有方法：执行模块方法
- * @param {object} module 模块对象
- * @param {string} method 方法名称
- * @param {Array} params 参数数组
- * @returns {Promise<any>} 执行结果
- * @private
- */
-Index.prototype._exec = async function (module, method, params = []) {
-  if (!module || !method) return null;
-
-  try {
-    // 确保模块已加载
-    if (!module.complete) {
-      await module.exec('load');
-    }
-
-    // 执行方法
-    let ret = await module.exec(method, ...params);
-
-    // 根据模式决定是否重载
-    if (this.mode >= 4) {
-      module.exec('reload');
-    }
-
-    return ret;
-  } catch (err) {
-    $.log.error(`[${this.type}] 执行模块方法失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 加载项
- * @param {string} dir 文件路径
- * @param {object} cg 配置参数
- * @param {string} file 配置文件
- * @returns {Promise<object | null>} 加载的驱动或配置对象
- */
-Index.prototype.loadDrive = async function (dir, cg, file) {
-  if (!dir || !file) {
-    $.log.error(`[${this.type}] load: 缺少必要参数`);
-    return null;
-  }
-
-  try {
-    if (this.Drive) {
-      const drive = new this.Drive(dir, this.dir_base.fullname());
-      drive.mode = this.mode;
-      if (cg) {
-        await drive.exec('loadConfig', file, cg.name);
-        await drive.exec('setConfig', cg);
-      } else {
-        await drive.exec('loadConfig', file);
-      }
-      this.list.push(drive);
-      return drive;
-    } else {
-      let json = file.loadJson();
-      if (!json) {
-        let fl = './config.tpl.json'.fullname(this.dir_base);
-        if (fl.hasFile()) {
-          fl.copyFile(file);
-          json = file.loadJson();
-        }
-      }
-      if (json) {
-        this.list.push(json);
-      }
-      return json;
-    }
-  } catch (err) {
-    $.log.error(`[${this.type}] 加载项失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 加载列表
- * @param {Array} list 文件列表
- * @returns {Promise<void>}
- */
-Index.prototype.loads = async function (list) {
-  // 遍历文件路径
-  if (!Array.isArray(list)) {
-    $.log.error(`[${this.type}] loads: 列表参数必须是数组`);
-    return;
-  }
-
-  // 使用函数式编程，按顺序加载文件
-  await list.reduce(async (prev_promise, file_item) => {
-    await prev_promise;
-    return this.loadFile(file_item, true);
-  }, Promise.resolve());
-};
-
-/**
- * 排序
- */
-Index.prototype.sort = function () {
-  this.list.sort((o1, o2) => {
-    let p1 = o1.config?.[this.sort_key] || 0;
-    let p2 = o2.config?.[this.sort_key] || 0;
-    return p2 - p1;
-  });
-};
-
-/**
- * 更新前
- * @param {string} dir_path 目录路径
- */
-Index.prototype.updateBefore = async function (dir_path) {
-  // $.log.debug("更新前")
-};
-
-/**
- * 更新后
- * @param {string} dir_path 目录路径
- */
-Index.prototype.updateAfter = async function (dir_path) {
-  // $.log.debug("更新后")
-};
-
-/**
- * 规范化检索路径
- * @param {string} search_path 检索路径
- * @returns {string} 规范化后的路径
- */
-Index.prototype._searchPath = function (search_path) {
-  if (!search_path) {
-    return './app/';
-  }
-  // 直接使用传入的路径，不强制添加app/
-  return search_path.fullname();
-};
-
-/**
- * 获取目录列表
- * @param {string} norm_path 规范化路径
- * @returns {Array} 目录列表
- */
-Index.prototype._getDirList = function (norm_path) {
-  try {
-    // 使用精准模式总是获取所有目录
-    // 这样可以确保找到test1和test2目录
-    return $.dir.getAll(norm_path);
-  } catch (err) {
-    $.log.error(`[${this.type}] 检索目录失败！`, err);
-    return [];
-  }
-};
-
-/**
- * 处理单个目录的配置文件
- * @param {string} dir 目录路径
- * @returns {Promise<void>}
- */
-Index.prototype._runDirConfig = async function (dir) {
-  // 直接检查并加载demo.json文件
-  let config_file = `./${this.type}.json`.fullname(dir);
-  if (config_file && config_file.hasFile && config_file.hasFile()) {
-    await this.loadFile(config_file, true);
-  }
-
-  // 同时也检查config_demo.json文件
-  let config_file2 = `./config_${this.type}.json`.fullname(dir);
-  if (config_file2 && config_file2.hasFile && config_file2.hasFile()) {
-    await this.loadFile(config_file2, true);
-  }
-};
-
-/**
- * 更新所有配置
- * @param {string} search_path 检索路径
- * @param {boolean} accurate 精准路径，默认为false
- * @returns {Promise<void>}
- */
-Index.prototype.updateConfigAll = async function (search_path, accurate) {
-  try {
-    // 规范化路径
-    let norm_path = this._searchPath(search_path);
-
-    // 获取目录列表
-    let list_scope = this._getDirList(norm_path);
-
-    // 使用函数式编程处理目录
-    await list_scope.reduce(async (prev_promise, dir) => {
-      await prev_promise;
-      return this._runDirConfig(dir);
-    }, Promise.resolve());
-  } catch (err) {
-    $.log.error(`[${this.type}] 更新所有配置失败: `, err);
-  }
-};
-
-/**
- * 更新已有配置文件
- * @param {string} dir_path 目录路径
- * @returns {Promise<void>}
- */
-Index.prototype.updateConfigHave = async function (dir_path) {
-  let list = this.list;
-  await list.reduce(async (prev_promise, o) => {
-    await prev_promise;
-    return this._updateSingleConfig(o);
-  }, Promise.resolve());
-};
-
-/**
- * 更新单个配置项
- * @param {object} o 配置对象
- */
-Index.prototype._updateSingleConfig = async function (o) {
-  let file = o.filename;
-  if (!file) return;
-
-  try {
-    let config = file.loadJson();
-    if (!config) return;
-
-    let target_config = this._findConfig(config, o.config.name);
-    if (target_config) {
-      await o.exec('setConfig', target_config);
-    }
-  } catch (err) {
-    $.log.error(`[${this.type}] 更新配置失败: `, err);
-  }
-};
-
-/**
- * 查找配置项
- * @param {object | Array} config 配置对象
- * @param {string} name 配置名称
- * @returns {object | null} 目标配置
- */
-Index.prototype._findConfig = function (config, name) {
-  if (Array.isArray(config)) {
-    return config.find((cg) => cg.name === name) || null;
-  }
-  return config;
-};
-
-/**
- * 更新配置
- * @param {object} dir - 检索目录
- * @param {boolean} accurate - 精准路径，默认为false
- * @param {boolean} clear - 是否清除现有配置，默认为false
- * @returns {Promise<void>}
- */
-Index.prototype.updateConfig = async function (dir, accurate = false, clear = false) {
-  try {
-    if (clear) {
-      this.clear();
-      await this.updateConfigAll(dir, accurate);
-    } else {
-      // 如果没有指定目录，则更新已有的配置文件
-      await this.updateConfigHave();
-    }
-    this.sort();
-  } catch (err) {
-    $.log.error(`[${this.type}] 配置更新失败: `, err);
-  }
-};
-
-/**
- * 更新JS
- * @returns {Promise<void>}
- */
-Index.prototype.updateScript = async function () {
-  let list = this.list;
-  await list.reduce(async (prev_promise, o) => {
-    await prev_promise;
-    if (o.config?.state === 1) {
-      return o.exec('loadScript');
-    }
-  }, Promise.resolve());
-};
-
-/**
- * 更新
- * @param {string} dir 检索的路径
- * @param {boolean} accurate 是否精准路径，默认为false
- * @param {boolean} loadJS 是否加载JS，默认为true
- * @param {boolean} clear 是否清除现有配置，默认为true
- * @returns {Promise<void>}
- */
-Index.prototype.updateMain = async function (dir, accurate = false, loadJS = true, clear = true) {
-  await this.updateConfig(dir, accurate, clear);
-  if (loadJS) {
-    await this.updateScript();
-  }
-};
-
-/**
- * 更新配置
- * @param {string} dir 检索的路径
- * @param {boolean} accurate 精准路径
- * @param {boolean} loadJS 是否加载JS
- * @param {boolean} clear 是否清除缓存
- */
-Index.prototype.update = async function (dir, accurate = false, loadJS = true, clear = true) {
-  await this.updateBefore(dir);
-  await this.updateMain(dir, accurate, loadJS, clear);
-  await this.updateAfter(dir);
-};
-
-/**
- * 查询配置项
- * @param {string} name 名称
- * @returns {object | null} 返回单项配置
- */
-Index.prototype.get = function (name) {
-  if (!name) return null;
-  return this.list.find((item) => item.config?.name === name) || null;
-};
-
-/**
- * 设置配置项
- * @param {string} name 配置项名称
- * @param {object} cg 配置对象
- * @returns {boolean} 是否设置成功
- */
-Index.prototype.set = function (name, cg) {
-  if (!name || !cg) return false;
-
-  let item = this.get(name);
-  if (item) {
-    // 使用Object.assign合并属性
-    Object.assign(item.config, cg);
-    return true;
-  }
-  return false;
-};
-
-/**
- * 保存
- * @returns {boolean} 是否保存成功
- */
-Index.prototype.save = async function () {
-  let list = this.list;
-  await list.reduce(async (prev_promise, o) => {
-    await prev_promise;
-    if (o.config?.state === 1) {
-      return o.exec('save');
-    }
-  }, Promise.resolve());
-};
-
-/**
- * 添加插件
- * @param {object} config 配置对象
- * @returns {Promise<object | null>} 新添加的插件对象
- */
-Index.prototype.add = async function (config) {
-  if (!config || !config.name) {
-    $.log.error(`[${this.type}] 添加插件失败: 缺少必要的配置信息`);
-    return null;
-  }
-
-  try {
-    // 检查是否已存在
-    let existing = this.get(config.name);
-    if (existing) {
-      $.log.warn(`插件 ${config.name} 已存在`);
-      return existing;
-    }
-
-    const item = new Item(this, config);
-    this.list.push(item);
-    this.sort();
-    return item;
-  } catch (err) {
-    $.log.error(`[${this.type}] 添加插件失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 删除插件
- * @param {string} name 插件名称
- * @returns {Promise<boolean>} 是否删除成功
- */
-Index.prototype.del = async function (name) {
-  if (!name) return false;
-
-  let index = this.list.findIndex((item) => item.config?.name === name);
-  if (index === -1) return false;
-
-  try {
-    let item = this.list[index];
-    await item.exec('unload');
-    this.list.splice(index, 1);
-    return true;
-  } catch (err) {
-    $.log.error(`[${this.type}] 删除插件失败: `, err);
-    return false;
-  }
-};
-
-/**
- * 加载插件
- * @param {string} name 插件名称
- * @returns {Promise<object | null>} 加载的插件对象
- */
-Index.prototype.load = async function (name) {
-  if (!name) return null;
-
-  let item = this.get(name);
-  if (!item) return null;
-
-  try {
-    if (item.config?.state === 1) {
-      await item.exec('load');
-    }
-    return item;
-  } catch (err) {
-    $.log.error(`[${this.type}] 加载插件 ${name} 失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 卸载插件
- * @param {string} name 插件名称
- * @returns {Promise<boolean>} 是否卸载成功
- */
-Index.prototype.unload = async function (name) {
-  if (!name) return false;
-
-  let item = this.get(name);
-  if (!item) return false;
-
-  try {
-    await item.exec('unload');
-    return true;
-  } catch (err) {
-    $.log.error(`[${this.type}] 卸载插件 ${name} 失败: `, err);
-    return false;
-  }
-};
-
-/**
- * 重新加载插件
- * @param {string} name 插件名称
- * @returns {Promise<object | null>} 重新加载的插件对象
- */
-Index.prototype.reload = async function (name) {
-  if (!name) return null;
-
-  let item = this.get(name);
-  if (!item) return null;
-
-  try {
-    await item.exec('reload');
-    return item;
-  } catch (err) {
-    $.log.error(`[${this.type}] 重新加载插件 ${name} 失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 通过文件加载配置
- * @param {string} file 文件名
- * @param {boolean} create 不存在则进行创建
- * @returns {Promise<object | null | string>} 加载的驱动对象、null或错误信息
- */
-Index.prototype.loadFile = async function (file, create = false) {
-  try {
-    let dir = file.dirname();
-    // 载入文件
-    let obj = file.loadJson();
-    if (obj) {
-      if (Array.isArray(obj)) {
-        // 使用函数式编程处理数组
-        await obj.reduce(async (prev_promise, o) => {
-          await prev_promise;
-          // 实例化一个驱动
-          return this.loadDrive(dir, o, file);
-        }, Promise.resolve());
-      } else {
-        return await this.loadDrive(dir, null, file);
-      }
-    } else if (create) {
-      return await this.loadDrive(dir, null, file);
-    } else {
-      return `${file}文件不存在`;
-    }
-    return null;
-  } catch (err) {
-    $.log.error(`[${this.type}] 加载文件失败: `, err);
-    return `加载文件失败: ${err.message}`;
-  }
-};
-
-/**
- * 调用函数
- * @param {string} name 模块名
- * @param {string} method 函数名
- * @param {object} params 参数集合
- * @returns {Promise<any>} 执行结果
- */
-Index.prototype.run = async function (name, method, ...params) {
-  if (name) {
-    let module = await this.get(name);
-    if (module && module.config?.state === 1) {
-      return await this._exec(module, method, params);
-    }
-    return null;
-  } else if (name === null) {
-    let result = null;
-    // 修复：使用for循环替代some，正确处理异步迭代
-    for (let module of this.list) {
-      if (module.config?.state === 1) {
-        result = await this._exec(module, method, params);
-        // 如果结果不为空且有结束标志，则停止迭代
-        if (result && module.config?.end) {
-          break;
-        }
-      }
-    }
-    return result;
-  }
-  return null;
-};
-
-/**
- * 执行方法
- * @param {string} name 插件名称
- * @param {string} method 方法名称
- * @param {...any} params 方法参数
- * @returns {Promise<any>} 执行结果
- */
-Index.prototype.exec = async function (name, method, ...params) {
-  if (name) {
-    let module = await this.get(name);
-    if (module) {
-      return await this._exec(module, method, params);
-    }
-    return null;
-  } else if (name === null) {
-    let result = null;
-    // 使用函数式编程处理列表，使用reduce模拟break逻辑
-    await this.list.reduce(async (prev_promise, module) => {
-      await prev_promise;
-      // 如果已经得到结果且有结束标志，则跳过后续处理
-      if (result && module.config?.end) {
-        return;
-      }
-      let current = await this._exec(module, method, params);
-      if (current) {
-        result = current;
-      }
-    }, Promise.resolve());
-    return result;
-  }
-  return null;
-};
-
-/**
- * @module 导出Index类
- */
-exports.Index = Index;
-exports.Item = Item;
+const { Mod } = require('./mod');
+const { Drive } = require('./drive.js');
+
+/**
+ * 管理器类
+ */
+class Manager extends Mod {
+  static config = {
+    // 管理器名称
+    name: 'manager',
+    // 管理器描述
+    description: '管理模块',
+    // 基础目录，加载模块内置资源
+    base_dir: '../common/manager'.fullname(__dirname),
+    // 自定义目录，加载项目自定义资源
+    dir: './ai/manager'.fullname(),
+    // 文件拓展名
+    filename: 'manager.json',
+    // 懒加载
+    lazy_load: true,
+    // 作用域（同时作为检索的后缀名）
+    scope: ($.val && $.val.scope) ? $.val.scope + '' : 'server',
+    // 排序项
+    sort_key: 'sort',
+    // 模式 script脚本 | json配置 | drive驱动
+    type: 'drive',
+    // 模式 1.生产模式 2.热更新模式 3.热重载模式 4.热更新+重载模式 5.重载模式
+    mode: 3
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置项
+   * @param {object} parent 父项对象
+   */
+  constructor(config, parent) {
+    super({
+      ...Manager.config,
+      ...config
+    }, parent);
+
+    // 模块信息列表 { name: '', sort: 0, available: true, enabled: true }
+    this.infos = [];
+    // 模块
+    this.mods = {};
+  }
+}
+
+/**
+ * 创建模块状态模型
+ * @param {string} name 模块名
+ * @param {number} sort 排序值
+ * @param {boolean} state 状态
+ * @returns {object} 模块状态模型
+ */
+Manager.prototype.newInfo = function (name, sort, state) {
+  return {
+    name,
+    sort,
+    available: state == true,
+    enabled: true
+  };
+};
+
+/**
+ * 获取基础目录
+ * @returns {string} 基础目录
+ */
+Manager.prototype.getBaseDir = function () {
+  return this.config.base_dir;
+};
+
+/**
+ * 默认驱动
+ */
+Manager.prototype.Drive = Drive;
+
+/**
+ * 更新模块信息
+ */
+Manager.prototype.updateInfo = function () {
+  this.infos = [];
+  for (let name in this.mods) {
+    let o = this.mods[name];
+    let info = this.newInfo(name, o.config.sort, o.config.state);
+    this.infos.push(info);
+  }
+  this.sort();
+};
+
+/**
+ * 排序
+ */
+Manager.prototype.sort = function () {
+  var sort_key = this.config.sort_key || 'sort';
+  this.infos.sort((o1, o2) => {
+    let p1 = o1[sort_key] || 0;
+    let p2 = o2[sort_key] || 0;
+    return p1 - p2;
+  });
+};
+
+// ==== 模块管理接口 ====
+/**
+ * 删除模块
+ * @param {string} name 模块名
+ * @returns {object|null} 删除的模块对象
+ */
+Manager.prototype.delMod = function (name) {
+  let mod = this.mods[name];
+  if (mod) {
+    delete this.mods[name];
+  }
+  return mod;
+};
+
+/**
+ * 设置模块
+ * @param {string} name 模块名
+ * @param {object} mod 模块对象
+ * @returns {object|null} 设置的模块对象
+ */
+Manager.prototype.setMod = function (name, mod) {
+  this.mods[name] = mod;
+  return this.getMod(name);
+};
+
+/**
+ * 获取模块
+ * @param {string} name 模块名
+ * @returns {object|null} 模块对象，若模块则返回模块对象，否则返回null
+ */
+Manager.prototype.getMod = function (name) {
+  return this.mods[name];
+};
+
+/**
+ * 获取所有模块
+ * @returns {object[]} 模块对象数组
+ */
+Manager.prototype.getMods = function () {
+  return this.mods;
+};
+
+/**
+ * 创建模块
+ * @param {string} config_file 配置文件路径
+ * @param {object} config 配置项
+ * @param {object} script 模块对象
+ * @returns {object} 模块对象
+ */
+Manager.prototype.newMod = function (config_file, config, script) {
+  let mod;
+  switch (this.config.type) {
+    case 'script':
+      mod = new Mod(config, this);
+      break;
+    default:
+      // 创建模块
+      mod = new this.Drive(config, this);
+      break;
+  }
+  mod.mode = this.config.mode;
+  mod.loadConfig(config_file);
+  mod.setMethods(script);
+  mod.setConfig(config);
+  return mod;
+};
+
+/**
+ * 注册模块
+ * @param {string} config_file 配置文件路径
+ * @param {object} config 配置项
+ * @param {object} script 模块对象
+ * @returns {object} 配置项
+ */
+Manager.prototype.register = function (config_file, config = {}, script = {}) {
+  let mod = this.newMod(config_file, config, script);
+  this.setMod(mod.config.name, mod);
+  return mod;
+};
+
+/**
+ * 加载模块
+ * @param {string} name 模块名
+ * @returns {Promise<any>} 加载结果
+ */
+Manager.prototype.load = async function (name) {
+  let mod = this.getMod(name);
+  if (mod) {
+    return await mod.exec('load');
+  }
+  return null;
+};
+
+/**
+ * 卸载模块
+ * @param {string} name 模块名
+ * @returns {Promise<any>} 卸载结果
+ */
+Manager.prototype.unload = async function (name) {
+  let mod = this.getMod(name);
+  if (mod) {
+    return await mod.exec('unload');
+  }
+  return null;
+};
+
+/**
+ * 重载模块
+ * @param {string} name 模块名
+ * @returns {Promise<any>} 重载结果
+ */
+Manager.prototype.reload = async function (name) {
+  let mod = this.getMod(name);
+  if (mod) {
+    return await mod.exec('reload');
+  }
+  return null;
+};
+
+/**
+ * 注销模块
+ * @param {string} name 模块名
+ * @returns {Promise<any>} 注销结果
+ */
+Manager.prototype.unregister = function (name) {
+  // 卸载模块
+  this.unload(name);
+  // 删除模块
+  this.delMod(name);
+  return mod;
+};
+
+/**
+ * 批量注册模块
+ * @param {string[]} files 配置文件路径数组
+ * @param {object} config 配置项
+ * @param {object} script 模块对象
+ */
+Manager.prototype.batchRegister = function (files, config = {}, script = {}) {
+  for (let file of files) {
+    this.register(file, config, script);
+  }
+};
+
+/**
+ * 加载所有模块
+ */
+Manager.prototype.loads = async function () {
+  var promises = [];
+  for (let name in this.mods) {
+    let mod = this.mods[name];
+    promises.push(mod.exec('load'));
+  }
+  await Promise.all(promises);
+};
+
+/**
+ * 检索目录下所有文件
+ * @private
+ * @param {string} dir 目录路径
+ * @returns {Array} 文件路径数组
+ */
+Manager.prototype._findFiles = function (dir) {
+  // 检查目录是否存在
+  if (!dir) {
+    this.log('error', '目录不能为空');
+    return [];
+  }
+  // 检查目录是否存在
+  if (!dir.hasDir()) {
+    this.log('warn', '目录不存在', dir);
+    return [];
+  }
+  // 检索目录下所有文件
+  return $.file.getAll(dir, this.config.filename);
+};
+
+/**
+ * 加载所有模块的脚本
+ */
+Manager.prototype.loadScripts = async function () {
+  var promises = [];
+  for (let name in this.mods) {
+    let mod = this.mods[name];
+    promises.push(mod.exec('loadScript'));
+  }
+  await Promise.all(promises);
+};
+
+/**
+ * 更新配置前的钩子函数
+ */
+Manager.prototype.updateBefore = function () {
+  this.log('info', '更新配置前的钩子函数');
+};
+
+/**
+ * 更新配置前的钩子函数
+ */
+Manager.prototype.updateAfter = function () {
+  this.log('info', '更新配置后钩子函数');
+};
+
+/**
+ * 更新配置
+ * @param {string} dir 检索的路径
+ * @param {boolean} clear 是否清除缓存
+ */
+Manager.prototype.update = async function (dir, clear = true) {
+  if (clear) {
+    // 初始化方法
+    this.mods = {};
+  }
+
+  // 查找所有json文件
+  let files = this._findFiles(dir);
+  // 批量注册模块
+  this.batchRegister(files);
+  // 更新配置信息
+  this.updateInfo();
+  if (!this.config.lazy_load) {
+    // 批量加载脚本
+    await this.loadScripts();
+  }
+  this.is_loaded = true;
+};
+
+// ==== 高性能调用接口 ====
+/**
+ * 调用模块的方法（高性能版本）
+ * @param {string} name 模块名
+ * @param {string} method 方法名
+ * @param {...any} params 参数集合
+ * @returns {Promise<any>} 执行结果
+ */
+Manager.prototype.main = async function (name, method, ...params) {
+  var result = null;
+  if (name) {
+    let mod = this.getMod(name);
+    if (mod && mod.config?.state === 1) {
+      result = await this._runSub(mod, method, ...params);
+    }
+  } else if (name === null) {
+    result = await this._runAllEnabled(method, ...params);
+  }
+  return result;
+};
+
+/**
+ * 私有方法：执行所有模块方法
+ * @param {string} method 方法名称
+ * @param {...any} params 方法参数集合
+ * @returns {Promise<any>} 执行结果
+ * @private
+ */
+Manager.prototype._runAllEnabled = async function (method, ...params) {
+  var result;
+  for (let i = 0; i < this.infos.length; i++) {
+    let config = this.infos[i];
+    let mod = this.getMod(config.name);
+    if (mod && mod.config?.state === 1) {
+      var ret = await this._runSub(mod, method, ...params);
+      if (ret !== null && ret !== undefined) {
+        result = ret;
+        // 如果结果不为空且有结束标志，则停止迭代
+        if (mod.config?.end) {
+          break;
+        }
+      }
+    }
+  }
+  return result;
+};
+
+/**
+ * 执行方法
+ * @param {string} name 模块名称
+ * @param {string} method 方法名称
+ * @param {...any} params 方法参数集合
+ * @returns {Promise<any>} 执行结果
+ */
+Manager.prototype.runAsync = async function (name, method, ...params) {
+  // 使用mods的顺序（按配置顺序调用）
+  var result = null;
+  if (name) {
+    let mod = await this.getMod(name);
+    if (mod) {
+      result = await this._runSub(mod, method, ...params);
+    }
+  } else if (name === null) {
+    result = await this._runAll(method, ...params);
+  }
+  return result;
+};
+
+/**
+ * 私有方法：执行所有模块方法
+ * @param {string} method 方法名称
+ * @param {...any} params 方法参数集合
+ * @returns {Promise<any>} 执行结果
+ * @private
+ */
+Manager.prototype._runAll = async function (method, ...params) {
+  var result = null;
+  for (let i = 0; i < this.infos.length; i++) {
+    let config = this.infos[i];
+    let mod = this.getMod(config.name);
+    if (mod) {
+      var ret = await this._runSub(mod, method, ...params);
+      if (ret !== null && ret !== undefined) {
+        result = ret;
+      }
+    }
+  }
+  return result;
+};
+
+/**
+ * 私有方法：执行模块方法
+ * @param {object} mod 模块对象
+ * @param {string} method 方法名称
+ * @param {...any} params 参数集合
+ * @returns {Promise<any>} 执行结果
+ * @private
+ */
+Manager.prototype._runSub = async function (mod, method, ...params) {
+  if (!mod || !method) return null;
+
+  try {
+    // 确保模块已加载
+    if (!mod.isLoaded()) {
+      await mod.do('loadScript');
+    }
+
+    // 执行方法
+    let ret = await mod.exec(method, ...params);
+    // 根据模式决定是否重载
+    if (this.mode >= 4) {
+      mod.do('reload');
+    }
+
+    return ret;
+  } catch (err) {
+    $.log.error(`[${this.type}] 执行模块方法失败: `, err);
+    return null;
+  }
+};
+
+/**
+ * 初始化管理器
+ */
+Manager.prototype._initManager = function () {
+
+};
+
+/**
+ * 加载资源
+ */
+Manager.prototype._loadSources = function () {
+};
+
+/**
+ * 初始化资源
+ */
+Manager.prototype._initSources = function () {
+};
+
+/**
+ * 初始化公共属性
+ */
+Manager.prototype._initCore = function () {
+  // 初始化管理器
+  this._initManager();
+  // 加载资源
+  this._loadSources();
+  // 初始化AI客户端
+  this._initSources();
+};
+
+module.exports = {
+  Manager,
+  Drive,
+  // 向后兼容
+  Index: Manager,
+  Item: Drive
+};