功能总览

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

右键菜单管理

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

你可以：

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

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

自定义菜单分组

可以创建一层自定义分组，把相关功能收进 Finder 右键菜单的子菜单。例如将图片处理、PDF 操作或系统工具分别放进独立分组。

• 分组可以重命名、修改图标或删除；删除分组后，组内菜单会回到顶层菜单。
• 左侧分组栏用于浏览分组和接收拖放，不用于排序。分组与普通菜单的显示顺序都在“顶层菜单”中调整。
• 从“顶层菜单”“未分组”或其他分组拖动功能到左侧分组，即可将它归类；也可以右键菜单项，选择“移动到”。
• 拖动菜单时，可接收的分组会高亮提示；右键分组可选择“在顶层菜单中定位”，快速调整该分组的位置。
• 新安装或恢复默认配置时，会提供“图片工具”“PDF 工具”“系统工具”三个推荐分组。已有用户升级不会自动改变原有菜单顺序或分组。
• 每个菜单层级最多保存 99 项，启用和禁用的菜单都会计入该数量。

新建文件

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。
• Otty。
• kooky。

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

复制、移动与粘贴

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

• 复制路径。
• 复制文件或文件夹名称。
• 复制文件内容。
• 复制目录树。
• 复制到常用目录或其他文件夹。
• 移动到常用目录或其他文件夹。
• 创建替身到指定目录。
• 粘贴为：先在 Finder 中复制文件或文件夹，再在目标目录创建替身或 ZIP 压缩包，不会修改源文件或剪贴板。
• 发送到桌面快捷方式。
• 剪切文件。
• 粘贴文件。
• 粘贴图片。

注意事项：

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

分享文件

通过 WiFi 局域网分享选中的文件，生成二维码供其他设备扫码下载。

默认菜单项包括：

• 分享文件 — 随机端口启动 HTTP 服务器，生成含下载链接的二维码。

注意事项：

• 双方必须在同一个 WiFi 网络下。
• 用手机扫码或在浏览器中打开链接即可下载。
• 关闭分享窗口会自动停止服务器。

文件与文件夹操作

常见文件操作包括：

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

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

批量重命名

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

支持的规则包括：

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

建议使用方式：

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

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

文件分析

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

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

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

图片与媒体处理

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

支持能力：

• 图片格式转换。
• 移除图片元数据：保持原图片格式生成新副本，不修改原文件。
• 多张图片合并为 PDF。
• PDF 提取图片。
• GIF 提取图片帧。
• HEIC 转换。
• 图片转文字 OCR。
• SRT 转 TXT。
• 图片缩放到预设尺寸。
• 自定义图片缩放。
• 图片裁剪。
• 图片旋转。
• 图片压缩。
• 图片去背景。
• 替换背景为纯色、渐变或图片。
• 图标换色：批量更换 PNG 图标颜色。
• 给图片和 PDF 添加水印：支持文字水印，自定义字体、颜色、透明度、位置和平铺。
• 多张图片拼接为长图：支持纵向/横向拼接，可拖拽排序、实时预览。
• 视频压缩：支持无损、大、中、小和小于 8 MB 等压缩选项。
• 提取音频：从视频文件中提取音频并保存为音频文件。
• 设置为桌面图片。
• 扫描二维码。
• 提取 App 或文件图标。

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

注意事项：

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

截图与图片编辑

MouseBoost 5.2.5 新增了完整的图片编辑流程，并升级了截图工具。你可以从“截图”菜单或为它配置的快捷键进入截图选区，也可以在 Finder 中选择图片后使用“编辑图片”。

截图时可以选取当前屏幕、自动检测到的窗口或自定义区域。完成选区后，可以直接：

• 调整选区、圆角和阴影。
• 添加矩形、圆角矩形、椭圆、三角形、五角星、直线和箭头。
• 使用画笔、高亮笔、文字和序号标记。
• 使用马赛克或模糊遮挡敏感内容。
• 添加矩形或椭圆聚光、放大镜和像素网格。
• 识别文字（OCR）或二维码。
• 将截图复制到剪贴板、贴在桌面、通过系统分享或保存为图片。

“编辑图片”复用同一套标注工具。编辑完成后默认另存为带“已编辑”后缀的 PNG，不直接覆盖原图片。

OCR 会打开独立的“识别结果”窗口，右侧显示提取出的文本，可以继续编辑或一键拷贝。

注意事项：

• 首次使用截图功能时，macOS 可能要求授予“屏幕录制”权限；授权后请重新打开相关功能。
• OCR 需要 macOS 12.0+。
• 原生录屏与 GIF 录制需要 macOS 12.3+。

PDF 工具

MouseBoost 提供常用的 PDF 文档处理能力：

• PDF 转 HTML、Markdown、TXT：文本型 PDF 会优先提取真实文字；扫描件转 TXT 会在需要时使用 OCR。HTML 和 Markdown 以本地提取为主，复杂表格和版式建议转换后人工检查。
• PDF 合并：作为独立 PDF 工具入口，支持将多个 PDF 或图片混合排序后合并为单一文档。列表会显示文件名称、类型、页数或图片尺寸以及文件大小。
• PDF 拆分：按页码范围将 PDF 拆分为多个独立文件，支持 1-3,5,7 格式灵活指定范围。
• Office 转 PDF：Word、PPT、Excel 一键转换，保持原格式（依赖 LibreOffice）。

注意事项：

• OCR 识别需要 macOS 12.0+。
• Office 转 PDF 依赖 LibreOffice，如果系统未安装，会提示安装。
• PDF 拆分会为每个页码范围生成一个独立的 _p1-3.pdf 文件。

压缩与 OmniZip

MouseBoost 自带压缩相关能力：

• 减小体积：针对图片、视频、PDF、PPT/PPTX 提供“高质量”“平衡”“小体积”三档内容压缩，生成新的输出文件并保留原文件。
• 加密压缩。
• tar 压缩脚本。
• 创建 DMG。
• 图片压缩。

同时可以集成 OmniZip 或 OmniZip Pro：

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

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

“减小体积”与 ZIP、加密压缩用途不同：前者直接降低文件内容占用，后两者用于打包和归档。对于 PDF 和演示文稿，建议先使用“高质量”或“平衡”，确认打开、页数和画面效果后再选择更小的档位。

快捷键

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。
• 下载云端配置会覆盖本地配置，操作前建议先导出备份。
• 自动同步开启后，导入配置也会触发同步到云端。