mm_os 5.0.1 → 5.0.2

package/lib/os.js

@@ -1,536 +1,572 @@
-const path = require('path');
-const { Mod } = require('mm_mod');
-const { containerAdmin } = require('mm_container');
-const { getLogger } = require('mm_logger');
-const { Loader } = require('mm_loader');
-const { appAdmin } = require('mm_apps');
-const { eventAdmin } = require('mm_event');
-
-/**
- * OS类
- */
-class OS extends Mod {
-  static config = {
-    name: 'os',
-    in_adapters: [{
-      name: 'web',
-      module: 'mm_web_server'
-    }, {
-      name: 'mqtt',
-      module: 'mm_mqtt_server'
-    }, {
-      name: 'socket',
-      module: 'mm_socket_server'
-    }, {
-      name: 'websocket',
-      module: 'mm_websocket_server'
-    }],
-    // 输出适配器
-    out_adapters: [{
-      name: 'redis',
-      module: 'mm_redis'
-    }, {
-      name: 'mongodb',
-      module: 'mm_mongodb'
-    }, {
-      name: 'mysql',
-      module: 'mm_mysql'
-    }, {
-      name: 'sqlite',
-      module: 'mm_sqlite'
-    }, {
-      name: 'jsondb',
-      module: 'mm_jsondb'
-    }, {
-      name: 'file',
-      module: 'mm_files'
-    }],
-    tools: [{
-      name: 'lang',
-      module: 'mm_lang'
-    }, {
-      name: 'tpl',
-      module: 'mm_tpl'
-    }, {
-      name: 'ret',
-      module: 'mm_ret'
-    }],
-    admins: [{
-      name: 'event',
-      module: 'mm_event'
-    }, {
-      name: 'api',
-      module: 'mm_api'
-    }, {
-      name: 'param',
-      module: 'mm_param'
-    }, {
-      name: 'dao',
-      module: 'mm_dao'
-    }, {
-      name: 'service',
-      module: 'mm_service'
-    }, {
-      name: 'template',
-      module: 'mm_template'
-    }, {
-      name: 'pendant',
-      module: 'mm_pendant'
-    }, {
-      name: 'timer',
-      module: 'mm_timer'
-    }, {
-      name: 'static',
-      module: 'mm_statics'
-    }],
-    cache: {
-      type: 'redis'
-    },
-    sql: {
-      type: 'mysql'
-    },
-    web: {
-      port: 8000
-    },
-    mqtt: {
-      port: 1883
-    },
-    socket: {
-      port: 9000
-    },
-    websocket: {
-      port: 9001
-    },
-    jsondb: {
-      dir: './data'
-    },
-    mysql: {
-      host: '127.0.0.1',
-      port: 3306,
-      user: 'root',
-      password: 'Asd159357',
-      database: 'mm'
-    },
-    redis: {
-      host: '127.0.0.1',
-      password: 'asd159357',
-      port: 6379,
-      db: 0
-    },
-    mongodb: {
-      host: '127.0.0.1',
-      port: 27017,
-      user: 'root',
-      password: 'asd123',
-      database: 'mm'
-    },
-    sqlite: {
-      dir: './db',
-      database: 'mm',
-      user: 'root',
-      password: 'asd123'
-    },
-    ret: {
-      type: 'json-rpc'
-    },
-    lang: {
-      type: 'zh_cn'
-    },
-    tpl: {
-      dir: './static/template',
-      ext: '.html'
-    },
-    loader: {
-      dir: ''
-    }
-  }
-
-  /**
-   * OS类构造函数
-   * @param {object} config 配置对象
-   */
-  constructor(config) {
-    super(config);
-    /**
-     * 实例容器（按作用域共享）
-     * @type {object}
-     */
-    this.container = containerAdmin('os', { name: 'os' });
-    this.container.server = this;
-  }
-
-  /**
-   * 生命周期初始化钩子
-   * @returns {void} 无返回值
-   */
-  async onInit() {
-    this.initConfig();
-    this.initLogger();
-    // 初始化事件总线
-    this.initEventBus();
-    // 存储需先于管理器初始化：mm_dao 等管理器会通过 mm_sql 的 getSql() 复用同名 SQL 实例，
-    // 若管理器先创建，则会以默认（空库名）配置占用实例，导致后续 SQL 报 No database selected
-    await this.initpStorage();
-    await this.initAdmins();
-    await this.initAdapter();
-    await this.initLoader();
-  }
-}
-
-/**
- * 初始化配置管理器
- */
-OS.prototype.initConfig = function () {
-  const { admin } = require('mm_config');
-  admin.setServer(this);
-  admin.get('os', this.config);
-  admin.get('cache', { ...this.config.cache, redis: this.config.redis, mongodb: this.config.mongodb });
-  admin.get('sql', { ...this.config.sql, mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb });
-  admin.get('web', this.config.web);
-  admin.get('mqtt', this.config.mqtt);
-  admin.get('socket', this.config.socket);
-  admin.get('websocket', this.config.websocket);
-  admin.get('jsondb', this.config.jsondb);  
-  admin.get('redis', this.config.redis);
-  admin.get('mongodb', this.config.mongodb);
-  admin.get('sqlite', this.config.sqlite);
-  admin.get('mysql', this.config.mysql);
-  admin.get('ret', this.config.ret);
-  admin.get('lang', this.config.lang);
-  admin.get('tpl', this.config.tpl);
-  admin.get('loader', this.config.loader);
-  this.reg('config', admin);
-};
-
-/**
- * 初始化日志记录器
- */
-OS.prototype.initLogger = function () {
-  this.reg('logger', getLogger(this.config.log || { level: 'info' }));
-};
-
-/**
- * 记录日志
- * @param {string} type 日志类型
- * @param {string} msg 日志消息
- * @param {...*} args 日志参数
- */
-OS.prototype.log = function (type, msg, ...args) {
-  this.container.get('logger')[type](msg, ...args);
-};
-
-/**
- * 注册管理
- * @param {string} name 管理名称
- * @param {object} admin 管理对象
- */
-OS.prototype.reg = function (name, admin) {
-  this.container.set(name, admin);
-};
-
-/**
- * 加载模块
- * @param {string} mod_name 模块名称
- * @returns {object} 模块对象
- */
-OS.prototype.require = function (mod_name) {
-  return require(mod_name);
-};
-
-/**
- * 初始化适配器
- * @returns {void} 无返回值
- */
-OS.prototype.initAdapter = async function () {
-  // 入站适配器
-  let adapters = this.config.in_adapters || [];
-  for (let mod of adapters) {
-    try {
-      let admin = this.require(mod.module).admin;
-      admin.setServer(this);
-      let manager = admin.get('os', this.config[mod.name]);
-      if (typeof manager.init === 'function') {
-        await manager.init();
-      }
-      this.reg(mod.name, manager);
-    } catch (error) {
-      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
-    }
-  }
-
-  // 出站适配器
-  let out_adapters = this.config.out_adapters || [];
-  for (let mod of out_adapters) {
-    try {
-      let admin = this.require(mod.module).admin;
-      admin.setServer(this);
-      let manager = admin.get('os', this.config[mod.name]);
-      if (typeof manager.init === 'function') {
-        await manager.init();
-      }
-      this.reg(mod.name, manager);
-    } catch (error) {
-      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
-    }
-  }
-};
-
-/**
- * 初始化工具
- * @returns {void} 无返回值
- */
-OS.prototype.initTools = async function () {
-  let tools = this.config.tools || [];
-  for (let mod of tools) {
-    try {
-      let admin = this.require(mod.module).admin;
-      admin.setServer(this);
-      let manager = admin.get('os', this.config[mod.name]);
-      if (typeof manager.init === 'function') {
-        await manager.init();
-      }
-      this.reg(mod.name, manager);
-    } catch (error) {
-      this.log('error', `初始化工具 ${mod.name} 失败: ${error}`);
-    }
-  }
-};
-
-/**
- * 初始化管理
- * @returns {void} 无返回值
- */
-OS.prototype.initAdmins = async function () {
-  let admins = this.config.admins || [];
-  for (let mod of admins) {
-    try {
-      let admin = this.require(mod.module).admin;
-      admin.setServer(this);
-      let manager = admin.get('os', this.config[mod.name]);
-      if (typeof manager.init === 'function') {
-        await manager.init();
-      }
-      this.reg(mod.name, manager);
-    } catch (error) {
-      this.log('error', `初始化管理 ${mod.name} 失败: ${error}`);
-    }
-  }
-};
-
-/**
- * 初始化存储
- * @returns {void} 无返回值
- */
-OS.prototype.initpStorage = async function () {
-  // 初始化缓存存储
-  let cacheAdmin = this.require('mm_cache').admin;
-  this._setAdminServer(cacheAdmin);
-  let cache = cacheAdmin.get('os', Object.assign({}, this.config.cache, { redis: this.config.redis, mongodb: this.config.mongodb, cachebase: this.config.cachebase }));
-  if (typeof cache.init === 'function') {
-    await cache.init();
-  }
-  this.reg('cache', cache);
-
-  // 初始化数据库
-  let sqlAdmin = this.require('mm_sql').admin;
-  this._setAdminServer(sqlAdmin);
-  let sql = sqlAdmin.get('os', Object.assign({}, this.config.sql, { mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb }));
-  if (typeof sql.init === 'function') {
-    await sql.init();
-  }
-  this.reg('sql', sql);
-};
-
-/**
- * 设置管理器服务器：已设置时跳过，避免同一 Admin 实例重复绑定
- * @param {object} admin 管理器工厂实例
- */
-OS.prototype._setAdminServer = function (admin) {
-  if (!admin.getServer()) {
-    admin.setServer(this);
-  }
-};
-
-/**
- * 初始化应用加载器（协调层：只创建加载器与应用管理器，装配逻辑在 mm_apps/mm_plugins）
- * @returns {void} 无返回值
- */
-OS.prototype.initLoader = async function () {
-  // 配置加载器：注入 socket/mqtt 类型，其余类型由 mm_loader 默认提供
-  const loader = new Loader(this.config.loader || {});
-  loader.addType('socket', 'socket.json');
-  loader.addType('mqtt', 'mqtt.json');
-  this.reg('loader', loader);
-
-  // 应用管理器：装配应用由 AppManager.load 负责，插件随 App.onInit 引入
-  const app = appAdmin('os');
-  app.setServer(this);
-  app.setLogger(this.container.get('logger'));
-  this.reg('app', app);
-
-  const dir = this.config.loader.dir || path.join(__dirname, '..', 'example', 'app');
-  await app.load(dir, loader);
-  await app.init();
-
-  // 注入 Web 请求路由
-  this._initWeb();
-};
-
-/**
- * 初始化 Web 适配器：注入跨作用域事件路由
- * @returns {void} 无返回值
- */
-OS.prototype._initWeb = function () {
-  const web = this.container.get('web');
-  if (!web) return;
-  web.setEventManager(this._createEventRouter());
-};
-
-/**
- * 创建跨作用域事件路由：Web 适配器只持有 web 作用域，需转发到各应用作用域
- * @returns {object} 含 run 方法的事件管理器
- */
-OS.prototype._createEventRouter = function () {
-  return {
-    run: (target, params, ctx, options) => this._routeRequest(target, params, ctx, options)
-  };
-};
-
-/**
- * 路由请求：先尝试静态资源，未命中再按应用顺序执行事件
- * @param {string} target 请求路径
- * @param {object} params 请求参数
- * @param {object} ctx 请求上下文
- * @param {object} options 事件运行选项
- * @returns {Promise<*>} 事件执行结果
- */
-OS.prototype._routeRequest = async function (target, params, ctx, options = {}) {
-  const statics = this.container.get('static');
-  if (!statics || typeof statics.run !== 'function') {
-    return await this._runAppEvents(target, params, ctx, options);
-  }
-  let result;
-  await statics.run(ctx, async () => {
-    result = await this._runAppEvents(target, params, ctx, options);
-  });
-  return result;
-};
-
-/**
- * 按应用排序依次执行事件：命中结果、响应已写出或发生错误时中止
- * @param {string} target 请求路径
- * @param {object} params 请求参数
- * @param {object} ctx 请求上下文
- * @param {object} options 事件运行选项
- * @returns {Promise<*>} 事件执行结果
- */
-OS.prototype._runAppEvents = async function (target, params, ctx, options = {}) {
-  const app = this.container.get('app');
-  if (!app || typeof app.list !== 'function') return undefined;
-
-  const apps = app.list().slice().sort((a, b) => this._getSort(a) - this._getSort(b));
-  for (const item of apps) {
-    if (this._isRequestHandled(ctx) || ctx.error) return undefined;
-    const name = item.config && item.config.name;
-    if (!name) continue;
-    const app_options = {};
-    const result = await eventAdmin(name).run(target, params, ctx, app_options);
-    if (app_options.error) {
-      ctx.error = ctx.error || app_options.error;
-      options.error = options.error || app_options.error;
-      return undefined;
-    }
-    if (result !== undefined && result !== null) return result;
-  }
-  return undefined;
-};
-
-/**
- * 判断请求是否已处理完毕：事件或中间件已写出响应
- * @param {object} ctx 请求上下文
- * @returns {boolean} 响应是否已写出
- */
-OS.prototype._isRequestHandled = function (ctx) {
-  if (!ctx) return false;
-  if (ctx.handled === true) return true;
-  const res = ctx.res;
-  return !!(res && (res.writableEnded || res.headersSent));
-};
-
-/**
- * 获取应用执行顺序
- * @param {object} app 应用驱动实例
- * @returns {number} 排序值，缺省 100
- */
-OS.prototype._getSort = function (app) {
-  const sort = app && app.config ? app.config.sort : undefined;
-  return typeof sort === 'number' ? sort : 100;
-};
-
-/**
- * 初始化事件总线
- * @returns {void} 无返回值
- */
-OS.prototype.initEventBus = function () {
-  let admin = this.require('mm_eventer').admin;
-  admin.setServer(this);
-  this.reg('eventer', admin.get('os'));
-};
-
-/**
- * 启动适配器：按配置中的入站、出站适配器名称从容器取出管理器并启动
- * @returns {void} 无返回值
- */
-OS.prototype._startAdapters = async function () {
-  let mods = this.config.in_adapters;
-  for (let mod of mods) {
-    let manager = this.container.get(mod.name);
-    if (!manager || typeof manager.start !== 'function') continue;
-    try {
-      await manager.start();
-      this._printAddress(mod.name, manager);
-    } catch (error) {
-      this.log('error', `启动适配器 ${mod.name} 失败: ${error}`);
-    }
-  }
-};
-
-/**
- * 启动
- * @returns {void} 无返回值
- */
-OS.prototype.start = async function () {
-  // 启动适配器
-  await this._startAdapters();
-
-  // 启动缓存存储
-  await this.container.get('cache').start();
-  // 启动数据库
-  await this.container.get('sql').start();
-
-  // 启动应用
-  const app = this.container.get('app');
-  if (app) {
-    await app.start();
-  }
-};
-
-/**
- * 打印适配器监听地址
- * @param {string} name 适配器名称
- * @param {object} manager 适配器管理器实例
- */
-OS.prototype._printAddress = function (name, manager) {
-  let { host, port } = manager.config || {};
-  if (!host || host === '0.0.0.0' || host === '::') {
-    host = 'localhost';
-  }
-  let protocol = { web: 'http', websocket: 'ws', socket: 'tcp', mqtt: 'mqtt' }[name] || name;
-  let address = `${protocol}://${host}`;
-  if (port) {
-    address += `:${port}`;
-  }
-  this.log('info', `适配器 ${name} 已启动: ${address}`);
-};
-
+const path = require('path');
+const { Mod } = require('mm_mod');
+const { containerAdmin } = require('mm_container');
+const { getLogger } = require('mm_logger');
+const { Loader } = require('mm_loader');
+const { appAdmin } = require('mm_apps');
+const { eventAdmin } = require('mm_event');
+const { Response } = require('mm_response');
+
+/**
+ * OS类
+ */
+class OS extends Mod {
+  static config = {
+    name: 'os',
+    in_adapters: [{
+      name: 'web',
+      module: 'mm_web_server'
+    }, {
+      name: 'mqtt',
+      module: 'mm_mqtt_server'
+    }, {
+      name: 'socket',
+      module: 'mm_socket_server'
+    }, {
+      name: 'websocket',
+      module: 'mm_websocket_server'
+    }],
+    // 输出适配器
+    out_adapters: [{
+      name: 'redis',
+      module: 'mm_redis'
+    }, {
+      name: 'mongodb',
+      module: 'mm_mongodb'
+    }, {
+      name: 'mysql',
+      module: 'mm_mysql'
+    }, {
+      name: 'sqlite',
+      module: 'mm_sqlite'
+    }, {
+      name: 'jsondb',
+      module: 'mm_jsondb'
+    }, {
+      name: 'file',
+      module: 'mm_files'
+    }],
+    tools: [{
+      name: 'lang',
+      module: 'mm_lang'
+    }, {
+      name: 'tpl',
+      module: 'mm_tpl'
+    }, {
+      name: 'ret',
+      module: 'mm_ret'
+    }],
+    admins: [{
+      name: 'event',
+      module: 'mm_event'
+    }, {
+      name: 'api',
+      module: 'mm_api'
+    }, {
+      name: 'param',
+      module: 'mm_param'
+    }, {
+      name: 'dao',
+      module: 'mm_dao'
+    }, {
+      name: 'service',
+      module: 'mm_service'
+    }, {
+      name: 'template',
+      module: 'mm_template'
+    }, {
+      name: 'pendant',
+      module: 'mm_pendant'
+    }, {
+      name: 'timer',
+      module: 'mm_timer'
+    }, {
+      name: 'static',
+      module: 'mm_statics'
+    }],
+    cache: {
+      type: 'redis'
+    },
+    sql: {
+      type: 'mysql'
+    },
+    web: {
+      port: 8000
+    },
+    mqtt: {
+      port: 1883
+    },
+    socket: {
+      port: 9000
+    },
+    websocket: {
+      port: 9001
+    },
+    jsondb: {
+      dir: './data'
+    },
+    mysql: {
+      host: '127.0.0.1',
+      port: 3306,
+      user: 'root',
+      password: 'Asd159357',
+      database: 'mm'
+    },
+    redis: {
+      host: '127.0.0.1',
+      password: 'asd159357',
+      port: 6379,
+      db: 0
+    },
+    mongodb: {
+      host: '127.0.0.1',
+      port: 27017,
+      user: 'root',
+      password: 'asd123',
+      database: 'mm'
+    },
+    sqlite: {
+      dir: './db',
+      database: 'mm',
+      user: 'root',
+      password: 'asd123'
+    },
+    ret: {
+      type: 'json-rpc'
+    },
+    lang: {
+      type: 'zh_cn'
+    },
+    tpl: {
+      dir: './static/template',
+      ext: '.html'
+    },
+    loader: {
+      dir: ''
+    }
+  }
+
+  /**
+   * OS类构造函数
+   * @param {object} config 配置对象
+   */
+  constructor(config) {
+    super(config);
+    /**
+     * 实例容器（按作用域共享）
+     * @type {object}
+     */
+    this.container = containerAdmin('os', { name: 'os' });
+    this.container.server = this;
+    /**
+     * 初始化阶段创建的全局管理器列表
+     * @type {Array<object>}
+     */
+    this._admin_managers = [];
+    /**
+     * 已启动的全局管理器集合，避免重复启动
+     * @type {Set<object>}
+     */
+    this._started_admins = new Set();
+  }
+
+  /**
+   * 生命周期初始化钩子
+   * @returns {void} 无返回值
+   */
+  async onInit() {
+    this.initConfig();
+    this.initLogger();
+    // 初始化事件总线
+    this.initEventBus();
+    // 存储需先于管理器初始化：mm_dao 等管理器会通过 mm_sql 的 getSql() 复用同名 SQL 实例，
+    // 若管理器先创建，则会以默认（空库名）配置占用实例，导致后续 SQL 报 No database selected
+    await this.initpStorage();
+    await this.initAdmins();
+    await this.initAdapter();
+    await this.initLoader();
+  }
+}
+
+/**
+ * 初始化配置管理器
+ */
+OS.prototype.initConfig = function () {
+  const { admin } = require('mm_config');
+  admin.setServer(this);
+  admin.get('os', this.config);
+  admin.get('cache', { ...this.config.cache, redis: this.config.redis, mongodb: this.config.mongodb });
+  admin.get('sql', { ...this.config.sql, mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb });
+  admin.get('web', this.config.web);
+  admin.get('mqtt', this.config.mqtt);
+  admin.get('socket', this.config.socket);
+  admin.get('websocket', this.config.websocket);
+  admin.get('jsondb', this.config.jsondb);  
+  admin.get('redis', this.config.redis);
+  admin.get('mongodb', this.config.mongodb);
+  admin.get('sqlite', this.config.sqlite);
+  admin.get('mysql', this.config.mysql);
+  admin.get('ret', this.config.ret);
+  admin.get('lang', this.config.lang);
+  admin.get('tpl', this.config.tpl);
+  admin.get('loader', this.config.loader);
+  this.reg('config', admin);
+};
+
+/**
+ * 初始化日志记录器
+ */
+OS.prototype.initLogger = function () {
+  this.reg('logger', getLogger(this.config.log || { level: 'info' }));
+};
+
+/**
+ * 记录日志
+ * @param {string} type 日志类型
+ * @param {string} msg 日志消息
+ * @param {...*} args 日志参数
+ */
+OS.prototype.log = function (type, msg, ...args) {
+  this.container.get('logger')[type](msg, ...args);
+};
+
+/**
+ * 注册管理
+ * @param {string} name 管理名称
+ * @param {object} admin 管理对象
+ */
+OS.prototype.reg = function (name, admin) {
+  this.container.set(name, admin);
+};
+
+/**
+ * 加载模块
+ * @param {string} mod_name 模块名称
+ * @returns {object} 模块对象
+ */
+OS.prototype.require = function (mod_name) {
+  return require(mod_name);
+};
+
+/**
+ * 初始化适配器
+ * @returns {void} 无返回值
+ */
+OS.prototype.initAdapter = async function () {
+  // 入站适配器
+  let adapters = this.config.in_adapters || [];
+  for (let mod of adapters) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+
+  // 出站适配器
+  let out_adapters = this.config.out_adapters || [];
+  for (let mod of out_adapters) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化工具
+ * @returns {void} 无返回值
+ */
+OS.prototype.initTools = async function () {
+  let tools = this.config.tools || [];
+  for (let mod of tools) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+    } catch (error) {
+      this.log('error', `初始化工具 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化管理
+ * @returns {void} 无返回值
+ */
+OS.prototype.initAdmins = async function () {
+  let admins = this.config.admins || [];
+  for (let mod of admins) {
+    try {
+      let admin = this.require(mod.module).admin;
+      admin.setServer(this);
+      let manager = admin.get('os', this.config[mod.name]);
+      if (typeof manager.init === 'function') {
+        await manager.init();
+      }
+      this.reg(mod.name, manager);
+      this._admin_managers.push(manager);
+    } catch (error) {
+      this.log('error', `初始化管理 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 初始化存储
+ * @returns {void} 无返回值
+ */
+OS.prototype.initpStorage = async function () {
+  // 初始化缓存存储
+  let cacheAdmin = this.require('mm_cache').admin;
+  this._setAdminServer(cacheAdmin);
+  let cache = cacheAdmin.get('os', Object.assign({}, this.config.cache, { redis: this.config.redis, mongodb: this.config.mongodb, cachebase: this.config.cachebase }));
+  if (typeof cache.init === 'function') {
+    await cache.init();
+  }
+  this.reg('cache', cache);
+
+  // 初始化数据库
+  let sqlAdmin = this.require('mm_sql').admin;
+  this._setAdminServer(sqlAdmin);
+  let sql = sqlAdmin.get('os', Object.assign({}, this.config.sql, { mysql: this.config.mysql, sqlite: this.config.sqlite, jsondb: this.config.jsondb }));
+  if (typeof sql.init === 'function') {
+    await sql.init();
+  }
+  this.reg('sql', sql);
+};
+
+/**
+ * 设置管理器服务器：已设置时跳过，避免同一 Admin 实例重复绑定
+ * @param {object} admin 管理器工厂实例
+ */
+OS.prototype._setAdminServer = function (admin) {
+  if (!admin.getServer()) {
+    admin.setServer(this);
+  }
+};
+
+/**
+ * 初始化应用加载器（协调层：只创建加载器与应用管理器，装配逻辑在 mm_apps/mm_plugins）
+ * @returns {void} 无返回值
+ */
+OS.prototype.initLoader = async function () {
+  // 配置加载器：注入 socket/mqtt 类型，其余类型由 mm_loader 默认提供
+  const loader = new Loader(this.config.loader || {});
+  loader.addType('socket', 'socket.json');
+  loader.addType('mqtt', 'mqtt.json');
+  this.reg('loader', loader);
+
+  // 应用管理器：装配应用由 AppManager.load 负责，插件随 App.onInit 引入
+  const app = appAdmin('os');
+  app.setServer(this);
+  app.setLogger(this.container.get('logger'));
+  this.reg('app', app);
+
+  const dir = this.config.loader.dir || path.join(__dirname, '..', 'example', 'app');
+  await app.load(dir, loader);
+  await app.init();
+
+  // 注入 Web 请求路由
+  this._initWeb();
+};
+
+/**
+ * 初始化 Web 适配器：注入跨作用域事件路由与响应写出器
+ * @returns {void} 无返回值
+ */
+OS.prototype._initWeb = function () {
+  const web = this.container.get('web');
+  if (!web) return;
+  web.setEventManager(this._createEventRouter());
+  new Response().bind(web);
+};
+
+/**
+ * 创建跨作用域事件路由：Web 适配器只持有 web 作用域，需转发到各应用作用域
+ * @returns {object} 含 run 方法的事件管理器
+ */
+OS.prototype._createEventRouter = function () {
+  return {
+    run: (target, params, ctx, options) => this._routeRequest(target, params, ctx, options)
+  };
+};
+
+/**
+ * 路由请求：先尝试静态资源，未命中再按应用顺序执行事件
+ * @param {string} target 请求路径
+ * @param {object} params 请求参数
+ * @param {object} ctx 请求上下文
+ * @param {object} options 事件运行选项
+ * @returns {Promise<*>} 事件执行结果
+ */
+OS.prototype._routeRequest = async function (target, params, ctx, options = {}) {
+  const statics = this.container.get('static');
+  if (statics && typeof statics.run === 'function') {
+    // 静态模块为服务式调用：命中即返回 true 并已写出响应，未命中返回 false 继续后续事件
+    const served = await statics.run(params, ctx, options);
+    if (served) {
+      return undefined;
+    }
+  }
+  return await this._runAppEvents(target, params, ctx, options);
+};
+
+/**
+ * 按应用排序依次执行事件：命中结果、响应已写出或发生错误时中止
+ * @param {string} target 请求路径
+ * @param {object} params 请求参数
+ * @param {object} ctx 请求上下文
+ * @param {object} options 事件运行选项
+ * @returns {Promise<*>} 事件执行结果
+ */
+OS.prototype._runAppEvents = async function (target, params, ctx, options = {}) {
+  const app = this.container.get('app');
+  if (!app || typeof app.list !== 'function') return undefined;
+
+  const apps = app.list().slice().sort((a, b) => this._getSort(a) - this._getSort(b));
+  for (const item of apps) {
+    if (this._isRequestHandled(ctx) || ctx.error) return undefined;
+    const name = item.config && item.config.name;
+    if (!name) continue;
+    const app_options = {};
+    const result = await eventAdmin(name).run(target, params, ctx, app_options);
+    if (app_options.error) {
+      ctx.error = ctx.error || app_options.error;
+      options.error = options.error || app_options.error;
+      return undefined;
+    }
+    if (result !== undefined && result !== null) return result;
+  }
+  return undefined;
+};
+
+/**
+ * 判断请求是否已处理完毕：事件或中间件已写出响应
+ * @param {object} ctx 请求上下文
+ * @returns {boolean} 响应是否已写出
+ */
+OS.prototype._isRequestHandled = function (ctx) {
+  if (!ctx) return false;
+  if (ctx.handled === true) return true;
+  const res = ctx.res;
+  return !!(res && (res.writableEnded || res.headersSent));
+};
+
+/**
+ * 获取应用执行顺序
+ * @param {object} app 应用驱动实例
+ * @returns {number} 排序值，缺省 100
+ */
+OS.prototype._getSort = function (app) {
+  const sort = app && app.config ? app.config.sort : undefined;
+  return typeof sort === 'number' ? sort : 100;
+};
+
+/**
+ * 初始化事件总线
+ * @returns {void} 无返回值
+ */
+OS.prototype.initEventBus = function () {
+  let admin = this.require('mm_eventer').admin;
+  admin.setServer(this);
+  this.reg('eventer', admin.get('os'));
+};
+
+/**
+ * 启动适配器：按配置中的入站、出站适配器名称从容器取出管理器并启动
+ * @returns {void} 无返回值
+ */
+OS.prototype._startAdapters = async function () {
+  let mods = this.config.in_adapters;
+  for (let mod of mods) {
+    let manager = this.container.get(mod.name);
+    if (!manager || typeof manager.start !== 'function') continue;
+    try {
+      await manager.start();
+      this._printAddress(mod.name, manager);
+    } catch (error) {
+      this.log('error', `启动适配器 ${mod.name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 启动初始化阶段创建的全局管理器
+ * 仅启动一次，避免重复执行管理器生命周期
+ * @returns {void} 无返回值
+ */
+OS.prototype._startAdmins = async function () {
+  let managers = this._admin_managers || [];
+  for (let manager of managers) {
+    if (!manager || typeof manager.start !== 'function') continue;
+    if (this._started_admins.has(manager)) continue;
+    try {
+      await manager.start();
+      this._started_admins.add(manager);
+    } catch (error) {
+      let name = manager.config && manager.config.name;
+      this.log('error', `启动管理 ${name} 失败: ${error}`);
+    }
+  }
+};
+
+/**
+ * 启动
+ * @returns {void} 无返回值
+ */
+OS.prototype.start = async function () {
+  // 启动适配器
+  await this._startAdapters();
+
+  // 启动缓存存储
+  await this.container.get('cache').start();
+  // 启动数据库
+  await this.container.get('sql').start();
+
+  // 启动应用
+  const app = this.container.get('app');
+  if (app) {
+    await app.start();
+  }
+
+  // 启动初始化阶段创建的全局管理器（含 os 作用域静态资源）
+  await this._startAdmins();
+};
+
+/**
+ * 打印适配器监听地址
+ * @param {string} name 适配器名称
+ * @param {object} manager 适配器管理器实例
+ */
+OS.prototype._printAddress = function (name, manager) {
+  let { host, port } = manager.config || {};
+  if (!host || host === '0.0.0.0' || host === '::') {
+    host = 'localhost';
+  }
+  let protocol = { web: 'http', websocket: 'ws', socket: 'tcp', mqtt: 'mqtt' }[name] || name;
+  let address = `${protocol}://${host}`;
+  if (port) {
+    address += `:${port}`;
+  }
+  this.log('info', `适配器 ${name} 已启动: ${address}`);
+};
+
 module.exports = OS;

package/package.json

@@ -1,60 +1,64 @@
 {
-  "name": "mm_os",
-  "version": "5.0.1",
-  "description": "这是OS系统",
-  "repository": {
-    "type": "git",
-    "url": "https://gitee.com/qiuwenwu91/mm_os.git"
-  },
-  "license": "ISC",
-  "author": "qww",
-  "type": "commonjs",
-  "main": "index.js",
-  "files": [
-    "index.js",
-    "lib",
-    "README.md"
-  ],
-  "directories": {
-    "example": "example",
-    "lib": "lib"
-  },
-  "scripts": {
-    "test": "node test.js",
-    "demo": "node --preserve-symlinks example/demo.js",
-    "api:test": "node api_test.js"
-  },
-  "dependencies": {
-    "markdown": "^0.5.0",
-    "mm_apps": "^1.0.2",
-    "mm_cache": "^1.5.5",
-    "mm_container": "^1.0.1",
-    "mm_corejs": "^1.1.5",
-    "mm_dao": "^1.8.0",
-    "mm_es6_to_amd": "^1.5.9",
-    "mm_event": "^2.2.4",
-    "mm_files": "^1.0.0",
-    "mm_handle": "^1.0.0",
-    "mm_jsondb": "^1.0.0",
-    "mm_loader": "^1.1.0",
-    "mm_logger": "^1.0.0",
-    "mm_mod": "^1.0.2",
-    "mm_mongodb": "^2.0.3",
-    "mm_mqtt_server": "^2.0.0",
-    "mm_mysql": "^2.5.6",
-    "mm_param": "^1.1.3",
-    "mm_pendant": "^1.1.1",
-    "mm_plugins": "^1.0.2",
-    "mm_redis": "^2.1.7",
-    "mm_render": "^1.0.0",
-    "mm_socket_server": "^3.0.0",
-    "mm_sql": "^1.8.2",
-    "mm_sqlite": "^1.5.5",
-    "mm_statics": "^1.9.1",
-    "mm_template": "^1.2.1",
-    "mm_timer": "^1.4.4",
-    "mm_tpl": "^2.7.3",
-    "mm_web_server": "^2.0.1",
-    "mm_websocket_server": "^2.0.0"
-  }
+    "name": "mm_os",
+    "version": "5.0.2",
+    "description": "这是OS系统",
+    "repository": {
+        "type": "git",
+        "url": "https://gitee.com/qiuwenwu91/mm_os.git"
+    },
+    "license": "ISC",
+    "author": "qww",
+    "type": "commonjs",
+    "main": "index.js",
+    "files": [
+        "index.js",
+        "lib",
+        "README.md"
+    ],
+    "directories": {
+        "example": "example",
+        "lib": "lib"
+    },
+    "scripts": {
+        "test": "node test.js && node --test tests/os.test.js",
+        "demo": "node --preserve-symlinks example/demo.js",
+        "api:test": "node api_test.js"
+    },
+    "dependencies": {
+        "markdown": "^0.5.0",
+        "mm_apps": "^1.0.3",
+        "mm_cache": "^1.5.5",
+        "mm_config": "^2.5.3",
+        "mm_container": "^1.0.2",
+        "mm_corejs": "^1.1.6",
+        "mm_dao": "^1.8.1",
+        "mm_es6_to_amd": "^1.5.9",
+        "mm_event": "^2.2.5",
+        "mm_eventer": "^1.0.0",
+        "mm_files": "^1.0.1",
+        "mm_handle": "^1.0.0",
+        "mm_jsondb": "^1.0.0",
+        "mm_loader": "^1.1.2",
+        "mm_logger": "^1.0.0",
+        "mm_mod": "^1.0.7",
+        "mm_mongodb": "^2.0.3",
+        "mm_mqtt_server": "^2.0.1",
+        "mm_mysql": "^2.5.6",
+        "mm_param": "^1.1.4",
+        "mm_pendant": "^1.1.2",
+        "mm_plugins": "^1.0.3",
+        "mm_redis": "^2.1.7",
+        "mm_render": "^1.0.1",
+        "mm_response": "^1.0.0",
+        "mm_socket_server": "^3.0.0",
+        "mm_sql": "^1.8.2",
+        "mm_sqlite": "^1.5.5",
+        "mm_statics": "^1.9.2",
+        "mm_template": "^1.2.2",
+        "mm_timer": "^1.4.5",
+        "mm_tpl": "^2.7.3",
+        "mm_web_server": "^2.0.2",
+        "mm_websocket_server": "^2.0.1"
+    },
+    "layer": "terminal"
 }