mm_machine 2.9.3 → 2.9.4

package/drive.js

@@ -1,377 +1,394 @@
-const prettier = require('@prettier/sync');
-require('mm_tpl');
-let { conf } = require('mm_config');
-// const { Word } = require('./ulits/word.js');
-const { Mod } = require('./mod');
-
-if (!$.prettyCode) {
-  $.prettyCode = function (code, options) {
-    return prettier.format(code, options);
-  };
-}
+/**
+ * Drive 驱动类
+ * 提供 JSON 配置文件加载、JS 脚本文件热重载、模板文件生成等能力
+ * @class Drive
+ * @augments Mod
+ */
+var path = require('path');
+var { Mod } = require('./mod');
 
 /**
- * 驱动基础类
- * @class
+ * 静态配置默认值
  */
-class Drive extends Mod {
-  // 配置项
-  static config = {
-    // 名称, 由中英文和下"_"组成, 用于卸载接口 例如: demo
-    name: '',
-    // 标题, 介绍作用
-    title: '',
-    // 描述, 用于描述该有什么用的
-    description: '',
-    // 文件路径, 当调用函数不存在时，会先从文件中加载
-    main: './index.js',
-    // 回调函数名 用于决定调用脚本的哪个函数
-    func_name: 'main',
-    // 作用域（同时作为检索的后缀名）
-    scope: $.val && $.val.scope ? $.val.scope : 'server',
-    // 排序
-    sort: 10,
-    // 状态, 0表示未启用, 1表示启用
-    state: 1,
-    // 显示, 0表示不显示, 1表示显示
-    show: 0,
-    // 是否结束，可选，默认false
-    end: false
-  };
+var defaultConfig = {
+  name: '',
+  title: '',
+  description: '',
+  main: '',
+  func_name: 'main',
+  scope: 0,
+  sort: 100,
+  mode: 3,
+  state: 1
+};
 
+class Drive extends Mod {
   /**
    * 构造函数
-   * @param {object} config 配置项
-   * @param {object} parent 父项
-   * @class
+   * @param {object} config 配置参数
+   * @param {object} [parent] 父对象
    */
   constructor(config, parent) {
-    super({ ...Drive.config, ...config }, parent);
-    // 当前配置文件路径
+    super({ ...defaultConfig, ...config, parent: parent });
+    this._config = {};
+    this._script = '';
+    this.is_loaded = false;
+    this._main_func = null;
+    this._watch = null;
+    this._notify_timer = null;
+    this._script_keys = null;
     this.config_file = '';
-
-    // 当前脚本文件路径
-    this.script_file = '';
-
-    // 模式: 1.生产模式 2.热更新模式 3.热重载模式 4.热更新+重载模式 5.重载模式
-    this.mode = 1;
+    this.config = { ...defaultConfig, ...config };
+    this.mode = this.config.mode;
   }
 }
 
+// ==================== 事件管理 ====================
+
 /**
  * 获取事件触发器
  * @returns {object} 事件触发器
  */
 Drive.prototype.getEventer = function () {
-  return $.eventer;
+  return typeof $.eventer !== 'undefined' ? $.eventer : this;
 };
 
 /**
- * 配置驱动
+ * 获取配置
+ * @returns {object} 配置对象
  */
-Drive.prototype._preset = function () {
-  let file = this.config.main;
-  if (file) {
-    this.script_file = file.fullname(this.getDir());
-  }
+Drive.prototype.getConfig = function () {
+  return this.config;
 };
 
 /**
- * 获取配置
- * @param {string} file 配置文件路径
- * @returns {object} 配置项
+ * 获取模板目录
+ * @returns {string} 模板目录
  */
-Drive.prototype._loadConfig = function (file) {
-  if (file) {
-    this.config_file = file;
-  }
-  // 加载配置
-  let config = $.loadJson(this.config_file, (cg) => {
-    this.setConfig(cg);
-    return cg;
-  });
-  if (!config) {
-    this.newConfig(this.config_file);
-    config = $.loadJson(this.config_file, (cg) => {
-      this.setConfig(cg);
-      return cg;
-    });
+Drive.prototype.getTplDir = function () {
+  if (!this.getParent) return '';
+  var parent = this.getParent();
+  return parent ? parent.getTplDir ? parent.getTplDir() : '' : '';
+};
+
+// ==================== 目录管理 ====================
+
+/**
+ * 获取模块目录
+ * 优先级：脚本文件目录 > 配置文件目录 > 父级目录 > 按名称拼接
+ * @returns {string} 目录路径
+ */
+Drive.prototype.getDir = function () {
+  if (this._dir) {
+    return this._dir;
+  }
+  if (this._script) {
+    this._dir = path.dirname(this._script);
+  } else if (this.config_file) {
+    this._dir = path.dirname(this.config_file);
+  } else if (this.getParent && this.getParent()) {
+    var parent_dir = this.getParent().getDir ? this.getParent().getDir() : '';
+    if (parent_dir && this.config.name) {
+      this._dir = path.resolve(parent_dir, this.config.name);
+    }
   }
-  this.setConfig(config);
-  return config;
+  return this._dir || '';
 };
 
+// ==================== 配置管理 ====================
+
 /**
- * 加载配置
- * @param {string} file 配置文件路径
+ * 预设处理
+ * 计算脚本文件路径
+ * @private
  */
-Drive.prototype.loadConfig = function (file) {
-  this._loadConfig(file);
+Drive.prototype._preset = function () {
+  var main = this.config.main;
+  if (main && this.config_file) {
+    this._script = path.resolve(path.dirname(this.config_file), main);
+  }
 };
 
 /**
  * 设置配置
- * @param {object} config 配置对象
- * @returns {object} 配置项
+ * 合并配置并触发变更通知
+ * @param {object} cfg 配置对象
+ * @returns {object} 合并后的配置
  */
-Drive.prototype.setConfig = function (config) {
-  if (config) {
-    // 如果main改变，重置加载状态
-    if (config.main !== this.config.main) {
-      this.is_loaded = false;
-    }
+Drive.prototype.setConfig = function (cfg) {
+  if (!cfg) {
+    return this.config;
+  }
 
-    if (this.config_file) {
-      // 合并配置并应用配置处理
-      this.config = conf(
-        {
-          ...this.config,
-          ...config
-        },
-        this.config_file
-      );
-    } else {
-      Object.assign(this.config, config);
-    }
+  // 如果 main 改变，重置加载状态
+  if (cfg.main !== undefined && cfg.main !== this.config.main) {
+    this.is_loaded = false;
   }
+
+  this.config = { ...this.config, ...cfg };
   this._preset();
-  // 通知父级刷新快照
-  this._notifySnapshot();
   return this.config;
 };
 
 /**
- * 通知父级Manager刷新快照（防抖）
+ * 加载配置
+ * 从 JSON 配置文件读取配置并合并
+ * @param {string} file 配置文件路径
+ * @returns {object} 配置对象
  */
-Drive.prototype._notifySnapshot = function () {
-  if (!this.getParent) {
-    return;
-  }
-  var parent = this.getParent();
-  if (!parent || !parent.config || !parent.config.use_snapshot) {
-    return;
-  }
-  // 防抖：避免频繁写文件，500ms内只刷新一次
-  if (this._snapshot_timer) {
-    return;
+Drive.prototype.loadConfig = function (file) {
+  if (file) {
+    this.config_file = file;
   }
-  this._snapshot_timer = setTimeout(() => {
-    this._snapshot_timer = null;
-    if (parent.refreshSnapshot) {
-      parent.refreshSnapshot();
-    }
-  }, 500);
+  return this._loadConfig();
 };
 
 /**
- * 获取配置
- * @returns {object} 配置项
+ * 内部加载配置
+ * 支持热更新模式（$.loadJson）和普通模式（require）
+ * @returns {object} 配置对象
+ * @private
  */
-Drive.prototype.getConfig = function () {
-  return this.config;
-};
+Drive.prototype._loadConfig = function () {
+  if (!this.config_file) {
+    return this.config;
+  }
 
-/**
- * 获取当前文件
- * @returns {object} 当前文件对象
- */
-Drive.prototype.getDir = function () {
-  let dir = this._dir;
-  if (!dir) {
-    if (this.script_file) {
-      dir = this.script_file.dirname();
-      this._dir = dir;
-    } else if (this.config_file) {
-      dir = this.config_file.dirname();
-      this._dir = dir;
-    } else if (this.getParent) {
-      let parent_dir = this.getParent()?.getDir() || '';
-      if (parent_dir) {
-        dir = this.config.name.fullname(parent_dir);
+  try {
+    var config;
+    if (this.mode === 2 || this.mode === 3 || this.mode === 4) {
+      // 热更新模式：使用 $.loadJson
+      if (typeof $.loadJson === 'function') {
+        config = $.loadJson(this.config_file, (cg) => {
+          this.setConfig(cg);
+          return cg;
+        });
       }
     }
+    if (!config) {
+      // 普通模式：使用 require 或 readFileSync
+      try {
+        config = require(this.config_file);
+      } catch {
+        var fs = require('fs');
+        var content = fs.readFileSync(this.config_file, 'utf8');
+        config = JSON.parse(content);
+      }
+    }
+    if (config) {
+      this.setConfig(config);
+    }
+  } catch {
+    // 配置文件不存在或解析失败，使用默认配置
   }
-  return dir;
-};
 
-/**
- * 获取模板目录
- * @returns {string} 模板目录
- */
-Drive.prototype._getTplDir = function () {
-  return this.getParent()?.getTplDir() || '';
+  return this.config;
 };
 
 /**
- * 移除加载的脚本模块
+ * 加载配置文件
+ * @param {string} file 文件路径
+ * @param {string} name 配置项名称
+ * @returns {object|null} 配置对象
  */
-Drive.prototype._remove = function () {
-  let file = this._getScriptFile();
-  if (!file) return;
-
+Drive.prototype.loadFile = function (file, name) {
   try {
-    if (this.mode === 3 || this.mode === 4) {
-      // 移除模块和监听
-      $.mod.unload(file);
-    } else {
-      // 移除模块缓存
-      let filename = require.resolve(file);
-      if (require.cache[filename]) {
-        require.cache[filename] = null;
-        delete require.cache[filename];
+    var fs = require('fs');
+    var filename = path.resolve(this.getDir(), file);
+    var text = '';
+
+    try {
+      text = fs.readFileSync(filename, 'utf8');
+    } catch {
+      // 文件不存在，创建新的配置文件
+      this.newConfig(filename);
+      try {
+        text = fs.readFileSync(filename, 'utf8');
+      } catch {
+        return null;
       }
     }
+
+    if (!text) return null;
+
+    var config = this._loadHotReload(filename);
+    var final_config = this._findConfigByName(config, name);
+    return final_config;
   } catch (err) {
-    this.log('error', `移除加载的脚本模块失败: `, err);
+    this.log('error', '加载配置文件失败: ', err);
+    return null;
   }
 };
 
 /**
- * 卸载脚本
+ * 根据模式加载配置（支持热更新）
+ * @param {string} file 完整文件路径
+ * @returns {object|Array|null} 配置对象
+ * @private
  */
-Drive.prototype.unloadScript = function () {
-  this._remove();
-  this._script_keys = null;
-  this.is_loaded = false;
+Drive.prototype._loadHotReload = function (file) {
+  if (this.mode === 2 || this.mode === 3 || this.mode === 4) {
+    if (typeof $.loadJson === 'function') {
+      return $.loadJson(file, this._handleHotReload.bind(this));
+    }
+  }
+  try {
+    return require(file);
+  } catch {
+    var fs = require('fs');
+    var content = fs.readFileSync(file, 'utf8');
+    return JSON.parse(content);
+  }
 };
 
 /**
- * 重新加载脚本
- * @returns {object | null} 返回加载的模块对象
+ * 热更新回调处理
+ * @param {object} config 配置对象
+ * @private
  */
-Drive.prototype.reloadScript = function () {
-  this.unloadScript();
-  return this.loadScript();
+Drive.prototype._handleHotReload = function (config) {
+  this.setConfig(config);
+  this._reloadIfNeeded();
+  return config;
 };
 
 /**
- * 卸载之后处理
- * @param {boolean} remove 是否删除文件
+ * 根据名称在配置数组中查找配置项
+ * @param {object|Array} config 配置对象或数组
+ * @param {string} name 配置项名称
+ * @returns {object|null} 匹配的配置项
+ * @private
  */
-Drive.prototype.unloadCore = async function (remove) {
-  // 删除脚本
-  this.unloadScript();
-  if (remove) {
-    this.delFile();
+Drive.prototype._findConfigByName = function (config, name) {
+  if (!name || !Array.isArray(config)) return config;
+  return config.find((item) => item.name === name) || null;
+};
+
+/**
+ * 根据模式决定是否重新加载脚本
+ * @private
+ */
+Drive.prototype._reloadIfNeeded = function () {
+  if (this.mode === 3 || this.mode === 4) {
+    this.reloadScript();
   }
 };
 
+// ==================== 脚本管理 ====================
+
 /**
  * 获取脚本文件路径
- * @returns {string | null} 完整文件路径
+ * @returns {string|null} 完整文件路径
+ * @private
  */
 Drive.prototype._getScriptFile = function () {
-  let main = this.config.main || '';
+  var main = this.config.main || '';
   if (!main) return null;
 
-  let filename = main.fullname(this.getDir());
-  if (!filename.hasFile()) {
+  var filename = path.resolve(this.getDir(), main);
+  var fs = require('fs');
+  if (!fs.existsSync(filename)) {
     this.newScript(filename);
   }
   return filename;
 };
 
 /**
- * 新建脚本文件
- * @param {string} file 目标文件路径
+ * 加载脚本
+ * 检查 main 配置，require 脚本文件并注册方法
+ * @returns {boolean} 是否加载成功
+ * @private
  */
-Drive.prototype.newScript = function (file) {
-  this._createScriptFile(file);
-};
+Drive.prototype._loadScript = function () {
+  var main = this.config.main;
+  if (!main) {
+    // 配置型模块，无脚本
+    return false;
+  }
 
-/**
- * 创建脚本
- * @param {string} file 文件路径
- * @returns {boolean} 创建是否成功
- */
-Drive.prototype._createScriptFile = function (file) {
-  var tpl = this._getScriptTpl();
-  var content = $.tpl.render(tpl, this.getModel('script'));
-  if (!content) {
-    return '';
+  var script_path = this._script;
+  if (!script_path) {
+    return false;
   }
-  let code = this.prettyCode(content, 'js');
-  file.saveText(code);
-  return file;
-};
 
-/**
- * 获取脚本模板
- * @returns {string} 脚本模板内容
- */
-Drive.prototype._getScriptTpl = function () {
-  var f = './script.tpl.js'.fullname(this._getTplDir());
-  if (f.hasFile()) {
-    return f.loadText();
-  } else {
-    return `module.exports = {
-  /**
-   * 初始化
-   */
-  async _init() {
-    this.log('debug', \`初始化！\`);
-  },
-  /**
-   * 启动
-   */
-  async _start() {
-    this.log('debug', \`启动！\`);
-  },
-  /**
-   * 停止
-   */
-  async _stop() {
-    this.log('debug', \`停止！\`);
-  },
-  /**
-   * 销毁
-   */
-  async _destroy(...args) {
-    this.log('debug', \`销毁！\`);
-  },
-  /**
-   * 主要逻辑
-   */
-  async main(...args) {
-    // 主要代码写在这
+  var fs = require('fs');
+  if (!fs.existsSync(script_path)) {
+    return false;
   }
-}`;
+
+  try {
+    var exports;
+    if (this.mode === 3 || this.mode === 4) {
+      // 开发模式：使用 $.require 进行热重载
+      if (typeof $.require === 'function') {
+        exports = $.require(script_path, (mod) => {
+          this._setMainMethod(mod);
+        });
+      } else {
+        exports = require(script_path);
+      }
+    } else {
+      // 生产模式：清除缓存后 require
+      try {
+        var resolved = require.resolve(script_path);
+        if (require.cache[resolved]) {
+          delete require.cache[resolved];
+        }
+      } catch {
+        // 模块未缓存，忽略
+      }
+      exports = require(script_path);
+    }
+
+    this._setMainMethod(exports);
+    this.is_loaded = true;
+    return true;
+  } catch {
+    // 脚本加载失败
+    this.is_loaded = false;
+    return false;
   }
 };
 
 /**
- * 加载脚本文件，支持热重载模式
- * 在开发模式(mode=3或4)下使用 $.require 进行热重载
- * 在生产模式下使用标准的 require 加载
- * @returns {object | null} 加载的模块对象
+ * 加载脚本文件（外部接口）
+ * 在开发模式下使用 $.require 进行热重载，在生产模式下使用标准 require
+ * @returns {object|null} 加载的模块对象
  */
 Drive.prototype.loadScript = function () {
-  let file = this._getScriptFile();
+  var file = this._getScriptFile();
   if (!file) return null;
+
   if (this.mode === 3 || this.mode === 4) {
-    // 开发模式：使用 $.require 进行热重载，绑定热更新回调
-    var cs = $.require(file, (mod) => {
-      this._setMainMethod(mod);
-    });
-    this._setMainMethod(cs);
-    return cs;
-  } else {
-    var cs = require(file);
-    this._setMainMethod(cs);
-    return cs;
+    // 开发模式：使用 $.require 进行热重载
+    if (typeof $.require === 'function') {
+      var cs = $.require(file, (mod) => {
+        this._setMainMethod(mod);
+      });
+      this._setMainMethod(cs);
+      return cs;
+    }
   }
+
+  var cs = require(file);
+  this._setMainMethod(cs);
+  return cs;
 };
 
 /**
  * 设置主方法
- * @param {object} mod 模块对象
+ * 从脚本导出对象中注册方法和数据
+ * @param {object} mod 脚本导出对象
+ * @private
  */
 Drive.prototype._setMainMethod = function (mod) {
   if (!mod) return;
+
   var name = this.config.func_name || 'main';
   if (name && mod[name]) {
-    this.main = mod[name];
+    this._main_func = mod[name];
   }
+
   var new_keys = Object.keys(mod);
   // 热重载时如果脚本未变化则跳过重建
   if (this._script_keys && this._script_keys.length === new_keys.length) {
@@ -387,355 +404,516 @@ Drive.prototype._setMainMethod = function (mod) {
       return;
     }
   }
+
   this._script_keys = new_keys;
   for (var key in mod) {
     var obj = mod[key];
     if (typeof obj === 'function') {
       this.setMethod(key, obj);
     } else {
-      this.setData(key, obj);
+      try {
+        // eslint-disable-next-line mm_eslint/function-name
+        this.setData(key, obj);
+      } catch {
+        // 忽略类型错误
+      }
     }
   }
   this.is_loaded = true;
 };
 
 /**
- * 获取配置文件作用域
- * @param {object} file 文件对象
- * @returns {string} 配置文件作用域
+ * 移除加载的脚本模块
+ * @private
  */
-Drive.prototype._getScope = function (file) {
-  return file.replace(/\\/g, '/').between('app/', '/');
-};
+Drive.prototype._remove = function () {
+  var file = this._getScriptFile();
+  if (!file) return;
 
-/**
- * 新建配置文件
- * @param {string} file 目标文件路径
- */
-Drive.prototype.newConfig = function (file) {
-  if (!this.config.name) {
-    this.config.name = this._getName(file);
-    this.config.scope = this._getScope(file);
+  try {
+    if (this.mode === 3 || this.mode === 4) {
+      // 移除模块和监听
+      if (typeof $.unload === 'function') {
+        $.unload(file);
+      }
+    } else {
+      // 移除模块缓存
+      try {
+        var filename = require.resolve(file);
+        if (require.cache[filename]) {
+          delete require.cache[filename];
+        }
+      } catch {
+        // 忽略
+      }
+    }
+  } catch (err) {
+    this.log('error', '移除加载的脚本模块失败: ', err);
   }
-  this._createConfigFile(file);
 };
 
 /**
- * 预试代码
- * @param {string} code 要预试的代码
- * @param {string} type 预试类型，可选"json"或"js"
- * @returns {string} 预试后的代码字符串
+ * 卸载脚本
+ * 清除 require.cache，重置加载状态
  */
-Drive.prototype.prettyCode = function (code, type = 'json5') {
-  let options = {
-    tabWidth: 2
-  };
-  switch (type) {
-    case 'json5':
-      options.parser = 'json5';
-      break;
-    case 'js':
-    case 'javascript':
-      options.parser = 'babel';
-      options.semi = true; // 在语句末尾添加分号
-      options.singleQuote = true; // 使用单引号
-      break;
-    default:
-      options.parser = 'json';
-      break;
-  }
-  let new_code = $.prettyCode(code, options);
-  return new_code;
+Drive.prototype.unloadScript = function () {
+  this._remove();
+  this._script_keys = null;
+  this.is_loaded = false;
 };
 
 /**
- * 获取模块模型
- * @param {string} type 模型类型，可选"config"或"script"
- * @returns {object} 模块模型
+ * 重新加载脚本
+ * @returns {object|null} 返回加载的模块对象
  */
-Drive.prototype.getModel = function (type) {
-  return this.config;
+Drive.prototype.reloadScript = function () {
+  this.unloadScript();
+  return this.loadScript();
 };
 
 /**
- * 创建配置文件
- * @param {string} file 目标文件路径
- * @param {object} model 模块模型
- * @returns {string} 配置文件内容
+ * 加载前处理
  */
-Drive.prototype._createConfigFile = function (file, model) {
-  var tpl = this._getConfigTpl();
-  var content = $.tpl.render(tpl, model || this.getModel('config'));
-  let code = this.prettyCode(content, 'json');
-  file.saveText(code);
-  return file;
+Drive.prototype.loadBefore = function () {
+  try {
+    var module = this.loadScript();
+    if (module) {
+      this.is_loaded = true;
+    }
+  } catch (err) {
+    this.log('error', '加载前处理失败: ', err);
+    this.is_loaded = false;
+  }
 };
 
-/**
- * 创建配置文件
- * @param {string} file 目标文件路径
- * @param {object} model 模块模型
- * @returns {string} 配置文件内容
- */
-Drive.prototype.createConfigFile = function (file, model) {
-  file.addDir();
-  return this._createConfigFile(file, model);
-};
+// ==================== 文件操作 ====================
 
 /**
- * 获取配置模板
- * @returns {string} 配置模板内容
+ * 保存配置
  */
-Drive.prototype._getConfigTpl = function () {
-  var f = './config.tpl.json'.fullname(this._getTplDir());
-  if (f.hasFile()) {
-    return f.loadText();
-  } else {
-    return `{
-  // 模块名称，必填
-  "name": "\${name}",
-  // 模块标题，可选，默认"示例标题"
-  "title": "\${title || '示例标题'}",
-  // 模块描述，可选，默认"示例描述"
-  "description": "\${description || '示例描述'}",
-  // 主脚本文件路径，可选，默认"./index.js"
-  "main": "\${main || './index.js'}",
-  // 模块作用域，可选，默认"server"
-  "scope": "\${scope || 'server'}",
-  // 模块状态，可选，默认1
-  "state": \${state || 1},
-  // 模块排序，可选，默认100
-  "sort": \${sort || 100},
-  // 是否结束，可选，默认false
-  "end": \${end || false}
-}`;
-  }
-};
+Drive.prototype.save = function () {
+  var file = this._script || this.config_file;
+  if (!file) return;
 
-/**
- * 加载配置文件
- * @param {string} file 文件路径
- * @param {string} name 配置项名称
- * @returns {object | null} 配置对象
- */
-Drive.prototype.loadFile = function (file, name) {
+  var fs = require('fs');
   try {
-    let filename = file.fullname(this.getDir());
-    let text = filename.loadText();
+    var text = fs.readFileSync(file, 'utf8');
 
-    // 如果文件不存在，创建新的配置文件
-    if (!text) {
-      this.newConfig(filename);
-      text = filename.loadText();
+    if (text && text.trim().startsWith('[')) {
+      // 数组格式配置
+      var config = JSON.parse(text);
+      if (Array.isArray(config)) {
+        var index = config.findIndex((item) => item.name === this.config.name);
+        if (index !== -1) {
+          config[index] = this.config;
+        } else {
+          config.push(this.config);
+        }
+        fs.writeFileSync(file, JSON.stringify(config, null, 2), 'utf8');
+        return;
+      }
     }
 
-    if (!text) return null;
-
-    let config = this._loadHotReload(filename);
-    let final_config = this._findConfigByName(config, name);
-    return final_config;
+    // 单对象格式配置，直接保存
+    fs.writeFileSync(file, JSON.stringify(this.config, null, 2), 'utf8');
   } catch (err) {
-    this.log('error', `加载配置文件失败: `, err);
-    return null;
-  }
-};
-
-/**
- * 根据模式加载配置（支持热更新）
- * @param {string} file 完整文件路径
- * @returns {object | Array | null} 配置对象
- */
-Drive.prototype._loadHotReload = function (file) {
-  if (this.mode === 2 || this.mode === 3 || this.mode === 4) {
-    return $.loadJson(file, this._handleHotReload.bind(this));
+    this.log('error', '保存配置失败: ', err);
   }
-  return file.loadJson();
-};
-
-/**
- * 根据名称在配置数组中查找配置项
- * @param {object | Array} config 配置对象或数组
- * @param {string} name 配置项名称
- * @returns {object | null} 匹配的配置项
- */
-Drive.prototype._findConfigByName = function (config, name) {
-  if (!name || !Array.isArray(config)) return config;
-  return config.find((Drive) => Drive.name === name) || null;
 };
 
 /**
- * 根据模式决定是否重新加载脚本
+ * 删除项目
+ * @returns {string|null} 删除的目录路径
  */
-Drive.prototype._reloadIfNeeded = function () {
-  if (this.mode === 3 || this.mode === 4) {
-    this.reloadScript();
+Drive.prototype.remove = function () {
+  var dir = this.getDir();
+  if (dir) {
+    var fs = require('fs');
+    try {
+      fs.rmdirSync(dir, { recursive: true });
+    } catch {
+      // 忽略
+    }
   }
+  return dir;
 };
 
 /**
  * 删除目录
  */
 Drive.prototype.delDir = function () {
-  let main = this.config.main;
-  if (main && $.dir && $.dir.del) {
-    $.dir.del(this.dir);
+  var dir = this.getDir();
+  if (dir) {
+    var fs = require('fs');
+    try {
+      fs.rmdirSync(dir, { recursive: true });
+    } catch {
+      // 忽略
+    }
   }
 };
 
 /**
  * 删除配置和脚本文件
- * @returns {string | null} 错误消息，如果没有错误则返回null
+ * @returns {string|null} 错误消息，如果没有错误则返回 null
  */
 Drive.prototype.delFile = function () {
-  let name = this.config.name;
-  let file = this.script_file;
+  var fs = require('fs');
+  var name = this.config.name;
+  var file = this._script || this.config_file;
 
-  let error_message = null;
   try {
-    if (!file || !file.hasFile) return null;
-
-    if (!file.hasFile()) {
-      return '配置文件不存在';
-    }
+    if (!file) return null;
+    if (!fs.existsSync(file)) return '文件不存在';
 
-    error_message = this._delConfigFile(file, name);
+    return this._delConfigFile(file, name);
   } catch (err) {
-    this.log('error', `删除文件失败: `, err);
-    error_message = `删除失败: ${err.message}`;
+    this.log('error', '删除文件失败: ', err);
+    return '删除失败: ' + (err.message || '');
   }
-  return error_message;
 };
 
 /**
  * 删除配置文件
- * @param {object} file 文件对象
+ * @param {string} file 文件路径
  * @param {string} name 配置名称
- * @returns {string | null} 错误消息
+ * @returns {string|null} 错误消息
+ * @private
  */
 Drive.prototype._delConfigFile = function (file, name) {
-  let text = file.loadText();
-  if (!text) {
+  var fs = require('fs');
+  try {
+    var text = fs.readFileSync(file, 'utf8');
+    if (!text) {
+      this.delDir();
+      return null;
+    }
+
+    var config = JSON.parse(text);
+    if (Array.isArray(config)) {
+      return this._delArray(file, config, name);
+    }
+
+    this.delDir();
+    return null;
+  } catch {
     this.delDir();
     return null;
   }
-
-  let config = text.toJson();
-  if (Array.isArray(config)) {
-    return this._delArray(file, config, name);
-  }
-
-  this.delDir();
-  return null;
 };
 
 /**
  * 从数组配置中删除指定项
- * @param {object} file 文件对象
+ * @param {string} file 文件路径
  * @param {Array} config 配置数组
  * @param {string} name 配置名称
- * @returns {string | null} 错误消息
+ * @returns {string|null} 错误消息
+ * @private
  */
 Drive.prototype._delArray = function (file, config, name) {
-  let index = config.findIndex((Drive) => Drive.name === name);
+  var fs = require('fs');
+  var index = config.findIndex((item) => item.name === name);
   if (index === -1) return null;
 
-  this.delDir();
   config.splice(index, 1);
 
   if (config.length > 0) {
-    file.saveText(JSON.stringify(config, null, 2));
-  } else if (file.delFile) {
-    file.delFile();
+    fs.writeFileSync(file, JSON.stringify(config, null, 2), 'utf8');
+  } else {
+    try {
+      fs.unlinkSync(file);
+    } catch {
+      // 忽略
+    }
   }
 
+  this.delDir();
   return null;
 };
 
 /**
  * 获取配置文件名称
- * @param {object} file 文件对象
+ * @param {string} file 文件路径
  * @returns {string} 配置文件名称
+ * @private
  */
 Drive.prototype._getName = function (file) {
-  let name = file.dirname().basename();
-  return name;
-  // // 提取文件名作为模块名
-  // var word = new Word();
-  // // 将文件名改为驼峰命名法
-  // return word.toCamelCase(name);
+  return path.basename(path.dirname(file));
 };
 
 /**
- * 加载前处理
+ * 获取配置文件作用域
+ * @param {string} file 文件路径
+ * @returns {string} 配置文件作用域
+ * @private
  */
-Drive.prototype.loadBefore = function () {
-  try {
-    let module = this.loadScript();
-    if (module) {
-      this.is_loaded = true;
-    }
-  } catch (err) {
-    this.log('error', `加载前处理失败: `, err);
-    this.is_loaded = false;
+Drive.prototype._getScope = function (file) {
+  var normalized = file.replace(/\\/g, '/');
+  var idx = normalized.indexOf('app/');
+  if (idx === -1) return '';
+  return normalized.substring(idx + 4, normalized.indexOf('/', idx + 4));
+};
+
+// ==================== 模板/文件创建 ====================
+
+/**
+ * 获取脚本模板
+ * @returns {string} 脚本模板内容
+ * @private
+ */
+Drive.prototype._getScriptTpl = function () {
+  var fs = require('fs');
+  var f = path.resolve(this.getTplDir(), 'script.tpl.js');
+  if (fs.existsSync(f)) {
+    return fs.readFileSync(f, 'utf8');
+  }
+  return 'module.exports = {\n' +
+    '  /**\n' +
+    '   * 初始化\n' +
+    '   */\n' +
+    '  async _init() {\n' +
+    "    this.log('debug', '初始化！');\n" +
+    '  },\n' +
+    '  /**\n' +
+    '   * 启动\n' +
+    '   */\n' +
+    '  async _start() {\n' +
+    "    this.log('debug', '启动！');\n" +
+    '  },\n' +
+    '  /**\n' +
+    '   * 停止\n' +
+    '   */\n' +
+    '  async _stop() {\n' +
+    "    this.log('debug', '停止！');\n" +
+    '  },\n' +
+    '  /**\n' +
+    '   * 销毁\n' +
+    '   */\n' +
+    '  async _destroy() {\n' +
+    "    this.log('debug', '销毁！');\n" +
+    '  },\n' +
+    '  /**\n' +
+    '   * 主要逻辑\n' +
+    '   */\n' +
+    '  async main() {\n' +
+    '    // 主要代码写在这\n' +
+    '  }\n' +
+    '};\n';
+};
+
+/**
+ * 获取配置模板
+ * @returns {string} 配置模板内容
+ * @private
+ */
+Drive.prototype._getConfigTpl = function () {
+  var fs = require('fs');
+  var f = path.resolve(this.getTplDir(), 'config.tpl.json');
+  if (fs.existsSync(f)) {
+    return fs.readFileSync(f, 'utf8');
   }
+  return '{\n' +
+    '  "name": "${name}",\n' +
+    '  "title": "${title || \'示例标题\'}",\n' +
+    '  "description": "${description || \'示例描述\'}",\n' +
+    '  "main": "${main || \'./index.js\'}",\n' +
+    '  "scope": "${scope || \'server\'}",\n' +
+    '  "state": ${state || 1},\n' +
+    '  "sort": ${sort || 100}\n' +
+    '}\n';
 };
 
 /**
- * 加载处理
+ * 获取模块模型
+ * @param {string} type 模型类型，可选 "config" 或 "script"
+ * @returns {object} 模块模型
  */
-Drive.prototype._loadCore = function () {
-  // this.loadConfig();
-  // this.loadScript();
+Drive.prototype.getModel = function (type) {
+  return this.config;
 };
 
 /**
- * 保存配置
+ * 新建配置文件
+ * @param {string} file 目标文件路径
  */
-Drive.prototype.save = function () {
-  try {
-    if (!this.script_file) return;
+Drive.prototype.newConfig = function (file) {
+  if (!this.config.name) {
+    this.config.name = this._getName(file);
+    this.config.scope = this._getScope(file);
+  }
+  this._createConfigFile(file);
+};
 
-    let file = this.script_file.fullname(this.getDir());
-    let text = file.loadText();
+/**
+ * 创建配置文件
+ * @param {string} file 目标文件路径
+ * @param {object} model 模块模型
+ * @returns {string} 文件路径
+ */
+Drive.prototype._createConfigFile = function (file, model) {
+  var fs = require('fs');
+  var tpl = this._getConfigTpl();
+  var content = this._renderTpl(tpl, model || this.getModel('config'));
+  var code = this.prettyCode(content, 'json');
+  var dir = path.dirname(file);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(file, code, 'utf8');
+  return file;
+};
 
-    if (text && text.trim().startsWith('[')) {
-      // 数组格式配置
-      let config = text.toJson();
-      if (Array.isArray(config)) {
-        // 查找并更新现有配置项
-        let index = config.findIndex((Drive) => Drive.name === this.config.name);
-        if (index !== -1) {
-          config[index] = this.config;
-        } else {
-          // 如果不存在，添加新配置项
-          config.push(this.config);
-        }
-        file.saveText(JSON.stringify(config, null, 2));
-        return;
-      }
+/**
+ * 创建配置文件（带目录创建）
+ * @param {string} file 目标文件路径
+ * @param {object} model 模块模型
+ * @returns {string} 文件路径
+ */
+Drive.prototype.createConfigFile = function (file, model) {
+  var fs = require('fs');
+  var dir = path.dirname(file);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  return this._createConfigFile(file, model);
+};
+
+/**
+ * 新建脚本文件
+ * @param {string} file 目标文件路径
+ */
+Drive.prototype.newScript = function (file) {
+  this._createScriptFile(file);
+};
+
+/**
+ * 创建脚本文件
+ * @param {string} file 文件路径
+ * @returns {string} 文件路径
+ * @private
+ */
+Drive.prototype._createScriptFile = function (file) {
+  var fs = require('fs');
+  var tpl = this._getScriptTpl();
+  var content = this._renderTpl(tpl, this.getModel('script'));
+  var code = this.prettyCode(content, 'js');
+  var dir = path.dirname(file);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  fs.writeFileSync(file, code, 'utf8');
+  return file;
+};
+
+/**
+ * 渲染模板（简单替换 ${key} 占位符）
+ * @param {string} tpl 模板内容
+ * @param {object} model 模型数据
+ * @returns {string} 渲染后的内容
+ * @private
+ */
+Drive.prototype._renderTpl = function (tpl, model) {
+  return tpl.replace(/\$\{([^}]+)\}/g, (match, key) => {
+    // 处理默认值表达式：${key || 'default'}
+    var parts = key.split('||').map((s) => s.trim());
+    var var_name = parts[0];
+    var default_val = '';
+    if (parts.length > 1) {
+      default_val = parts[1].replace(/^['"]|['"]$/g, '');
     }
+    var val = model ? model[var_name] : undefined;
+    return val !== undefined && val !== null ? val : default_val;
+  });
+};
 
-    // 单对象格式配置，直接保存
-    file.saveText(JSON.stringify(this.config, null, 2));
-  } catch (err) {
-    this.log('error', `保存配置失败: `, err);
+/**
+ * 美化代码
+ * @param {string} code 代码字符串
+ * @param {string} type 代码类型，可选 "json" 或 "js"
+ * @returns {string} 美化后的代码
+ */
+Drive.prototype.prettyCode = function (code, type) {
+  if (typeof $.prettyCode === 'function') {
+    var options = {
+      tab_width: 2
+    };
+    switch (type) {
+      case 'json5':
+      case 'json':
+        options.parser = 'json5';
+        break;
+      case 'js':
+      case 'javascript':
+        options.parser = 'babel';
+        options.semi = true;
+        options.singleQuote = true;
+        break;
+      default:
+        options.parser = 'json';
+        break;
+    }
+    return $.prettyCode(code, options);
   }
+  return code;
 };
 
+// ==================== 生命周期重写 ====================
+
 /**
- * 删除项目
+ * 加载核心
+ * 加载配置文件和脚本文件
+ * @returns {Promise<void>}
+ * @private
+ * @override
  */
-Drive.prototype.remove = function () {
-  let dir = this.getDir();
-  if (dir) {
-    dir.delDir();
+Drive.prototype._loadCore = async function () {
+  if (this.lifecycle_state !== 'created') {
+    throw new Error('模块未创建，无法加载');
+  }
+
+  this.emit('load:before');
+
+  try {
+    // 加载配置
+    this._loadConfig();
+    // 加载脚本
+    this._loadScript();
+    this.lifecycle_state = 'loaded';
+    this.emit('load:success');
+  } catch (err) {
+    this.emit('load:error', err);
+    throw err;
   }
-  return dir;
 };
 
 /**
- * @module 导出Drive类
+ * 结束核心
+ * 先调用 _end 钩子，再卸载脚本
+ * @returns {Promise<void>}
+ * @private
+ * @override
  */
-module.exports = {
-  Drive
+Drive.prototype._endCore = async function () {
+  if (this.lifecycle_state !== 'started' && this.lifecycle_state !== 'paused') {
+    throw new Error('模块未启动或暂停，无法结束');
+  }
+
+  this.emit('end:before');
+
+  try {
+    var end_hook = this.getMethod('_end');
+    if (end_hook) {
+      end_hook(this);
+    }
+
+    // 卸载脚本
+    this.unloadScript();
+    this.lifecycle_state = 'ended';
+    this.emit('end:success');
+  } catch (err) {
+    this.emit('end:error', err);
+    throw err;
+  }
 };
+
+module.exports = { Drive };