mm_machine 2.7.6 → 2.7.8

package/drive.js

@@ -1,699 +1,716 @@
-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);
-  };
-}
-
-/**
- * 驱动基础类
- * @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
-  };
-
-  /**
-   * 构造函数
-   * @param {object} config 配置项
-   * @param {object} parent 父项
-   * @class
-   */
-  constructor(config, parent) {
-    super({ ...Drive.config, ...config }, parent);
-    // 当前配置文件路径
-    this.config_file = '';
-
-    // 当前脚本文件路径
-    this.script_file = '';
-
-    // 模式: 1.生产模式 2.热更新模式 3.热重载模式 4.热更新+重载模式 5.重载模式
-    this.mode = 1;
-  }
-}
-
-/**
- * 获取事件触发器
- * @returns {object} 事件触发器
- */
-Drive.prototype.getEventer = function () {
-  return $.eventer;
-};
-
-/**
- * 配置驱动
- */
-Drive.prototype._preset = function () {
-  let file = this.config.main;
-  if (file) {
-    this.script_file = file.fullname(this.getDir());
-  }
-};
-
-/**
- * 获取配置
- * @param {string} file 配置文件路径
- * @returns {object} 配置项
- */
-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;
-    });
-  }
-  this.setConfig(config);
-  return config;
-};
-
-/**
- * 加载配置
- * @param {string} file 配置文件路径
- */
-Drive.prototype.loadConfig = function (file) {
-  this._loadConfig(file);
-};
-
-/**
- * 设置配置
- * @param {object} config 配置对象
- * @returns {object} 配置项
- */
-Drive.prototype.setConfig = function (config) {
-  if (config) {
-    // 如果main改变，重置加载状态
-    if (config.main !== this.config.main) {
-      this.is_loaded = false;
-    }
-
-    if (this.config_file) {
-      // 合并配置并应用配置处理
-      this.config = conf({
-        ...this.config,
-        ...config
-      }, this.config_file);
-    }
-    else {
-      Object.assign(this.config, config);
-    }
-  }
-  this._preset();
-  return this.config;
-};
-
-/**
- * 获取配置
- * @returns {object} 配置项
- */
-Drive.prototype.getConfig = function () {
-  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);
-      }
-    }
-  }
-  return dir;
-};
-
-/**
- * 获取模板目录
- * @returns {string} 模板目录
- */
-Drive.prototype._getTplDir = function () {
-  return this.getParent()?.getTplDir() || '';
-};
-
-/**
- * 移除加载的脚本模块
- */
-Drive.prototype._remove = function () {
-  let file = this._getScriptFile();
-  if (!file) return;
-
-  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];
-      }
-    }
-  } catch (err) {
-    this.log('error', `移除加载的脚本模块失败: `, err);
-  }
-};
-
-/**
- * 卸载脚本
- */
-Drive.prototype.unloadScript = function () {
-  this._remove();
-  this.is_loaded = false;
-};
-
-/**
- * 重新加载脚本
- * @returns {object | null} 返回加载的模块对象
- */
-Drive.prototype.reloadScript = function () {
-  this.unloadScript();
-  return this.loadScript();
-};
-
-/**
- * 卸载之后处理
- * @param {boolean} remove 是否删除文件
- */
-Drive.prototype.unloadCore = async function (remove) {
-  // 删除脚本
-  this.unloadScript();
-  if (remove) {
-    this.delFile();
-  }
-};
-
-/**
- * 获取脚本文件路径
- * @returns {string | null} 完整文件路径
- */
-Drive.prototype._getScriptFile = function () {
-  let main = this.config.main || '';
-  if (!main) return null;
-
-  let filename = main.fullname(this.getDir());
-  if (!filename.hasFile()) {
-    this.newScript(filename);
-  }
-  return filename;
-};
-
-/**
- * 新建脚本文件
- * @param {string} file 目标文件路径
- */
-Drive.prototype.newScript = function (file) {
-  this._createScriptFile(file);
-};
-
-/**
- * 创建脚本
- * @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 '';
-  }
-  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) {
-    // 主要代码写在这
-  }
-}`;
-  }
-
-};
-
-/**
- * 加载脚本文件，支持热重载模式
- * 在开发模式(mode=3或4)下使用 $.require 进行热重载
- * 在生产模式下使用标准的 require 加载
- * @returns {object | null} 加载的模块对象
- */
-Drive.prototype.loadScript = function () {
-  let 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;
-  }
-};
-
-/**
- * 设置主方法
- * @param {object} mod 模块对象
- */
-Drive.prototype._setMainMethod = function (mod) {
-  if (!mod) return;
-  let name = this.config.func_name || 'main';
-  if (name && mod[name]) {
-    this.main = mod[name];
-  }
-  for (let key in mod) {
-    let obj = mod[key];
-    if (typeof obj === 'function') {
-      this.setMethod(key, obj);
-    }
-    else {
-      this.setData(key, obj);
-    }
-  }
-  this.is_loaded = true;
-};
-
-/**
- * 获取配置文件作用域
- * @param {object} file 文件对象
- * @returns {string} 配置文件作用域
- */
-Drive.prototype._getScope = function (file) {
-  return file.replace(/\\/g, '/').between('app/', '/');
-};
-
-/**
- * 新建配置文件
- * @param {string} file 目标文件路径
- */
-Drive.prototype.newConfig = function (file) {
-  if (!this.config.name) {
-    this.config.name = this._getName(file);
-    this.config.scope = this._getScope(file);
-  }
-  this._createConfigFile(file);
-};
-
-/**
- * 预试代码
- * @param {string} code 要预试的代码
- * @param {string} type 预试类型，可选"json"或"js"
- * @returns {string} 预试后的代码字符串
- */
-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;
-};
-
-/**
- * 获取模块模型
- * @param {string} type 模型类型，可选"config"或"script"
- * @returns {object} 模块模型
- */
-Drive.prototype.getModel = function (type) {
-  return this.config;
-};
-
-/**
- * 创建配置文件
- * @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;
-};
-
-/**
- * 创建配置文件
- * @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}
-}`;
-  }
-};
-
-/**
- * 加载配置文件
- * @param {string} file 文件路径
- * @param {string} name 配置项名称
- * @returns {object | null} 配置对象
- */
-Drive.prototype.loadFile = function (file, name) {
-  try {
-    let filename = file.fullname(this.getDir());
-    let text = filename.loadText();
-
-    // 如果文件不存在，创建新的配置文件
-    if (!text) {
-      this.newConfig(filename);
-      text = filename.loadText();
-    }
-
-    if (!text) return null;
-
-    let config = this._loadHotReload(filename);
-    let final_config = this._findConfigByName(config, name);
-    return final_config;
-  } 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));
-  }
-  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;
-};
-
-/**
- * 根据模式决定是否重新加载脚本
- */
-Drive.prototype._reloadIfNeeded = function () {
-  if (this.mode === 3 || this.mode === 4) {
-    this.reloadScript();
-  }
-};
-
-/**
- * 删除目录
- */
-Drive.prototype.delDir = function () {
-  let main = this.config.main;
-  if (main && $.dir && $.dir.del) {
-    $.dir.del(this.dir);
-  }
-};
-
-/**
- * 删除配置和脚本文件
- * @returns {string | null} 错误消息，如果没有错误则返回null
- */
-Drive.prototype.delFile = function () {
-  let name = this.config.name;
-  let file = this.script_file;
-
-  let error_message = null;
-  try {
-    if (!file || !file.hasFile) return null;
-
-    if (!file.hasFile()) {
-      return '配置文件不存在';
-    }
-
-    error_message = this._delConfigFile(file, name);
-  } catch (err) {
-    this.log('error', `删除文件失败: `, err);
-    error_message = `删除失败: ${err.message}`;
-  }
-  return error_message;
-};
-
-/**
- * 删除配置文件
- * @param {object} file 文件对象
- * @param {string} name 配置名称
- * @returns {string | null} 错误消息
- */
-Drive.prototype._delConfigFile = function (file, name) {
-  let text = file.loadText();
-  if (!text) {
-    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 {Array} config 配置数组
- * @param {string} name 配置名称
- * @returns {string | null} 错误消息
- */
-Drive.prototype._delArray = function (file, config, name) {
-  let index = config.findIndex((Drive) => Drive.name === name);
-  if (index === -1) return null;
-
-  this.delDir();
-  config.splice(index, 1);
-
-  if (config.length > 0) {
-    file.saveText(JSON.stringify(config, null, 4));
-  } else if (file.delFile) {
-    file.delFile();
-  }
-
-  return null;
-};
-
-/**
- * 获取配置文件名称
- * @param {object} file 文件对象
- * @returns {string} 配置文件名称
- */
-Drive.prototype._getName = function (file) {
-  let name = file.dirname().basename();
-  return name;
-  // // 提取文件名作为模块名
-  // var word = new Word();
-  // // 将文件名改为驼峰命名法
-  // return word.toCamelCase(name);
-};
-
-/**
- * 加载处理
- */
-Drive.prototype._loadCore = function () {
-  try {
-    let module = this.loadScript();
-    if (module) {
-      this.is_loaded = true;
-    }
-  } catch (err) {
-    this.log('error', `加载前处理失败: `, err);
-    this.is_loaded = false;
-  }
-  // this.loadConfig();
-  // this.loadScript();
-};
-
-/**
- * 保存配置
- */
-Drive.prototype.save = function () {
-  try {
-    if (!this.script_file) return;
-
-    let file = this.script_file.fullname(this.getDir());
-    let text = file.loadText();
-
-    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;
-      }
-    }
-
-    // 单对象格式配置，直接保存
-    file.saveText(JSON.stringify(this.config, null, 2));
-  } catch (err) {
-    this.log('error', `保存配置失败: `, err);
-  }
-};
-
-/**
- * 删除项目
- */
-Drive.prototype.remove = function () {
-  let dir = this.getDir();
-  if (dir) {
-    dir.delDir();
-  }
-  return dir;
-};
-
-/**
- * @module 导出Drive类
- */
-module.exports = {
-  Drive
-};
+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);
+  };
+}
+
+/**
+ * 驱动基础类
+ * @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
+  };
+
+  /**
+   * 构造函数
+   * @param {object} config 配置项
+   * @param {object} parent 父项
+   * @class
+   */
+  constructor(config, parent) {
+    super({ ...Drive.config, ...config }, parent);
+    // 当前配置文件路径
+    this.config_file = '';
+
+    // 当前脚本文件路径
+    this.script_file = '';
+
+    // 模式: 1.生产模式 2.热更新模式 3.热重载模式 4.热更新+重载模式 5.重载模式
+    this.mode = 1;
+  }
+}
+
+/**
+ * 获取事件触发器
+ * @returns {object} 事件触发器
+ */
+Drive.prototype.getEventer = function () {
+  return $.eventer;
+};
+
+/**
+ * 配置驱动
+ */
+Drive.prototype._preset = function () {
+  let file = this.config.main;
+  if (file) {
+    this.script_file = file.fullname(this.getDir());
+  }
+};
+
+/**
+ * 获取配置
+ * @param {string} file 配置文件路径
+ * @returns {object} 配置项
+ */
+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;
+    });
+  }
+  this.setConfig(config);
+  return config;
+};
+
+/**
+ * 加载配置
+ * @param {string} file 配置文件路径
+ */
+Drive.prototype.loadConfig = function (file) {
+  this._loadConfig(file);
+};
+
+/**
+ * 设置配置
+ * @param {object} config 配置对象
+ * @returns {object} 配置项
+ */
+Drive.prototype.setConfig = function (config) {
+  if (config) {
+    // 如果main改变，重置加载状态
+    if (config.main !== this.config.main) {
+      this.is_loaded = false;
+    }
+
+    if (this.config_file) {
+      // 合并配置并应用配置处理
+      this.config = conf(
+        {
+          ...this.config,
+          ...config
+        },
+        this.config_file
+      );
+    } else {
+      Object.assign(this.config, config);
+    }
+  }
+  this._preset();
+  return this.config;
+};
+
+/**
+ * 获取配置
+ * @returns {object} 配置项
+ */
+Drive.prototype.getConfig = function () {
+  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);
+      }
+    }
+  }
+  return dir;
+};
+
+/**
+ * 获取模板目录
+ * @returns {string} 模板目录
+ */
+Drive.prototype._getTplDir = function () {
+  return this.getParent()?.getTplDir() || '';
+};
+
+/**
+ * 移除加载的脚本模块
+ */
+Drive.prototype._remove = function () {
+  let file = this._getScriptFile();
+  if (!file) return;
+
+  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];
+      }
+    }
+  } catch (err) {
+    this.log('error', `移除加载的脚本模块失败: `, err);
+  }
+};
+
+/**
+ * 卸载脚本
+ */
+Drive.prototype.unloadScript = function () {
+  this._remove();
+  this._script_keys = null;
+  this.is_loaded = false;
+};
+
+/**
+ * 重新加载脚本
+ * @returns {object | null} 返回加载的模块对象
+ */
+Drive.prototype.reloadScript = function () {
+  this.unloadScript();
+  return this.loadScript();
+};
+
+/**
+ * 卸载之后处理
+ * @param {boolean} remove 是否删除文件
+ */
+Drive.prototype.unloadCore = async function (remove) {
+  // 删除脚本
+  this.unloadScript();
+  if (remove) {
+    this.delFile();
+  }
+};
+
+/**
+ * 获取脚本文件路径
+ * @returns {string | null} 完整文件路径
+ */
+Drive.prototype._getScriptFile = function () {
+  let main = this.config.main || '';
+  if (!main) return null;
+
+  let filename = main.fullname(this.getDir());
+  if (!filename.hasFile()) {
+    this.newScript(filename);
+  }
+  return filename;
+};
+
+/**
+ * 新建脚本文件
+ * @param {string} file 目标文件路径
+ */
+Drive.prototype.newScript = function (file) {
+  this._createScriptFile(file);
+};
+
+/**
+ * 创建脚本
+ * @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 '';
+  }
+  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) {
+    // 主要代码写在这
+  }
+}`;
+  }
+};
+
+/**
+ * 加载脚本文件，支持热重载模式
+ * 在开发模式(mode=3或4)下使用 $.require 进行热重载
+ * 在生产模式下使用标准的 require 加载
+ * @returns {object | null} 加载的模块对象
+ */
+Drive.prototype.loadScript = function () {
+  let 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;
+  }
+};
+
+/**
+ * 设置主方法
+ * @param {object} mod 模块对象
+ */
+Drive.prototype._setMainMethod = function (mod) {
+  if (!mod) return;
+  var name = this.config.func_name || 'main';
+  if (name && mod[name]) {
+    this.main = mod[name];
+  }
+  var new_keys = Object.keys(mod);
+  // 热重载时如果脚本未变化则跳过重建
+  if (this._script_keys && this._script_keys.length === new_keys.length) {
+    var same = true;
+    for (var i = 0; i < new_keys.length; i++) {
+      if (this._script_keys[i] !== new_keys[i]) {
+        same = false;
+        break;
+      }
+    }
+    if (same) {
+      this.is_loaded = true;
+      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);
+    }
+  }
+  this.is_loaded = true;
+};
+
+/**
+ * 获取配置文件作用域
+ * @param {object} file 文件对象
+ * @returns {string} 配置文件作用域
+ */
+Drive.prototype._getScope = function (file) {
+  return file.replace(/\\/g, '/').between('app/', '/');
+};
+
+/**
+ * 新建配置文件
+ * @param {string} file 目标文件路径
+ */
+Drive.prototype.newConfig = function (file) {
+  if (!this.config.name) {
+    this.config.name = this._getName(file);
+    this.config.scope = this._getScope(file);
+  }
+  this._createConfigFile(file);
+};
+
+/**
+ * 预试代码
+ * @param {string} code 要预试的代码
+ * @param {string} type 预试类型，可选"json"或"js"
+ * @returns {string} 预试后的代码字符串
+ */
+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;
+};
+
+/**
+ * 获取模块模型
+ * @param {string} type 模型类型，可选"config"或"script"
+ * @returns {object} 模块模型
+ */
+Drive.prototype.getModel = function (type) {
+  return this.config;
+};
+
+/**
+ * 创建配置文件
+ * @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;
+};
+
+/**
+ * 创建配置文件
+ * @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}
+}`;
+  }
+};
+
+/**
+ * 加载配置文件
+ * @param {string} file 文件路径
+ * @param {string} name 配置项名称
+ * @returns {object | null} 配置对象
+ */
+Drive.prototype.loadFile = function (file, name) {
+  try {
+    let filename = file.fullname(this.getDir());
+    let text = filename.loadText();
+
+    // 如果文件不存在，创建新的配置文件
+    if (!text) {
+      this.newConfig(filename);
+      text = filename.loadText();
+    }
+
+    if (!text) return null;
+
+    let config = this._loadHotReload(filename);
+    let final_config = this._findConfigByName(config, name);
+    return final_config;
+  } 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));
+  }
+  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;
+};
+
+/**
+ * 根据模式决定是否重新加载脚本
+ */
+Drive.prototype._reloadIfNeeded = function () {
+  if (this.mode === 3 || this.mode === 4) {
+    this.reloadScript();
+  }
+};
+
+/**
+ * 删除目录
+ */
+Drive.prototype.delDir = function () {
+  let main = this.config.main;
+  if (main && $.dir && $.dir.del) {
+    $.dir.del(this.dir);
+  }
+};
+
+/**
+ * 删除配置和脚本文件
+ * @returns {string | null} 错误消息，如果没有错误则返回null
+ */
+Drive.prototype.delFile = function () {
+  let name = this.config.name;
+  let file = this.script_file;
+
+  let error_message = null;
+  try {
+    if (!file || !file.hasFile) return null;
+
+    if (!file.hasFile()) {
+      return '配置文件不存在';
+    }
+
+    error_message = this._delConfigFile(file, name);
+  } catch (err) {
+    this.log('error', `删除文件失败: `, err);
+    error_message = `删除失败: ${err.message}`;
+  }
+  return error_message;
+};
+
+/**
+ * 删除配置文件
+ * @param {object} file 文件对象
+ * @param {string} name 配置名称
+ * @returns {string | null} 错误消息
+ */
+Drive.prototype._delConfigFile = function (file, name) {
+  let text = file.loadText();
+  if (!text) {
+    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 {Array} config 配置数组
+ * @param {string} name 配置名称
+ * @returns {string | null} 错误消息
+ */
+Drive.prototype._delArray = function (file, config, name) {
+  let index = config.findIndex((Drive) => Drive.name === name);
+  if (index === -1) return null;
+
+  this.delDir();
+  config.splice(index, 1);
+
+  if (config.length > 0) {
+    file.saveText(JSON.stringify(config, null, 4));
+  } else if (file.delFile) {
+    file.delFile();
+  }
+
+  return null;
+};
+
+/**
+ * 获取配置文件名称
+ * @param {object} file 文件对象
+ * @returns {string} 配置文件名称
+ */
+Drive.prototype._getName = function (file) {
+  let name = file.dirname().basename();
+  return name;
+  // // 提取文件名作为模块名
+  // var word = new Word();
+  // // 将文件名改为驼峰命名法
+  // return word.toCamelCase(name);
+};
+
+/**
+ * 加载前处理
+ */
+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._loadCore = function () {
+  // this.loadConfig();
+  // this.loadScript();
+};
+
+/**
+ * 保存配置
+ */
+Drive.prototype.save = function () {
+  try {
+    if (!this.script_file) return;
+
+    let file = this.script_file.fullname(this.getDir());
+    let text = file.loadText();
+
+    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;
+      }
+    }
+
+    // 单对象格式配置，直接保存
+    file.saveText(JSON.stringify(this.config, null, 2));
+  } catch (err) {
+    this.log('error', `保存配置失败: `, err);
+  }
+};
+
+/**
+ * 删除项目
+ */
+Drive.prototype.remove = function () {
+  let dir = this.getDir();
+  if (dir) {
+    dir.delDir();
+  }
+  return dir;
+};
+
+/**
+ * @module 导出Drive类
+ */
+module.exports = {
+  Drive
+};