mm_machine 2.1.1 → 2.1.3

package/index.js

@@ -1,571 +1,640 @@
-/**
- * @fileOverview 机制构建帮助类函数
- * @author <a href="http://qww.elins.cn">邱文武</a>
- * @version 1.6
- */
-const util = require('util');
-const Item = require('./item.js');
-
-/**
- * @class Index索引类
- */
-class Index {
-	/**
-	 * 构造函数
-	 * @param {Object} scope 作用域
-	 * @param {String} dir_base 模块目录
-	 * @constructor
-	 */
-	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;
-	}
-
-	/**
-	 * 私有方法：执行模块方法
-	 * @param {Object} module 模块对象
-	 * @param {String} method 方法名称
-	 * @param {Array} params 参数数组
-	 * @returns {Promise<any>} 执行结果
-	 * @private
-	 */
-	async _execute(module, method, params = []) {
-		if (!module || !method) return null;
-
-		try {
-			// 确保模块已加载
-			if (!module.complete) {
-				await module.exec('load');
-			}
-
-			// 执行方法
-			const ret = await module.exec(method, ...params);
-
-			// 根据模式决定是否重载
-			if (this.mode >= 4) {
-				module.exec('reload');
-			}
-
-			return ret;
-		} catch (err) {
-			$.log.error(`[${this.type}] 执行模块方法失败: `, err);
-			return null;
-		}
-	}
-}
-
-/**
- * 清除接口缓存
- */
-Index.prototype.clear = function() {
-	this.list = [];
-};
-
-/**
- * 默认驱动
- */
-Index.prototype.Drive = Item;
-
-/**
- * 加载项
- * @param {String} dir 文件路径
- * @param {Object} cg 配置参数
- * @param {String} file 配置文件
- * @returns {Promise<Object|null>} 加载的驱动或配置对象
- */
-Index.prototype.loadItem = 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) {
-				const 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;
-	}
-
-	// 使用for...of和async/await以保证正确的执行顺序
-	for (const file of list) {
-		await this.loadFile(file, true);
-	}
-};
-
-/**
- * 排序
- */
-Index.prototype.sort = function() {
-	this.list.sort((o1, o2) => {
-		const p1 = o1.config?.[this.sort_key] || 0;
-		const p2 = o2.config?.[this.sort_key] || 0;
-		return p2 - p1;
-	});
-};
-
-/**
- * 更新前
- */
-Index.prototype.update_before = async function(dir) {
-	// $.log.debug("更新前")
-}
-
-/**
- * 更新后
- */
-Index.prototype.update_after = async function(dir) {
-	// $.log.debug("更新后")
-}
-
-/**
- * 更新所有配置
- * @param {String} searchPath 检索路径
- * @param {Boolean} accurate 精准路径，默认为false
- * @returns {Promise<void>}
- */
-Index.prototype.updateConfigAll = async function(searchPath, accurate) {
-	try {
-		// 规范化路径
-		let normalizedPath = searchPath;
-		if (!normalizedPath) {
-			normalizedPath = './app/';
-		} else {
-			// 直接使用传入的路径，不强制添加app/
-			normalizedPath = normalizedPath.fullname();
-		}
-
-		let list_scope = [];
-		try {
-			// 使用精准模式总是获取所有目录
-			// 这样可以确保找到test1和test2目录
-			list_scope = $.dir.getAll(normalizedPath);
-		} catch (err) {
-			$.log.error(`[${this.type}] 检索目录失败！`, err);
-		}
-
-		// 处理找到的目录
-		for (const f of list_scope) {
-			// 直接检查并加载demo.json文件
-			const config_file = `./${this.type}.json`.fullname(f);
-			if (config_file && config_file.hasFile && config_file.hasFile()) {
-				// 直接加载这个文件
-				await this.loadFile(config_file, true);
-			}
-
-			// 同时也检查config_demo.json文件
-			const config_file2 = `./config_${this.type}.json`.fullname(f);
-			if (config_file2 && config_file2.hasFile && config_file2.hasFile()) {
-				// 直接加载这个文件
-				await this.loadFile(config_file2, true);
-			}
-		}
-	} catch (err) {
-		$.log.error(`[${this.type}] 更新所有配置失败: `, err);
-	}
-};
-
-/**
- * 更新已有配置文件
- * @param {string} dir 目录路径
- * @returns {Promise<void>}
- */
-Index.prototype.updateConfigHave = async function(dir) {
-	const list = this.list;
-	for (const o of list) {
-		const file = o.filename;
-		if (file) {
-			try {
-				const config = file.loadJson();
-				if (config) {
-					if (Array.isArray(config)) {
-						// 使用find方法查找匹配项
-						const targetConfig = config.find(cg => cg.name === o.config.name);
-						if (targetConfig) {
-							await o.exec('setConfig', targetConfig);
-						}
-					} else {
-						await o.exec('setConfig', config);
-					}
-				}
-			} catch (err) {
-				$.log.error(`[${this.type}] 更新配置失败: `, err);
-			}
-		}
-	}
-};
-
-/**
- * 更新配置
- * @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() {
-	const list = this.list;
-	for (const o of list) {
-		if (o.config?.state === 1) {
-			await o.exec('load');
-		}
-	}
-};
-
-/**
- * 更新
- * @param {String} dir 检索的路径
- * @param {Boolean} accurate 是否精准路径，默认为false
- * @param {Boolean} loadJS 是否加载JS，默认为true
- * @param {Boolean} clear 是否清除现有配置，默认为true
- * @returns {Promise<void>}
- */
-Index.prototype.update_main = 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} loadJS 是否加载JS
- */
-Index.prototype.update = async function(dir, accurate = false, loadJS = true, clear = true) {
-	await this.update_before(dir);
-	await this.update_main(dir, accurate, loadJS, clear);
-	await this.update_after(dir);
-};
-
-/**
- * 查询配置项
- * @param {String} name 名称
- * @return {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 配置对象
- * @return {Boolean} 是否设置成功
- */
-Index.prototype.set = function(name, cg) {
-	if (!name || !cg) return false;
-
-	const item = this.get(name);
-	if (item) {
-		// 使用Object.assign合并属性
-		Object.assign(item.config, cg);
-		return true;
-	}
-	return false;
-};
-
-/**
- * 保存
- * @returns {Boolean} 是否保存成功
- */
-Index.prototype.save = async function() {
-	const list = this.list;
-	for (const o of list) {
-		try {
-			await o.exec('save');
-		} catch (err) {
-			$.log.error(`[${this.type}] 保存失败: `, err);
-		}
-	}
-	return true;
-};
-
-/**
- * 添加插件
- * @param {Object} config 配置对象
- * @returns {Promise<Object|null>} 新添加的插件对象
- */
-Index.prototype.add = async function(config) {
-	if (!config || !config.name) {
-		$.log.error(`[${this.type}] 添加插件失败: 缺少必要的配置信息`);
-		return null;
-	}
-
-	try {
-		// 检查是否已存在
-		const 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;
-
-	const index = this.list.findIndex(item => item.config?.name === name);
-	if (index === -1) return false;
-
-	try {
-		const 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;
-
-	const 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;
-
-	const 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;
-
-	const 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 {
-		const dir = file.dirname();
-		// 载入文件
-		const obj = file.loadJson();
-		if (obj) {
-			if (Array.isArray(obj)) {
-				for (const o of obj) {
-					// 实例化一个驱动
-					await this.loadItem(dir, o, file);
-				}
-			} else {
-				return await this.loadItem(dir, null, file);
-			}
-		} else if (create) {
-			return await this.loadItem(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) {
-		const module = await this.get(name);
-		if (module && module.config?.state === 1) {
-			return await this._execute(module, method, params);
-		}
-		return null;
-	} else if (name === null) {
-		let result = null;
-		for (const module of this.list) {
-			if (module.config?.state === 1) {
-				result = await this._execute(module, method, params);
-				if (result && module.config?.end) {
-					break;
-				}
-			}
-		}
-		return result;
-	}
-	return null;
-};
-
-/**
- * 执行方法
- * @param {String} name 插件名称
- * @param {String} method 方法名称
- * @param {Object} option 配置参数
- * @returns {Promise<any>} 执行结果
- */
-Index.prototype.exec = async function(name, method, ...params) {
-	if (name) {
-		const module = await this.get(name);
-		if (module) {
-			return await this._execute(module, method, params);
-		}
-		return null;
-	} else if (name === null) {
-		let result = null;
-		for (const module of this.list) {
-			result = await this._execute(module, method, params);
-			if (result && module.config?.end) {
-				break;
-			}
-		}
-		return result;
-	}
-	return null;
-};
-
-/**
- * @module 导出Index类
- */
-exports.Index = Index;
-exports.Item = Item;
+/**
+ * @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');
+    }
+
+    // 执行方法
+    const 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.loadItem = 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) {
+        const 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) => {
+    const p1 = o1.config?.[this.sort_key] || 0;
+    const 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._normalizeSearchPath = function (search_path) {
+  if (!search_path) {
+    return './app/';
+  }
+  // 直接使用传入的路径，不强制添加app/
+  return search_path.fullname();
+};
+
+/**
+ * 获取目录列表
+ * @param {string} norm_path 规范化路径
+ * @returns {Array} 目录列表
+ */
+Index.prototype._getDirectoryList = 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._processDirectoryConfig = async function (dir) {
+  // 直接检查并加载demo.json文件
+  const 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文件
+  const 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 {
+    // 规范化路径
+    const norm_path = this._normalizeSearchPath(search_path);
+
+    // 获取目录列表
+    const list_scope = this._getDirectoryList(norm_path);
+
+    // 使用函数式编程处理目录
+    await list_scope.reduce(async (prev_promise, dir) => {
+      await prev_promise;
+      return this._processDirectoryConfig(dir);
+    }, Promise.resolve());
+  } catch (err) {
+    $.log.error(`[${this.type}] 更新所有配置失败: `, err);
+  }
+};
+
+/**
+ * 更新已有配置文件
+ * @param {string} dir_path 目录路径
+ * @returns {Promise<void>}
+ */
+Index.prototype.updateConfigHave = async function (dir_path) {
+  const 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) {
+  const file = o.filename;
+  if (!file) return;
+
+  try {
+    const config = file.loadJson();
+    if (!config) return;
+
+    const 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 () {
+  const 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;
+
+  const item = this.get(name);
+  if (item) {
+    // 使用Object.assign合并属性
+    Object.assign(item.config, cg);
+    return true;
+  }
+  return false;
+};
+
+/**
+ * 保存
+ * @returns {boolean} 是否保存成功
+ */
+Index.prototype.save = async function () {
+  const 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 {
+    // 检查是否已存在
+    const 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;
+
+  const index = this.list.findIndex((item) => item.config?.name === name);
+  if (index === -1) return false;
+
+  try {
+    const 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;
+
+  const 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;
+
+  const 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;
+
+  const 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 {
+    const dir = file.dirname();
+    // 载入文件
+    const obj = file.loadJson();
+    if (obj) {
+      if (Array.isArray(obj)) {
+        // 使用函数式编程处理数组
+        await obj.reduce(async (prev_promise, o) => {
+          await prev_promise;
+          // 实例化一个驱动
+          return this.loadItem(dir, o, file);
+        }, Promise.resolve());
+      } else {
+        return await this.loadItem(dir, null, file);
+      }
+    } else if (create) {
+      return await this.loadItem(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) {
+    const 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;
+    // 使用函数式编程处理列表，使用some模拟break逻辑
+    await this.list.some(async (module) => {
+      if (module.config?.state === 1) {
+        result = await this._exec(module, method, params);
+        // 如果结果不为空且有结束标志，则停止迭代
+        return result && module.config?.end;
+      }
+      return false;
+    });
+    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) {
+    const 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;
+      }
+      const current_result = await this._exec(module, method, params);
+      if (current_result) {
+        result = current_result;
+      }
+    }, Promise.resolve());
+    return result;
+  }
+  return null;
+};
+
+/**
+ * @module 导出Index类
+ */
+exports.Index = Index;
+exports.Item = Item;