Orchid Utils
VS Code 扩展工具箱，提供便捷的文件操作功能。
功能特性
批量复制文件
- 右键点击文件夹，选择 @Orchid 工具 > 批量复制文件
- 支持文件名通配符（如
*.json 复制所有 JSON 文件）
- 支持多个文件列表（用逗号分隔）
- 自动保存上次使用的目标目录和文件模式
批量重命名
- 右键点击文件夹，选择 @Orchid 工具 > 批量重命名
- 支持递归扫描所有子目录中的文件
- 支持文件名通配符匹配（如
*.json）
- 保留原始目录结构，只修改文件名
- 支持丰富的重命名规则占位符：
{name} - 原文件名（不含扩展名）{ext} - 扩展名（包含点号，如 .json）{date} - 日期（格式：YYYY-MM-DD）{time} - 时间（格式：HH-MM-SS）{index} - 序号（从1开始）{index:N} - 带宽度的序号（如 {index:3} 生成 001, 002...）{dir} - 文件所在目录名
- 显示重命名预览，确认后再执行
- 自动保存上次使用的匹配模式和重命名规则
重命名示例：
{name}_backup → file_backup.json{date}_{name} → 2026-04-16_file.json{index:3}_{name} → 001_file.json, 002_file.json{dir}_{name} → images_file.jpg
图片压缩
- 右键点击文件夹，选择 @Orchid 图片工具 > 压缩图片
- 或直接右键点击图片文件，选择 @Orchid 图片工具 > 压缩图片
- 支持三种压缩引擎：
- Sharp - 本地压缩，无需网络，速度快
- TinyPNG - 在线压缩，需要 API Key，压缩效果好
- pngquant - 本地 PNG 专用压缩器，高压缩比
- 批量压缩时自动递归扫描所有子目录
- 显示压缩进度、耗时和节省空间统计
压缩示例：
- 单张图片：直接右键点击 → 压缩
- 文件夹：右键文件夹 → 选择压缩 → 自动压缩所有图片
删除空目录
- 打开左侧 工具箱 > 转换工具，切换到 空目录清理
- 点击 转换工具 面板右上角齿轮按钮，可打开 Orchid Utils 扩展设置
- 扫描目录留空时默认扫描当前工作区根目录，也可以输入相对于工作区的目录
- 支持配置排除目录，默认排除
.git、node_modules、dist、out、.vscode-test
- 扫描目录和排除目录会按工作区自动保存，下次打开同一工作区时恢复
- 扫描过程中显示当前扫描目录、已扫描目录数和已发现候选数，并支持取消
- 先扫描并预览空目录列表，勾选确认后再删除
- 支持级联空目录清理：删除子空目录后父目录变空时，也会纳入候选
Cocos 调试
- 打开左侧 工具箱 > 转换工具，切换到 Cocos 调试
- 默认扫描
localhost 的 7456-7700 端口，自动识别已启动的 Cocos Creator 预览服务
- 进入页签时会自动扫描一次端口，也可以手动点击 扫描端口 重新扫描
- 扫描时会优先读取当前工作区
temp/startup.json 的 Cocos 进程，并按监听端口进程匹配当前项目
- 端口列表会标记 当前项目 或 未确认项目，无法确认且同时发现多个预览端口时需要手动选择
- 可点击 同步配置 将当前 Host、端口、
webRoot、runtimeArgs 写入已有 .vscode/launch.json 和 .vscode/tasks.json 中约定 Cocos 配置
- 默认勾选自动同步，唯一匹配当前项目端口时会自动同步上述配置；取消勾选后只更新面板端口
- 支持点击 Cocos 编译 调用当前端口的
/asset-db/refresh，刷新 Cocos Creator 资源数据库
- 支持配置
webRoot，默认使用 ${workspaceFolder}
- 支持勾选常用 Chrome
runtimeArgs（--disable-web-security、--incognito），并可继续按行填写其他参数
- Host、端口范围、上次选择端口和调试配置会在修改后按工作区自动保存，下次打开同一工作区时恢复
- 只启动 Chrome 调试，不负责启动 Cocos Creator 预览服务
Git 远程仓库
- 在源代码管理标题菜单中选择 远程 > 修改远程仓库（Orchid）...
- 支持修改已有 remote 的远端名称和 URL / 路径
- 多个 remote 时可在同一表单内选择要修改的远端
- 可设置或取消当前分支跟踪远端
配置项
批量复制文件
orchid-utils.copyFiles.targetDir - 上次使用的目标目录orchid-utils.copyFiles.patterns - 文件匹配模式
批量重命名
orchid-utils.batchRename.patterns - 文件匹配模式orchid-utils.batchRename.rule - 重命名规则
图片压缩
orchid-utils.compress.defaultEngine - 默认图片压缩引擎orchid-utils.compress.quality - 默认压缩质量orchid-utils.compress.tinypngApiKey - TinyPNG API Keyorchid-utils.compress.pngquantQuality - pngquant 质量范围orchid-utils.compress.pngquantSpeed - pngquant 压缩速度
使用方法
批量复制文件
- 在 VS Code 资源管理器中右键点击任意文件夹
- 选择 @Orchid 工具 > 批量复制文件
- 输入目标目录路径
- 输入要复制的文件名（支持通配符）
批量重命名
- 在 VS Code 资源管理器中右键点击任意文件夹
- 选择 @Orchid 工具 > 批量重命名
- 输入要重命名的文件模式（如
*.json 或 file1.json,file2.json）
- 输入重命名规则（如
{name}_v2 或 {index:3}_{name}）
- 确认预览后执行重命名
删除空目录
- 点击左侧活动栏的 工具箱
- 打开 转换工具 视图并切换到 空目录清理
- 输入扫描目录和排除目录，扫描目录留空表示工作区根目录
- 点击 扫描，在预览列表中勾选要删除的空目录
- 点击 删除选中，确认后执行删除
Cocos 调试
- 先在 Cocos Creator 中启动预览服务
- 点击左侧活动栏的 工具箱
- 打开 转换工具 视图并切换到 Cocos 调试
- 按需修改 Host、端口范围、
webRoot、自动同步开关，并勾选或填写 runtimeArgs
- 等待页签自动扫描，或点击 扫描端口 手动刷新当前可用预览端口
- 需要写入 VS Code 启动配置时，点击 同步配置
- 需要刷新 Cocos 资源时，点击 Cocos 编译
- 如果自动匹配到当前项目端口，直接点击 启动调试
- 如果发现多个端口但无法确认当前项目，选择要调试的端口后再次点击 启动调试
Git 远程仓库
- 打开源代码管理视图右上角的更多操作菜单
- 选择 远程 > 修改远程仓库（Orchid）...
- 选择要修改的 remote
- 修改远端名称或 URL / 路径
- 按需设置或取消当前分支跟踪远端
安装
使用 VSIX 文件安装：
- 下载
.vsix 文件
- 在 VS Code 中按
Ctrl+Shift+P
- 输入
Extensions: Install from VSIX...
- 选择下载的 VSIX 文件
| |
