mm_os 4.3.7 → 5.0.1

package/core/app/index.js

@@ -1,711 +0,0 @@
-const compressing = require('compressing');
-const { Manager, Drive } = require('mm_machine');
-const { Plugin } = require('../plugin/index.js');
-
-/**
- * 应用
- */
-class App extends Drive {
-  static config = {
-    name: 'default',
-    version: '1.0.0',
-    title: '应用',
-    description: '应用',
-    author: 'qww',
-    scope: 'server',
-    dir: '',
-    // 运行模式: 1=生产, 3=开发热重载, 根据 NODE_ENV 自动切换
-    mode: process.env.NODE_ENV === 'production' ? 1 : 3,
-    // // 游戏配置，非游戏模块不需要配置
-    // 'game': {
-    //   // 游戏类型
-    //   'type': 'card_game'
-    // },
-    dependencies: [],
-    // // 压缩目录
-    // 'zip_dir': './static/file/zip',
-    // // 解压目录
-    // 'unzip_dir': './static/file/unzip',
-    // 自定义数据库 - 1 开启 0 关闭
-    diy_sql: 0,
-    // 自定义缓存 - 1 开启 0 关闭
-    diy_cache: 0,
-    // sql 配置 - 可以没有，没有则使用默认数据库
-    sql: {
-      // 数据库方式
-      way: 'mysql',
-      mysql: {
-        // 数据库主机
-        host: '127.0.0.1',
-        // 数据库端口
-        port: 3306,
-        // 数据库用户名
-        username: 'root',
-        // 数据库密码
-        password: process.env.DB_PASSWORD || '',
-        // 数据库名称
-        database: 'mm',
-      },
-    },
-    // 缓存配置 - 可以没有，没有则使用默认缓存
-    cache: {
-      // 缓存方式方式
-      way: 'redis',
-      redis: {
-        // 缓存主机
-        host: '127.0.0.1',
-        // 缓存端口
-        port: 6379,
-        // 缓存密码
-        password: process.env.REDIS_PASSWORD || '',
-        // 缓存数据库
-        database: 0,
-      },
-    },
-  };
-  /**
-   * 构造函数
-   * @param {object} config 配置参数
-   * @param {object} parent 父对象
-   */
-  constructor(config, parent) {
-    super({ ...App.config, ...(config || {}) }, parent);
-  }
-}
-
-/**
- * 预置
- */
-App.prototype._preset = function () {
-  // 管理器集合
-  this.manager = {};
-
-  // 插件，用于功能扩展
-  this.plugin = {};
-
-  // 数据库，调用统一数据库接口，也允许重定义数据库
-  this.sql = null;
-  // 缓存，调用统一缓存接口，也允许重定义缓存
-  this.cache = null;
-  // 文件管理，调用统一文件管理接口，也允许重定义文件管理
-  this.filer = null;
-
-  /**
-   * 获取服务器实例
-   * @returns {object} 服务器实例对象
-   */
-  this.getServer = function () {
-    return $.server;
-  };
-};
-
-/**
- * 创建管理器实例
- * @param {string} name 管理器名称
- * @param {string} title 管理器标题
- * @param {Function} cls 管理器类
- * @returns {object} 管理器实例
- */
-App.prototype._createManager = function (name, title, cls) {
-  let dir = this.getDir();
-  var manager = new Manager(
-    {
-      name: name,
-      title: title,
-      filename: name + '.json',
-      tpl_dir: `../${name}/`.fullname(__dirname),
-      base_dir: '',
-      dir: `./${name}`.fullname(dir),
-    },
-    this,
-    this[name],
-    cls,
-  );
-  this.manager[name] = manager;
-  return manager;
-};
-
-/**
- * 初始化管理器集合
- * @returns {Promise<void>} 初始化完成
- */
-App.prototype._initManager = async function () {
-  // 管理器配置列表
-  var mgr_configs = [{ name: 'plugin', title: '插件', Module: Plugin }];
-
-  // 管理器实例集合
-  var managers = [];
-
-  // 使用for循环初始化所有管理器
-  for (var i = 0; i < mgr_configs.length; i++) {
-    var config = mgr_configs[i];
-    var manager = this._createManager(config.name, config.title, config.Module);
-    managers.push(manager);
-  }
-
-  // 并行执行所有管理器的初始化操作
-  var list = [];
-  for (var j = 0; j < managers.length; j++) {
-    list.push(managers[j].do('load'));
-  }
-
-  await Promise.all(list);
-};
-
-/**
- * 加载资源
- * @returns {Promise<void>} 加载完成
- */
-App.prototype._loadSources = async function () {
-  await this.manager.plugin.runAll('load');
-};
-
-/**
- * 初始化资源
- * @returns {Promise<void>} 初始化完成
- */
-App.prototype._initSources = async function () {
-  await this.manager.plugin.runAll(
-    'init',
-    this,
-    this.getEventer(),
-    this.getLogger(),
-  );
-};
-
-/**
- * 初始化核心
- * @param {object} server 服务器
- * @param {object} eventer 事件总线
- * @param {object} logger 日志管理器
- * @private
- */
-App.prototype._initCore = async function (server, eventer, logger) {
-  if (logger) {
-    this.setLogger(logger);
-  }
-  if (eventer) {
-    this.getEventer = function () {
-      return eventer;
-    };
-  }
-  if (server) {
-    this.getServer = function () {
-      return server;
-    };
-  }
-  // 初始化基础设施
-  await this._initBase();
-  // 初始化管理
-  await this._initManager();
-  // 加载资源
-  await this._loadSources();
-  // 验证依赖关系
-  this._validateDep();
-};
-
-/**
- * 初始化基础设施
- * @private
- */
-App.prototype._initBase = async function () {
-  // 初始化文件处理器
-  this.filer = this.getServer().filer;
-
-  // 初始化数据库
-  if (this.config.diy_sql) {
-    var cg = this.config.sql || $.config.get('sql');
-    this.sql = sqlAdmin(this.config.name, cg);
-    await this.sql.open();
-  } else {
-    this.sql = this.getServer().sql;
-  }
-
-  // 初始化缓存
-  if (this.config.diy_cache) {
-    var cg = this.config.cache || $.config.get('cache');
-    this.cache = cacheAdmin(this.config.name, cg);
-    await this.cache.connect();
-  } else {
-    this.cache = this.getServer().cache;
-  }
-};
-
-/**
- * 启动资源
- */
-App.prototype._startSources = async function () {
-  await this.manager.plugin.runAll('start');
-};
-
-/**
- * 启动核心
- * @private
- */
-App.prototype._startCore = async function () {
-  // 初始化资源
-  await this._initSources();
-  // 启动资源
-  await this._startSources();
-  // 注册信号处理和全局错误处理
-  this._signalHandle();
-};
-
-/**
- * 验证依赖关系
- * @private
- */
-App.prototype._validateDep = function () {
-  var required_managers = ['plugin'];
-
-  for (var name of required_managers) {
-    if (!this.manager[name]) {
-      throw new Error(`缺少必要的管理器: ${name}`);
-    }
-  }
-};
-
-/**
- * 获取压缩目录
- * @returns {string} 压缩目录
- */
-App.prototype.getZipDir = function () {
-  return '/static/file/zip/'.fullname();
-};
-
-/**
- * 压缩插件
- * @param {string} name 插件名称
- * @returns {string} 打包成功返回压缩包文件地址
- */
-App.prototype.zipPlugin = async function (name) {
-  if (!name || typeof name !== 'string') {
-    throw new TypeError('无效的插件名称');
-  }
-  var plugin = this.plugin[name];
-  if (!plugin) {
-    throw new Error(`插件 ${name} 不存在`);
-  }
-  var dir = plugin.getDir();
-  var file = ('./' + name + '.zip').fullname(this.getZipDir());
-  return await this.zip(file, dir);
-};
-
-/**
- * 压缩目录
- * @param {string} file 压缩文件
- * @param {string} dir 要压缩的目录
- * @returns {string} 打包成功返回压缩包文件路径
- */
-App.prototype.zip = async function (file, dir) {
-  var target_dir = dir || this.getZipDir();
-  file.addDir();
-  if (!target_dir.hasDir()) {
-    target_dir.addDir();
-  }
-  // 重试压缩，避免文件在压缩过程中被修改导致 yazl 报错
-  var max_retry = 3;
-  for (var i = 0; i < max_retry; i++) {
-    try {
-      await compressing.zip.compressDir(target_dir, file);
-      break;
-    } catch (error) {
-      if (
-        i < max_retry - 1 &&
-        error.message.includes('unexpected number of bytes')
-      ) {
-        // 等待后重试
-        await new Promise((resolve) => setTimeout(resolve, 500));
-        continue;
-      }
-      throw error;
-    }
-  }
-  if (file.hasFile()) {
-    return file;
-  }
-  return null;
-};
-
-/**
- * 解压插件
- * @param {object} file 插件压缩文件
- * @param {string} unzip_dir 要解压的目录
- * @returns {object} 返回解压结果
- */
-App.prototype.unzip = async function (file, unzip_dir = '/cache/unzip/') {
-  if (!file) {
-    throw new TypeError('无效的文件路径');
-  }
-  var name = file.basename().left('.');
-  var dir = name.fullname(unzip_dir);
-
-  try {
-    // 先清理可能残留的旧解压目录，避免只读文件冲突
-    if (dir.hasDir()) {
-      dir.delDir();
-    }
-    // 确保目标目录存在
-    dir.addDir();
-    // 解压文件到目标目录
-    await compressing.zip.uncompress(file, dir);
-    // 查找目标目录
-    var target_dir = this._findTargetDir(dir, name);
-    // 如果找到目标目录，直接使用它作为解压结果
-    if (target_dir) {
-      var config_file = './plugin.json'.fullname(target_dir);
-      if (config_file.hasFile()) {
-        return { file, config_file, dir: target_dir, unzip_dir: dir };
-      }
-    }
-    return { file, dir, unzip_dir: dir };
-  } catch (err) {
-    this.log('error', '插件解压失败！', err);
-    // 清理失败的解压目录
-    if (dir.hasDir()) {
-      dir.delDir();
-    }
-    return null;
-  }
-};
-
-/**
- * 查找目标目录
- * @param {string} dir 解压目录
- * @param {string} name 插件名称
- * @returns {string|null} 目标目录路径
- * @private
- */
-App.prototype._findTargetDir = function (dir, name) {
-  var dir_files = $.dir.get(dir);
-  if (!dir_files || dir_files.length === 0) {
-    return null;
-  }
-  for (var i = 0; i < dir_files.length; i++) {
-    var item = dir_files[i];
-    if (item.hasDir()) {
-      // 优先按名称匹配
-      if (item.basename() === name) {
-        var plugin_json = './plugin.json'.fullname(item);
-        if (plugin_json.hasFile()) {
-          return item;
-        }
-      }
-    }
-  }
-  // 名称匹配失败时，查找任意包含 plugin.json 的子目录
-  for (var i = 0; i < dir_files.length; i++) {
-    var item = dir_files[i];
-    if (item.hasDir()) {
-      var plugin_json = './plugin.json'.fullname(item);
-      if (plugin_json.hasFile()) {
-        return item;
-      }
-    }
-  }
-  return null;
-};
-
-/**
- * 卸载插件
- * @param {string} name 插件名称
- * @returns {string} 返回卸载路径
- */
-App.prototype.uninstallPlugin = async function (name) {
-  if (!name || typeof name !== 'string') {
-    this.log('error', '卸载失败：无效的插件名称');
-    return null;
-  }
-
-  var plugin = this.manager.plugin.get(name);
-  if (!plugin) {
-    this.log('error', '卸载失败：插件不存在');
-    return null;
-  }
-
-  var dir = plugin.getDir();
-
-  // 执行卸载脚本
-  if (plugin.call) {
-    await plugin.call('uninstall');
-  }
-  try {
-    this.manager.plugin.del(name);
-    dir.delDir();
-  } catch (err) {
-    this.log('error', '卸载失败：', err);
-    return null;
-  }
-};
-
-/**
- * 复制目录
- * @param {string} dir_src 原路径
- * @param {string} dir 新路径
- * @returns {object} 返回复制结果
- */
-App.prototype.copyDir = function (dir_src, dir) {
-  return new Promise((resolve, reject) => {
-    if (!dir_src || !dir) {
-      this.log('error', '复制目录失败：无效的目录路径');
-      reject(new Error('无效的目录路径'));
-      return;
-    }
-
-    if (!dir_src.hasDir()) {
-      this.log('error', '复制目录失败：源目录不存在');
-      reject(new Error('源目录不存在'));
-      return;
-    }
-
-    try {
-      // 确保目标目录存在
-      dir.addDir();
-
-      $.dir.copy(dir_src, dir, (err) => {
-        if (err) {
-          this.log('error', '复制目录失败：', err);
-          reject(err);
-        } else {
-          resolve({
-            dir_src,
-            dir,
-          });
-        }
-      });
-    } catch (err) {
-      this.log('error', '复制目录失败：', err);
-      reject(err);
-    }
-  });
-};
-
-/**
- * 解压插件
- * @param {object} file 插件压缩文件
- * @returns {object} 返回解压结果
- */
-App.prototype._unzipPlugin = async function (file) {
-  var ret = await this.unzip(file);
-  if (!ret) {
-    return null;
-  }
-
-  // 直接使用解压目录作为 dir_src
-  var dir_src = ret.dir;
-
-  var config_file = './plugin.json'.fullname(dir_src);
-
-  if (!config_file.hasFile()) {
-    throw new Error('安装失败：找不到配置文件');
-  }
-
-  var config = config_file.loadJson();
-  if (!config) {
-    throw new Error('安装失败：配置文件无效');
-  }
-
-  var app = config.app || this.config.name;
-  var name = config.name;
-
-  if (!name) {
-    throw new Error('安装失败：配置文件中缺少名称字段');
-  }
-
-  var dir = `/app/${app}/plugin/${name}`;
-
-  await this.copyDir(dir_src, dir);
-  ret.app = app;
-  ret.name = name;
-  ret.dir = dir;
-  return ret;
-};
-
-/**
- * 安装插件
- * @param {object} info 插件信息
- * @returns {object} 返回安装结果
- */
-App.prototype._installPlugin = async function (info) {
-  if (!info) {
-    return null;
-  }
-  if (!info.config_file) {
-    throw new Error('安装失败：找不到配置文件');
-  }
-
-  var manager = this.manager.plugin;
-  if (info.app !== this.config.name) {
-    var app = this.getServer().app[info.app];
-    if (!app) {
-      throw new Error(`安装失败：应用 ${info.app} 不存在`);
-    }
-    manager = app.manager.plugin;
-  }
-  // 只加载当前插件，而不是重载所有插件
-  await manager.load(info.config_file);
-
-  // 执行安装方法
-  var plugin = manager.getMod(info.name);
-  if (plugin && plugin.call) {
-    await plugin.call('install');
-  }
-  return true;
-};
-
-/**
- * 安装插件
- * @param {string} file 插件压缩文件路径
- * @returns {object} 返回安装结果
- */
-App.prototype.installPlugin = async function (file) {
-  if (!file) {
-    throw new TypeError('无效的文件路径');
-  }
-
-  // 解压插件
-  var info = await this._unzipPlugin(file);
-  if (!info) {
-    return null;
-  }
-  // 安装插件
-  await this._installPlugin(info);
-
-  // 清理临时目录
-  var _this = this;
-  this._cleanup_timer = setTimeout(() => {
-    _this.log('info', '清理临时目录', info.unzip_dir);
-    if (info.unzip_dir && info.unzip_dir.hasDir()) {
-      info.unzip_dir.delDir();
-    }
-  }, 3000);
-  info.zip_file = file;
-  return info;
-};
-
-// 模块级单例: 每种 process 事件只注册一次, 热重载时仅切换内部引用
-var _app_ref = null;
-var _inited = false;
-
-function _initProcess() {
-  if (_inited) return;
-  _inited = true;
-
-  process.on('SIGTERM', () => {
-    if (_app_ref) _app_ref._onSignal('SIGTERM');
-  });
-  process.on('SIGINT', () => {
-    if (_app_ref) _app_ref._onSignal('SIGINT');
-  });
-  process.on('uncaughtException', (err) => {
-    if (_app_ref) {
-      _app_ref.log('error', '未捕获异常, 进程即将退出', {
-        message: err.message,
-        stack: err.stack,
-      });
-    }
-    process.exit(1);
-  });
-  process.on('unhandledRejection', (reason) => {
-    if (_app_ref) {
-      _app_ref.log('error', '未处理的Promise rejection', {
-        reason: reason ? reason.message : '',
-        stack: reason ? reason.stack : '',
-      });
-    }
-  });
-}
-
-/**
- * 注册信号和错误处理, 热重载时仅更新 app 引用
- * @private
- */
-App.prototype._signalHandle = function () {
-  _app_ref = this;
-  _initProcess();
-};
-
-/**
- * 处理系统信号
- * @param {string} signal 信号名称
- * @private
- */
-App.prototype._onSignal = async function (signal) {
-  this.log('info', `收到 ${signal} 信号, 开始优雅关闭`);
-
-  try {
-    var timeout = setTimeout(() => {
-      this.log('warn', '优雅关闭超时, 强制退出');
-      process.exit(1);
-    }, 15000);
-
-    await this._destroy();
-
-    clearTimeout(timeout);
-    this.log('info', '优雅关闭完成');
-    process.exit(0);
-  } catch (err) {
-    this.log('error', '优雅关闭失败', err);
-    process.exit(1);
-  }
-};
-App.prototype._destroy = async function () {
-  if (this._cleanup_timer) {
-    clearTimeout(this._cleanup_timer);
-    this._cleanup_timer = null;
-  }
-  if (this.config.diy_sql && this.sql && this.sql.close) {
-    try {
-      await this.sql.close();
-    } catch (err) {
-      this.log('error', '关闭数据库连接失败', err);
-    }
-  }
-  if (this.config.diy_cache && this.cache && this.cache.close) {
-    try {
-      await this.cache.close();
-    } catch (err) {
-      this.log('error', '关闭缓存连接失败', err);
-    }
-  }
-};
-
-/**
- * 健康检查, 返回各组件状态
- * @returns {object} 健康状态对象
- */
-App.prototype.healthcheck = async function () {
-  var status = {
-    status: 'ok',
-    uptime: process.uptime(),
-    memory: process.memoryUsage(),
-    timestamp: new Date().toISOString(),
-    services: {},
-  };
-
-  // 检查数据库连接
-  if (this.sql) {
-    try {
-      await this.sql.run('SELECT 1');
-      status.services.database = 'ok';
-    } catch {
-      status.services.database = 'error';
-      status.status = 'degraded';
-    }
-  }
-
-  // 检查缓存连接
-  if (this.cache) {
-    try {
-      await this.cache.ping();
-      status.services.cache = 'ok';
-    } catch {
-      status.services.cache = 'error';
-      status.status = 'degraded';
-    }
-  }
-
-  return status;
-};
-
-exports.App = App;