mm_machine 5.0.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +14 -2
  2. package/lib/manager.js +36 -18
  3. package/package.json +6 -4
package/README.md CHANGED
@@ -498,9 +498,9 @@ mm_machine 模块系统基于以下核心设计理念:
498
498
 
499
499
  `update(dir)` 完成后会对检索目录开启一次递归监听(经 mm_loader 的 `Loader.watch`,配置文件与 `.js` 脚本的变更按扩展名分流):
500
500
 
501
- - 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.use_scope || 'os')`),避免重复扫描、重复监听与重复加载
501
+ - 所有管理器默认共享 mm_loader 的同一个加载器实例(`loadAdmin(config.load_scope || 'app')`),避免重复扫描、重复监听与重复加载
502
502
  - 管理器把自己的清单文件名登记为加载器类型:类型键为文件名去掉 `.json` 后缀(`manager.json` → `manager`),已存在的类型不覆盖
503
- - 需要独立加载器时,用 `use_scope` 指定另一共享作用域(按 `scope@目录` 派生独立实例)
503
+ - 需要独立加载器时,用 `load_scope` 指定另一加载器名(一个名称对应一个目录,实例即 `Loader.<load_scope>`)
504
504
 
505
505
  | 变更 | 模式要求 | 行为 |
506
506
  | --- | --- | --- |
@@ -576,6 +576,18 @@ mm_machine 模块系统基于以下核心设计理念:
576
576
 
577
577
  ## 更新日志
578
578
 
579
+ ### 6.0.0
580
+
581
+ - 加载器实例键改为 `load_scope`(即 `Loader.name`),不再拼接 `@目录`:同一应用目录共用一个加载器,其他目录请配置不同的 `load_scope`(如 `data`)。
582
+ - `_findFiles` 改为「扫描一次 + 按类型取切片」:先 `loader.ensureScanned()`,再从 `typeStore(type)` 读取加载器扫描根下的条目,按文件名与目标子目录过滤,多个管理器不再各自扫描。
583
+ - 依赖升级:`mm_loader ^7.0.0`、新增 `mm_scanner ^5.0.0` 与 `mm_store ^1.0.1`。
584
+ - 移除未使用的 `use_scope` 配置,加载器实例共享统一由 `load_scope` 控制。
585
+
586
+ ### 5.0.1
587
+
588
+ - 配置加载依赖升级到 `mm_loader@^4.0.1`:该版本修复了 `load()` 在 JSON5 解析之外额外对整串 `{表达式}` 做模板字段求值的 BUG,现在 `load()` 只委托 `mm_helper.loadJson` 把配置读成对象,花括号内容一律原样保留。
589
+ - 本模块源码无需改动:`_readModConfig` 本就通过 `_getLoader().load()` 加载配置,**配置加载职责保持在 mm_machine 这一层**。子类(如 `mm_mcps`)不必覆盖 `_readModConfig`,也不必直接依赖 `mm_loader`;运行时内变量由各业务模块在消费配置时自行解析。
590
+
579
591
  ### v4.1.0
580
592
 
581
593
  - 配置加载器改为共享:`_getLoader()` 默认取 mm_loader 实例池中的同一个 `Loader`(`loadAdmin(config.use_scope || 'os')`),不再为每个管理器各建实例
package/lib/manager.js CHANGED
@@ -2,6 +2,7 @@ const path = require('path');
2
2
  const { Manager: Core } = require('mm_mod');
3
3
  const { hasDir, hasFile, fullname, basename, dirname, string } = require('mm_helper');
4
4
  const { loadAdmin } = require('mm_loader');
5
+ const { typeStore } = require('mm_scanner');
5
6
  const { Mod, addMethods } = require('./mod.js');
6
7
  const { Drive, MODE } = require('./drive.js');
7
8
  const { resolveScriptFile, reloadScript } = require('./script_protocol.js');
@@ -16,6 +17,19 @@ function _normPath(file) {
16
17
  return path.resolve(String(file)).toLowerCase();
17
18
  }
18
19
 
20
+ /**
21
+ * 判断文件是否位于指定目录内(含子目录)
22
+ * @description 加载器按应用根目录扫描,管理器只处理自己目录范围内的清单
23
+ * @param {string} file 文件路径
24
+ * @param {string} dir 目录绝对路径
25
+ * @returns {boolean} 位于目录内返回 true
26
+ * @private
27
+ */
28
+ function _inDir(file, dir) {
29
+ const rel = path.relative(dir, file);
30
+ return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
31
+ }
32
+
19
33
  /**
20
34
  * 失效单个脚本文件的 require 缓存
21
35
  * @description 文件不存在或从未加载时静默跳过
@@ -107,10 +121,10 @@ class Manager extends Core {
107
121
  */
108
122
  scope: 'server',
109
123
  /**
110
- * 共享实例作用域,取用其他模块 xxxAdmin 实例时使用(loadAdmin 等),缺省 'os'
124
+ * 共享加载器作用域,取用 loadAdmin 实例时使用,缺省 'app'
111
125
  * @type {string}
112
126
  */
113
- use_scope: '',
127
+ load_scope: 'app',
114
128
  /**
115
129
  * 忽略目录数组
116
130
  * @type {Array}
@@ -223,27 +237,27 @@ Manager.prototype.getTplDir = function () {
223
237
 
224
238
  /**
225
239
  * 获取配置加载器
226
- * @description 直接取 mm_loader 实例池中的共享 Loader(键为 use_scope@目录,缺省 'os'),
227
- * 同目录同作用域天然是同一个实例,本管理器不再另存一份引用;
228
- * 一个加载器只负责一个目录,不同目录由实例池各自派生;
229
- * use_scope 一并写入加载器配置,使加载器下传的扫描器与监听器落在同一作用域。
240
+ * @description 直接取 mm_loader 实例池中的共享 Loader(键为 load_scope,缺省 'app'),
241
+ * 同一加载器名天然是同一个实例,本管理器不再另存一份引用;
242
+ * 一个加载器只负责一个目录,多目录请为每个目录配置不同的 load_scope;
243
+ * load_scope 即加载器实例键(Loader.name),与内核创建的实例同名即共享。
230
244
  * 并把本管理器清单类型登记进该实例:类型键为 filename 去掉 .json 后缀
231
245
  * (manager.json → manager,与默认 app → app.json 同构),已存在的类型不覆盖;
232
246
  * 脚本监听由 _watchDir 是否传 script_callback 决定(回调驱动),不再配置实例
233
- * @param {string} [dir] 检索目录,缺省回退 config.dir
247
+ * @param {string} [dir] 检索目录,用于首次创建实例时确定扫描根目录,缺省回退 config.dir
234
248
  * @returns {Loader} 配置加载器
235
249
  * @private
236
250
  */
237
251
  Manager.prototype._getLoader = function (dir) {
238
- const scope = this.config.use_scope || 'os';
252
+ const scope = this.config.load_scope || 'app';
239
253
  const target = dir || this.config.dir || '';
240
254
  const key = target ? path.resolve(target) : '';
241
- const loader = loadAdmin(scope, { dir: key, use_scope: scope });
255
+ const loader = loadAdmin(scope, key ? { dir: key } : {});
242
256
  const filename = this.config.filename;
243
257
  if (filename) {
244
258
  const type = filename.replace(/\.json$/i, '');
245
259
  if (type && !loader.config.resources[type]) {
246
- loader.addType(type, filename, false);
260
+ loader.addType(type, filename);
247
261
  }
248
262
  }
249
263
  return loader;
@@ -338,7 +352,6 @@ Manager.prototype._readModConfig = function (config_file, config = {}) {
338
352
  }
339
353
  // 归属信息:app 为所属应用(声明值优先,兼作注册域),plugin 为所属插件(应用级资源为空),
340
354
  // scope 为注册域(与管理器域一致的推导口径,即该资源配置到 require(module).admin 的哪个域)。
341
- // 旧版 update(dir) 全量扫描注册(如 xxx_web 网关镜像)不经过 load_resources/_addResource,
342
355
  // 归属信息统一在这里兜底注入
343
356
  if (config_file) {
344
357
  const norm_path = String(config_file).replace(/\\/g, '/');
@@ -566,6 +579,8 @@ Manager.prototype.update = async function (dir, clear = true) {
566
579
 
567
580
  /**
568
581
  * 检索目录下所有文件
582
+ * @description 扫描只做一次:加载器已扫描时直接复用类型 Store 中的分类结果,
583
+ * 再按管理器的清单文件名精确过滤,不再重复遍历目录
569
584
  * @private
570
585
  * @param {string} dir 目录路径
571
586
  * @returns {Array} 文件路径数组
@@ -578,14 +593,17 @@ Manager.prototype._findFiles = async function (dir) {
578
593
  if (!hasDir(dir)) {
579
594
  return [];
580
595
  }
581
- // scan 是物理扫描唯一入口:每次都拿最新清单(mm_scanner 缓存无变化时不重复遍历),
582
- // update 语义要求看到新增/删除的文件
583
- let files = this._getLoader(dir).scan();
596
+ let loader = this._getLoader(dir).ensureScanned();
584
597
  let filename = this.config.filename;
585
598
  if (!filename) {
586
- return files;
599
+ return loader.files;
587
600
  }
588
- return files.filter((file) => basename(file) === filename);
601
+ let type = filename.replace(/\.json$/i, '');
602
+ let scope = path.resolve(dir);
603
+ return typeStore(type)
604
+ .list({ root: loader.config.dir })
605
+ .filter((one) => one.name === filename && _inDir(one.file, scope))
606
+ .map((one) => one.file);
589
607
  };
590
608
 
591
609
  // ==== 目录监听 ====
@@ -604,11 +622,11 @@ Manager.prototype._watchDir = function (dir) {
604
622
  let hot = this._isScriptHot();
605
623
  let loader = this._getLoader(dir);
606
624
  let config_callback = (changes) => {
607
- this._applyChanges(changes);
625
+ this._applyChanges(changes.filter((one) => _inDir(one.file, dir)));
608
626
  };
609
627
  let script_callback = hot
610
628
  ? (changes) => {
611
- this._applyScriptChanges(changes);
629
+ this._applyScriptChanges(changes.filter((one) => _inDir(one.file, dir)));
612
630
  }
613
631
  : undefined;
614
632
  let success = loader.watch(config_callback, script_callback);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
- "name": "mm_machine",
3
- "version": "5.0.0",
2
+ "name": "mm_machine",
3
+ "version": "6.0.0",
4
4
  "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.",
5
5
  "main": "index.js",
6
6
  "scripts": {
@@ -25,7 +25,7 @@
25
25
  "framework",
26
26
  "mechanism"
27
27
  ],
28
- "layer": "infra",
28
+ "layer": "infrastructure",
29
29
  "group": "runtime",
30
30
  "author": "邱文武",
31
31
  "license": "ISC",
@@ -42,8 +42,10 @@
42
42
  "@prettier/sync": "^0.6.1",
43
43
  "mm_config": "^2.5.3",
44
44
  "mm_helper": "^1.0.3",
45
- "mm_loader": "^4.0.0",
45
+ "mm_loader": "^7.0.0",
46
46
  "mm_mod": "^1.0.6",
47
+ "mm_scanner": "^5.0.0",
48
+ "mm_store": "^1.0.1",
47
49
  "mm_tpl": "^2.7.3"
48
50
  },
49
51
  "devDependencies": {