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；压图页可手工一次生成 1-10 个临时邮箱，也可在扫描后按每个账户 500 张图片的容量一次补齐全部扫描结果所需邮箱；每行可独立复制邮箱并打开 Tinify API 注册页，等待期间可重新打开页面并把邮件等待时间重置为 5 分钟；也可自行在外部打开注册页并提交表单，再点击 检测邮箱邮件 启动或立即检查列表中的邮箱，随后激活账户并将该账户的一个代表 Key 加入 Key 池
  • pngquant - 本地 PNG 专用压缩器，高压缩比
• TinyPNG 压缩会按 Key 池顺序使用；当前 Key 所属账户额度耗尽时会自动移除并切换下一项继续压缩，全部 Key 耗尽后才停止剩余任务并提示前往压图页注册
• 尚未取得 Key 的 TinyPNG 临时邮箱和密码会保存在 VS Code 全局安全存储中；重载或重启后邮箱会恢复为待注册状态，点击对应行即可重新登录并继续收信，也可手动删除
• TinyPNG 注册成功后会先保存 Key，再清理对应临时邮箱凭据；安全存储不会保存 mail.tm token，也不会把邮箱密码写入普通设置
• 压图面板会按当前引擎显示对应参数，并保存到用户级 VS Code 设置，影响右键压缩命令
• Sharp 使用 质量 参数；pngquant 使用独立的 质量范围 和 速度；TinyPNG 由服务端自动压缩，不使用本地质量参数
• 压图面板扫描目录首次默认 assets，首次进入页面会自动扫描；可直接输入工作区相对目录或点击 选择目录 回填，清空时扫描当前工作区根目录
• 扫描结果首次默认按大小从大到小排列，支持按大小、名称或格式正反序切换；排序会按工作区保存并决定图片进入压缩队列的顺序
• 扫描结果支持按工作区相对路径设置“包含的文件”和“排除的文件” Glob、图片格式及文件大小范围并即时过滤；多个 Glob 使用逗号分隔，支持 *、**、?，排除规则优先；大小范围使用包含边界，可分别设置“不小于”和“不大于”的数值及 KB/MB 单位；过滤区域默认收起，展开状态和过滤条件按工作区保存
• 全选、反选和压缩仅作用于当前过滤结果；隐藏图片会保留原勾选状态，但不会进入本次压缩队列
• 批量压缩时自动递归扫描所有子目录
• 显示压缩进度、耗时和节省空间统计

压缩示例：

• 面板压缩：切换到 压图 → 输入扫描目录或点击 选择目录 → 扫描 → 勾选图片 → 压缩选中
• 单张图片：直接右键点击 → 压缩
• 文件夹：右键文件夹 → 选择压缩 → 自动压缩所有图片

删除空目录

• 打开左侧 工具箱 > 转换工具，切换到 空目录清理
• 点击 转换工具 面板右上角齿轮按钮，可打开 Orchid Utils 扩展设置
• 扫描目录留空时默认扫描当前工作区根目录，也可以输入相对于工作区的目录
• 支持配置排除目录，默认排除 .git、node_modules、dist、out、.vscode-test；清空后将扫描包括 dist、out 在内的所有目录
• 扫描目录和排除目录会按工作区自动保存，下次打开同一工作区时恢复
• 扫描过程中显示当前扫描目录、已扫描目录数和已发现候选数，并支持取消
• 先扫描并预览空目录列表，勾选确认后再删除
• 支持级联空目录清理：删除子空目录后父目录变空时，也会纳入候选

Node 依赖

• 打开左侧 工具箱 > 转换工具，切换到 Node 依赖
• 递归扫描当前工作区中有依赖声明的 package.json，默认排除 .git、node_modules、dist、out、.vscode-test
• 没有依赖声明且不是 workspace 根项目的 package.json 会被忽略
• 按锁文件优先选择包管理器：pnpm-lock.yaml、yarn.lock、package-lock.json / npm-shrinkwrap.json、bun.lock / bun.lockb
• 无锁文件时会读取 package.json 的 packageManager 字段，仍无法判断时使用 npm install
• 扫描完成后默认勾选缺少 node_modules 的可安装项目，已有 node_modules 的项目会展示但默认不勾选
• 安装依赖时默认 3 个项目并发执行，详细 stdout / stderr 会写入 Orchid Node 依赖 Output 面板
• 支持取消尚未开始的排队安装任务，已启动的安装会继续完成

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 - Sharp 默认压缩质量
• orchid-utils.compress.tinypngApiKeys - TinyPNG API Key 池，按顺序使用并在额度耗尽后自动移除当前项
• orchid-utils.compress.pngquantQuality - pngquant 质量范围
• orchid-utils.compress.pngquantSpeed - pngquant 压缩速度

使用方法

批量复制文件

1. 在 VS Code 资源管理器中右键点击任意文件夹
2. 选择 @Orchid 工具 > 批量复制文件
3. 输入目标目录路径
4. 输入要复制的文件名（支持通配符）

批量重命名

1. 在 VS Code 资源管理器中右键点击任意文件夹
2. 选择 @Orchid 工具 > 批量重命名
3. 输入要重命名的文件模式（如 *.json 或 file1.json,file2.json）
4. 输入重命名规则（如 {name}_v2 或 {index:3}_{name}）
5. 确认预览后执行重命名

图片压缩

1. 点击左侧活动栏的 工具箱
2. 打开 转换工具 视图并切换到 压图
3. 输入扫描目录或点击 选择目录，首次默认 assets，清空表示工作区根目录
4. 选择压缩引擎并填写对应参数；TinyPNG 可手工设置 1-10 个邮箱，或扫描后按全部图片数量、现有 Key 池和待注册邮箱一次补齐所需邮箱，再逐行完成注册；等待注册邮件时可重新打开注册页并重置 5 分钟等待时间，也可自行在外部打开注册页并提交表单，然后点击 检测邮箱邮件 启动或立即检查列表中的邮箱，每个账户只会选择一个 active Key 加入用户级 Key 池
5. 首次进入会自动扫描；需要重新扫描时点击 扫描，可对结果排序并勾选要压缩的图片，点击图片路径可在 VS Code 编辑区预览
6. 点击 压缩选中，在 Output 面板查看详细压缩日志

删除空目录

1. 点击左侧活动栏的 工具箱
2. 打开 转换工具 视图并切换到 空目录清理
3. 输入扫描目录和排除目录，扫描目录留空表示工作区根目录
4. 点击 扫描，在预览列表中勾选要删除的空目录
5. 点击 删除选中，确认后执行删除

Node 依赖

1. 点击左侧活动栏的 工具箱
2. 打开 转换工具 视图并切换到 Node 依赖
3. 点击 扫描，等待有依赖的项目列表生成
4. 点击项目卡片中的安装命令可立即只安装该项目的依赖，也可按需调整勾选项
5. 点击 安装选中 可批量安装勾选项目的依赖，在 Output 面板查看详细安装日志

Cocos 调试

1. 先在 Cocos Creator 中启动预览服务
2. 点击左侧活动栏的 工具箱
3. 打开 转换工具 视图并切换到 Cocos 调试
4. 按需修改 Host、端口范围、webRoot、自动同步开关，并勾选或填写 runtimeArgs
5. 等待页签自动扫描，或点击 扫描端口 手动刷新当前可用预览端口
6. 需要写入 VS Code 启动配置时，点击 同步配置
7. 需要刷新 Cocos 资源时，点击 Cocos 编译
8. 如果自动匹配到当前项目端口，直接点击 启动调试
9. 如果发现多个端口但无法确认当前项目，选择要调试的端口后再次点击 启动调试

Git 远程仓库

1. 打开源代码管理视图右上角的更多操作菜单
2. 选择 远程 > 修改远程仓库（Orchid）...
3. 选择要修改的 remote
4. 修改远端名称或 URL / 路径
5. 按需设置或取消当前分支跟踪远端

安装

同一个 VSIX 文件支持 Windows x64、Apple Silicon Mac 和 Intel Mac。使用 VSIX 文件安装：

1. 下载 .vsix 文件
2. 在 VS Code 中按 Ctrl+Shift+P
3. 输入 Extensions: Install from VSIX...
4. 选择下载的 VSIX 文件