mm_machine 2.5.5 → 2.5.6

package/drive.js

@@ -19,7 +19,6 @@ if (!$.prettyCode) {
  * @class
  */
 class Drive extends Mod {
-
   // 配置项
   static config = {
     // 名称, 由中英文和下"_"组成, 用于卸载接口 例如: demo
@@ -109,7 +108,6 @@ Drive.prototype._loadConfig = function (file) {
 /**
  * 加载配置
  * @param {string} file 配置文件路径
- * @returns {object} 配置项
  */
 Drive.prototype.loadConfig = function (file) {
   this._loadConfig(file);
@@ -177,51 +175,6 @@ Drive.prototype._getTplDir = function () {
   return this.getParent().getTplDir();
 };
 
-/**
- * 获取脚本模板
- * @param {string} tpl_dir 模板文件路径
- * @returns {string} 脚本模板内容
- */
-Drive.prototype._getScriptTpl = function () {
-  var f = './script.tpl.js'.fullname(this._getTplDir());
-  if (f.hasFile()) {
-    return f.loadText();
-  } else {
-    return `module.exports = {
-  /**
-   * 初始化
-   */
-  async _init() {
-    this.log('debug', \`初始化！\`);
-  },
-  /**
-   * 启动
-   */
-  async _start() {
-    this.log('debug', \`启动！\`);
-  },
-  /**
-   * 停止
-   */
-  async _stop() {
-    this.log('debug', \`停止！\`);
-  },
-  /**
-   * 销毁
-   */
-  async _destroy(...args) {
-    this.log('debug', \`销毁！\`);
-  },
-  /**
-   * 主要逻辑
-   */
-  async main(...args) {
-    // 主要代码写在这
-  }
-}`;
-  }
-};
-
 /**
  * 移除加载的脚本模块
  */
@@ -301,7 +254,6 @@ Drive.prototype.newScript = function (file) {
 /**
  * 创建脚本
  * @param {string} file 文件路径
- * @param {object} model 模板数据
  * @returns {boolean} 创建是否成功
  */
 Drive.prototype._createScriptFile = function (file) {
@@ -317,7 +269,6 @@ Drive.prototype._createScriptFile = function (file) {
 
 /**
  * 获取脚本模板
- * @param {string} tpl_dir 模板文件路径
  * @returns {string} 脚本模板内容
  */
 Drive.prototype._getScriptTpl = function () {
@@ -332,6 +283,18 @@ Drive.prototype._getScriptTpl = function () {
   async _init() {
     this.log('debug', \`初始化！\`);
   },
+  /**
+   * 启动
+   */
+  async _start() {
+    this.log('debug', \`启动！\`);
+  },
+  /**
+   * 停止
+   */
+  async _stop() {
+    this.log('debug', \`停止！\`);
+  },
   /**
    * 销毁
    */
@@ -346,6 +309,7 @@ Drive.prototype._getScriptTpl = function () {
   }
 }`;
   }
+
 };
 
 /**
@@ -381,17 +345,15 @@ Drive.prototype._setMainMethod = function (mod) {
   if (name && mod[name]) {
     this.main = mod[name];
   }
-
   for (let key in mod) {
     let obj = mod[key];
     if (typeof obj === 'function') {
-      this._methods[key] = obj;
+      this.setMethod(key, obj);
     }
     else {
-      this._datas[key] = obj;
+      this.setData(key, obj);
     }
   }
-  Object.assign(this, mod);
   this.is_loaded = true;
 };
 
@@ -451,7 +413,7 @@ Drive.prototype.prettyCode = function (code, type = 'json5') {
  */
 Drive.prototype.getModel = function (type) {
   return this.config;
-}
+};
 
 /**
  * 创建配置文件
@@ -718,7 +680,7 @@ Drive.prototype.emitEvent = function (event, ...args) {
 /**
  * 注册事件监听
  * @param {string} event 事件名
- * @param {function} callback 事件回调函数
+ * @param {Function} callback 事件回调函数
  */
 Drive.prototype.onEvent = function (event, callback) {
   this.getEventer()?.on(event, callback);

package/index.js

@@ -39,12 +39,12 @@ class Manager extends Mod {
      * 基础目录，加载模块内置资源
      * @type {string}
      */
-    base_dir: '../common/manager'.fullname(__dirname),
+    base_dir: '', // '../common/manager'.fullname(__dirname),
     /**
      * 自定义目录，加载项目自定义资源
      * @type {string}
      */
-    dir: './ai/manager'.fullname(),
+    dir: '', // './ai/manager'.fullname(),
     /**
      * 搜索模式 dir按目录搜索 | file按文件名搜索
      * @type {string}
@@ -204,8 +204,9 @@ Manager.prototype.Drive = Drive;
  */
 Manager.prototype.updateInfo = function () {
   this.infos = [];
-  for (let name in this.mods) {
-    let o = this.mods[name];
+  let mods = this.getMods();
+  for (let name in mods) {
+    let o = mods[name];
     let info = this.newInfo(name, o.config.sort, o.config.state, o.config_file);
     this.infos.push(info);
   }
@@ -232,6 +233,13 @@ Manager.prototype.sort = function () {
 };
 
 // ==== 模块管理接口 ====
+/**
+ * 清除所有模块
+ */
+Manager.prototype.clearMods = function () {
+  $.clear(this.mods);
+};
+
 /**
  * 删除模块
  * @param {string} name 模块名
@@ -392,8 +400,9 @@ Manager.prototype.registerMods = function (files, config = {}, script = {}) {
  */
 Manager.prototype.loadMods = async function () {
   var promises = [];
-  for (let name in this.mods) {
-    let mod = this.mods[name];
+  let mods = this.getMods();
+  for (let name in mods) {
+    let mod = mods[name];
     promises.push(mod.do('load'));
   }
   await Promise.all(promises);
@@ -458,8 +467,9 @@ Manager.prototype._findFiles = function (dir) {
  */
 Manager.prototype.loadScripts = async function () {
   var promises = [];
-  for (let name in this.mods) {
-    let mod = this.mods[name];
+  let mods = this.getMods();
+  for (let name in mods) {
+    let mod = mods[name];
     promises.push(mod.call('loadScript'));
   }
   await Promise.all(promises);
@@ -486,8 +496,7 @@ Manager.prototype.updateAfter = function () {
  */
 Manager.prototype.update = async function (dir, clear = true) {
   if (clear) {
-    // 初始化方法
-    $.clear(this.mods);
+    this.clearMods();
   }
 
   // 查找所有json文件
@@ -623,10 +632,11 @@ Manager.prototype._initCore = async function () {
 };
 
 /**
- * 执行方法
+ * 执行方法 - 内部方法
+ * @param {string} mod 模块对象
  * @param {string} method 方法名称
- * @param {...object} params 参数列表
- * @returns {object} 返回执行结果
+ * @param {...any} params 参数列表
+ * @returns {any} 返回执行结果
  */
 Manager.prototype._exec = async function (mod, method, ...params) {
   if (mod[method]) {
@@ -639,14 +649,18 @@ Manager.prototype._exec = async function (mod, method, ...params) {
 
 /**
  * 执行方法
+ * @param {string} name 模块名
  * @param {string} method 方法名称
- * @param  {...any} params 参数列表
- * @returns {object} 返回执行结果
+ * @param {...any} params 参数列表
+ * @returns {any} 返回执行结果
  */
 Manager.prototype.exec = async function (name, method, ...params) {
   let ret;
   try {
     let mod = this.getMod(name);
+    if (!mod) {
+      throw new Error(`模块${name}不存在`);
+    }
     ret = await this._exec(mod, method, ...params);
   }
   catch (error) {
@@ -659,7 +673,7 @@ Manager.prototype.exec = async function (name, method, ...params) {
  * 确保所有模块都已加载
  * @returns {Promise} 加载完成
  */
-Manager.prototype._ensureAllModulesLoaded = async function () {
+Manager.prototype._ensureAllLoaded = async function () {
   let infos = this.getInfos();
 
   for (let i = 0; i < infos.length; i++) {
@@ -733,7 +747,7 @@ Manager.prototype.runAsync = async function (method, ...params) {
   }
 
   // 确保所有模块都已加载
-  await this._ensureAllModulesLoaded();
+  await this._ensureAllLoaded();
 
   let infos = this.getInfos();
 
@@ -764,7 +778,7 @@ Manager.prototype.runAll = async function (method, ...params) {
   }
 
   // 确保所有模块都已加载
-  await this._ensureAllModulesLoaded();
+  await this._ensureAllLoaded();
 
   const promises = [];
   let infos = this.getInfos();
@@ -797,7 +811,7 @@ Manager.prototype.runRace = async function (method, ...params) {
   }
 
   // 确保所有模块都已加载
-  await this._ensureAllModulesLoaded();
+  await this._ensureAllLoaded();
 
   const promises = [];
   let infos = this.getInfos();
@@ -872,7 +886,7 @@ Manager.prototype.emitEvent = function (event, ...args) {
 /**
  * 注册事件监听
  * @param {string} event 事件名
- * @param {function} callback 事件回调函数
+ * @param {Function} callback 事件回调函数
  */
 Manager.prototype.onEvent = function (event, callback) {
   this.getEventer()?.on(event, callback);

package/mod.js

@@ -12,11 +12,11 @@ require('mm_hot_reload');
 $.require = function (file, func) {
   // 参数校验
   if (typeof file !== 'string') {
-    throw new TypeError('文件路径必须是字符串');
+    throw new TypeError('第一个参数(file)必须是字符串');
   }
 
   if (func && typeof func !== 'function') {
-    throw new TypeError('回调函数必须是函数');
+    throw new TypeError('第二个参数(func)必须是函数');
   }
 
   // 确保文件是.js文件
@@ -38,11 +38,11 @@ $.require = function (file, func) {
 $.loadJson = function (file, func) {
   // 参数校验
   if (typeof file !== 'string') {
-    throw new TypeError('文件路径必须是字符串');
+    throw new TypeError('第一个参数(file)必须是字符串');
   }
 
   if (func && typeof func !== 'function') {
-    throw new TypeError('回调函数必须是函数');
+    throw new TypeError('第二个参数(func)必须是函数');
   }
 
   // 确保文件是.json文件
@@ -65,7 +65,11 @@ class Mod extends Base {
     // 模块描述
     description: '',
     // 状态, 可选值: 1-启用, 0-禁用
-    state: 1
+    state: 1,
+    // 是否需要缓存数据
+    need_cache: false,
+    // 缓存文件路径
+    cache_file: ''
   };
 
   /**
@@ -244,30 +248,36 @@ Mod.prototype._onDestroy = async function (ctx) {
 
 /**
  * 加载 - 内部方法
+ * @param {...any} args 加载参数
+ * @returns {object} 模块对象
  * @private
  */
-Mod.prototype._load = async function () {
+Mod.prototype._load = async function (...args) {
   return this;
 };
 
 /**
  * 加载
+ * @param {...any} args 加载参数
+ * @returns {object} 模块对象
  */
-Mod.prototype.load = async function () {
-  return await this._load();
+Mod.prototype.load = async function (...args) {
+  return await this._load(...args);
 };
 
 /**
  * 加载核心
+ * @private
+ * @param {...any} args 加载参数
  */
-Mod.prototype._loadCore = async function () {
-
+Mod.prototype._loadCore = async function (...args) {
 };
 
 /**
  * 启动 - 内部方法
  * @private
  * @param {...any} args 初始化参数
+ * @returns {object} 模块对象
  */
 Mod.prototype._start = async function (...args) {
   return this;
@@ -275,6 +285,8 @@ Mod.prototype._start = async function (...args) {
 
 /**
  * 启动
+ * @param {...any} args 初始化参数
+ * @returns {object} 模块对象
  */
 Mod.prototype.start = async function (...args) {
   return await this._start(...args);
@@ -283,14 +295,16 @@ Mod.prototype.start = async function (...args) {
 /**
  * 启动核心
  * @private
+ * @param {...any} args 初始化参数
  */
-Mod.prototype._startCore = async function () {
+Mod.prototype._startCore = async function (...args) {
 
 };
 
 /**
  * 停止 - 内部方法
  * @private
+ * @returns {object} 模块对象
  */
 Mod.prototype._stop = async function () {
   return this;
@@ -298,6 +312,7 @@ Mod.prototype._stop = async function () {
 
 /**
  * 停止
+ * @returns {object} 模块对象
  */
 Mod.prototype.stop = async function () {
   return await this._stop();
@@ -314,6 +329,7 @@ Mod.prototype._stopCore = async function () {
 /**
  * 卸载 - 内部方法
  * @private
+ * @returns {object} 模块对象
  */
 Mod.prototype._unload = async function () {
   return this;
@@ -321,6 +337,7 @@ Mod.prototype._unload = async function () {
 
 /**
  * 卸载
+ * @returns {object} 模块对象
  */
 Mod.prototype.unload = async function () {
   return await this._unload();
@@ -379,7 +396,7 @@ Mod.prototype.end = async function () {
 
 /**
  * 获取事件管理器
- * @returns {Eventer|null} 事件管理器
+ * @returns {object} 事件管理器
  */
 Mod.prototype.getEventer = function () {
   return this._eventer || $.eventer;
@@ -387,7 +404,7 @@ Mod.prototype.getEventer = function () {
 
 /**
  * 设置事件管理器
- * @param {Eventer} eventer 事件管理器
+ * @param {object} eventer 事件管理器
  */
 Mod.prototype.setEventer = function (eventer) {
   this._eventer = eventer;
@@ -422,13 +439,15 @@ Mod.prototype.main = async function (...args) {
  * @param {object} methods 脚本方法对象
  */
 Mod.prototype.setMethods = function (methods) {
+  if (typeof methods !== 'object') {
+    throw new Error(`参数(methods)必须是对象`);
+  }
   if (!methods) return;
   if (!this._methods) {
     this._methods = {};
   }
-  Object.assign(this._methods, methods);
-  for (let key in this._methods) {
-    this[key] = this._methods[key];
+  for (let key in methods) {
+    this.setMethod(key, methods[key]);
   }
 };
 
@@ -438,25 +457,36 @@ Mod.prototype.setMethods = function (methods) {
  * @param {Function} func 方法函数
  */
 Mod.prototype.setMethod = function (method, func) {
-  if (!func) throw new Error(`函数(func)不能为空`);
+  if (typeof method !== 'string') {
+    throw new Error(`第一个参数(method)必须是字符串`);
+  }
+  if (method === '_datas') {
+    throw new Error(`第一个参数(method)不能为_datas键`);
+  }
+  if (method === '_methods') {
+    throw new Error(`第一个参数(method)不能为_methods键`);
+  }
+  if (!func) throw new Error(`第二个参数(func)不能为空`);
+  if (typeof func !== 'function') {
+    throw new Error(`第二个参数(func)必须是函数`);
+  }
   if (!this._methods) {
     this._methods = {};
   }
-  this._methods[method] = func;
-  this[method] = this._methods[method];
+  this._methods[method] = true;
+  this[method] = func;
 };
 
 /**
  * 获取方法函数
  * @param {string} method 方法名
- * @returns {Function|null} 方法函数
+ * @returns {Function} 方法函数
  */
 Mod.prototype.getMethod = function (method) {
-  let func = this._methods[method];
-  if (!func) {
-    func = this[method];
+  if (typeof method !== 'string') {
+    throw new Error(`第一个参数(method)必须是字符串`);
   }
-  return func;
+  return this[method];
 };
 
 /**
@@ -464,7 +494,20 @@ Mod.prototype.getMethod = function (method) {
  * @returns {object} 数据对象
  */
 Mod.prototype.getDatas = function () {
-  return this._datas;
+  let datas = this._datas;
+  let result = {};
+  for (let key in datas) {
+    result[key] = this[key];
+  }
+  return result;
+};
+
+/**
+ * 获取数据
+ * @returns {object} 数据对象
+ */
+Mod.prototype.getData = function (key) {
+  return this[key];
 };
 
 /**
@@ -472,12 +515,14 @@ Mod.prototype.getDatas = function () {
  * @param {object} datas 数据对象
  */
 Mod.prototype.setDatas = function (datas) {
+  if (typeof datas !== 'object') {
+    throw new Error(`参数(datas)必须是对象`);
+  }
   if (!this._datas) {
     this._datas = {};
   }
-  Object.assign(this._datas, datas);
-  for (let key in this._datas) {
-    this[key] = this._datas[key];
+  for (let key in datas) {
+    this.setData(key, datas[key]);
   }
 };
 
@@ -487,10 +532,41 @@ Mod.prototype.setDatas = function (datas) {
  * @param {*} value 数据值
  */
 Mod.prototype.setData = function (key, value) {
-  this._datas[key] = value;
+  if (typeof key !== 'string') {
+    throw new Error(`第一个参数(key)必须是字符串`);
+  }
+  if (key === '_datas') {
+    throw new Error(`第一个参数(key)不能为_datas键`);
+  }
+  if (key === '_methods') {
+    throw new Error(`第一个参数(key)不能为_methods键`);
+  }
+  if (value === undefined || value === null) throw new Error(`第二个参数(value)不能为undefined或null`);
+  if (typeof value == 'function') {
+    throw new Error(`第二个参数(value)不能为函数`);
+  }
+  this._datas[key] = typeof (value);
   this[key] = value;
 };
 
+/**
+ * 保存数据
+ */
+Mod.prototype.saveDatas = function () {
+  let datas = this.getDatas();
+  let file = this.config.cache_file || './cache.json'.fullname(__dirname);
+  file.saveJson(datas);
+};
+
+/**
+ * 加载数据
+ */
+Mod.prototype.loadDatas = function () {
+  let file = this.config.cache_file || './cache.json'.fullname(__dirname);
+  let datas = file.loadJson();
+  this.setDatas(datas);
+};
+
 /**
  * 调用函数（核心执行方法）
  * @param {string} method 函数名
@@ -572,6 +648,18 @@ Mod.prototype._callAfter = async function (method, params, result) {
   }
 };
 
+/**
+ * 销毁核心
+ * @returns {object} 返回当前对象
+ */
+Mod.prototype._destroyCore = async function () {
+  if(this.config.save_cache) {
+    this.saveDatas();
+  }
+  this._datas = {};
+  this._methods = {};
+};
+
 module.exports = {
   Mod
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mm_machine",
-  "version": "2.5.5",
+  "version": "2.5.6",
   "description": "A flexible Node.js plugin mechanism system for dynamic loading, management and execution of modules. Supports hot reload, lifecycle management, and modern JavaScript features.",
   "main": "index.js",
   "scripts": {