@yaohaixiao/renames.js 0.0.1

package/jest.config.js

@@ -0,0 +1,51 @@
+import { supportsColor } from 'chalk';
+
+/**
+ * # Jest.config.js - jest 配置
+ *
+ * Created By: Yaohaixiao Update: 2026.1.10
+ */
+export default {
+  moduleFileExtensions: ['js'],
+  // 处理导入映射
+  moduleNameMapper: {
+    '^#ansi-styles$': 'ansi-styles',
+    '^#supports-color$': 'supports-color',
+    '^@/(.*)$': '<rootDir>/$1',
+  },
+  testMatch: ['**/tests/*.spec.(js)'],
+  transform: {
+    '^.+\\.js$': [
+      'babel-jest',
+      {
+        presets: [
+          [
+            '@babel/preset-env',
+            {
+              targets: { node: 'current' },
+            },
+          ],
+        ],
+      },
+    ],
+  },
+  testEnvironment: 'node',
+  testTimeout: 5000,
+  // 确保不会忽略转换 chalk
+  transformIgnorePatterns: [
+    'node_modules/(?!(chalk|ansi-styles|supports-color)/)',
+  ],
+  collectCoverage: true,
+  coverageDirectory: 'report/coverage',
+  reporters: [
+    'default',
+    [
+      './node_modules/jest-html-reporter',
+      {
+        pageTitle: 'renames.js 单测报告',
+        outputPath: './report/unit-test/index.html',
+        includeFailureMsg: true,
+      },
+    ],
+  ],
+};

package/jsconfig.json

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "baseUrl": "./",
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "exclude": ["./node_modules"]
+}

package/lib/batch-rename.js

@@ -0,0 +1,190 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import chalk from 'chalk';
+
+import generateFilename from './generate-filename.js';
+import isFileExists from './utils/is-file-exists.js';
+import isFunction from './utils/is-function.js';
+import readList from './read-list.js';
+import rename from './utils/rename.js';
+import readDir from './utils/read-dir.js';
+import showWarningLog from './utils/show-warning-log.js';
+import sortFiles from './utils/sort-files.js';
+
+// 辅助函数：规整配置项，统一处理默认值和衍生配置
+const getNormalizedOptions = (options, filesCount) => {
+  const config = {
+    namesList: [],
+    prefix: '',
+    suffix: '',
+    connector: '',
+    autoIndex: false,
+    startIndex: 0,
+    indexPadZero: true,
+    indexPrefix: '第',
+    indexSuffix: '集',
+    delimiter: '：',
+    extname: '',
+    force: false,
+    filter: null,
+    sortBy: 'name',
+    order: 'desc',
+    sensitivity: 'base',
+    format: null,
+    ...options,
+  };
+
+  // 处理自动编号补零的长度配置
+  if (config.autoIndex && config.indexPadZero) {
+    config.indexLength = filesCount.toString().length;
+  }
+
+  // 处理过滤函数（确保为有效函数或 null）
+  config.filter = isFunction(config.filter) ? config.filter : null;
+  // 处理格式化函数（确保为有效函数或 null）
+  config.format = isFunction(config.format) ? config.format : null;
+
+  return config;
+};
+
+// 辅助函数：加载并校验文件名列表，并将名称列表复制给 options
+const analysisNamesList = (options, filesCount) => {
+  const { namesList } = options;
+  let names = [];
+
+  // 加载名称列表（数组直接使用，非数组调用 readList）
+  if (namesList) {
+    names =
+      Array.isArray(namesList) && namesList.length > 0
+        ? namesList
+        : readList(namesList);
+  }
+
+  // 校验名称列表与文件数量是否一致
+  const namesCount = names.length;
+
+  if (namesCount && namesCount !== filesCount) {
+    showWarningLog(
+      '警告',
+      `当前配置指定的 dirPath 文件夹中的文件数量`,
+      `与 namesList 中的数据数量不一致。`,
+    );
+  }
+
+  // 校验通过，挂载名称列表到配置并返回名称数组
+  options.names = names;
+};
+
+// 辅助函数：处理单个文件的重命名逻辑
+const doRename = (dirPath, oldFilename, index, config) => {
+  const { join } = path;
+  const oldFilePath = join(dirPath, oldFilename);
+  const stats = fs.statSync(oldFilePath);
+
+  // 过滤隐藏文件和文件夹（直接返回，不执行重命名）
+  if (stats.isDirectory() || oldFilename.startsWith('.')) {
+    return false;
+  }
+
+  // 生成新文件名并执行重命名
+  const newFilename = generateFilename(oldFilename, index, config);
+  const newFilePath = join(dirPath, newFilename);
+
+  rename(oldFilePath, newFilePath, config.force || false);
+
+  return true;
+};
+
+/**
+ * # 批量重命名指定文件夹中文件的文件名
+ *
+ * @param {string} dirPath - 必须，目标文件夹（绝对或相对）路径
+ * @param {object} [options={}] - 可选，配置参数对象数据. Default is `{}`
+ * @param {Array | string} [options.namesList=[]] - 可选，要修改的对应的文件名列表数组或者文件名列表的数据.
+ *   Default is `[]`
+ * @param {string} [options.prefix=''] - 可选，要添加的前缀. Default is `''`
+ * @param {string} [options.suffix=''] - 可选，要添加的后缀，添加在文件名和扩展名之间. Default is `''`
+ * @param {string} [options.connector=''] - 可选，prefix 和 suffix 之间的连接符. Default
+ *   is `''`
+ * @param {boolean | string} [options.autoIndex=false] - 可选，是否自动编号. Default is
+ *   `false`
+ * @param {number} [options.startIndex=0] - 可选，自动编号的起始索引值. Default is `0`
+ * @param {boolean} [options.indexPadZero=true] - 可选，是否索引编号自动补"0". Default is
+ *   `true`
+ * @param {string} [options.indexPrefix='第'] - 可选，自动编号后缀. Default is `'第'`
+ * @param {string} [options.indexSuffix='集'] - 可选，是否自动编号. Default is `'集'`
+ * @param {string} [options.delimiter='：'] - 可选，自动编号和名字间的分隔符. Default is `'：'`
+ * @param {boolean} [options.force=false] - 可选，是否强制重命名. Default is `false`
+ * @param {string} [options.extname=''] - 可选，重命名后的扩展名，例如: '.mp4'. Default is
+ *   `''`
+ * @param {Function} [options.filter=null] - 可选，对给文件夹中的文件进行过滤的函数方法，返回过滤后的文件列表数据.
+ *   Default is `null`
+ * @param {string | Function} [options.sortBy='name'] -
+ *   可选，排序方式，可选项：name、type、size、birthtime 和 modify-time)，或者排序的功能函数. Default is
+ *   `'name'`
+ * @param {string} [options.order='asc'] - 可选，文件名的排序方式（可选项：desc 和 asc）. Default
+ *   is `'asc'`
+ * @param {string} [options.sensitivity='base'] - 可选，name
+ *   排序时大小写/重音处理的方式，可选项：base、accent、case 和 variant. Default is `'base'`
+ * @param {Function} [options.format=null] - 可选，文件名的格式化方法. Default is `null`
+ * @returns {boolean} - 数据异常时返回 false，数据处理完成，返回 true.
+ */
+const batchRename = (dirPath, options = {}) => {
+  const { resolve } = path;
+  // 解析绝对路径（避免相对路径混乱）
+  const finalDirPath = resolve(dirPath);
+
+  // 检测文件路径是否存在
+  if (!isFileExists(finalDirPath)) {
+    showWarningLog('警告', finalDirPath, '文件夹不存在或已被删除。');
+    return false;
+  }
+
+  // 读取文件夹文件
+  const files = readDir(finalDirPath);
+
+  // 校验是否为空
+  if (files.length === 0) {
+    showWarningLog('警告', finalDirPath, '文件夹中没有任何文件。');
+    return false;
+  }
+
+  // 规整配置并过滤目标文件
+  const normalizedOptions = getNormalizedOptions(options, files.length);
+  const { filter, sortBy, order, sensitivity } = normalizedOptions;
+  const results = filter ? filter(files) : files;
+
+  if (results.length === 0) {
+    showWarningLog('警告', finalDirPath, '文件夹中没有符合过滤条件的文件。');
+    return false;
+  }
+
+  // 加载并校验文件名列表
+  analysisNamesList(normalizedOptions, results.length);
+
+  // 对目标文件进行排序
+  const sortedFiles = sortFiles(results, {
+    sortBy,
+    order,
+    sensitivity,
+    finalDirPath,
+  });
+
+  // 执行批量重命名
+  console.log(
+    chalk.greenBright('\n开始：'),
+    chalk.green('批量重命名进行中...\n'),
+  );
+
+  for (const [index, oldFilename] of sortedFiles.entries()) {
+    doRename(finalDirPath, oldFilename, index, normalizedOptions);
+  }
+
+  console.log(chalk.greenBright('\n结束：'), chalk.green('批量重命名完成！'));
+
+  // 正常执行完成返回 true
+  return true;
+};
+
+export default batchRename;

package/lib/create-config.js

@@ -0,0 +1,265 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { confirm, input } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { highlight } from 'cli-highlight';
+import prettier from 'prettier';
+
+import isFileExists from './utils/is-file-exists.js';
+import readFile from './utils/read-file.js';
+import writeFile from './utils/write-file.js';
+
+/**
+ * # 辅助函数：解析配置文件路径（统一路径处理，避免重复解构和 resolve）
+ *
+ * @function getConfigFilePaths
+ * @param {string} currentFilePath - 当前文件 URL 转换后的路径
+ * @returns {object} - 配置文件路径集合
+ */
+const getConfigFilePaths = (currentFilePath) => {
+  const configDir = path.dirname(currentFilePath);
+  const CONFIG_JSON_FILE = 'renames.config.js';
+  return {
+    CONFIG_JSON_FILE,
+    CONFIG_FILE_PATH: path.resolve(configDir, `../${CONFIG_JSON_FILE}`),
+    DEFAULT_CONFIG_PATH: path.resolve(
+      configDir,
+      '../config/default.config.json',
+    ),
+  };
+};
+
+/**
+ * # 辅助函数：初始化默认配置（集中管理默认值，减少零散条件判断）
+ *
+ * @function initDefaultConfig
+ * @param {string} defaultConfigPath - 默认配置文件路径
+ * @returns {object} - 初始化后的配置对象
+ */
+const initDefaultConfig = (defaultConfigPath) => {
+  const defaultConfigJson = readFile(defaultConfigPath);
+  const baseConfig = defaultConfigJson ? JSON.parse(defaultConfigJson) : {};
+  // 补充核心默认值，统一覆盖
+  return {
+    dirPath: '',
+    namesList: '',
+    prefix: '',
+    suffix: '',
+    connector: '',
+    autoIndex: false,
+    startIndex: 0,
+    indexPadZero: true,
+    indexPrefix: '第',
+    indexSuffix: '集',
+    delimiter: '：',
+    force: false,
+    extname: '',
+    filter: null,
+    sortBy: 'name',
+    order: 'asc',
+    sensitivity: 'base',
+    format: null,
+    ...baseConfig,
+  };
+};
+
+/**
+ * # 辅助函数：赋值配置项（统一处理配置赋值，减少重复 if 判断）
+ *
+ * @function assignConfigKeys
+ * @param {object} config - 目标配置对象
+ * @param {object} options - 传入的选项
+ * @param {string[]} keys - 需要赋值的配置项键名列表
+ */
+const assignConfigKeys = (config, options, keys) => {
+  for (const key in keys) {
+    if (options[key] !== undefined) {
+      // 特殊处理：startIndex 转为数字类型
+      config[key] =
+        key === 'startIndex' ? Number.parseInt(options[key], 10) : options[key];
+    }
+  }
+};
+
+/**
+ * # 辅助函数：交互式获取必填配置（提取重复交互逻辑，减少分支嵌套）
+ *
+ * @function getConfigInteractive
+ * @param {object} config - 目标配置对象
+ * @param {string} key - 配置项键名
+ * @param {string} promptText - 提示文本
+ * @param {string} demoText - 示例文本
+ * @returns {Promise<void>}
+ */
+const getConfigInteractive = async (config, key, promptText, demoText) => {
+  if (!config[key]) {
+    const answer = await input({
+      message: chalk.greenBright(
+        `可选，${promptText}（例如："${demoText}"）：`,
+      ),
+    });
+    if (answer) config[key] = answer;
+  }
+};
+
+/**
+ * 批量重命名配置类型
+ *
+ * @typedef {object} RenameConfig
+ * @property {string} dirPath 目录路径
+ * @property {string} namesList 文件名列表（逗号分隔）
+ * @property {string} prefix 文件名前缀
+ * @property {string} suffix 文件名后缀
+ * @property {string} connector 前缀与索引/名称的连接符
+ * @property {boolean} autoIndex 是否自动添加索引
+ * @property {string} startIndex 起始索引
+ * @property {boolean} indexPadZero 索引是否补零
+ * @property {string} indexPrefix 索引前缀
+ * @property {string} indexSuffix 索引后缀
+ * @property {string} delimiter 列表分隔符
+ * @property {boolean} force 是否强制覆盖
+ * @property {string} extname 文件扩展名
+ * @property {string} sortBy 排序依据
+ * @property {string} order 排序顺序（asc/desc）
+ * @property {string} sensitivity 排序敏感度
+ */
+
+/**
+ * 取消操作类型
+ *
+ * @typedef {object} CancelAction
+ * @property {boolean} isCancel 是否取消操作
+ */
+
+/**
+ * # 生成工具的配置文件
+ *
+ * @async
+ * @function createConfig
+ * @param {object} options - 配置信息
+ * @param {string} [options.dirPath=''] - 必须，目标文件夹路径（绝对路径或相对路径）. Default is `''`
+ * @param {string} [options.namesList=''] -
+ *   可选，要修改的对应的文件名列表数组或者文件名列表的数据（例如：标题1，标题2）. Default is `''`
+ * @param {string} [options.prefix=''] - 可选，要添加的前缀. Default is `''`
+ * @param {string} [options.suffix=''] - 可选，要添加的后缀，添加在文件名和扩展名之间. Default is `''`
+ * @param {string} [options.connector=''] - 可选，prefix 和 suffix 之间的连接符. Default
+ *   is `''`
+ * @param {string} [options.autoIndex=false] - 可选，是否自动生成索引编号. Default is `false`
+ * @param {string} [options.startIndex=0] - 可选，自动编号的起始索引值. Default is `0`
+ * @param {string} [options.indexPadZero=false] - 可选，是否索引编号自动补‘0’. Default is
+ *   `false`
+ * @param {string} [options.indexPrefix='第'] - 可选，自动编号后缀. Default is `'第'`
+ * @param {string} [options.indexSuffix='集'] - 可选，是否自动编号. Default is `'集'`
+ * @param {string} [options.delimiter='：'] - 可选，自动编号和名字间的分隔符. Default is `'：'`
+ * @param {string} [options.force=false] - 可选，是否强制重命名. Default is `false`
+ * @param {string} [options.extname=''] - 可选，重命名后的扩展名，例如: '.mp4'. Default is
+ *   `''`
+ * @param {string} [options.sortBy='name'] -
+ *   可选，文件名的排序类型（可选项：name、size、type、birthtime 和 modify-time）. Default is
+ *   `'name'`
+ * @param {string} [options.order='asc'] - 可选，文件名的排序方式（可选项：desc 和 asc）. Default
+ *   is `'asc'`
+ * @param {string} [options.sensitivity='base'] - 可选，name
+ *   排序时大小写/重音处理的方式，可选项：base、accent、case 和 variant. Default is `'base'`
+ * @returns {Promise<RenameConfig | CancelAction>}
+ *
+ *   - 返回配置信息的 JSON 数据
+ */
+const createConfig = async (options) => {
+  const currentFilePath = fileURLToPath(import.meta.url);
+  const { CONFIG_JSON_FILE, CONFIG_FILE_PATH, DEFAULT_CONFIG_PATH } =
+    getConfigFilePaths(currentFilePath);
+  const DEMO_DIR_PATH = String.raw`C:\Downloads\Videos`;
+  const DEMO_LIST_PATH = String.raw`C:\Downloads\names.txt`;
+
+  // 初始化默认配置（集中管理，减少零散条件判断）
+  const config = initDefaultConfig(DEFAULT_CONFIG_PATH);
+
+  // 交互式确认是否生成/重写配置
+  const isConfigExists = isFileExists(CONFIG_FILE_PATH);
+  const confirmMessage = isConfigExists
+    ? `配置文件 ${CONFIG_JSON_FILE} 已存在，是否重写配置？`
+    : `执行 init 命令后，工具将生成配置文件 ${CONFIG_JSON_FILE}，是否继续？`;
+  const isConfirm = await confirm({ message: confirmMessage });
+
+  if (!isConfirm) {
+    return { isCancel: true };
+  }
+
+  // 批量赋值可选配置项（提取工具函数，减少重复 if 判断）
+  const configKeys = [
+    'prefix',
+    'suffix',
+    'connector',
+    'autoIndex',
+    'startIndex',
+    'indexPadZero',
+    'indexPrefix',
+    'indexSuffix',
+    'delimiter',
+    'force',
+    'extname',
+    'sortBy',
+    'order',
+    'sensitivity',
+  ];
+
+  // 优先使用传入的 options 的 dirPath 值
+  if (options.dirPath) {
+    config.dirPath = options.dirPath;
+  } else {
+    // 然后使用交互式获取 dirPath 参数
+    await getConfigInteractive(
+      config,
+      'dirPath',
+      '请输入需要执行重命名操作的文件夹路径',
+      DEMO_DIR_PATH,
+    );
+  }
+
+  // 优先使用传入的 options 的 namesList 值
+  if (options.namesList) {
+    config.namesList = options.namesList;
+  } else {
+    // 然后使用交互式获取 namesList 参数
+    await getConfigInteractive(
+      config,
+      'namesList',
+      '请输入要修改的对应的文件名列表数组或者文件名列表的数据',
+      DEMO_LIST_PATH,
+    );
+  }
+
+  // 其余非必填参数，如果用户输入了，按用户输入值，否则使用参数的默认值
+  assignConfigKeys(config, options, configKeys);
+
+  // 格式化配置并生成文件
+  const configCode = `export default ${JSON.stringify(config)}`;
+  const formatedConfigCode = await prettier.format(configCode, {
+    // JS 解析器
+    parser: 'babel',
+    // 缩进 2 空格
+    tabWidth: 2,
+    // 单引号
+    singleQuote: true,
+    // 尾逗号
+    trailingComma: 'es5',
+    // 保留分号
+    semi: true,
+  });
+
+  console.log(
+    `\n配置文件内容如下：\n\n`,
+    highlight(formatedConfigCode, {
+      language: 'javascript',
+    }),
+  );
+
+  writeFile(CONFIG_FILE_PATH, formatedConfigCode);
+
+  // 返回最终配置
+  return config;
+};
+
+export default createConfig;

package/lib/generate-filename.js

@@ -0,0 +1,182 @@
+import getBasename from './utils/get-basename.js';
+import getExtension from './utils/get-extension.js';
+import isFunction from './utils/is-function.js';
+import padZero from './utils/pad-zero.js';
+import toIndexChapter from './utils/to-index-chapter.js';
+
+// 辅助函数：规整配置项，提供统一默认值
+const getNormalizedOptions = (options) => ({
+  extname: '',
+  autoIndex: false,
+  indexLength: 2,
+  indexPrefix: '',
+  indexSuffix: '',
+  delimiter: '：',
+  prefix: '',
+  suffix: '',
+  connector: '',
+  names: [],
+  format: null,
+  startIndex: 0,
+  ...options,
+});
+
+// 辅助函数：生成索引章节字符串
+const generateIndexChapter = (index, options) => {
+  const {
+    autoIndex,
+    indexLength,
+    startIndex,
+    indexPrefix,
+    indexSuffix,
+    delimiter,
+  } = options;
+  if (!autoIndex) return '';
+
+  const onlyIndex = autoIndex === 'only';
+  const fileIndex = index + 1 + startIndex;
+  const paddedIndex = indexLength
+    ? padZero(fileIndex, indexLength)
+    : `${fileIndex}`;
+
+  return toIndexChapter(paddedIndex, onlyIndex, {
+    indexPrefix,
+    indexSuffix,
+    delimiter,
+  });
+};
+
+// 辅助函数：从名称列表生成核心文件名
+const getFilenameByNames = (
+  oldFilename,
+  index,
+  indexChapter,
+  options,
+  namesList,
+) => {
+  const { format, autoIndex } = options;
+  const onlyIndex = autoIndex === 'only';
+  const matchedName = namesList[index] || getBasename(oldFilename);
+
+  // 优先使用格式化函数，否则直接使用列表中的文件名
+  let newFilename = isFunction(format)
+    ? format(oldFilename, matchedName, index, namesList)
+    : matchedName;
+
+  // 拼接自动编号（仅非 onlyIndex 模式）
+  if (autoIndex && !onlyIndex) {
+    newFilename = `${indexChapter}${newFilename}`;
+  }
+
+  // onlyIndex 模式直接返回索引章节
+  return onlyIndex ? indexChapter : newFilename;
+};
+
+// 辅助函数：拼接前后缀
+const appendPrefixAndSuffix = (filename, options) => {
+  const { prefix, suffix, connector } = options;
+  let result = filename;
+
+  // 拼接前缀
+  if (prefix) {
+    result = `${prefix}${connector}${result}`;
+  }
+
+  // 拼接后缀
+  if (suffix) {
+    result = `${result}${connector}${suffix}`;
+  }
+
+  return result;
+};
+
+/**
+ * # 辅助函数：获取格式化后的文件名
+ *
+ * @function formatBasename
+ * @param {string} basename - 文件的基础名称
+ * @param {Function} [format=null] - 用来格式化的回调函数. Default is `null`
+ * @param {number} [index=-1] - 文件在 dirPath 文件排序后的索引值. Default is `-1`
+ * @returns {string} - 返回格式化后的文件名
+ */
+const formatBasename = (basename, format = null, index = -1) => {
+  return isFunction(format) ? format(basename, index) : basename;
+};
+
+/**
+ * # 获取文件名，通过原文件名，文件在文件夹中所有文件中的索引值和配置参数
+ *
+ * @function generateFilename
+ * @param {string} oldFilename - 原文件名
+ * @param {number} index - 文件在文件夹中所有文件中的索引值
+ * @param {object} [options={}] - 可选，配置参数对象数据. Default is `{}`
+ * @param {Array} [options.names=[]] - 可选，要修改的对应的文件名列表数组. Default is `[]`
+ * @param {string} [options.prefix=''] 可选，要添加的前缀. Default is `''`
+ * @param {string} [options.suffix=''] - 可选，要添加的后缀，添加在文件名和扩展名之间. Default is `''`
+ * @param {string} [options.connector=''] - 可选，Prefix 和 suffix 之间的连接符. Default
+ *   is `''`
+ * @param {boolean | string} [options.autoIndex=false] - 可选，是否自动编号. Default is
+ *   `false`
+ * @param {number} [options.startIndex=0] - 可选，自动编号的起始索引值. Default is `0`
+ * @param {boolean} [options.indexPadZero=true] - 可选，是否索引编号自动补"0". Default is
+ *   `true`
+ * @param {number} [options.indexLength=2] - 可选，自动补齐的字符串长度值. Default is `2`
+ * @param {string} [options.indexPrefix='第'] - 可选，自动编号后缀. Default is `'第'`
+ * @param {string} [options.indexSuffix='集'] - 可选，是否自动编号. Default is `'集'`
+ * @param {string} [options.delimiter='：'] - 可选，自动编号和名字间的分隔符. Default is `'：'`
+ * @param {Function | null} [options.format=null] - 可选，文件名的格式化方法. Default is
+ *   `null`
+ * @param {string} [options.extname=''] - 可选，想替换的扩展名. Default is `''`
+ * @returns {string} - 返回生成的文件名字符串
+ */
+const generateFilename = (oldFilename, index, options = {}) => {
+  // 拆分文件名和扩展名（如 "photo.jpg" → 文件名"photo"，扩展名".jpg"）
+  const basename = getBasename(oldFilename);
+  const originExtname = getExtension(oldFilename);
+
+  // 获取配置信息
+  const normalizedOptions = getNormalizedOptions(options);
+  const { extname, names, format, autoIndex } = normalizedOptions;
+  const namesCount = names.length;
+  let matchedName = '';
+
+  // 直接使用 namesList 中的匹配的文件名，如果 namesList 和 dirPath 文件夹中的数量不一致，则使用原文件名
+  if (namesCount && !autoIndex) {
+    matchedName = names?.[index] ?? basename;
+    return `${formatBasename(matchedName, format)}${originExtname}`;
+  }
+
+  const namesList = Array.isArray(names) && names.length > 0 ? names : [];
+  const indexChapter = generateIndexChapter(index, normalizedOptions);
+  const onlyIndex = autoIndex === 'only';
+  let newFilename;
+
+  // 存在名称列表
+  if (namesList.length > 0) {
+    newFilename = getFilenameByNames(
+      oldFilename,
+      index,
+      indexChapter,
+      normalizedOptions,
+      namesList,
+    );
+  } else if (autoIndex) {
+    // 无名称列表，但开启自动编号
+    newFilename = onlyIndex
+      ? indexChapter
+      : `${indexChapter}${formatBasename(basename, format, index)}`;
+  } else {
+    // 无名称列表，无自动编号（默认场景）
+    newFilename = formatBasename(basename, format, index);
+  }
+
+  // 拼接前后缀 + 确定扩展名
+  newFilename = appendPrefixAndSuffix(newFilename, normalizedOptions);
+
+  const finalExtname = extname || originExtname;
+
+  // 返回最终结果
+  return `${newFilename}${finalExtname}`;
+};
+
+export default generateFilename;