mm_machine 2.9.8 → 3.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 (4) hide show
  1. package/index.js +8 -9
  2. package/manager.js +1093 -0
  3. package/package.json +5 -5
  4. package/registry.js +412 -0
package/manager.js ADDED
@@ -0,0 +1,1093 @@
1
+ const { Mod } = require('./mod');
2
+ const { Drive } = require('./drive.js');
3
+ const { Scanner } = require('./scanner.js');
4
+
5
+ /**
6
+ * 管理器类
7
+ */
8
+ class Manager extends Mod {
9
+ /**
10
+ * 配置项
11
+ * @type {object}
12
+ */
13
+ static config = {
14
+ /**
15
+ * 管理器名称
16
+ * @type {string}
17
+ */
18
+ name: 'manager',
19
+ /**
20
+ * 管理器标题
21
+ * @type {string}
22
+ */
23
+ title: '管理器',
24
+ /**
25
+ * 管理器描述
26
+ * @type {string}
27
+ */
28
+ description: '用于管理驱动',
29
+ /**
30
+ * 检索文件名
31
+ * @type {string}
32
+ */
33
+ filename: 'manager.json',
34
+ /**
35
+ * 模板目录
36
+ * @type {string}
37
+ */
38
+ tpl_dir: __dirname,
39
+ /**
40
+ * 基础目录,加载模块内置资源
41
+ * @type {string}
42
+ */
43
+ base_dir: '', // '../common/manager'.fullname(__dirname),
44
+ /**
45
+ * 自定义目录,加载项目自定义资源
46
+ * @type {string}
47
+ */
48
+ dir: '', // './ai/manager'.fullname(),
49
+ /**
50
+ * 搜索模式 dir按目录搜索 | file按文件名搜索
51
+ * @type {string}
52
+ */
53
+ search_way: 'file',
54
+ /**
55
+ * 类型 script脚本 | json配置 | drive驱动
56
+ * @type {string}
57
+ */
58
+ mod_type: 'drive',
59
+ /**
60
+ * 是否懒加载
61
+ * @type {boolean}
62
+ */
63
+ lazy_load: true,
64
+ /**
65
+ * 模式
66
+ * 1.生产模式,改变文件不会重新加载
67
+ * 2.热更新模式,改变配置文件会重新加载配置,不重新加载脚本
68
+ * 3.热重载模式,改变配置文件都会加载配置和脚本
69
+ * 4.热更新+重载模式,改变配置文件重新加载配置和脚本,执行完后重新加载脚本
70
+ * 5.重载模式,执行完后重新加载脚本,避免变量污染
71
+ * @type {number}
72
+ */
73
+ mode: 3,
74
+ /**
75
+ * 排序项
76
+ * @type {string}
77
+ */
78
+ sort_key: 'sort',
79
+ /**
80
+ * 是否启用注册表集成
81
+ * true 时自动从 $.registry 读取/写入模块配置
82
+ * @type {boolean}
83
+ */
84
+ use_registry: true,
85
+ /**
86
+ * 作用域
87
+ * @type {string}
88
+ */
89
+ scope: $.val && $.val.scope ? $.val.scope + '' : 'server'
90
+ };
91
+
92
+ /**
93
+ * 构造函数
94
+ * @param {object} config 配置项
95
+ * @param {object} parent 父项对象
96
+ * @param {object} mods 模块对象列表
97
+ * @param {object} Drive 驱动对象
98
+ */
99
+ constructor(config, parent, mods = {}, Drive) {
100
+ super(
101
+ {
102
+ ...Manager.config,
103
+ ...config
104
+ },
105
+ parent
106
+ );
107
+
108
+ this.scanner = new Scanner();
109
+ // 模块信息列表 { name: '', sort: 0, available: true, enabled: true }
110
+ this.infos = [];
111
+ // 模块
112
+ this.mods = mods;
113
+ if (Drive) {
114
+ this.Drive = Drive;
115
+ }
116
+ }
117
+
118
+ get list() {
119
+ return this.getList();
120
+ }
121
+ }
122
+
123
+ /**
124
+ * 获取事件触发器
125
+ * @returns {object} 事件触发器
126
+ */
127
+ Manager.prototype.getEventer = function () {
128
+ return $.eventer;
129
+ };
130
+
131
+ /**
132
+ * 获取所有模块信息
133
+ * @returns {object[]} 模块信息数组
134
+ */
135
+ Manager.prototype.getInfos = function () {
136
+ return this.infos;
137
+ };
138
+
139
+ /**
140
+ * 创建模块状态模型
141
+ * @param {string} name 模块名
142
+ * @param {number} sort 排序值
143
+ * @param {boolean} state 状态
144
+ * @param {string} file 文件名
145
+ * @returns {object} 模块状态模型
146
+ */
147
+ Manager.prototype.newInfo = function (name, sort, state, file = '') {
148
+ return {
149
+ name,
150
+ sort,
151
+ state,
152
+ enabled: true,
153
+ file: file || '',
154
+ get available() {
155
+ return this.state == true && this.enabled;
156
+ }
157
+ };
158
+ };
159
+
160
+ /**
161
+ * 设置模块信息
162
+ * @param {object} info 模块信息
163
+ */
164
+ Manager.prototype.setInfo = function (info) {
165
+ let has = false;
166
+ for (let i = 0; i < this.infos.length; i++) {
167
+ let o = this.infos[i];
168
+ if (o.name == info.name) {
169
+ this.infos[i] = info;
170
+ has = true;
171
+ break;
172
+ }
173
+ }
174
+ if (!has) {
175
+ this.infos.push(info);
176
+ }
177
+ };
178
+
179
+ /**
180
+ * 获取所有模块对象
181
+ * @param {string} keyword 查询关键词,判断name、title、description之一是否包含关键词,包含的才返回
182
+ * @returns {object[]} 模块对象数组
183
+ */
184
+ Manager.prototype.getList = function (keyword) {
185
+ let list = [];
186
+ for (let i = 0; i < this.infos.length; i++) {
187
+ let info = this.infos[i];
188
+ let mod = this.getMod(info.name);
189
+ if (!mod) {
190
+ continue;
191
+ }
192
+ mod.config.state = info.state;
193
+ list.push(mod);
194
+ }
195
+ if (keyword) {
196
+ list = list.filter(
197
+ (o) =>
198
+ o.name.includes(keyword) || o.title.includes(keyword) || o.description.includes(keyword)
199
+ );
200
+ }
201
+ return list;
202
+ };
203
+
204
+ /**
205
+ * 获取基础目录
206
+ * @returns {string} 基础目录
207
+ */
208
+ Manager.prototype.getBaseDir = function () {
209
+ return this.config.base_dir || __dirname;
210
+ };
211
+
212
+ /**
213
+ * 获取模板目录
214
+ * @returns {string} 模板目录
215
+ */
216
+ Manager.prototype.getTplDir = function () {
217
+ return this.config.tpl_dir || __dirname;
218
+ };
219
+
220
+ /**
221
+ * 默认驱动
222
+ */
223
+ Manager.prototype.Drive = Drive;
224
+
225
+ /**
226
+ * 更新模块信息
227
+ */
228
+ Manager.prototype.updateInfo = function () {
229
+ this.infos = [];
230
+ let mods = this.getMods();
231
+ for (let name in mods) {
232
+ let o = mods[name];
233
+ let info = this.newInfo(name, o.config.sort, o.config.state, o.config_file);
234
+ this.infos.push(info);
235
+ }
236
+ this.sort();
237
+ };
238
+
239
+ /**
240
+ * 排序
241
+ */
242
+ Manager.prototype._sort = function () {
243
+ var sort_key = this.config.sort_key || 'sort';
244
+ this.infos.sort((o1, o2) => {
245
+ let p1 = o1[sort_key] || 100;
246
+ let p2 = o2[sort_key] || 100;
247
+ return p1 - p2;
248
+ });
249
+ };
250
+
251
+ /**
252
+ * 排序
253
+ */
254
+ Manager.prototype.sort = function () {
255
+ this._sort();
256
+ };
257
+
258
+ // ==== 模块管理接口 ====
259
+ /**
260
+ * 清除所有模块
261
+ */
262
+ Manager.prototype.clearMods = function () {
263
+ for (let name in this.mods) {
264
+ delete this.mods[name];
265
+ }
266
+ };
267
+
268
+ /**
269
+ * 删除模块
270
+ * @param {string} name 模块名
271
+ * @returns {object|null} 删除的模块对象
272
+ */
273
+ Manager.prototype.delMod = function (name) {
274
+ let mod = this.mods[name];
275
+ if (mod) {
276
+ delete this.mods[name];
277
+ }
278
+ return mod;
279
+ };
280
+
281
+ /**
282
+ * 设置模块
283
+ * @param {string} name 模块名
284
+ * @param {object} mod 模块对象
285
+ * @returns {object|null} 设置的模块对象
286
+ */
287
+ Manager.prototype.setMod = function (name, mod) {
288
+ this.mods[name] = mod;
289
+ return this.getMod(name);
290
+ };
291
+
292
+ /**
293
+ * 获取模块
294
+ * @param {string} name 模块名
295
+ * @returns {object|null} 模块对象,若模块则返回模块对象,否则返回null
296
+ */
297
+ Manager.prototype.getMod = function (name) {
298
+ return this.mods[name];
299
+ };
300
+
301
+ /**
302
+ * 获取所有模块
303
+ * @returns {object[]} 模块对象数组
304
+ */
305
+ Manager.prototype.getMods = function () {
306
+ return this.mods;
307
+ };
308
+
309
+ /**
310
+ * 创建模块
311
+ * @param {string} config_file 配置文件路径
312
+ * @param {object} config 配置项
313
+ * @param {object} script 模块对象
314
+ * @returns {object} 模块对象
315
+ */
316
+ Manager.prototype.newMod = function (config_file, config, script) {
317
+ var mod;
318
+ switch (this.config.mod_type) {
319
+ case 'script':
320
+ mod = new Mod(config, this);
321
+ break;
322
+ default:
323
+ mod = new this.Drive(config, this);
324
+ break;
325
+ }
326
+ mod.mode = this.config.mode;
327
+
328
+ if (config && config.name) {
329
+ // config 已从 registry 缓存获取,跳过磁盘读
330
+ mod.config_file = config_file;
331
+ if (mod._preset) {
332
+ mod._preset();
333
+ }
334
+ } else {
335
+ mod.loadConfig(config_file);
336
+ }
337
+
338
+ if (script) {
339
+ for (var key in script) {
340
+ var obj = script[key];
341
+ if (typeof obj == 'function') {
342
+ mod.setMethod(key, obj);
343
+ } else {
344
+ mod.setData(key, obj);
345
+ }
346
+ }
347
+ }
348
+ return mod;
349
+ };
350
+
351
+ /**
352
+ * 注册模块
353
+ * @param {string} config_file 配置文件路径
354
+ * @param {object} config 配置项
355
+ * @param {object} script 模块对象
356
+ * @returns {object} 模块对象
357
+ */
358
+ Manager.prototype.registerMod = function (config_file, config = {}, script = {}) {
359
+ let cg = { ...config };
360
+ // 未传 config 时尝试从 registry 缓存获取
361
+ if (!cg || !cg.name) {
362
+ var cached = this._getRegistryConfig(config_file);
363
+ if (cached) {
364
+ cg = cached;
365
+ }
366
+ }
367
+
368
+ var mod = this.newMod(config_file, cg, script);
369
+ this.setMod(mod.config.name, mod);
370
+
371
+ // 启用注册表时,自动写入 $.registry 供后续实例复用
372
+ if (this.config.use_registry && $.registry) {
373
+ var list = $.registry.module_list;
374
+ var has = list.some(function (o) {
375
+ return o.name === mod.config.name;
376
+ });
377
+ if (!has) {
378
+ // 用管理器自身的 name 作为 parent 标签,实现多 Manager 隔离
379
+ var parent_name = mod.config.parent || this.config.name;
380
+ var entry = {
381
+ name: mod.config.name,
382
+ title: mod.config.title,
383
+ description: mod.config.description,
384
+ sort: mod.config.sort,
385
+ state: mod.config.state,
386
+ config_file: config_file,
387
+ main: mod.config.main || '',
388
+ scope: mod.config.scope || '',
389
+ class_name: mod.config.class_name || 'Drive',
390
+ parent: parent_name
391
+ };
392
+ list.push(entry);
393
+ // 同步 registry 的内部缓存,确保 Index.getModule() 可查
394
+ $.registry.registerModule(entry);
395
+ }
396
+ }
397
+
398
+ return mod;
399
+ };
400
+
401
+ /**
402
+ * 加载模块
403
+ * @param {string} name 模块名
404
+ * @returns {Promise<any>} 加载结果
405
+ */
406
+ Manager.prototype.loadMod = async function (name) {
407
+ let mod = this.getMod(name);
408
+ if (mod) {
409
+ return await mod.do('load');
410
+ }
411
+ return null;
412
+ };
413
+
414
+ /**
415
+ * 卸载模块
416
+ * @param {string} name 模块名
417
+ * @returns {Promise<any>} 卸载结果
418
+ */
419
+ Manager.prototype.unloadMod = async function (name) {
420
+ let mod = this.getMod(name);
421
+ if (mod) {
422
+ return await mod.do('unload');
423
+ }
424
+ return null;
425
+ };
426
+
427
+ /**
428
+ * 重载模块
429
+ * @param {string} name 模块名
430
+ * @returns {Promise<any>} 重载结果
431
+ */
432
+ Manager.prototype.reloadMod = async function (name) {
433
+ let mod = this.getMod(name);
434
+ if (mod) {
435
+ return await mod.do('reload');
436
+ }
437
+ return null;
438
+ };
439
+
440
+ /**
441
+ * 注销模块
442
+ * @param {string} name 模块名
443
+ * @returns {Promise<any>} 注销结果
444
+ */
445
+ Manager.prototype.unregisterMod = async function (name) {
446
+ let mod = this.getMod(name);
447
+ if (mod) {
448
+ // 按生命周期顺序停止→卸载,避免状态机拦截
449
+ await mod.do('stop');
450
+ await mod.do('unload');
451
+ }
452
+ // 删除模块
453
+ return this.delMod(name);
454
+ };
455
+
456
+ /**
457
+ * 批量注册模块
458
+ * @param {string[]} files 配置文件路径数组
459
+ * @param {object} config 配置项
460
+ * @param {object} script 模块对象
461
+ */
462
+ Manager.prototype.registerMods = function (files, config = {}, script = {}) {
463
+ for (let file of files) {
464
+ this.registerMod(file, config, script);
465
+ }
466
+ };
467
+
468
+ /**
469
+ * 加载所有模块
470
+ */
471
+ Manager.prototype.loadMods = async function () {
472
+ var promises = [];
473
+ let mods = this.getMods();
474
+ for (let name in mods) {
475
+ let mod = mods[name];
476
+ promises.push(mod.do('load'));
477
+ }
478
+ await Promise.all(promises);
479
+ };
480
+
481
+ /**
482
+ * 获取目录名
483
+ * @returns {string} 目录名
484
+ */
485
+ Manager.prototype.getDirName = function () {
486
+ let prefix = this.constructor.name.toLowerCase();
487
+ let name = this.config.name.toLowerCase();
488
+ return prefix + '_' + name;
489
+ };
490
+
491
+ /**
492
+ * 加载所有模块的脚本
493
+ */
494
+ Manager.prototype.loadScripts = async function () {
495
+ var promises = [];
496
+ let mods = this.getMods();
497
+ for (let name in mods) {
498
+ let mod = mods[name];
499
+ promises.push(mod.call('loadScript'));
500
+ }
501
+ await Promise.all(promises);
502
+ };
503
+
504
+ /**
505
+ * 更新配置前的钩子函数
506
+ */
507
+ Manager.prototype.updateBefore = function () {};
508
+
509
+ /**
510
+ * 更新配置前的钩子函数
511
+ */
512
+ Manager.prototype.updateAfter = function () {};
513
+
514
+ /**
515
+ * 更新配置
516
+ * @param {string} dir 检索的路径
517
+ * @param {boolean} clear 是否清除缓存
518
+ */
519
+ Manager.prototype.update = async function (dir, clear = true) {
520
+ if (clear) {
521
+ this.clearMods();
522
+ this.infos = [];
523
+ }
524
+
525
+ var search_dir = dir || this.config.dir;
526
+ var files = await this._findFiles(search_dir);
527
+ this.registerMods(files);
528
+ this.updateInfo();
529
+
530
+ if (!this.config.lazy_load) {
531
+ await this.loadScripts();
532
+ }
533
+ this._is_loaded = true;
534
+ };
535
+
536
+ /**
537
+ * 从 registry 缓存中查找匹配配置文件的模块配置
538
+ * 使用 Map 索引避免每次 O(n) 扫描
539
+ * @param {string} config_file 配置文件路径
540
+ * @returns {object|null} 模块配置项
541
+ */
542
+ Manager.prototype._getRegistryConfig = function (config_file) {
543
+ var registry = $.registry;
544
+ if (!registry || !registry.module_list) return null;
545
+
546
+ // 懒构建 config_file → config 的 Map 索引
547
+ if (!registry._config_map) {
548
+ registry._config_map = {};
549
+ var list = registry.module_list;
550
+ for (var i = 0; i < list.length; i++) {
551
+ var entry = list[i];
552
+ registry._config_map[entry.config_file] = entry;
553
+ }
554
+ }
555
+ return registry._config_map[config_file] || null;
556
+ };
557
+
558
+ /**
559
+ * 从 registry 缓存加载模块(按 parent 字段匹配)
560
+ * 内联创建模块并构建 infos,避免 registerMod/_getRegistryConfig/updateInfo 的冗余循环
561
+ * @param {string} parent 父级标识,空或不传时加载所有模块
562
+ * @returns {boolean} 是否加载到模块
563
+ */
564
+ Manager.prototype._loadFromRegistry = function (parent) {
565
+ var registry = $.registry;
566
+ if (!registry || !registry.module_list || !registry.module_list.length) return false;
567
+
568
+ var ModClass = this.config.mod_type === 'script' ? Mod : this.Drive;
569
+ var mode = this.config.mode;
570
+ var sort_key = this.config.sort_key || 'sort';
571
+ var list = registry.module_list;
572
+ var mods = this.mods;
573
+ var infos = this.infos;
574
+ var count = 0;
575
+
576
+ for (var i = 0; i < list.length; i++) {
577
+ var entry = list[i];
578
+ // 按 parent 字段匹配,不传或空时加载所有
579
+ if (parent && entry.parent !== parent) continue;
580
+
581
+ var config = entry;
582
+ var mod = new ModClass(config, this);
583
+ mod.mode = mode;
584
+ mod.config_file = entry.config_file;
585
+ if (mod._preset) {
586
+ mod._preset();
587
+ }
588
+ mods[config.name] = mod;
589
+ infos.push({
590
+ name: config.name,
591
+ sort: config.sort || 100,
592
+ state: config.state,
593
+ enabled: true,
594
+ file: entry.config_file || ''
595
+ });
596
+ count++;
597
+ }
598
+
599
+ // 排序 infos
600
+ if (count > 0) {
601
+ infos.sort(function (o1, o2) {
602
+ var p1 = o1[sort_key] || 100;
603
+ var p2 = o2[sort_key] || 100;
604
+ return p1 - p2;
605
+ });
606
+ }
607
+
608
+ return count > 0;
609
+ };
610
+
611
+ /**
612
+ * 检索目录下所有文件
613
+ * @private
614
+ * @param {string} dir 目录路径
615
+ * @returns {Array} 文件路径数组
616
+ */
617
+ Manager.prototype._findFiles = async function (dir) {
618
+ if (!dir) {
619
+ this.log('warn', '目录为空,跳过扫描');
620
+ return [];
621
+ }
622
+ if (!dir.hasDir()) {
623
+ return [];
624
+ }
625
+ if (this.config.search_way === 'dir') {
626
+ return await this.scanner.scan(dir, this.config.filename, this.getDirName());
627
+ }
628
+ return await this.scanner.scanFile(dir, this.config.filename);
629
+ };
630
+
631
+ // ==== 高性能调用接口 ====
632
+ /**
633
+ * 调用模块的方法(高性能版本)
634
+ * @param {string} name 模块名
635
+ * @param {string} method 方法名
636
+ * @param {...any} params 参数集合
637
+ * @returns {Promise<any>} 执行结果
638
+ */
639
+ Manager.prototype.main = async function (name, method, ...params) {
640
+ var result = null;
641
+ if (name) {
642
+ let mod = this.getMod(name);
643
+ if (mod && mod.config?.state === 1) {
644
+ result = await this._runMod(mod, method, ...params);
645
+ }
646
+ } else if (name === null) {
647
+ result = await this._runAllEnabled(method, ...params);
648
+ }
649
+ return result;
650
+ };
651
+
652
+ /**
653
+ * 私有方法:执行所有模块方法
654
+ * @param {string} method 方法名称
655
+ * @param {...any} params 方法参数集合
656
+ * @returns {Promise<any>} 执行结果
657
+ * @private
658
+ */
659
+ Manager.prototype._runAllEnabled = async function (method, ...params) {
660
+ var result;
661
+ for (let i = 0; i < this.infos.length; i++) {
662
+ let config = this.infos[i];
663
+ let mod = this.getMod(config.name);
664
+ if (mod && mod.config?.state === 1) {
665
+ var ret = null;
666
+ try {
667
+ ret = await this._runMod(mod, method, ...params);
668
+ } catch (err) {
669
+ this.log('error', `执行模块方法失败: `, err);
670
+ }
671
+ if (ret !== null && ret !== undefined) {
672
+ result = ret;
673
+ // 如果结果不为空且有结束标志,则停止迭代
674
+ if (mod.config?.end) {
675
+ break;
676
+ }
677
+ }
678
+ }
679
+ }
680
+ return result;
681
+ };
682
+
683
+ /**
684
+ * 私有方法:执行模块方法
685
+ * @param {object} mod 模块对象
686
+ * @param {string} method 方法名称
687
+ * @param {...any} params 参数集合
688
+ * @returns {Promise<any>} 执行结果
689
+ * @private
690
+ */
691
+ Manager.prototype._runMod = async function (mod, method, ...params) {
692
+ if (!mod || !method) return null;
693
+
694
+ // 确保模块已加载
695
+ if (!mod.isLoaded()) {
696
+ try {
697
+ await mod.call('loadScript');
698
+ } catch (err) {
699
+ $.log.error(`加载模块脚本失败: `, err);
700
+ }
701
+ // 加载失败则不再执行,避免无方法调用
702
+ if (!mod.isLoaded()) {
703
+ return null;
704
+ }
705
+ }
706
+
707
+ // 执行方法
708
+ let ret = await mod.call(method, ...params);
709
+ // 根据模式决定是否重载
710
+ if (this.config.mode >= 4) {
711
+ await mod.do('reload');
712
+ }
713
+
714
+ return ret;
715
+ };
716
+
717
+ /**
718
+ * 初始化管理器
719
+ */
720
+ Manager.prototype._initManager = function () {};
721
+
722
+ /**
723
+ * 获取二次开发模块目录
724
+ * @returns {string} 二次开发模块目录
725
+ */
726
+ Manager.prototype.getDir = function () {
727
+ return this.config.dir || this.getParent().getDir();
728
+ };
729
+
730
+ /**
731
+ * 加载资源
732
+ * 启用注册表时优先从 $.registry.module_list 读取,跳过文件系统扫描
733
+ */
734
+ Manager.prototype._loadSources = async function () {
735
+ var base_dir = this.getBaseDir();
736
+ var dir = this.getDir();
737
+
738
+ // 启用注册表且有缓存数据时,走内存快路径
739
+ // 按管理器自身 name 过滤,多 Manager 共享 $.registry 时互不污染
740
+ if (
741
+ this.config.use_registry &&
742
+ $.registry &&
743
+ $.registry.module_list &&
744
+ $.registry.module_list.length > 0
745
+ ) {
746
+ this._loadFromRegistry(this.config.name);
747
+ this.updateInfo();
748
+ return;
749
+ }
750
+
751
+ // 无注册表缓存,走文件系统扫描
752
+ if (base_dir) {
753
+ // base_dir 和 dir 并行扫描,互不依赖
754
+ await Promise.all([this.call('update', base_dir, true), this.call('update', dir, false)]);
755
+ } else {
756
+ await this.call('update', dir, true);
757
+ }
758
+ };
759
+
760
+ /**
761
+ * 初始化资源
762
+ */
763
+ Manager.prototype._initSources = async function () {
764
+ // 通过
765
+ };
766
+
767
+ /**
768
+ * 初始化公共属性
769
+ */
770
+ Manager.prototype._initCore = async function () {
771
+ // 初始化管理器
772
+ this._initManager();
773
+ // 加载资源
774
+ await this._loadSources();
775
+ // 初始化AI客户端
776
+ await this._initSources();
777
+ };
778
+
779
+ /**
780
+ * 执行方法 - 内部方法
781
+ * @param {string} mod 模块对象
782
+ * @param {string} method 方法名称
783
+ * @param {...any} params 参数列表
784
+ * @returns {any} 返回执行结果
785
+ */
786
+ Manager.prototype._exec = async function (mod, method, ...params) {
787
+ if (mod[method]) {
788
+ return await mod[method](...params);
789
+ } else {
790
+ throw new Error(`方法${method}不存在`);
791
+ }
792
+ };
793
+
794
+ /**
795
+ * 执行方法
796
+ * @param {string} name 模块名
797
+ * @param {string} method 方法名称
798
+ * @param {...any} params 参数列表
799
+ * @returns {any} 返回执行结果
800
+ */
801
+ Manager.prototype.exec = async function (name, method, ...params) {
802
+ let ret;
803
+ try {
804
+ let mod = this.getMod(name);
805
+ if (!mod) {
806
+ throw new Error(`模块${name}不存在`);
807
+ }
808
+ ret = await this._exec(mod, method, ...params);
809
+ } catch (error) {
810
+ this.log('error', `${method}方法执行失败!`, error);
811
+ }
812
+ return ret;
813
+ };
814
+
815
+ /**
816
+ * 确保单个模块已加载
817
+ * @param {string} name 模块名
818
+ * @returns {Promise<object|null>} 模块实例或 null
819
+ */
820
+ Manager.prototype._ensureModLoaded = async function (name) {
821
+ let mod = this.getMod(name);
822
+ if (!mod) return null;
823
+ if (!mod.isLoaded()) {
824
+ try {
825
+ await mod.call('loadScript');
826
+ } catch (error) {
827
+ this.log('error', `模块${name}加载失败`, error);
828
+ return null;
829
+ }
830
+ }
831
+ return mod;
832
+ };
833
+
834
+ /**
835
+ * 确保所有模块都已加载
836
+ * @returns {Promise} 加载完成
837
+ */
838
+ Manager.prototype._ensureAllLoaded = async function () {
839
+ var infos = this.getInfos();
840
+ var promises = [];
841
+
842
+ for (var i = 0; i < infos.length; i++) {
843
+ var info = infos[i];
844
+ promises.push(this._ensureModLoaded(info.name));
845
+ }
846
+ await Promise.all(promises);
847
+ };
848
+
849
+ /**
850
+ * 异步触发事件,按顺序执行等待完成
851
+ * @param {string} method 方法名称
852
+ * @param {...any} params 事件参数
853
+ * @returns {Promise} 事件触发结果
854
+ */
855
+ Manager.prototype.runWait = async function (method, ...params) {
856
+ if (typeof method !== 'string') {
857
+ throw new TypeError('方法名称必须是字符串');
858
+ }
859
+
860
+ let result;
861
+ let infos = this.getInfos();
862
+
863
+ for (let i = 0; i < infos.length; i++) {
864
+ let info = infos[i];
865
+ let mod = await this._ensureModLoaded(info.name);
866
+ if (!mod) continue;
867
+
868
+ try {
869
+ let ret = await mod.do(method, ...params);
870
+ if (ret !== null && ret !== undefined) {
871
+ result = ret;
872
+ }
873
+ } catch (error) {
874
+ this.log('error', `模块${info.name}执行${method}方法失败`, error);
875
+ }
876
+ }
877
+
878
+ return result;
879
+ };
880
+
881
+ /**
882
+ * 异步触发事件,并发执行不等待
883
+ * @param {string} method 方法名称
884
+ * @param {...any} params 事件参数
885
+ * @returns {boolean} 是否成功触发事件
886
+ */
887
+ Manager.prototype.runAsync = async function (method, ...params) {
888
+ if (typeof method !== 'string') {
889
+ throw new TypeError('方法名称必须是字符串');
890
+ }
891
+
892
+ // 确保所有模块都已加载
893
+ await this._ensureAllLoaded();
894
+
895
+ let infos = this.getInfos();
896
+
897
+ for (let i = 0; i < infos.length; i++) {
898
+ let info = infos[i];
899
+ let mod = this.getMod(info.name);
900
+ if (!mod) continue;
901
+
902
+ mod.do(method, ...params).catch((error) => {
903
+ this.log('error', `模块${info.name}执行${method}方法失败`, error);
904
+ });
905
+ }
906
+
907
+ return true;
908
+ };
909
+
910
+ /**
911
+ * 异步触发事件,并发执行等待完成
912
+ * @param {string} method 方法名称
913
+ * @param {...any} params 事件参数
914
+ * @returns {Promise} 事件触发结果
915
+ */
916
+ Manager.prototype.runAll = async function (method, ...params) {
917
+ if (typeof method !== 'string') {
918
+ throw new TypeError('方法名称必须是字符串');
919
+ }
920
+
921
+ // 确保所有模块都已加载
922
+ await this._ensureAllLoaded();
923
+
924
+ const promises = [];
925
+ let infos = this.getInfos();
926
+
927
+ for (let i = 0; i < infos.length; i++) {
928
+ let info = infos[i];
929
+ let mod = this.getMod(info.name);
930
+ if (!mod) continue;
931
+
932
+ promises.push(
933
+ mod.do(method, ...params).catch(() => {
934
+ return null;
935
+ })
936
+ );
937
+ }
938
+
939
+ return await Promise.all(promises);
940
+ };
941
+
942
+ /**
943
+ * 异步触发事件,竞争执行
944
+ * @param {string} method 方法名称
945
+ * @param {...any} params 事件参数
946
+ * @returns {Promise} 第一个完成的结果
947
+ */
948
+ Manager.prototype.runRace = async function (method, ...params) {
949
+ if (typeof method !== 'string') {
950
+ throw new TypeError('方法名称必须是字符串');
951
+ }
952
+
953
+ // 确保所有模块都已加载
954
+ await this._ensureAllLoaded();
955
+
956
+ const promises = [];
957
+ let infos = this.getInfos();
958
+
959
+ for (let i = 0; i < infos.length; i++) {
960
+ let info = infos[i];
961
+ let mod = this.getMod(info.name);
962
+ if (!mod) continue;
963
+
964
+ promises.push(
965
+ mod.do(method, ...params).catch((error) => {
966
+ throw error;
967
+ })
968
+ );
969
+ }
970
+
971
+ return await Promise.race(promises);
972
+ };
973
+
974
+ /**
975
+ * 异步触发事件,瀑布流执行
976
+ * @param {string} method 方法名称
977
+ * @param {*} result 初始值
978
+ * @param {...any} params 事件参数
979
+ * @returns {Promise} 最后一个事件监听者的结果
980
+ */
981
+ Manager.prototype.runWaterfall = async function (method, result, ...params) {
982
+ if (typeof method !== 'string') {
983
+ throw new TypeError('方法名称必须是字符串');
984
+ }
985
+
986
+ let infos = this.getInfos();
987
+
988
+ for (let i = 0; i < infos.length; i++) {
989
+ let info = infos[i];
990
+ let mod = await this._ensureModLoaded(info.name);
991
+ if (!mod) continue;
992
+
993
+ try {
994
+ let ret = await mod.do(method, result, ...params);
995
+ if (ret !== null && ret !== undefined) {
996
+ result = ret;
997
+ }
998
+ } catch (error) {
999
+ this.log('error', `模块${info.name}执行${method}方法失败`, error);
1000
+ }
1001
+ }
1002
+
1003
+ return result;
1004
+ };
1005
+
1006
+ /**
1007
+ * 异步触发事件,子模块执行
1008
+ * @param {string} name 子模块名称
1009
+ * @param {string} method 方法名称
1010
+ * @param {...any} params 事件参数
1011
+ * @returns {Promise} 事件触发结果
1012
+ */
1013
+ Manager.prototype.runSubMod = async function (name, method, ...params) {
1014
+ if (typeof method !== 'string') {
1015
+ throw new TypeError('方法名称必须是字符串');
1016
+ }
1017
+ let mod = await this._ensureModLoaded(name);
1018
+ if (!mod) {
1019
+ throw new Error(`模块${name}不存在或加载失败`);
1020
+ }
1021
+ return await mod.do(method, ...params);
1022
+ };
1023
+
1024
+ /**
1025
+ * 移除事件监听
1026
+ * @param {string} event 事件名
1027
+ */
1028
+ Manager.prototype.offEvent = function (event) {
1029
+ this.getEventer()?.off(event);
1030
+ };
1031
+
1032
+ /**
1033
+ * 创建模块
1034
+ * @param {object} config 模块配置
1035
+ * @param {string} file 模块文件路径
1036
+ * @returns {string} 创建的模块文件路径
1037
+ */
1038
+ Manager.prototype.createFile = function (config, file) {
1039
+ if (!config.name) {
1040
+ throw new TypeError('模块名称不能为空');
1041
+ }
1042
+ if (!config.title) {
1043
+ throw new TypeError('模块标题不能为空');
1044
+ }
1045
+ if (!config.description) {
1046
+ throw new TypeError('模块描述不能为空');
1047
+ }
1048
+ if (this.getMod(config.name)) {
1049
+ throw new Error(`创建失败,原因:模块${config.name}已存在`);
1050
+ }
1051
+ let mod = new this.Drive(config, this);
1052
+ let f = file;
1053
+ if (!f) {
1054
+ f = `${config.name}/${this.config.filename}`;
1055
+ if (this.config.search_way === 'dir') {
1056
+ let dir_name = this.getDirName();
1057
+ f = `${dir_name}/${f}`;
1058
+ }
1059
+ }
1060
+ f = f.fullname(this.config.dir);
1061
+ mod.createConfigFile(f, config);
1062
+ return f;
1063
+ };
1064
+
1065
+ /**
1066
+ * 创建模块
1067
+ * @param {object} config 模块配置
1068
+ * @param {string} file 模块文件路径
1069
+ * @returns {object} 创建的模块实例
1070
+ */
1071
+ Manager.prototype.create = function (config, file = '') {
1072
+ let f = this.createFile(config, file);
1073
+ let mod = this.registerMod(f, config);
1074
+ return mod;
1075
+ };
1076
+
1077
+ /**
1078
+ * 删除模块
1079
+ * @param {string} name 模块名称
1080
+ * @returns {object} 删除的模块实例
1081
+ */
1082
+ Manager.prototype.remove = async function (name) {
1083
+ let mod = this.getMod(name);
1084
+ if (mod) {
1085
+ await mod.remove();
1086
+ }
1087
+ this.unregisterMod(name);
1088
+ return mod;
1089
+ };
1090
+
1091
+ module.exports = {
1092
+ Manager
1093
+ };