文件工具箱

文件工具箱是一个面向本地文件和目录管理的 VS Code 扩展，提供常用文件操作、批量处理、规则化重命名、目录差异导出和操作报告能力。

English summary: File Toolbox is a VS Code extension for local file and folder operations, rule-based renaming, reports, templates, and directory diff export.

功能概览

• 单个文件/目录：重命名、复制到、移动到、安全删除、创建副本。
• 路径工具：复制绝对路径、相对路径、文件名、不带扩展名的文件名。
• 批量操作：批量重命名、复制、移动、删除，执行前可先预览。
• 规则重命名：支持后缀映射、后缀恢复、前后缀增删、文本/正则替换、大小写转换、序号和日期时间。
• 目录差异导出：比较原始目录和修改后目录，导出新增/修改文件，并在预览/结果区提示删除项。
• 差异导出并重命名：导出差异文件时同步应用重命名规则。
• 规则集管理：通过独立 HTML 界面查看内置规则集和自定义规则集，支持新增、删除和扩展自定义规则。
• 报告：支持 JSON、Markdown、CSV。
• 多语言：命令、配置和工作台支持中文/英文。

右键菜单

在 VS Code 资源管理器中右键文件或目录，进入“文件工具箱”菜单后即可使用相关命令。菜单采用两层结构：第一层是“文件工具箱”入口，第二层直接列出命令，不再继续拆成“基础操作 / 批量操作 / 路径工具 / 规则”等第三层分类。

常见命令包括：

• 打开工作台
• 重命名、复制到、移动到、安全删除、创建副本
• 复制绝对路径、复制相对路径、复制文件名、复制不带扩展名的文件名
• 批量重命名、批量复制、批量移动、批量删除
• 应用/恢复重命名规则
• 打开所在文件夹、在终端打开目录

工作台

执行“文件工具箱：打开工作台”可以进入综合工作台。工作台分为三个页签，每个页签只显示该操作需要的参数，避免重复的“修改后目录”等输入造成歧义。

• 重命名：填写源路径，选择规则来源、规则集和正向/反向重命名方向。
• 差异导出：填写原始目录、修改后目录、输出目录，选择比较方式、路径模式和导出结构。
• 差异导出并重命名：在差异导出的基础上选择重命名规则和方向。

每个路径输入框都可以手工输入，也可以点击“浏览”打开 VS Code 的文件/目录选择框。左侧是输入区和操作按钮，右侧是预览区；中间分隔线可以拖动，用来调整输入区和预览区宽度。

点击“预览”后，右侧会显示预览列表，包括是否选中、处理动作、源路径、目标路径、命中规则、处理说明和状态。“执行选中项”只会处理勾选的预览项。关键结果会显示在工作台右侧的结果提示区，而不是弹出 VS Code 通知。

规则集管理

在工作台中点击“管理规则集”会打开独立界面：

• 左侧列出内置规则集和用户自定义规则集。
• 右侧展示当前规则集下每条规则的类型和内容。
• 内置规则集只读。
• 自定义规则集可以新增、添加规则或删除。

工作台中的临时自定义规则适合一次性操作；需要长期复用时，建议保存为自定义规则集。

差异导出

差异导出会比较原始目录和修改后目录：

• 新增文件会导出。
• 修改文件会导出。
• 删除文件不会生成额外报告文件，预览和执行结果会提示删除项数量及路径信息。
• 可以选择相对路径或绝对路径显示方式。
• 可以选择保留目录结构或扁平化导出。
• 可以选择 content、size/mtime 或 hash 比较策略。

配置

设置项以 fileToolbox.* 开头，包含：

• 默认冲突策略。
• 是否扫描隐藏文件。
• 是否跟随符号链接。
• 是否启用 gitignore 预留过滤。
• 默认比较策略。
• 默认 include/exclude glob。
• 远程 provider 预留开关。
• 自定义 JavaScript 规则预留开关。

当前边界

• 当前版本仅支持本地文件系统。
• FTP/SFTP/SSH provider 已预留扩展入口，但当前版本会明确提示暂不支持。
• 本扩展不调用、不迁移、不依赖任何 Python 脚本。
• 自定义 JavaScript 重命名规则入口只做配置预留，默认关闭，当前版本不会执行用户 JavaScript。

联系方式

如需反馈问题或交流建议，可以联系：guanyezhui@163.com