mm_expand 2.4.2 → 2.4.4

package/lib/file.js

@@ -1,797 +1,797 @@
-const {
-  writeFileSync,
-  existsSync,
-  readFileSync,
-  copyFileSync,
-  statSync,
-  readdirSync,
-  mkdirSync,
-  unlinkSync,
-  promises: fsp
-} = require('fs');
-const {
-  join,
-  dirname,
-  basename,
-  extname,
-  resolve,
-  isAbsolute
-} = require('path');
-const os = require('os');
-const {
-  rimrafSync
-} = require('rimraf');
-var ncp = require('ncp').ncp;
-const { Base } = require('./base.js');
-
-/**
- * 判断是否为文件
- * @param {string} file_or_dir 文件或目录
- * @returns {boolean} 是文件返回true，否则返回false
- */
-function isFile(file_or_dir) {
-  return statSync(file_or_dir).isDirectory() !== true;
-}
-
-/**
- * 处理根路径
- * @param {string} file 文件路径
- * @returns {string} 完整路径
- */
-function handleRootPath(file) {
-  if ($.run_path.indexOf(file) === 0 || file.indexOf($.run_path) === 0) {
-    return file;
-  }
-  return resolve($.run_path || process.cwd(), file.substring(1));
-}
-
-/**
- * 处理用户主目录路径
- * @param {string} file 文件路径
- * @returns {string} 完整路径
- */
-function handleHomePath(file) {
-  return resolve(os.homedir(), file.substring(2));
-}
-
-/**
- * 处理项目根路径
- * @param {string} file 文件路径
- * @returns {string} 完整路径
- */
-function handleAtPath(file) {
-  return resolve($.root_path, file.substring(2));
-}
-
-/**
- * 处理相对路径
- * @param {string} file 文件路径
- * @param {string} dir 当前目录
- * @returns {string} 完整路径
- */
-function handleRelativePath(file, dir) {
-  var base_dir = dir && typeof dir === 'string' ? dir : $.run_path;
-  return resolve(fullname(base_dir), file);
-}
-
-/**
- * 验证文件路径
- * @param {string} file 文件路径
- * @returns {string | null} 验证结果或null
- */
-function validateFilePath(file) {
-  if (typeof file !== 'string') {
-    throw new Error('file参数必须是字符串');
-  }
-
-  // 如果是空字符串，返回当前运行路径
-  if (!file) {
-    return $.run_path || process.cwd();
-  }
-
-  return null;
-}
-
-/**
- * 补全文件路径
- * @param {string} file 文件路径
- * @param {string} dir 当前目录
- * @returns {string} 完整路径
- */
-function fullname(file, dir) {
-  var result = validateFilePath(file);
-  if (result) {
-    return result;
-  }
-
-  // 处理以 / 开头的路径（从项目启动位置）
-  if (file.startsWith('/') && !file.startsWith('//') && file !== '/') {
-    return handleRootPath(file);
-  }
-
-  // 处理以 ~/ 开头的路径（从用户主目录开始）
-  if (file.startsWith('~/')) {
-    return handleHomePath(file);
-  }
-
-  // 处理以 @/ 开头的路径（从用户主目录开始）
-  if (file.startsWith('@/')) {
-    return handleAtPath(file);
-  }
-
-  // 处理相对路径
-  if (file.startsWith('./') || file.startsWith('../')
-
-    || (!isAbsolute(file) && !file.startsWith('/'))) {
-    return handleRelativePath(file, dir);
-  }
-
-  // 如果已经是绝对路径，直接返回
-  return file;
-}
-
-/**
- * 文件类函数
- */
-class File extends Base {
-  /**
-   * 构造函数，用于初始化文件类
-   * @param {object} config 文件配置对象
-   */
-  constructor(config) {
-    super(config);
-  }
-}
-
-/**
- * 补全文件路径
- * @param {string} file 文件路径
- * @param {string} dir 当前目录
- * @returns {string} 完整路径
- */
-File.prototype.fullname = fullname;
-
-/**
- * 搜索目录下所有文件
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @param {string} keyword_dir 目录搜素关键词
- * @returns {Array} 文件路径数组
- */
-File.prototype.getAll = function (dir, keyword, keyword_dir) {
-  // 文件数组
-  var list = [];
-
-  // 目录数组
-  var dirs = [];
-  // 获取相关目录
-  eachDir(dirs, dir.fullname(), keyword_dir);
-  var len = dirs.length;
-  for (var i = 0; i < len; i++) {
-    getFile(list, dirs[i], keyword);
-  }
-  return list;
-};
-
-/**
- * 搜索目录下所有文件（异步并行极速版）
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @param {string} keyword_dir 目录搜素关键词
- * @returns {Array} 文件路径数组
- */
-File.prototype.getAllAsync = async function (dir, keyword, keyword_dir) {
-  var root_dir = dir.fullname();
-  var matchedDirs = [];
-
-  // 使用独立 eachDirAsync 并行收集匹配的目录
-  await eachDirAsync(matchedDirs, root_dir, keyword_dir);
-
-  /**
-   * 异步获取目录下的匹配文件
-   * @param {string} directory 目录路径
-   * @returns {Array} 文件路径数组
-   */
-  async function getFileAsync(directory) {
-    var items;
-    try {
-      items = await fsp.readdir(directory, { withFileTypes: true });
-    } catch {
-      return [];
-    }
-
-    var files = [];
-    for (var i = 0; i < items.length; i++) {
-      var item = items[i];
-      if (item.isFile() && (!keyword || item.name.has(keyword))) {
-        files.push(join(directory, item.name));
-      }
-    }
-    return files;
-  }
-
-  // 没有匹配的子目录时，直接搜索根目录
-  if (matchedDirs.length === 0) {
-    return await getFileAsync(root_dir);
-  }
-
-  // 并行处理所有匹配目录的文件收集
-  var file_lists = await Promise.all(matchedDirs.map(getFileAsync));
-  return file_lists.flat();
-};
-
-/**
- * 获取当前目录下所有文件
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @returns {Array} 文件路径数组
- */
-File.prototype.get = function (dir, keyword) {
-  var list = [];
-  getFile(list, dir, keyword);
-  return list;
-};
-
-/**
- * 加载文件
- * @param {string} file 文件路径
- * @param {string} encode 编码方式
- * @returns {string} 加载的文本
- */
-File.prototype.load = function (file, encode) {
-  if (!file || typeof file !== 'string') {
-    throw new Error('file参数必须是非空字符串');
-  }
-  try {
-    if (existsSync(file) && isFile(file)) {
-      return readFileSync(file, encode);
-    }
-    return null;
-  } catch (error) {
-    this.log('error', '加载文件失败:', error);
-    return null;
-  }
-};
-
-/**
- * 保存文件
- * @param {string} file 文件路径
- * @param {string} data 数据内容
- * @param {string} encode 编码方式
- * @returns {boolean} 保存成功返回true，否则返回false
- */
-File.prototype.save = function (file, data, encode) {
-  if (!file || typeof file !== 'string') {
-    throw new Error('file参数必须是非空字符串');
-  }
-  if (data === undefined || data === null) {
-    throw new Error('data参数不能为空');
-  }
-  var enc = encode || 'utf-8';
-  try {
-    writeFileSync(file, data, enc);
-    return true;
-  } catch (e) {
-    this.log('error', '保存文件失败：', e);
-    return false;
-  }
-};
-
-/**
- * 复制文件
- * @param {string} source 文件原路径
- * @param {string} target 目标路径
- * @returns {boolean} 复制成功返回true，否则返回false
- */
-File.prototype.copy = function (source, target) {
-  if (!source || typeof source !== 'string') {
-    throw new Error('source参数必须是非空字符串');
-  }
-  if (!target || typeof target !== 'string') {
-    throw new Error('target参数必须是非空字符串');
-  }
-  try {
-    copyFileSync(source.fullname(), target.fullname());
-    return true;
-  } catch (err) {
-    this.log('error', err);
-    return false;
-  }
-};
-
-/**
- * 删除文件
- * @param {string} file 文件路径
- * @returns {boolean} 删除成功返回true，否则返回false
- */
-File.prototype.del = function (file) {
-  if (!file || typeof file !== 'string') {
-    throw new Error('file参数必须是非空字符串');
-  }
-  try {
-    unlinkSync(file.fullname());
-    return true;
-  } catch (err) {
-    this.log('error', err);
-    return false;
-  }
-};
-
-/**
- * 检查文件是否存在
- * @param {string} file 文件路径
- * @returns {boolean} 存在返回true，否则返回false
- */
-File.prototype.exists = function (file) {
-  if (!file || typeof file !== 'string') {
-    throw new Error('file参数必须是非空字符串');
-  }
-  return existsSync(file);
-};
-
-/**
- * 读取文件内容
- * @param {string} file 文件路径
- * @param {string} encode 编码方式
- * @returns {string} 文件内容
- */
-File.prototype.read = function (file, encode) {
-  var enc = encode || 'utf-8';
-  return this.load(file, enc);
-};
-
-/**
- * 写入文件内容
- * @param {string} file 文件路径
- * @param {string} data 数据内容
- * @param {string} encode 编码方式
- * @returns {boolean} 写入成功返回true，否则返回false
- */
-File.prototype.write = function (file, data, encode) {
-  if (!data) {
-    throw new Error('data参数不能为空');
-  }
-  return this.save(file, data, encode);
-};
-
-/**
- * 搜索目录下所有目录
- * @param {Array} list 结果路径数组
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- */
-function eachDir(list, dir, keyword) {
-  var items = readdirSync(dir);
-  var len = items.length;
-
-  for (var i = 0; i < len; i++) {
-    var name = items[i];
-    var f = join(dir, name);
-
-    // 识别是否为目录
-    if (!isFile(f)) {
-      // 判断是否包含关键词
-      if (!keyword || name.has(keyword)) {
-        list.push(f);
-      }
-      eachDir(list, f, keyword);
-    }
-  }
-}
-/**
- * 异步并行搜索目录下所有目录
- * @param {Array} list 结果路径数组
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- */
-async function eachDirAsync(list, dir, keyword) {
-  var items;
-  try {
-    items = await fsp.readdir(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-
-  var subDirs = [];
-  for (var i = 0; i < items.length; i++) {
-    var item = items[i];
-    if (item.isDirectory()) {
-      var full_path = join(dir, item.name);
-      if (!keyword || item.name.has(keyword)) {
-        list.push(full_path);
-      }
-      subDirs.push(full_path);
-    }
-  }
-
-  // 并行遍历所有子目录
-  if (subDirs.length > 0) {
-    await Promise.all(subDirs.map((d) => {
-      return eachDirAsync(list, d, keyword);
-    }));
-  }
-}
-
-/**
- * 获取当前目录下所有目录
- * @param {Array} list 结果路径数组
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- */
-function getDir(list, dir, keyword) {
-  var items = readdirSync(dir);
-  var len = items.length;
-
-  for (var i = 0; i < len; i++) {
-    var name = items[i];
-    var f = join(dir, name);
-
-    // 识别是否为目录
-    if (!isFile(f)) {
-      // 判断关键词是否相等
-      if (!keyword || name.has(keyword)) {
-        list.push(f);
-      }
-    }
-  }
-}
-
-/**
- * 添加文件路径
- * @param {Array} list 结果路径数组
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- */
-function getFile(list, dir, keyword) {
-  var items = readdirSync(dir);
-  var len = items.length;
-
-  for (var i = 0; i < len; i++) {
-    var name = items[i];
-    var f = join(dir, name);
-
-    // 识别是否非目录
-    if (isFile(f)) {
-      // 判断关键词是否相等
-      if (!keyword || name.has(keyword)) {
-        list.push(f);
-      }
-    }
-  }
-}
-/**
- * 目录类函数
- */
-class Dir extends Base {
-  /**
-   * 构造函数
-   * @param {object} config 目录配置对象
-   */
-  constructor(config) {
-    super(config);
-  }
-}
-
-/**
- * 补全目录路径
- * @param {string} dir 目录路径
- * @param {string} base_dir 基础目录
- * @returns {string} 完整路径
- */
-Dir.prototype.fullname = fullname;
-
-/**
- * 搜索目录下所有目录
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @returns {Array} 目录路径数组
- */
-Dir.prototype.getAll = function (dir, keyword) {
-  var list = [];
-  eachDir(list, this.fullname(dir), keyword);
-  return list;
-};
-
-/**
- * 搜索目录下所有目录（异步并行极速版）
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @returns {Array} 目录路径数组
- */
-Dir.prototype.getAllAsync = async function (dir, keyword) {
-  var list = [];
-  await eachDirAsync(list, this.fullname(dir), keyword);
-  return list;
-};
-
-/**
- * 搜索当前目录下所有目录
- * @param {string} dir 目录地址
- * @param {string} keyword 搜索关键词
- * @returns {Array} 目录路径数组
- */
-Dir.prototype.get = function (dir, keyword) {
-  var list = [];
-  getDir(list, this.fullname(dir), keyword);
-  return list;
-};
-
-/**
- * 复制目录
- * @param {string} source 源路径
- * @param {string} target 目标路径
- * @param {Function} func 回调函数
- */
-Dir.prototype.copy = function (source, target, func) {
-  ncp(source.fullname(), target.fullname(), func);
-};
-
-/**
- * 删除目录
- * @param {string} dir 目录路径
- * @param {Function} func 回调函数
- */
-Dir.prototype.del = function (dir, func) {
-  rimrafSync(dir.fullname(), func);
-};
-
-/**
- * 判断目录是否存在
- * @param {string} dir 目录路径
- * @returns {boolean} 存在返回true, 否则返回false
- */
-Dir.prototype.exists = function (dir) {
-  return existsSync(dir.fullname());
-};
-
-/** === 文件类函数 === */
-/**
- * 补全路径
- * @param {string} dir 文件路径
- * @returns {string} 全路径
- */
-String.prototype.fullname = function (dir) {
-  return fullname(this + '', dir);
-};
-
-/**
- * 获取当前目录下所有文件
- * @param {string} keyword 搜索关键词
- * @returns {Array} 文件路径数组
- */
-String.prototype.getFile = function (keyword) {
-  return $.file.get(this + '', keyword);
-};
-
-/**
- * 搜索当前目录下所有目录
- * @param {string} keyword 搜索关键词
- * @returns {Array} 目录路径数组
- */
-String.prototype.getDir = function (keyword) {
-  return $.dir.get(this + '', keyword);
-};
-
-/**
- * 复制文件
- * @param {string} file 保存路径
- * @returns {boolean} 复制成功返回true, 失败返回false
- */
-String.prototype.copyFile = function (file) {
-  return copyFileSync(this.fullname(), file.fullname());
-};
-
-/**
- * 复制目录
- * @param {string} file 保存路径
- * @param {Function} func 回调函数
- * @returns {boolean} 复制成功返回true, 失败返回false
- */
-String.prototype.copyDir = function (file, func) {
-  return ncp(this.fullname(), file.fullname(), func);
-};
-
-/**
- * 是否目录
- * @returns {boolean} 是目录返回true, 否则返回false
- */
-String.prototype.isDir = function () {
-  var bl = false;
-  try {
-    bl = statSync(this + '').isDirectory();
-  } catch {
-    // $.log.error("非路径");
-  }
-  return bl;
-};
-
-/**
- * 是否文件
- * @returns {boolean} 是目录返回true, 否则返回false
- */
-String.prototype.isFile = function () {
-  var bl = false;
-  try {
-    bl = statSync(this + '').isFile();
-  } catch {
-    // $.log.error("非路径");
-  }
-  return bl;
-};
-
-/**
- * 取路径
- * @returns {string} 字符串
- */
-String.prototype.dirname = function () {
-  return dirname(this + '');
-};
-/**
- * 取基础名
- * @returns {string} 字符串
- */
-String.prototype.basename = function () {
-  return basename(this + '');
-};
-/**
- * 取拓展名
- * @returns {string} 字符串
- */
-String.prototype.extname = function () {
-  return extname(this + '');
-};
-
-
-/**
- * 保存文件
- * @param {string} text 被保存的文本
- * @returns {boolean} 保存成功返回true, 失败返回false
- */
-String.prototype.saveText = function (text) {
-  try {
-    writeFileSync(this.fullname(), text);
-    return true;
-  } catch (e) {
-    $.log.error('保存文件失败：', e);
-    return false;
-  }
-};
-
-/**
- * 保存为JSON格式文件
- * @param {object} obj 被保存的内容
- * @param {boolean} format 是否格式化
- * @param {number} space 格式化缩进空格数
- * @returns {boolean} 保存成功返回true, 失败返回false
- */
-String.prototype.saveJson = function (obj, format = true, space = 2) {
-  try {
-    var text = '';
-    if (format) {
-      text = JSON.stringify(obj, null, space);
-    } else {
-      text = JSON.stringify(obj);
-    }
-    writeFileSync(this.fullname(), text);
-    return true;
-  } catch (e) {
-    $.log.error('保存JSON文件失败：', e);
-    return false;
-  }
-};
-
-/**
- * 加载文件
- * @param {string} encode 编码方式
- * @returns {string} 加载的文本
- */
-String.prototype.loadText = function (encode) {
-  var file = this.fullname();
-  if (existsSync(file)) {
-    var enc = encode || 'utf-8';
-    return readFileSync(file, enc);
-  } else {
-    return undefined;
-  }
-};
-
-/**
- * 加载xml
- * @param {string} file 当前路径
- * @returns {string} 加载的文本
- */
-String.prototype.loadXml = function (file) {
-  var f = this.fullname(file);
-  if (existsSync(f)) {
-    var text = readFileSync(f, 'utf-8');
-    if (text) {
-      var ret = text.toXml();
-      if (ret === null) {
-        $.log.error('xml反序列化错误！', f);
-      }
-      return ret;
-    }
-  }
-  return undefined;
-};
-
-/**
- * 加载json
- * @param {string} file 当前路径
- * @returns {object} 加载后转换的对象
- */
-String.prototype.loadJson = function (file) {
-  var f = this.fullname(file);
-  if (existsSync(f)) {
-    var text = readFileSync(f, 'utf-8');
-    if (text) {
-      var ret = text.toJson();
-      if (ret === null) {
-        $.log.error('json反序列化错误！', f);
-      }
-      return ret;
-    }
-  }
-  return undefined;
-};
-
-/**
- * 判断文件是否存在
- * @param {string} file 当前路径
- * @returns {boolean} 存在返回true, 不存在返回false
- */
-String.prototype.hasFile = function (file) {
-  return existsSync(this.fullname(file));
-};
-
-/**
- * 删除文件
- * @param {string} file 当前路径
- */
-String.prototype.delFile = function (file) {
-  unlinkSync(this.fullname(file), (e) => { });
-};
-
-/**
- * 判断目录是否存在
- * @param {string} dir 当前路径
- * @returns {boolean} 存在返回true, 不存在返回false
- */
-String.prototype.hasDir = function (dir) {
-  return existsSync(this.fullname(dir));
-};
-
-/**
- * 删除目录
- * @param {string} dir 当前路径
- * @param {Function} func 回调函数
- */
-String.prototype.delDir = function (dir, func) {
-  rimrafSync(this.fullname(dir), func);
-};
-
-/**
- * 创建路径
- * @param {string} dirbase 目录基础路径
- */
-String.prototype.addDir = function (dirbase) {
-  var d = (this + '').fullname(dirbase);
-
-  if (d.indexOf('.') !== -1) {
-    d = d.dirname();
-  }
-  var l = $.slash;
-  var arr = d.split(l);
-  var dir = '';
-  for (var i = 0; i < arr.length; i++) {
-    dir += arr[i] + l;
-    if (!existsSync(dir)) {
-      mkdirSync(dir);
-    }
-  }
-};
-
-module.exports = {
-  File,
-  Dir
-};
+const {
+  writeFileSync,
+  existsSync,
+  readFileSync,
+  copyFileSync,
+  statSync,
+  readdirSync,
+  mkdirSync,
+  unlinkSync,
+  promises: fsp
+} = require('fs');
+const {
+  join,
+  dirname,
+  basename,
+  extname,
+  resolve,
+  isAbsolute
+} = require('path');
+const os = require('os');
+const {
+  rimrafSync
+} = require('rimraf');
+var ncp = require('ncp').ncp;
+const { Base } = require('./base.js');
+
+/**
+ * 判断是否为文件
+ * @param {string} file_or_dir 文件或目录
+ * @returns {boolean} 是文件返回true，否则返回false
+ */
+function isFile(file_or_dir) {
+  return statSync(file_or_dir).isDirectory() !== true;
+}
+
+/**
+ * 处理根路径
+ * @param {string} file 文件路径
+ * @returns {string} 完整路径
+ */
+function handleRootPath(file) {
+  if ($.run_path.indexOf(file) === 0 || file.indexOf($.run_path) === 0) {
+    return file;
+  }
+  return resolve($.run_path || process.cwd(), file.substring(1));
+}
+
+/**
+ * 处理用户主目录路径
+ * @param {string} file 文件路径
+ * @returns {string} 完整路径
+ */
+function handleHomePath(file) {
+  return resolve(os.homedir(), file.substring(2));
+}
+
+/**
+ * 处理项目根路径
+ * @param {string} file 文件路径
+ * @returns {string} 完整路径
+ */
+function handleAtPath(file) {
+  return resolve($.root_path, file.substring(2));
+}
+
+/**
+ * 处理相对路径
+ * @param {string} file 文件路径
+ * @param {string} dir 当前目录
+ * @returns {string} 完整路径
+ */
+function handleRelativePath(file, dir) {
+  var base_dir = dir && typeof dir === 'string' ? dir : $.run_path;
+  return resolve(fullname(base_dir), file);
+}
+
+/**
+ * 验证文件路径
+ * @param {string} file 文件路径
+ * @returns {string | null} 验证结果或null
+ */
+function validateFilePath(file) {
+  if (typeof file !== 'string') {
+    throw new Error('file参数必须是字符串');
+  }
+
+  // 如果是空字符串，返回当前运行路径
+  if (!file) {
+    return $.run_path || process.cwd();
+  }
+
+  return null;
+}
+
+/**
+ * 补全文件路径
+ * @param {string} file 文件路径
+ * @param {string} dir 当前目录
+ * @returns {string} 完整路径
+ */
+function fullname(file, dir) {
+  var result = validateFilePath(file);
+  if (result) {
+    return result;
+  }
+
+  // 处理以 / 开头的路径（从项目启动位置）
+  if (file.startsWith('/') && !file.startsWith('//') && file !== '/') {
+    return handleRootPath(file);
+  }
+
+  // 处理以 ~/ 开头的路径（从用户主目录开始）
+  if (file.startsWith('~/')) {
+    return handleHomePath(file);
+  }
+
+  // 处理以 @/ 开头的路径（从用户主目录开始）
+  if (file.startsWith('@/')) {
+    return handleAtPath(file);
+  }
+
+  // 处理相对路径
+  if (file.startsWith('./') || file.startsWith('../')
+
+    || (!isAbsolute(file) && !file.startsWith('/'))) {
+    return handleRelativePath(file, dir);
+  }
+
+  // 如果已经是绝对路径，直接返回
+  return file;
+}
+
+/**
+ * 文件类函数
+ */
+class File extends Base {
+  /**
+   * 构造函数，用于初始化文件类
+   * @param {object} config 文件配置对象
+   */
+  constructor(config) {
+    super(config);
+  }
+}
+
+/**
+ * 补全文件路径
+ * @param {string} file 文件路径
+ * @param {string} dir 当前目录
+ * @returns {string} 完整路径
+ */
+File.prototype.fullname = fullname;
+
+/**
+ * 搜索目录下所有文件
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @param {string} keyword_dir 目录搜素关键词
+ * @returns {Array} 文件路径数组
+ */
+File.prototype.getAll = function (dir, keyword, keyword_dir) {
+  // 文件数组
+  var list = [];
+
+  // 目录数组
+  var dirs = [];
+  // 获取相关目录
+  eachDir(dirs, dir.fullname(), keyword_dir);
+  var len = dirs.length;
+  for (var i = 0; i < len; i++) {
+    getFile(list, dirs[i], keyword);
+  }
+  return list;
+};
+
+/**
+ * 搜索目录下所有文件（异步并行极速版）
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @param {string} keyword_dir 目录搜素关键词
+ * @returns {Array} 文件路径数组
+ */
+File.prototype.getAllAsync = async function (dir, keyword, keyword_dir) {
+  var root_dir = dir.fullname();
+  var matched_dirs = [];
+
+  // 使用独立 eachDirAsync 并行收集匹配的目录
+  await eachDirAsync(matched_dirs, root_dir, keyword_dir);
+
+  /**
+   * 异步获取目录下的匹配文件
+   * @param {string} directory 目录路径
+   * @returns {Array} 文件路径数组
+   */
+  async function getFileAsync(directory) {
+    var items;
+    try {
+      items = await fsp.readdir(directory, { withFileTypes: true });
+    } catch {
+      return [];
+    }
+
+    var files = [];
+    for (var i = 0; i < items.length; i++) {
+      var item = items[i];
+      if (item.isFile() && (!keyword || item.name.has(keyword))) {
+        files.push(join(directory, item.name));
+      }
+    }
+    return files;
+  }
+
+  // 没有匹配的子目录时，直接搜索根目录
+  if (matched_dirs.length === 0) {
+    return await getFileAsync(root_dir);
+  }
+
+  // 并行处理所有匹配目录的文件收集
+  var file_lists = await Promise.all(matched_dirs.map(getFileAsync));
+  return file_lists.flat();
+};
+
+/**
+ * 获取当前目录下所有文件
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 文件路径数组
+ */
+File.prototype.get = function (dir, keyword) {
+  var list = [];
+  getFile(list, dir, keyword);
+  return list;
+};
+
+/**
+ * 加载文件
+ * @param {string} file 文件路径
+ * @param {string} encode 编码方式
+ * @returns {string} 加载的文本
+ */
+File.prototype.load = function (file, encode) {
+  if (!file || typeof file !== 'string') {
+    throw new Error('file参数必须是非空字符串');
+  }
+  try {
+    if (existsSync(file) && isFile(file)) {
+      return readFileSync(file, encode);
+    }
+    return null;
+  } catch (error) {
+    this.log('error', '加载文件失败:', error);
+    return null;
+  }
+};
+
+/**
+ * 保存文件
+ * @param {string} file 文件路径
+ * @param {string} data 数据内容
+ * @param {string} encode 编码方式
+ * @returns {boolean} 保存成功返回true，否则返回false
+ */
+File.prototype.save = function (file, data, encode) {
+  if (!file || typeof file !== 'string') {
+    throw new Error('file参数必须是非空字符串');
+  }
+  if (data === undefined || data === null) {
+    throw new Error('data参数不能为空');
+  }
+  var enc = encode || 'utf-8';
+  try {
+    writeFileSync(file, data, enc);
+    return true;
+  } catch (e) {
+    this.log('error', '保存文件失败：', e);
+    return false;
+  }
+};
+
+/**
+ * 复制文件
+ * @param {string} source 文件原路径
+ * @param {string} target 目标路径
+ * @returns {boolean} 复制成功返回true，否则返回false
+ */
+File.prototype.copy = function (source, target) {
+  if (!source || typeof source !== 'string') {
+    throw new Error('source参数必须是非空字符串');
+  }
+  if (!target || typeof target !== 'string') {
+    throw new Error('target参数必须是非空字符串');
+  }
+  try {
+    copyFileSync(source.fullname(), target.fullname());
+    return true;
+  } catch (err) {
+    this.log('error', err);
+    return false;
+  }
+};
+
+/**
+ * 删除文件
+ * @param {string} file 文件路径
+ * @returns {boolean} 删除成功返回true，否则返回false
+ */
+File.prototype.del = function (file) {
+  if (!file || typeof file !== 'string') {
+    throw new Error('file参数必须是非空字符串');
+  }
+  try {
+    unlinkSync(file.fullname());
+    return true;
+  } catch (err) {
+    this.log('error', err);
+    return false;
+  }
+};
+
+/**
+ * 检查文件是否存在
+ * @param {string} file 文件路径
+ * @returns {boolean} 存在返回true，否则返回false
+ */
+File.prototype.exists = function (file) {
+  if (!file || typeof file !== 'string') {
+    throw new Error('file参数必须是非空字符串');
+  }
+  return existsSync(file);
+};
+
+/**
+ * 读取文件内容
+ * @param {string} file 文件路径
+ * @param {string} encode 编码方式
+ * @returns {string} 文件内容
+ */
+File.prototype.read = function (file, encode) {
+  var enc = encode || 'utf-8';
+  return this.load(file, enc);
+};
+
+/**
+ * 写入文件内容
+ * @param {string} file 文件路径
+ * @param {string} data 数据内容
+ * @param {string} encode 编码方式
+ * @returns {boolean} 写入成功返回true，否则返回false
+ */
+File.prototype.write = function (file, data, encode) {
+  if (!data) {
+    throw new Error('data参数不能为空');
+  }
+  return this.save(file, data, encode);
+};
+
+/**
+ * 搜索目录下所有目录
+ * @param {Array} list 结果路径数组
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ */
+function eachDir(list, dir, keyword) {
+  var items = readdirSync(dir);
+  var len = items.length;
+
+  for (var i = 0; i < len; i++) {
+    var name = items[i];
+    var f = join(dir, name);
+
+    // 识别是否为目录
+    if (!isFile(f)) {
+      // 判断是否包含关键词
+      if (!keyword || name.has(keyword)) {
+        list.push(f);
+      }
+      eachDir(list, f, keyword);
+    }
+  }
+}
+/**
+ * 异步并行搜索目录下所有目录
+ * @param {Array} list 结果路径数组
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ */
+async function eachDirAsync(list, dir, keyword) {
+  var items;
+  try {
+    items = await fsp.readdir(dir, { withFileTypes: true });
+  } catch {
+    return;
+  }
+
+  var subDirs = [];
+  for (var i = 0; i < items.length; i++) {
+    var item = items[i];
+    if (item.isDirectory()) {
+      var full_path = join(dir, item.name);
+      if (!keyword || item.name.has(keyword)) {
+        list.push(full_path);
+      }
+      subDirs.push(full_path);
+    }
+  }
+
+  // 并行遍历所有子目录
+  if (subDirs.length > 0) {
+    await Promise.all(subDirs.map((d) => {
+      return eachDirAsync(list, d, keyword);
+    }));
+  }
+}
+
+/**
+ * 获取当前目录下所有目录
+ * @param {Array} list 结果路径数组
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ */
+function getDir(list, dir, keyword) {
+  var items = readdirSync(dir);
+  var len = items.length;
+
+  for (var i = 0; i < len; i++) {
+    var name = items[i];
+    var f = join(dir, name);
+
+    // 识别是否为目录
+    if (!isFile(f)) {
+      // 判断关键词是否相等
+      if (!keyword || name.has(keyword)) {
+        list.push(f);
+      }
+    }
+  }
+}
+
+/**
+ * 添加文件路径
+ * @param {Array} list 结果路径数组
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ */
+function getFile(list, dir, keyword) {
+  var items = readdirSync(dir);
+  var len = items.length;
+
+  for (var i = 0; i < len; i++) {
+    var name = items[i];
+    var f = join(dir, name);
+
+    // 识别是否非目录
+    if (isFile(f)) {
+      // 判断关键词是否相等
+      if (!keyword || name.has(keyword)) {
+        list.push(f);
+      }
+    }
+  }
+}
+/**
+ * 目录类函数
+ */
+class Dir extends Base {
+  /**
+   * 构造函数
+   * @param {object} config 目录配置对象
+   */
+  constructor(config) {
+    super(config);
+  }
+}
+
+/**
+ * 补全目录路径
+ * @param {string} dir 目录路径
+ * @param {string} base_dir 基础目录
+ * @returns {string} 完整路径
+ */
+Dir.prototype.fullname = fullname;
+
+/**
+ * 搜索目录下所有目录
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 目录路径数组
+ */
+Dir.prototype.getAll = function (dir, keyword) {
+  var list = [];
+  eachDir(list, this.fullname(dir), keyword);
+  return list;
+};
+
+/**
+ * 搜索目录下所有目录（异步并行极速版）
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 目录路径数组
+ */
+Dir.prototype.getAllAsync = async function (dir, keyword) {
+  var list = [];
+  await eachDirAsync(list, this.fullname(dir), keyword);
+  return list;
+};
+
+/**
+ * 搜索当前目录下所有目录
+ * @param {string} dir 目录地址
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 目录路径数组
+ */
+Dir.prototype.get = function (dir, keyword) {
+  var list = [];
+  getDir(list, this.fullname(dir), keyword);
+  return list;
+};
+
+/**
+ * 复制目录
+ * @param {string} source 源路径
+ * @param {string} target 目标路径
+ * @param {Function} func 回调函数
+ */
+Dir.prototype.copy = function (source, target, func) {
+  ncp(source.fullname(), target.fullname(), func);
+};
+
+/**
+ * 删除目录
+ * @param {string} dir 目录路径
+ * @param {Function} func 回调函数
+ */
+Dir.prototype.del = function (dir, func) {
+  rimrafSync(dir.fullname(), func);
+};
+
+/**
+ * 判断目录是否存在
+ * @param {string} dir 目录路径
+ * @returns {boolean} 存在返回true, 否则返回false
+ */
+Dir.prototype.exists = function (dir) {
+  return existsSync(dir.fullname());
+};
+
+/** === 文件类函数 === */
+/**
+ * 补全路径
+ * @param {string} dir 文件路径
+ * @returns {string} 全路径
+ */
+String.prototype.fullname = function (dir) {
+  return fullname(this + '', dir);
+};
+
+/**
+ * 获取当前目录下所有文件
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 文件路径数组
+ */
+String.prototype.getFile = function (keyword) {
+  return $.file.get(this + '', keyword);
+};
+
+/**
+ * 搜索当前目录下所有目录
+ * @param {string} keyword 搜索关键词
+ * @returns {Array} 目录路径数组
+ */
+String.prototype.getDir = function (keyword) {
+  return $.dir.get(this + '', keyword);
+};
+
+/**
+ * 复制文件
+ * @param {string} file 保存路径
+ * @returns {boolean} 复制成功返回true, 失败返回false
+ */
+String.prototype.copyFile = function (file) {
+  return copyFileSync(this.fullname(), file.fullname());
+};
+
+/**
+ * 复制目录
+ * @param {string} file 保存路径
+ * @param {Function} func 回调函数
+ * @returns {boolean} 复制成功返回true, 失败返回false
+ */
+String.prototype.copyDir = function (file, func) {
+  return ncp(this.fullname(), file.fullname(), func);
+};
+
+/**
+ * 是否目录
+ * @returns {boolean} 是目录返回true, 否则返回false
+ */
+String.prototype.isDir = function () {
+  var bl = false;
+  try {
+    bl = statSync(this + '').isDirectory();
+  } catch {
+    // $.log.error("非路径");
+  }
+  return bl;
+};
+
+/**
+ * 是否文件
+ * @returns {boolean} 是目录返回true, 否则返回false
+ */
+String.prototype.isFile = function () {
+  var bl = false;
+  try {
+    bl = statSync(this + '').isFile();
+  } catch {
+    // $.log.error("非路径");
+  }
+  return bl;
+};
+
+/**
+ * 取路径
+ * @returns {string} 字符串
+ */
+String.prototype.dirname = function () {
+  return dirname(this + '');
+};
+/**
+ * 取基础名
+ * @returns {string} 字符串
+ */
+String.prototype.basename = function () {
+  return basename(this + '');
+};
+/**
+ * 取拓展名
+ * @returns {string} 字符串
+ */
+String.prototype.extname = function () {
+  return extname(this + '');
+};
+
+
+/**
+ * 保存文件
+ * @param {string} text 被保存的文本
+ * @returns {boolean} 保存成功返回true, 失败返回false
+ */
+String.prototype.saveText = function (text) {
+  try {
+    writeFileSync(this.fullname(), text);
+    return true;
+  } catch (e) {
+    $.log.error('保存文件失败：', e);
+    return false;
+  }
+};
+
+/**
+ * 保存为JSON格式文件
+ * @param {object} obj 被保存的内容
+ * @param {boolean} format 是否格式化
+ * @param {number} space 格式化缩进空格数
+ * @returns {boolean} 保存成功返回true, 失败返回false
+ */
+String.prototype.saveJson = function (obj, format = true, space = 2) {
+  try {
+    var text = '';
+    if (format) {
+      text = JSON.stringify(obj, null, space);
+    } else {
+      text = JSON.stringify(obj);
+    }
+    writeFileSync(this.fullname(), text);
+    return true;
+  } catch (e) {
+    $.log.error('保存JSON文件失败：', e);
+    return false;
+  }
+};
+
+/**
+ * 加载文件
+ * @param {string} encode 编码方式
+ * @returns {string} 加载的文本
+ */
+String.prototype.loadText = function (encode) {
+  var file = this.fullname();
+  if (existsSync(file)) {
+    var enc = encode || 'utf-8';
+    return readFileSync(file, enc);
+  } else {
+    return undefined;
+  }
+};
+
+/**
+ * 加载xml
+ * @param {string} file 当前路径
+ * @returns {string} 加载的文本
+ */
+String.prototype.loadXml = function (file) {
+  var f = this.fullname(file);
+  if (existsSync(f)) {
+    var text = readFileSync(f, 'utf-8');
+    if (text) {
+      var ret = text.toXml();
+      if (ret === null) {
+        $.log.error('xml反序列化错误！', f);
+      }
+      return ret;
+    }
+  }
+  return undefined;
+};
+
+/**
+ * 加载json
+ * @param {string} file 当前路径
+ * @returns {object} 加载后转换的对象
+ */
+String.prototype.loadJson = function (file) {
+  var f = this.fullname(file);
+  if (existsSync(f)) {
+    var text = readFileSync(f, 'utf-8');
+    if (text) {
+      var ret = text.toJson();
+      if (ret === null) {
+        $.log.error('json反序列化错误！', f);
+      }
+      return ret;
+    }
+  }
+  return undefined;
+};
+
+/**
+ * 判断文件是否存在
+ * @param {string} file 当前路径
+ * @returns {boolean} 存在返回true, 不存在返回false
+ */
+String.prototype.hasFile = function (file) {
+  return existsSync(this.fullname(file));
+};
+
+/**
+ * 删除文件
+ * @param {string} file 当前路径
+ */
+String.prototype.delFile = function (file) {
+  unlinkSync(this.fullname(file), (e) => { });
+};
+
+/**
+ * 判断目录是否存在
+ * @param {string} dir 当前路径
+ * @returns {boolean} 存在返回true, 不存在返回false
+ */
+String.prototype.hasDir = function (dir) {
+  return existsSync(this.fullname(dir));
+};
+
+/**
+ * 删除目录
+ * @param {string} dir 当前路径
+ * @param {Function} func 回调函数
+ */
+String.prototype.delDir = function (dir, func) {
+  rimrafSync(this.fullname(dir), func);
+};
+
+/**
+ * 创建路径
+ * @param {string} dirbase 目录基础路径
+ */
+String.prototype.addDir = function (dirbase) {
+  var d = (this + '').fullname(dirbase);
+
+  if (d.indexOf('.') !== -1) {
+    d = d.dirname();
+  }
+  var l = $.slash;
+  var arr = d.split(l);
+  var dir = '';
+  for (var i = 0; i < arr.length; i++) {
+    dir += arr[i] + l;
+    if (!existsSync(dir)) {
+      mkdirSync(dir);
+    }
+  }
+};
+
+module.exports = {
+  File,
+  Dir
+};