mm_machine 2.0.5 → 2.0.7

package/README.md

@@ -44,7 +44,7 @@ async function init() {
     });
     
     // 加载所有模块
-    await engine.load_list();
+    await engine.loads();
     
     // 执行所有模块的main方法
     const results = await engine.execute('main');
@@ -162,7 +162,7 @@ const engine = new Machine();
 // 初始化引擎
 async function init() {
     // 加载模块
-    await engine.load_list();
+    await engine.loads();
     
     // 执行所有模块的main方法
     await engine.execute('main');
@@ -306,7 +306,7 @@ engine.update_config_all({
 });
 
 // 然后加载模块
-await engine.load_list();
+await engine.loads();
 ```
 
 ### 示例3：实现热更新和动态管理
@@ -322,7 +322,7 @@ engine.mode = 2;
 // 初始化
 async function setup() {
     // 加载模块
-    await engine.load_list();
+    await engine.loads();
     
     // 开始监听文件变化
     engine.watch();
@@ -357,7 +357,7 @@ const engine = new Machine();
 async function run() {
     try {
         // 加载模块并捕获可能的错误
-        await engine.load_list();
+        await engine.loads();
         
         // 安全地执行模块方法
         try {

package/app/test1/index.js

@@ -1,28 +1,61 @@
-var counter = 0;
-
-function test() {
+/**
+ * 计数器变量
+ * @type {number}
+ */
+var counter = 200;
+
+/**
+ * 测试函数
+ * @private
+ */
+function _test() {
     console.log("测试模块1执行", counter++);
 }
 
+/**
+ * 主函数
+ * @returns {Object} 返回执行结果
+ * @returns {string} return.message - 消息内容
+ * @returns {number} return.value - 计数器值
+ */
 function main() {
-    test();
+    _test();
     return { message: "测试模块1返回", value: counter };
 }
 
 exports.main = main;
 
+/**
+ * 主函数执行前的钩子函数
+ * @returns {void}
+ */
 exports.main_before = function() {
     console.log("测试模块1前置钩子");
 };
 
+/**
+ * 主函数执行后的钩子函数
+ * @param {Object} ret - 主函数返回值
+ * @param {string} ret.message - 消息内容
+ * @param {number} ret.value - 计数器值
+ * @returns {Promise<void>}
+ */
 exports.main_after = async function(ret) {
     console.log("测试模块1后置钩子", ret);
 };
 
+/**
+ * 模块加载时的钩子函数
+ * @returns {void}
+ */
 exports.load = function() {
     console.log("加载测试模块1");
 };
 
+/**
+ * 模块初始化时的钩子函数
+ * @returns {void}
+ */
 exports.init = function() {
     console.log("初始化测试模块1");
 };

package/app/test2/after.js

@@ -1,3 +1,10 @@
+/**
+ * 主函数执行后的钩子函数
+ * @param {Object} ret - 主函数返回值
+ * @param {string} ret.result - 执行结果
+ * @param {number} ret.count - 计数器值
+ * @returns {Object} 返回处理后的结果
+ */
 exports.main_after = function(ret) {
     console.log("测试模块2后置处理", ret);
     return ret;

package/app/test2/index.js

@@ -0,0 +1,17 @@
+
+/**
+ * 导入主模块
+ */
+var mainModule = require('./main.js');
+
+/**
+ * 导入后置处理模块
+ */
+var afterModule = require('./after.js');
+
+/**
+ * 合并模块导出
+ */
+Object.assign(exports, mainModule, afterModule);
+
+console.log("测试模块2入口文件已加载");

package/app/test2/main.js

@@ -1,5 +1,15 @@
+/**
+ * 计数器变量
+ * @type {number}
+ */
 var count = 0;
 
+/**
+ * 主函数
+ * @returns {Object} 返回执行结果
+ * @returns {string} return.result - 执行结果
+ * @returns {number} return.count - 计数器值
+ */
 function main() {
     console.log("测试模块2执行", count++);
     return { result: "测试模块2结果", count: count };
@@ -7,10 +17,18 @@ function main() {
 
 exports.main = main;
 
+/**
+ * 模块加载时的钩子函数
+ * @returns {void}
+ */
 exports.load = function() {
     console.log("加载测试模块2");
 };
 
+/**
+ * 模块初始化时的钩子函数
+ * @returns {void}
+ */
 exports.init = function() {
     console.log("初始化测试模块2");
 };

package/demo/test1/index.js

@@ -1,7 +1,7 @@
 var i = 0;
 
 function test() {
-	console.log("你好7654321", i++)
+	console.log("你好123", i++)
 }
 
 function main() {

package/demo/test2/index.js

@@ -1,11 +1,30 @@
+/**
+ * Demo类
+ * @class
+ */
 class Demo {
 	constructor() {}
 }
-var i = 0;
+
+/**
+ * 计数器
+ * @type {number}
+ */
+var counter = 0;
+
+/**
+ * 主函数
+ * @returns {number} 返回计数器值
+ */
 Demo.prototype.main = function() {
-	console.log("我很好7654321", i++);
-	return i;
+	console.log("我很好7654321", counter++);
+	return counter;
 }
+
+/**
+ * 初始化函数
+ * @returns {void}
+ */
 Demo.prototype.init = function(){
 	console.log("初始化test2");
 }

package/index.js

@@ -56,7 +56,7 @@ class Index {
 	 * @returns {Promise<any>} 执行结果
 	 * @private
 	 */
-	async _executeMethod(module, method, params = []) {
+	async _execute(module, method, params = []) {
 		if (!module || !method) return null;
 
 		try {
@@ -66,15 +66,14 @@ class Index {
 			}
 
 			// 执行方法
-			const ret = module.exec(method, ...params);
-			const result = util.types.isPromise(ret) ? await ret : ret;
+			const ret = await module.exec(method, ...params);
 
 			// 根据模式决定是否重载
 			if (this.mode >= 4) {
 				module.exec('reload');
 			}
 
-			return result;
+			return ret;
 		} catch (err) {
 			$.log.error(`执行模块方法失败: ${err.message}`);
 			return null;
@@ -101,9 +100,9 @@ Index.prototype.Drive = Item;
  * @param {String} file 配置文件
  * @returns {Promise<Object|null>} 加载的驱动或配置对象
  */
-Index.prototype.load_item = async function(dir, cg, file) {
+Index.prototype.loadItem = async function(dir, cg, file) {
 	if (!dir || !file) {
-		$.log.error('load_item: 缺少必要参数');
+		$.log.error('load: 缺少必要参数');
 		return null;
 	}
 
@@ -112,10 +111,10 @@ Index.prototype.load_item = async function(dir, cg, file) {
 			const drive = new this.Drive(dir, this.dir_base.fullname());
 			drive.mode = this.mode;
 			if (cg) {
-				await drive.exec('load_config', file, cg.name);
-				await drive.exec('set_config', cg);
+				await drive.exec('loadConfig', file, cg.name);
+				await drive.exec('setConfig', cg);
 			} else {
-				await drive.exec('load_config', file);
+				await drive.exec('loadConfig', file);
 			}
 			this.list.push(drive);
 			return drive;
@@ -144,16 +143,16 @@ Index.prototype.load_item = async function(dir, cg, file) {
  * @param {Array} list 文件列表
  * @returns {Promise<void>}
  */
-Index.prototype.load_list = async function(list) {
+Index.prototype.loads = async function(list) {
 	// 遍历文件路径
 	if (!Array.isArray(list)) {
-		$.log.error('load_list: 列表参数必须是数组');
+		$.log.error('loads: 列表参数必须是数组');
 		return;
 	}
 
 	// 使用for...of和async/await以保证正确的执行顺序
 	for (const file of list) {
-		await this.load_file(file, true);
+		await this.loadFile(file, true);
 	}
 };
 
@@ -188,7 +187,7 @@ Index.prototype.update_after = async function(dir) {
  * @param {Boolean} accurate 精准路径，默认为false
  * @returns {Promise<void>}
  */
-Index.prototype.update_config_all = async function(searchPath, accurate) {
+Index.prototype.updateConfigAll = async function(searchPath, accurate) {
 	try {
 		// 规范化路径
 		let normalizedPath = searchPath;
@@ -214,16 +213,14 @@ Index.prototype.update_config_all = async function(searchPath, accurate) {
 			const config_file = `${this.type}.json`.fullname(f);
 			if (config_file && config_file.hasFile && config_file.hasFile()) {
 				// 直接加载这个文件
-				await this.load_file(config_file, true);
-				$.log.debug(`成功加载配置文件: ${config_file}`);
+				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.load_file(config_file2, true);
-				$.log.debug(`成功加载配置文件: ${config_file2}`);
+				await this.loadFile(config_file2, true);
 			}
 		}
 	} catch (err) {
@@ -232,10 +229,11 @@ Index.prototype.update_config_all = async function(searchPath, accurate) {
 };
 
 /**
- * 更新配置
- * @param {Object} dir
+ * 更新已有配置文件
+ * @param {string} dir 目录路径
+ * @returns {Promise<void>}
  */
-Index.prototype.update_config_have = async function(dir) {
+Index.prototype.updateConfigHave = async function(dir) {
 	const list = this.list;
 	for (const o of list) {
 		const file = o.filename;
@@ -267,14 +265,14 @@ Index.prototype.update_config_have = async function(dir) {
  * @param {Boolean} clear - 是否清除现有配置，默认为false
  * @returns {Promise<void>}
  */
-Index.prototype.update_config = async function(dir, accurate = false, clear = false) {
+Index.prototype.updateConfig = async function(dir, accurate = false, clear = false) {
 	try {
 		if (clear) {
 			this.clear();
-			await this.update_config_all(dir, accurate);
+			await this.updateConfigAll(dir, accurate);
 		} else {
 			// 如果没有指定目录，则更新已有的配置文件
-			await this.update_config_have();
+			await this.updateConfigHave();
 		}
 		this.sort();
 	} catch (err) {
@@ -286,7 +284,7 @@ Index.prototype.update_config = async function(dir, accurate = false, clear = fa
  * 更新JS
  * @returns {Promise<void>}
  */
-Index.prototype.update_script = async function() {
+Index.prototype.updateScript = async function() {
 	const list = this.list;
 	for (const o of list) {
 		if (o.config?.state === 1) {
@@ -304,9 +302,9 @@ Index.prototype.update_script = async function() {
  * @returns {Promise<void>}
  */
 Index.prototype.update_main = async function(dir, accurate = false, loadJS = true, clear = true) {
-	await this.update_config(dir, accurate, clear);
+	await this.updateConfig(dir, accurate, clear);
 	if (loadJS) {
-		await this.update_script();
+		await this.updateScript();
 	}
 };
 
@@ -484,7 +482,7 @@ Index.prototype.reload = async function(name) {
  * @param {Boolean} create 不存在则进行创建
  * @returns {Promise<Object|null|String>} 加载的驱动对象、null或错误信息
  */
-Index.prototype.load_file = async function(file, create = false) {
+Index.prototype.loadFile = async function(file, create = false) {
 	try {
 		const dir = file.dirname();
 		// 载入文件
@@ -493,13 +491,13 @@ Index.prototype.load_file = async function(file, create = false) {
 			if (Array.isArray(obj)) {
 				for (const o of obj) {
 					// 实例化一个驱动
-					await this.load_item(dir, o, file);
+					await this.loadItem(dir, o, file);
 				}
 			} else {
-				return await this.load_item(dir, null, file);
+				return await this.loadItem(dir, null, file);
 			}
 		} else if (create) {
-			return await this.load_item(dir, null, file);
+			return await this.loadItem(dir, null, file);
 		} else {
 			return `${file}文件不存在`;
 		}
@@ -520,12 +518,15 @@ Index.prototype.load_file = async function(file, create = false) {
 Index.prototype.run = async function(name, method, ...params) {
 	if (name) {
 		const module = await this.get(name);
-		return module && module.config?.state === 1 ? this._executeMethod(module, method, params) : null;
+		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._executeMethod(module, method, params);
+				result = await this._execute(module, method, params);
 				if (result && module.config?.end) {
 					break;
 				}
@@ -546,11 +547,19 @@ Index.prototype.run = async function(name, method, ...params) {
 Index.prototype.exec = async function(name, method, ...params) {
 	if (name) {
 		const module = await this.get(name);
-		return module ? this._executeMethod(module, method, params) : null;
+		if (module) {
+			return await this._execute(module, method, params);
+		}
+		return null;
 	} else if (name === null) {
+		let result = null;
 		for (const module of this.list) {
-			await this._executeMethod(module, method, params);
+			result = await this._execute(module, method, params);
+			if (result && module.config?.end) {
+				break;
+			}
 		}
+		return result;
 	}
 	return null;
 };

package/item.js

@@ -115,7 +115,7 @@ class Item {
  * 设置配置
  * @param {Object} config 配置对象
  */
-Item.prototype.set_config = function (config) {
+Item.prototype.setConfig = function (config) {
 	if (!config) return;
 
 	// 如果func_file改变，重置加载状态
@@ -130,7 +130,7 @@ Item.prototype.set_config = function (config) {
 /**
  * 设置配置后钩子方法
  */
-Item.prototype.set_config_after = function () {
+Item.prototype.setConfig_after = function () {
 	// 空实现，供子类重写
 };
 
@@ -138,8 +138,8 @@ Item.prototype.set_config_after = function () {
  * 新建脚本文件
  * @param {String} file 目标文件路径
  */
-Item.prototype.new_script = function (file) {
-	const templateFile = `${this.dir_base}/script.js`;
+Item.prototype.newScript = function (file) {
+	const templateFile = './script.js'.fullname(this.dir_base);
 	if (templateFile.hasFile()) {
 		templateFile.copyFile(file);
 	}
@@ -149,7 +149,7 @@ Item.prototype.new_script = function (file) {
  * 移除模块
  * @param {Object|String} module 模块对象或路径
  */
-Item.prototype.remove_module = function (module) {
+Item.prototype._remove = function (module) {
 	if (!module) return;
 
 	try {
@@ -171,9 +171,9 @@ Item.prototype.remove_module = function (module) {
 
 /**
  * 卸载脚本
- * @param {String} file 文件路径
+ * @param {string} file 脚本文件路径
  */
-Item.prototype.unload_script = function (file) {
+Item.prototype.unloadScript = function (file) {
 	if (!file) {
 		const funcFile = this.config.func_file;
 		if (funcFile) {
@@ -182,18 +182,18 @@ Item.prototype.unload_script = function (file) {
 	}
 
 	if (file) {
-		this.remove_module(file);
+		this._remove(file);
 	}
 
 	this.complete = false;
 };
 
 /**
- * 重载脚本
+ * 重新加载脚本
  */
-Item.prototype.reload_script = function () {
-	this.unload_script();
-	this.load_script();
+Item.prototype.reloadScript = function () {
+	this.unloadScript();
+	this.loadScript();
 };
 
 /**
@@ -209,9 +209,9 @@ Item.prototype.unload = async function () {
  */
 Item.prototype.unload_after = async function (remove) {
 	// 删除脚本
-	this.unload_script();
+	this.unloadScript();
 	if (remove) {
-		this.remove_file();
+		this.removeFile();
 	}
 };
 
@@ -221,13 +221,13 @@ Item.prototype.unload_after = async function (remove) {
  * @param {String} name 函数名
  * @returns {Object|null} 返回加载的模块对象
  */
-Item.prototype.load_script = function (file, name = '') {
+Item.prototype.loadScript = function (file, name = '') {
 	if (!file) {
 		const funcFile = this.config.func_file;
 		if (funcFile) {
 			file = funcFile.fullname(this.dir);
 			if (!file.hasFile()) {
-				this.new_script(file);
+				this.newScript(file);
 			}
 		} else {
 			return null;
@@ -277,8 +277,8 @@ Item.prototype.load_script = function (file, name = '') {
  * 新建配置文件
  * @param {String} file 目标文件路径
  */
-Item.prototype.new_config = function (file) {
-	const templateFile = `${this.dir_base}/config.tpl.json`;
+Item.prototype.newConfig = function (file) {
+	const templateFile = './config.tpl.json'.fullname(this.dir_base);
 	templateFile.copyFile(file);
 };
 
@@ -288,7 +288,7 @@ Item.prototype.new_config = function (file) {
  * @param {String} name 配置项名称
  * @return {Object|null} 配置对象
  */
-Item.prototype.load_file = function (file, name) {
+Item.prototype.loadFile = function (file, name) {
 	let config = null;
 	try {
 		const fullPath = file.fullname(this.dir);
@@ -296,7 +296,7 @@ Item.prototype.load_file = function (file, name) {
 
 		// 如果文件不存在，创建新的配置文件
 		if (!text) {
-			this.new_config(fullPath);
+			this.newConfig(fullPath);
 			text = fullPath.loadText();
 		}
 
@@ -310,18 +310,18 @@ Item.prototype.load_file = function (file, name) {
 								// 在数组中查找匹配的配置项
 								const targetConfig = loadedConfig.find(item => item.name === this.config.name);
 								if (targetConfig) {
-									this.set_config(targetConfig);
-									this.set_config_after();
+									this.setConfig(targetConfig);
+									this.setConfig_after();
 									// 根据模式决定是否重新加载脚本
 									if (this.mode === 3 || this.mode === 4) {
-										this.reload_script();
+										this.reloadScript();
 									}
 								}
 							} else {
-								this.set_config(loadedConfig);
-								this.set_config_after();
+								this.setConfig(loadedConfig);
+								this.setConfig_after();
 								if (this.mode === 3 || this.mode === 4) {
-									this.reload_script();
+									this.reloadScript();
 								}
 							}
 						} catch (err) {
@@ -352,7 +352,7 @@ Item.prototype.load_file = function (file, name) {
 /**
  * 删除目录
  */
-Item.prototype.del_dir = function () {
+Item.prototype.delDir = function () {
 	const funcFile = this.config.func_file;
 	if (funcFile && $.dir && $.dir.del) {
 		$.dir.del(this.dir);
@@ -363,7 +363,7 @@ Item.prototype.del_dir = function () {
  * 删除配置和脚本文件
  * @returns {String|null} 错误消息，如果没有错误则返回null
  */
-Item.prototype.remove_file = function () {
+Item.prototype.removeFile = function () {
 	const name = this.config.name;
 	const file = this.filename;
 
@@ -378,7 +378,7 @@ Item.prototype.remove_file = function () {
 						// 在数组配置中查找并删除指定项
 						const index = config.findIndex(item => item.name === name);
 						if (index !== -1) {
-							this.del_dir();
+							this.delDir();
 							config.splice(index, 1);
 						}
 						// 根据剩余配置决定保存或删除文件
@@ -389,10 +389,10 @@ Item.prototype.remove_file = function () {
 						}
 					} else {
 						// 单个配置直接删除目录
-						this.del_dir();
+						this.delDir();
 					}
 				} else {
-					this.del_dir();
+					this.delDir();
 				}
 			} else {
 				errorMessage = '配置文件不存在';
@@ -410,21 +410,21 @@ Item.prototype.remove_file = function () {
  * @param {Object|String} configData 配置对象或配置路径
  * @param {String} name 配置名称
  */
-Item.prototype.load_config = function (configData, name) {
+Item.prototype.loadConfig = function (configData, name) {
 	let config;
 	try {
 		if (configData) {
 			if (typeof configData === 'string') {
-				config = this.load_file(configData, name);
+				config = this.loadFile(configData, name);
 			} else {
 				config = configData;
 			}
 		} else {
-			config = this.load_file(this.filename, name);
+			config = this.loadFile(this.filename, name);
 		}
 
-		this.set_config(config);
-		this.set_config_after();
+		this.setConfig(config);
+		this.setConfig_after();
 	} catch (err) {
 		$.log.error(`载入配置失败: ${err.message}`);
 	}
@@ -435,7 +435,7 @@ Item.prototype.load_config = function (configData, name) {
  */
 Item.prototype.load_before = async function () {
 	try {
-		const module = this.load_script();
+		const module = this.loadScript();
 		if (module) {
 			this.complete = true;
 		}
@@ -520,7 +520,14 @@ Item.prototype.run = async function (...params) {
  * @returns {Promise<any>} 执行结果
  */
 Item.prototype.exec = async function (method, ...params) {
-	if (!this[method]) {
+	// 优先从加载的模块中获取方法
+	let methodFunc = this._mod && this._mod[method];
+	// 如果模块中没有，再检查实例自身
+	if (!methodFunc) {
+		methodFunc = this[method];
+	}
+	
+	if (!methodFunc) {
 		return null;
 	}
 
@@ -529,9 +536,13 @@ Item.prototype.exec = async function (method, ...params) {
 	try {
 		// 执行前置钩子
 		const beforeMethod = `${method}_before`;
-		if (this[beforeMethod]) {
+		let beforeFunc = this._mod && this._mod[beforeMethod];
+		if (!beforeFunc) {
+			beforeFunc = this[beforeMethod];
+		}
+		if (beforeFunc) {
 			try {
-				result = this[beforeMethod](...params);
+				result = beforeFunc.call(this._mod || this, ...params);
 				if (util.types.isPromise(result)) {
 					result = await result;
 				}
@@ -541,14 +552,18 @@ Item.prototype.exec = async function (method, ...params) {
 		}
 
 		// 执行主方法
-		const methodResult = this[method](...params);
+		const methodResult = methodFunc.call(this._mod || this, ...params);
 		result = util.types.isPromise(methodResult) ? await methodResult : methodResult;
 
 		// 执行后置钩子
 		const afterMethod = `${method}_after`;
-		if (this[afterMethod]) {
+		let afterFunc = this._mod && this._mod[afterMethod];
+		if (!afterFunc) {
+			afterFunc = this[afterMethod];
+		}
+		if (afterFunc) {
 			try {
-				const afterResult = this[afterMethod](result, ...params);
+				const afterResult = afterFunc.call(this._mod || this, result, ...params);
 				if (util.types.isPromise(afterResult)) {
 					const resolvedAfterResult = await afterResult;
 					if (resolvedAfterResult !== undefined) {

package/methods_documentation.md

@@ -0,0 +1,214 @@
+# 方法清单文档
+
+## 1. index.js - Index类方法
+
+### 构造函数
+- **constructor(scope, dir_base)** - 初始化Index类实例
+  - `scope`: 作用域（同时作为检索的后缀名）
+  - `dir_base`: 模块目录
+
+### 私有方法
+- **_execute(module, method, params)** - 执行模块方法
+  - `module`: 模块对象
+  - `method`: 方法名称
+  - `params`: 参数数组
+  - 返回: Promise<any> - 执行结果
+
+### 公共方法
+- **clear()** - 清除接口缓存
+- **load(dir, cg, file)** - 加载项
+  - `dir`: 文件路径
+  - `cg`: 配置参数
+  - `file`: 配置文件
+  - 返回: Promise<Object|null> - 加载的驱动或配置对象
+- **loads(list)** - 加载列表
+  - `list`: 文件列表
+  - 返回: Promise<void>
+- **sort()** - 排序接口列表
+- **update_before(dir)** - 更新前钩子方法
+  - `dir`: 目录路径
+- **update_after(dir)** - 更新后钩子方法
+  - `dir`: 目录路径
+- **updateConfigAll(searchPath, accurate)** - 更新所有配置
+  - `searchPath`: 检索路径
+  - `accurate`: 精准路径标志
+  - 返回: Promise<void>
+- **updateConfigHave(dir)** - 更新已有配置文件
+  - `dir`: 目录路径
+  - 返回: Promise<void>
+- **updateConfig(dir, accurate, clear)** - 更新配置
+  - `dir`: 检索目录
+  - `accurate`: 精准路径标志
+  - `clear`: 是否清除现有配置
+  - 返回: Promise<void>
+- **update_script()** - 更新JS脚本
+  - 返回: Promise<void>
+- **update_main(dir, accurate, loadJS, clear)** - 更新主逻辑
+  - `dir`: 检索路径
+  - `accurate`: 精准路径标志
+  - `loadJS`: 是否加载JS
+  - `clear`: 是否清除现有配置
+  - 返回: Promise<void>
+- **update(dir, accurate, loadJS, clear)** - 完整更新流程
+  - `dir`: 检索路径
+  - `accurate`: 精准路径标志
+  - `loadJS`: 是否加载JS
+  - `clear`: 是否清除现有配置
+- **get(name)** - 查询配置项
+  - `name`: 配置项名称
+  - 返回: Object|null - 配置项对象
+- **set(name, cg)** - 设置配置项
+  - `name`: 配置项名称
+  - `cg`: 配置对象
+  - 返回: Boolean - 是否设置成功
+- **save()** - 保存所有配置
+  - 返回: Boolean - 是否保存成功
+- **add(config)** - 添加插件
+  - `config`: 配置对象
+  - 返回: Promise<Object|null> - 新添加的插件对象
+- **del(name)** - 删除插件
+  - `name`: 插件名称
+  - 返回: Promise<Boolean> - 是否删除成功
+- **load(name)** - 加载插件（重载版本）
+  - `name`: 插件名称
+  - 返回: Promise<Object|null> - 加载的插件对象
+- **unload(name)** - 卸载插件
+  - `name`: 插件名称
+  - 返回: Promise<Boolean> - 是否卸载成功
+- **reload(name)** - 重新加载插件
+  - `name`: 插件名称
+  - 返回: Promise<Object|null> - 重新加载的插件对象
+- **loadFile(file, create)** - 通过文件加载配置
+  - `file`: 文件名
+  - `create`: 不存在则创建标志
+  - 返回: Promise<Object|null|String> - 加载结果
+- **run(name, method, ...params)** - 调用函数
+  - `name`: 模块名
+  - `method`: 函数名
+  - `params`: 参数集合
+  - 返回: Promise<any> - 执行结果
+- **exec(name, method, ...params)** - 执行方法
+  - `name`: 插件名称
+  - `method`: 方法名称
+  - `params`: 参数集合
+  - 返回: Promise<any> - 执行结果
+
+### 属性
+- **Drive** - 默认驱动类，指向Item类
+
+## 2. item.js - Item类方法
+
+### 构造函数
+- **constructor(dir, dir_base)** - 初始化Item类实例
+  - `dir`: 当前目录
+  - `dir_base`: 模块目录
+
+### 私有方法
+- **_remove(module)** - 移除模块
+  - `module`: 模块对象或路径
+
+### 公共方法
+- **setConfig(config)** - 设置配置
+  - `config`: 配置对象
+- **setConfig_after()** - 设置配置后钩子方法
+- **newScript(file)** - 新建脚本文件
+  - `file`: 目标文件路径
+- **unloadScript(file)** - 卸载脚本
+  - `file`: 脚本文件路径
+- **reloadScript()** - 重新加载脚本
+- **unload()** - 卸载钩子方法
+- **unload_after(remove)** - 卸载之后处理
+  - `remove`: 是否删除文件
+- **loadScript(file, name)** - 加载脚本
+  - `file`: 文件路径
+  - `name`: 函数名
+  - 返回: Object|null - 加载的模块对象
+- **newConfig(file)** - 新建配置文件
+  - `file`: 目标文件路径
+- **loadFile(file, name)** - 加载配置文件
+  - `file`: 文件路径
+  - `name`: 配置项名称
+  - 返回: Object|null - 配置对象
+- **delDir()** - 删除目录
+- **removeFile()** - 删除配置和脚本文件
+  - 返回: String|null - 错误消息
+- **loadConfig(configData, name)** - 载入配置
+  - `configData`: 配置对象或配置路径
+  - `name`: 配置名称
+- **load_before()** - 加载前处理
+- **load()** - 加载处理
+- **reload()** - 重载配置和脚本
+- **save()** - 保存配置
+- **main(...params)** - 主要执行函数
+  - `params`: 参数集合
+  - 返回: Promise<any> - 执行结果
+- **run(...params)** - 运行主函数
+  - `params`: 参数集合
+  - 返回: Promise<any> - 执行结果
+- **exec(method, ...params)** - 调用函数（核心执行方法）
+  - `method`: 函数名
+  - `params`: 参数集合
+  - 返回: Promise<any> - 执行结果
+
+## 3. item.js - 全局方法
+
+- **$.require(file, func)** - 增强require函数，支持热更新
+  - `file`: 文件路径
+  - `func`: 回调函数
+  - 返回: Object - 加载的模块
+
+- **$.loadJson(file, func)** - 增强JSON加载函数，支持热更新
+  - `file`: 文件路径
+  - `func`: 回调函数
+  - 返回: Object - 解析的JSON对象
+
+## 方法命名规范检查
+
+### 符合规范的方法名（小驼峰）
+- clear
+- load
+- loads
+- sort
+- updateConfigAll
+- updateConfigHave
+- updateConfig
+- get
+- set
+- save
+- add
+- del
+- unload
+- reload
+- loadFile
+- run
+- exec
+- setConfig
+- newScript
+- unloadScript
+- reloadScript
+- loadScript
+- newConfig
+- loadFile
+- delDir
+- removeFile
+- loadConfig
+- main
+
+### 符合规范的时态方法名
+- update_before
+- update_after
+- setConfig_after
+- unload_after
+- load_before
+
+### 需要注意的方法名
+- **updateScript** - 已从update_script修改为符合小驼峰命名规范
+- **update_main** - 保持不变，因为_main属于时态方法命名格式（main表示主逻辑）
+
+## 重复方法名
+
+在index.js中发现两个同名的load方法：
+1. `load(dir, cg, file)` - 加载项
+2. `load(name)` - 加载插件
+
+建议重命名其中一个以避免混淆。

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mm_machine",
-	"version": "2.0.5",
+	"version": "2.0.7",
 	"description": "这是超级美眉框架机制构建辅助模块，用于快速构建一个机制，支持动态加载、热更新、模块管理等功能，并具有增强的错误处理和现代JavaScript特性支持。",
 	"main": "index.js",
 	"scripts": {

package/test.js

@@ -27,6 +27,10 @@ class Engine extends Index {
 	}
 }
 
+/**
+ * 设置引擎的Drive类
+ * @type {Drive}
+ */
 Engine.prototype.Drive = Drive;
 
 async function demo() {
@@ -37,42 +41,42 @@ async function demo() {
 	console.log("模块数", engine.list.length);
 	// console.log("模块", engine.list);
 
-	await engine.run('demo1', 'init'); // 只有启动状态的插件才会执行
-	await engine.exec('demo1', 'init'); // 未启动也会执行，并且如果未加载脚本则会自动加载
+	await engine.run('test1', 'init'); // 只有启动状态的插件才会执行
+	await engine.exec('test1', 'init'); // 未启动也会执行，并且如果未加载脚本则会自动加载
 	await engine.run(null, 'main');
 	await engine.exec(null, 'main');
 
-	var ret = await engine.run('demo3', 'main');
-	console.log("指明回调demo3", ret);
+	var ret = await engine.run('test2', 'main');
+	console.log("指明回调test2", ret);
 
-	var ret = await engine.exec('demo1', 'main');
-	console.log("指明回调demo1", ret);
+	var ret = await engine.exec('test1', 'main');
+	console.log("指明回调test1", ret);
 
 	var i = 0;
 	var timer = setInterval(async () => {
-		await engine.run('demo1', 'main');
-		await engine.run('demo2', 'main');
+		await engine.run('test1', 'main');
+		await engine.run('test2', 'main');
 		i++;
 		if (i == 3) {
 			console.info("→ 重载mod");
-			await engine.reload("demo1");
+			await engine.reload("test1");
 		} else if (i == 5) {
 			console.info("→ 卸载mod");
-			await engine.unload("demo2");
+			await engine.unload("test2");
 		} else if (i == 16) {
 			console.info("→ 卸载并删除mod");
-			await engine.unload("demo1", true);
+			await engine.unload("test1", true);
 		} else if (i == 18) {
 			clearTimeout(timer);
 		}
 	}, 3000);
 
 	setTimeout(async() => {
-		var file = "./demo/test1/index.js";
+		var file = "./app/test1/index.js";
 		var text = file.loadText();
-		text = text.replace("123", "1234567");
+		text = text.replace("counter = 0", "counter = 100");
 		file.saveText(text);
-		var ret = await engine.exec("demo1", 'main');
+		var ret = await engine.exec("test1", 'main');
 		console.log("这结果", ret);
 	}, 7000)
 
@@ -88,27 +92,27 @@ async function demo() {
 		console.info("→ 热重载失效");
 		$.mod.config.watch = false;
 		// 失效后再加载的模块修改文件没有变化
-		var file = "./demo/test1/index.js";
+		var file = "./app/test1/index.js";
 		var text = file.loadText();
-		text = text.replace("1234567", "7654321");
+		text = text.replace("counter = 100", "counter = 200");
 		file.saveText(text);
-		var ret = await engine.exec("demo1", 'main');
+		var ret = await engine.exec("test1", 'main');
 		console.log("这结果", ret);
 	}, 16000)
 	
 	var n = 0;
 	var timer_2 = setInterval(async () => {
 		// await engine.update(null, false, false, false);
-		var ret = await engine.exec('demo1', 'main');
-		console.info("最后运行demo", ret);
-		var plug = engine.get("demo1");
+		var ret = await engine.exec('test1', 'main');
+		console.info("最后运行test1", ret);
+		var plug = engine.get("test1");
 		if (plug) {
 			console.log("查看变化1", plug.config);
 		}
-		var plug = engine.get("demo3");
+		var plug = engine.get("test2");
 		if (plug) {
 			var ret = await plug.run();
-			console.log("查看变化3", plug.config);
+			console.log("查看变化2", plug.config);
 		}
 		n++;
 		if (n == 6) {

package/test_dir_search.js

@@ -1,108 +0,0 @@
-var { Index } = require('./index.js');
-
-// 创建一个测试用的Index子类
-class TestIndex extends Index {
-  constructor() {
-    super('sys', __dirname);
-    this.type = 'demo';
-  }
-}
-
-// 测试函数
-async function testDirSearch() {
-  console.log('开始测试目录搜索逻辑...');
-  
-  const index = new TestIndex();
-  const searchPath = './app/'.fullname(__dirname);
-  
-  console.log('搜索路径:', searchPath);
-  console.log('type:', index.type);
-  console.log('scope:', index.scope);
-  
-  // 计算search_dir
-  const search_dir = index.scope && index.scope !== $.val?.scope
-    ? `${index.type}_${index.scope}`
-    : index.type;
-  
-  console.log('search_dir:', search_dir);
-  
-  try {
-    // 测试精准模式（accurate=true）
-    console.log('\n测试精准模式（accurate=true）:');
-    const list_scope2 = $.dir.getAll(searchPath);
-    console.log('找到的目录数量:', list_scope2.length);
-    console.log('找到的目录:', list_scope2.map(d => d.toString()));
-    
-    // 测试精准模式下的文件搜索
-    console.log('\n测试精准模式下的文件搜索:');
-    for (const dir of list_scope2) {
-      // 先列出目录中所有文件
-      console.log(`\n目录 ${dir} 中的所有文件:`);
-      const all_files = $.file.getAll(dir);
-      console.log(all_files.map(f => f.toString()));
-      
-      // 测试精确文件名搜索（修改后的模式）
-      console.log(`\n目录 ${dir} 中匹配 ${index.type}.json 的文件:`);
-      const list_file = $.file.getAll(dir, `${index.type}.json`);
-      console.log(list_file.map(f => f.toString()));
-      
-      // 尝试直接列出demo.json文件
-      console.log(`\n检查目录 ${dir} 中的 demo.json 文件:`);
-      const demo_file = `${dir}demo.json`.fullname();
-      console.log(`文件路径: ${demo_file}`);
-      console.log(`文件是否存在: ${demo_file.hasFile ? demo_file.hasFile() : '无法检查'}`);
-      
-      if (demo_file.hasFile && demo_file.hasFile()) {
-        try {
-          const content = demo_file.loadText();
-          console.log(`文件内容长度:`, content ? content.length : 0);
-          if (content) {
-            const json = JSON.parse(content);
-            console.log(`文件解析成功，是否数组:`, Array.isArray(json));
-            if (Array.isArray(json)) {
-              console.log('配置项数量:', json.length);
-              console.log('配置项名称:', json.map(item => item.name));
-            } else if (json) {
-              console.log('配置名称:', json.name);
-            }
-          }
-        } catch (err) {
-          console.error(`读取文件失败:`, err);
-        }
-      }
-    }
-    
-    // 测试非精准模式（accurate=false）
-    console.log('\n测试非精准模式（accurate=false）:');
-    const list_scope1 = $.dir.getAll(searchPath, search_dir);
-    console.log('找到的目录数量:', list_scope1.length);
-    console.log('找到的目录:', list_scope1.map(d => d.toString()));
-    
-    // 测试每个目录中的json文件
-    for (const dir of list_scope1) {
-      const list_file = $.file.getAll(dir, `*${index.type}.json`);
-      console.log(`\n目录 ${dir} 中的json文件:`);
-      console.log(list_file.map(f => f.toString()));
-    }
-    
-  } catch (err) {
-    console.error('测试失败:', err);
-  }
-  
-  // 直接测试update_config_all方法
-  console.log('\n直接测试update_config_all方法:');
-  try {
-    await index.update_config_all(searchPath, false);
-    console.log('update_config_all后模块数量:', index.list.length);
-    if (index.list.length > 0) {
-      console.log('模块信息:', index.list.map(m => m.config.name));
-    }
-  } catch (err) {
-    console.error('update_config_all失败:', err);
-  }
-}
-
-// 运行测试
-testDirSearch().then(() => {
-  console.log('\n测试完成');
-});