功能总览

MouseBoost 的功能很多，建议按“我现在想完成什么任务”来理解，而不是按菜单顺序死记。实际菜单会根据当前选择的文件类型、是否多选、是否选中文件夹、是否安装第三方应用、是否拥有权限动态显示。

右键菜单管理

MouseBoost 的核心是可配置的 Finder 右键菜单。

你可以：

• 启用或隐藏菜单项。
• 调整菜单顺序。
• 为每一个菜单项单独设置快捷键。
• 把常用功能放到主菜单。
• 使用折叠菜单减少 Finder 菜单长度。
• 修改折叠菜单名称和图标。
• 隐藏主菜单图标或子菜单图标。
• 控制系统右键菜单显示在顶部、底部或不显示。

适合放在主菜单的高频功能包括复制路径、新建文件、打开终端、常用目录、复制到、移动到、剪贴板历史、批量重命名。

新建文件

MouseBoost 可以直接在 Finder 当前目录新建文件。

默认支持的类型包括：

• 文本与富文本：txt、rtf、md。
• 数据与配置：json、xml。
• Office 与 iWork：docx、xlsx、pptx、pages、numbers、key。
• WPS：wps、et、dps。
• Web 与脚本：html、css、js、py、sh。

你还可以把已有文件添加为模板。之后在右键菜单中创建新文件时，会复制模板内容，并可以保留图标和默认文件名。

注意事项：

• 新建文件可以选择是否创建后自动打开。
• 可以设置新文件是否隐藏扩展名。
• 在无选中文件时，部分新建入口会弹出保存面板。
• 如果当前目录不可写，需要先授权对应目录。

常用目录

常用目录用于把高频文件夹放进右键菜单。

典型用法：

• 快速打开项目目录、下载目录、素材目录。
• 将当前选中文件复制到常用目录。
• 将当前选中文件移动到常用目录。
• 在常用目录中创建替身。
• 将终端打开到常用目录。
• 右键文件夹时快速添加为常用目录。

常用目录支持展开子目录。对于目录层级较深的工作区，可以把顶层目录加入常用目录，然后在右键菜单中继续选择子文件夹。

常用应用

常用应用可以把文件或文件夹快速交给指定 App 打开。

默认候选包括：

• OmniZip / OmniZip Pro。
• OmniReader。
• WeChat。
• Visual Studio Code。
• Sublime Text。
• Trae CN。
• Cursor。
• Windsurf。
• Antigravity。
• Codex。
• Android Studio、IntelliJ IDEA、WebStorm、PyCharm、PhpStorm、GoLand。
• Warp、Zed、Emacs。

适合用法：

• 右键项目文件夹，直接用 VS Code、Cursor、WebStorm 打开。
• 右键文件，用指定编辑器打开。
• 把常用开发工具加入主菜单。
• 对不存在的 App 显示安装或打开失败提示。

常用网站

常用网站把网页入口放进 Finder 右键菜单。

默认包含一些 AI 工具网站：

• DeepSeek。
• 豆包。
• Kimi。
• Gemini。
• ChatGPT。
• Claude。

你可以添加自己的网址，例如项目管理系统、内部文档、网盘、设计工具、后台系统等。

常用脚本

常用脚本支持 shell 脚本和 AppleScript。脚本可以读取当前选中的文件路径、文件名、扩展名和目录，并在 Finder 场景中直接执行。

默认脚本包括：

• 欢迎提示。
• 根据文件创建同名文件夹。
• tar 压缩。
• 重启 Finder。
• 切换深色 / 浅色外观。
• 启动屏幕保护。
• 锁屏。
• 睡眠显示器并锁定。
• 睡眠。
• 切换菜单栏自动隐藏。
• 切换 Dock 自动隐藏。
• macOS 13+ 切换台前调度和最近 App。
• 弹出所有磁盘。
• 显示本机 IP。
• 清空剪贴板。
• 清空废纸篓。
• Git 常用操作。

脚本变量包括：

• @rfpath：当前文件路径。
• @rfpaths：多个选中文件路径。
• @rfpos：当前文件所在目录。
• @rfposs：多个文件所在目录。
• @rfname：当前文件完整名称。
• @rfnames：多个文件完整名称。
• @rfnam：当前文件不含扩展名的名称。
• @rfnams：多个文件不含扩展名的名称。
• @rfext：当前文件扩展名。
• @rfexts：多个文件扩展名。
• @rday：使用天数。
• @rloading：执行时显示加载提示。

Shell 脚本会自动 cd 到当前选中文件所在目录。脚本如果需要访问受保护路径，可能触发目录授权或完全磁盘访问提示。

默认脚本代码、Git 动态脚本和更多改造示例见 常用脚本文档。

终端与开发工具

MouseBoost 可以在当前目录打开终端或第三方终端工具。

支持的入口包括：

• Terminal Window。
• Terminal Tab。
• Terminal To。
• iTerm2 Window / Tab / To。
• Ghostty Window / Tab / To。
• cmux Window / Tab / To。
• Kaku Window / To。

如果设置了默认终端 Bundle ID，MouseBoost 会优先使用该终端。对于未安装的第三方终端，会提示安装或打开下载地址。

复制、移动与粘贴

MouseBoost 提供很多 Finder 文件管理增强能力：

• 复制路径。
• 复制文件或文件夹名称。
• 复制文件内容。
• 复制目录树。
• 复制到常用目录或其他文件夹。
• 移动到常用目录或其他文件夹。
• 创建替身到指定目录。
• 发送到桌面快捷方式。
• 剪切文件。
• 粘贴文件。
• 粘贴图片。

注意事项：

• 剪切和粘贴依赖 Finder 选中文件路径读取能力，通常需要辅助功能权限。
• Command + X 剪切文件需要在偏好设置中启用。
• 跨磁盘移动、外置磁盘、受保护目录可能需要额外授权。
• 如果目标位置已有同名文件，MouseBoost 会提示替换或生成唯一名称。

文件与文件夹操作

常见文件操作包括：

• 新建文件夹。
• 移动到废纸篓。
• 直接删除。
• 获取信息。
• 显示包内容。
• 弹出外置卷。
• 显示或隐藏文件扩展名。
• 隐藏选中文件。
• 取消隐藏选中文件。
• 隐藏当前目录所有文件。
• 取消隐藏当前目录所有文件。
• 显示或隐藏系统隐藏文件。
• 锁定或解锁文件。
• 嵌入文件夹。
• 解除嵌入文件夹。
• 添加文件夹图标。
• 恢复文件夹图标。

“嵌入文件夹”适合把一个或多个文件快速收进新文件夹；多选时可以选择是否按扩展名分类。“解除嵌入文件夹”会把文件夹内容移动到上一级，单文件场景可选择是否把文件重命名为文件夹名。

批量重命名

批量重命名是一个独立窗口工具，适合一次处理大量文件名。

支持的规则包括：

• 添加文本。
• 替换文本。
• 大小写转换。
• 序号。
• 日期。
• 格式化名称。
• 删除文本。
• 清理非法字符或不规范字符。
• 扩展名规则。

建议使用方式：

1. 先在 Finder 中选中要处理的文件。
2. 打开批量重命名。
3. 添加一条或多条规则。
4. 检查预览列表。
5. 确认无误后执行。

批量重命名属于高影响操作，文档和官网建议配截图展示“规则区域”和“预览区域”。

文件分析

MouseBoost 提供文件信息与分析工具：

• 文件信息窗口。
• MD5。
• SHA1。
• SHA256。
• SHA512。
• CRC32。
• 总文件大小统计。
• 重复文件查找。

重复文件查找需要选择文件夹。扫描完成后会显示重复文件分组，并允许用户检查后删除。对于大目录，扫描可能需要较长时间。

图片与媒体处理

图片工具是 MouseBoost 的重要功能组。

支持能力：

• 图片格式转换。
• 多张图片合并为 PDF。
• PDF 提取图片。
• GIF 提取图片帧。
• HEIC 转换。
• 图片转文字 OCR。
• SRT 转 TXT。
• 图片缩放到预设尺寸。
• 自定义图片缩放。
• 图片裁剪。
• 图片旋转。
• 图片压缩。
• 图片去背景。
• 替换背景为纯色、渐变或图片。
• 设置为桌面图片。
• 扫描二维码。
• 提取 App 或文件图标。

图片转换支持常见格式，例如 png、jpg、jpeg、tiff、bmp、gif、webp、heic、pdf 等。Office 文档转 PDF 依赖 LibreOffice，如果系统未安装 LibreOffice，会提示安装。

注意事项：

• 去背景功能需要 macOS 14.0+。
• 屏幕截图到剪贴板可能需要屏幕录制权限。
• 大图片或批量处理时可能需要等待进度完成。
• 图片压缩会生成新的 _compressed.jpg 文件。
• 图片旋转会直接保存回原文件，使用前请确认是否需要备份。

压缩与 OmniZip

MouseBoost 自带压缩相关能力：

• 加密压缩。
• tar 压缩脚本。
• 创建 DMG。
• 图片压缩。

同时可以集成 OmniZip 或 OmniZip Pro：

• 解压到当前目录。
• 预览压缩包。
• 直接压缩为 zip。
• 自定义压缩。

如果 OmniZip 未安装，对应菜单可能提示打开失败或引导安装。

快捷键

MouseBoost 的每个菜单项都可以单独设置快捷键。你可以在主应用“通用”菜单配置页面的快捷键列中录入组合键，把复制路径、批量重命名、剪贴板历史、脚本、终端到此处等高频功能变成直接触发。

默认快捷键包括快捷呼出、剪切文件、粘贴文件和剪贴板历史。需要读取 Finder 选中文件的快捷键通常依赖辅助功能权限。

剪贴板历史

MouseBoost 内置剪贴板历史，并使用 SQLite 保存历史。

支持内容类型：

• 文件。
• 图片。
• 文本。
• HTML。
• RTF。

主要能力：

• 自动监听剪贴板变化。
• 搜索历史内容。
• 按类型、来源 App、时间过滤。
• 预览条目。
• 复制条目。
• 粘贴到当前编辑器。
• 固定或取消固定。
• 删除单条记录。
• 清空历史。
• 双击行为可配置为复制或粘贴。
• 弹窗位置可设置为鼠标位置或屏幕居中。
• 设置黑名单或白名单忽略指定 App。
• 粘贴队列，把多条历史按顺序逐个粘贴。

隐私处理：

• 会忽略系统标记为隐藏、临时、自动生成的剪贴板类型。
• 会忽略 1Password 等密码类剪贴板类型。
• MouseBoost 自己写入剪贴板的内容会打标，避免循环记录。

系统工具

MouseBoost 还集成了一组系统级小工具：

• 键盘清洁：显示清洁遮罩，并拦截键盘输入，便于擦拭键盘。
• 保持唤醒：支持 5、10、30、60、120 分钟或无限期。
• 麦克风静音 / 取消静音。
• QuickTime 屏幕录制。
• QuickTime 音频录制。
• QuickTime 影片录制。
• AirDrop。
• 发送到微信。
• 使用选中图片作为桌面图片。
• 截图到剪贴板。

这些能力可能依赖辅助功能、屏幕录制、麦克风、系统分享服务或第三方 App 设置。

配置备份与同步

MouseBoost 支持配置导入导出和 iCloud 同步。

你可以：

• 导出配置到本地文件。
• 从本地配置文件导入。
• 手动上传到 iCloud。
• 手动从 iCloud 下载。
• 启用自动同步。

配置内容主要包含菜单、常用目录、常用应用、常用脚本、新建文件模板、文件夹图标等偏好数据。

注意事项：

• 使用 iCloud 同步需要系统启用 iCloud Drive。
• 下载云端配置会覆盖本地配置，操作前建议先导出备份。
• 自动同步开启后，导入配置也会触发同步到云端。