mm_machine 2.8.1 → 2.8.2

package/index.js

@@ -79,7 +79,17 @@ class Manager extends Mod {
      * 作用域
      * @type {string}
      */
-    scope: $.val && $.val.scope ? $.val.scope + '' : 'server'
+    scope: $.val && $.val.scope ? $.val.scope + '' : 'server',
+    /**
+     * 是否启用快照加速
+     * @type {boolean}
+     */
+    use_snapshot: true,
+    /**
+     * 快照文件路径
+     * @type {string}
+     */
+    snapshot_file: './snapshot.json'
   };
 
   /**
@@ -102,8 +112,6 @@ class Manager extends Mod {
     this.infos = [];
     // 模块
     this.mods = mods;
-    // getList 缓存
-    this._list_cache = null;
     if (Drive) {
       this.Drive = Drive;
     }
@@ -156,7 +164,6 @@ Manager.prototype.newInfo = function (name, sort, state, file = '') {
  * @param {object} info 模块信息
  */
 Manager.prototype.setInfo = function (info) {
-  this._list_cache = null;
   let has = false;
   for (let i = 0; i < this.infos.length; i++) {
     let o = this.infos[i];
@@ -176,17 +183,15 @@ Manager.prototype.setInfo = function (info) {
  * @returns {object[]} 模块对象数组
  */
 Manager.prototype.getList = function () {
-  if (this._list_cache) return this._list_cache;
-  var list = [];
-  for (var i = 0; i < this.infos.length; i++) {
-    var info = this.infos[i];
-    var mod = this.getMod(info.name);
+  let list = [];
+  for (let i = 0; i < this.infos.length; i++) {
+    let info = this.infos[i];
+    let mod = this.getMod(info.name);
     if (mod) {
       mod.config.state = info.state;
     }
     list.push(mod);
   }
-  this._list_cache = list;
   return list;
 };
 
@@ -215,7 +220,6 @@ Manager.prototype.Drive = Drive;
  * 更新模块信息
  */
 Manager.prototype.updateInfo = function () {
-  this._list_cache = null;
   this.infos = [];
   let mods = this.getMods();
   for (let name in mods) {
@@ -242,7 +246,6 @@ Manager.prototype._sort = function () {
  * 排序
  */
 Manager.prototype.sort = function () {
-  this._list_cache = null;
   this._sort();
 };
 
@@ -251,7 +254,6 @@ Manager.prototype.sort = function () {
  * 清除所有模块
  */
 Manager.prototype.clearMods = function () {
-  this._list_cache = null;
   for (let name in this.mods) {
     delete this.mods[name];
   }
@@ -263,7 +265,6 @@ Manager.prototype.clearMods = function () {
  * @returns {object|null} 删除的模块对象
  */
 Manager.prototype.delMod = function (name) {
-  this._list_cache = null;
   let mod = this.mods[name];
   if (mod) {
     delete this.mods[name];
@@ -278,7 +279,6 @@ Manager.prototype.delMod = function (name) {
  * @returns {object|null} 设置的模块对象
  */
 Manager.prototype.setMod = function (name, mod) {
-  this._list_cache = null;
   this.mods[name] = mod;
   return this.getMod(name);
 };
@@ -477,6 +477,149 @@ Manager.prototype._findFiles = async function (dir) {
   return await $.file.getAllAsync(dir, this.config.filename);
 };
 
+/**
+ * 获取快照文件路径
+ * @returns {string} 快照文件完整路径
+ */
+Manager.prototype.getSnapshotPath = function () {
+  var snapshot_file = this.config.snapshot_file || './snapshot.json';
+  return snapshot_file.fullname(__dirname);
+};
+
+/**
+ * 保存快照数据
+ * @param {object} files_map 目录到文件列表的映射 { dir: [file_path, ...] }
+ */
+Manager.prototype._saveSnapshot = function (files_map) {
+  try {
+    var snapshot_path = this.getSnapshotPath();
+    var snapshot = {
+      files_map: files_map,
+      updated_at: Date.now()
+    };
+    snapshot_path.saveJson(snapshot);
+  } catch (err) {
+    this.log('error', '保存快照失败', err);
+  }
+};
+
+/**
+ * 加载快照数据
+ * @returns {object|null} 快照数据，不存在时返回null
+ */
+Manager.prototype._loadSnapshot = function () {
+  try {
+    var snapshot_path = this.getSnapshotPath();
+    if (!snapshot_path.hasFile()) {
+      return null;
+    }
+    var snapshot = snapshot_path.loadJson();
+    if (!snapshot || !snapshot.files_map) {
+      return null;
+    }
+    return snapshot;
+  } catch (err) {
+    this.log('error', '加载快照失败', err);
+    return null;
+  }
+};
+
+/**
+ * 从快照快速加载模块，不进行文件系统扫描
+ * @param {object} files_map 目录到文件列表的映射
+ * @param {boolean} clear 是否清除已有模块
+ */
+Manager.prototype._loadFromSnapshot = function (files_map, clear = true) {
+  if (clear) {
+    this.clearMods();
+  }
+  for (var dir in files_map) {
+    var files = files_map[dir];
+    if (files && files.length > 0) {
+      this.registerMods(files);
+    }
+  }
+  this.updateInfo();
+  this.is_loaded = true;
+};
+
+/**
+ * 后台增量同步：扫描文件系统并与快照进行diff，增减模块
+ * @param {object} snapshot 快照数据
+ */
+Manager.prototype._syncFromFile = async function (snapshot) {
+  try {
+    var old_dirs = snapshot.files_map || {};
+    var old = this._buildSet(old_dirs);
+
+    // 扫描目录并注册新模块
+    for (var dir in old_dirs) {
+      var current = await this._findFiles(dir);
+      for (var fi = 0; fi < current.length; fi++) {
+        var f = current[fi];
+        if (!old[f]) {
+          this.registerMod(f);
+          this.log('info', '快照同步: 新增模块 ' + f);
+        }
+        old[f] = false;
+      }
+    }
+
+    // 移除已删除的模块
+    this._removeStale(old);
+    this.updateInfo();
+    await this._saveSnapshotDirs(Object.keys(old_dirs));
+  } catch (err) {
+    this.log('error', '快照增量同步失败', err);
+  }
+};
+
+/**
+ * 构建文件集合
+ * @param {object} dirs 目录到文件列表的映射
+ * @returns {object} 文件集合 { file: true }
+ */
+Manager.prototype._buildSet = function (dirs) {
+  var set = {};
+  for (var dir in dirs) {
+    var files = dirs[dir];
+    for (var i = 0; i < files.length; i++) {
+      set[files[i]] = true;
+    }
+  }
+  return set;
+};
+
+/**
+ * 移除已删除的模块
+ * @param {object} old 旧文件集合，标记为false表示仍存在
+ */
+Manager.prototype._removeStale = function (old) {
+  for (var file in old) {
+    if (old[file] === true) {
+      var mod = this.getMod(file);
+      if (mod) {
+        this.unloadMod(mod.config.name);
+        this.delMod(mod.config.name);
+        this.log('info', '快照同步: 移除模块 ' + file);
+      }
+    }
+  }
+};
+
+/**
+ * 保存快照目录
+ * @param {string[]} dirs 目录列表
+ */
+Manager.prototype._saveSnapshotDirs = async function (dirs) {
+  var new_dirs = {};
+  for (var i = 0; i < dirs.length; i++) {
+    var dir = dirs[i];
+    new_dirs[dir] = await this._findFiles(dir);
+  }
+  this._saveSnapshot(new_dirs);
+};
+
 /**
  * 加载所有模块的脚本
  */
@@ -514,8 +657,9 @@ Manager.prototype.update = async function (dir, clear = true) {
     this.clearMods();
   }
 
+  var search_dir = dir || this.config.dir;
   // 查找所有json文件
-  let files = await this._findFiles(dir || this.config.dir);
+  var files = await this._findFiles(search_dir);
   // 批量注册模块
   this.registerMods(files);
   // 更新配置信息
@@ -634,14 +778,38 @@ Manager.prototype.getDir = function () {
  * 加载资源
  */
 Manager.prototype._loadSources = async function () {
-  // 通过更新函数加载资源信息
-  let base_dir = this.getBaseDir();
-  let dir = this.getDir();
+  var base_dir = this.getBaseDir();
+  var dir = this.getDir();
+
+  // 启用快照加速时，优先从快照加载
+  if (this.config.use_snapshot) {
+    var snapshot = this._loadSnapshot();
+    if (snapshot) {
+      // 快照存在，快速加载模块
+      this._loadFromSnapshot(snapshot.files_map);
+      this.log('info', '已从快照快速加载模块，正在后台同步文件变更...');
+      // 异步增量同步，不阻塞启动
+      this._syncFromFile(snapshot);
+      return;
+    }
+  }
+
+  // 无快照时走正常流程
   if (base_dir) {
-    await this.call('update', base_dir);
+    await this.call('update', base_dir, true);
     await this.call('update', dir, false);
   } else {
-    await this.call('update', dir);
+    await this.call('update', dir, true);
+  }
+
+  // 首次扫描后保存快照
+  if (this.config.use_snapshot) {
+    var files_map = {};
+    if (base_dir) {
+      files_map[base_dir] = await this._findFiles(base_dir);
+    }
+    files_map[dir] = await this._findFiles(dir);
+    this._saveSnapshot(files_map);
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mm_machine",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "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": {
@@ -34,9 +34,9 @@
   ],
   "dependencies": {
     "@prettier/sync": "^0.6.1",
-    "mm_config": "^2.4.2",
-    "mm_hot_reload": "^1.3.9",
-    "mm_tpl": "^2.6.1"
+    "mm_config": "^2.4.3",
+    "mm_hot_reload": "^1.4.0",
+    "mm_tpl": "^2.6.2"
   },
   "devDependencies": {
     "eslint": "^10.6.0",