权限与使用注意事项

MouseBoost 是 Finder 右键增强工具，很多能力需要和 Finder、系统剪贴板、系统设置、文件系统、屏幕、键盘鼠标事件协作。因此，权限设置是否正确会直接影响功能是否出现、是否能执行、是否稳定。

Finder 扩展权限

Finder 右键菜单依赖 Finder Extension。没有启用 Finder 扩展时，标准 Finder 右键菜单里不会出现 MouseBoost。

需要 Finder 扩展的功能：

• Finder 右键菜单。
• 根据选中文件动态显示菜单。
• 文件夹、文件、图片、压缩包等类型过滤。
• 右键工具栏菜单。

排查建议：

• 确认系统设置中 MouseBoost Finder 扩展已启用。
• 重启 Finder。
• 退出并重新打开 MouseBoost。
• 在普通本地目录测试，不要一开始就在外置盘或受保护目录测试。

辅助功能权限

辅助功能权限用于监听和模拟键盘鼠标事件。MouseBoost 不只是读取 Finder 扩展菜单，还提供快捷呼出、覆盖右键、中键菜单、剪切粘贴等增强能力。

需要辅助功能的功能：

• 鼠标中键呼出 MouseBoost 菜单。
• 覆盖系统右键。
• 按住修饰键后右键呼出菜单。
• 读取 Finder 当前选中的文件路径。
• 模拟 Finder 复制、粘贴、剪切、获取信息、移动到废纸篓。
• Command + X 剪切文件。
• 剪贴板历史中的“粘贴到编辑器”。
• 键盘清洁模式拦截输入。
• 搜索当前文件夹等需要激活 Finder 并模拟快捷键的功能。

授权路径：

系统设置 -> 隐私与安全性 -> 辅助功能 -> 启用 MouseBoost。

如果授权后仍不可用：

• 关闭 MouseBoost 后重新打开。
• 在系统设置中关闭再重新打开 MouseBoost 的辅助功能开关。
• 重启 Finder。
• 重新登录 macOS。

完全磁盘访问权限

完全磁盘访问用于访问系统保护位置和部分用户隐私目录。没有该权限时，一些文件操作会失败或弹出授权面板。

建议开启的场景：

• 外置磁盘文件管理。
• 跨目录复制和移动。
• 删除、强制删除、移动到废纸篓。
• App 卸载与残留文件扫描。
• 访问用户目录以外的位置。
• 访问桌面、文稿、下载、照片资料库等受系统保护位置。
• 处理系统目录或老版本 macOS 权限更严格的目录。

授权路径：

系统设置 -> 隐私与安全性 -> 完全磁盘访问权限 -> 启用 MouseBoost。

注意：完全磁盘访问不等于所有路径永远可写。文件本身可能被锁定、磁盘可能只读、网络卷可能权限不足、备份快照可能不可修改。

目录授权与安全作用域

当 MouseBoost 发现目标路径不可写或无法访问时，会弹出目录选择授权面板。授权后，MouseBoost 会保存安全作用域 URL，用于之后访问该目录。

常见触发场景：

• 复制到某个受保护目录。
• 从外置磁盘移动文件。
• 操作非用户目录。
• 打开常用目录但目录权限不足。
• 执行脚本读取或写入受保护路径。

建议：

• 授权时选择实际需要操作的上层目录。
• 如果只处理某个项目文件夹，不必授权整个磁盘。
• 如果经常处理外置盘，可以授权外置盘根目录。

外置磁盘使用注意事项

外置磁盘涉及文件系统格式、挂载状态和权限。MouseBoost 提供“外置磁盘启用”设置，用于让相关菜单和权限逻辑更适合外置盘场景。

使用建议：

• 在偏好设置中启用“外置磁盘启用”。
• 给 MouseBoost 完全磁盘访问权限。
• 首次操作外置盘时，如果弹出授权面板，选择该外置盘或目标目录。
• 如果外置盘是 NTFS 且系统没有写入能力，复制和移动可能失败。
• 如果外置盘只读、损坏、正在被 Time Machine 使用，删除或移动可能失败。
• 弹出磁盘功能只会在选中卷宗时显示。

屏幕录制权限

截图到剪贴板、颜色拾取、部分屏幕相关功能可能需要屏幕录制权限。

授权路径：

系统设置 -> 隐私与安全性 -> 屏幕录制 -> 启用 MouseBoost。

如果截图或拾色异常，请检查该权限，并重新打开 MouseBoost。

麦克风权限

麦克风静音和 QuickTime 音频录制可能涉及麦克风访问。

如果系统弹出麦克风权限提示，请允许。若没有弹出但功能不可用，请到系统设置的麦克风权限中检查 MouseBoost 或 QuickTime Player。

自动化与 AppleScript 权限

MouseBoost 的一些脚本会控制 Finder、System Events、QuickTime Player 或系统设置。这类操作可能触发 macOS 自动化授权。

涉及功能：

• 重启 Finder。
• 锁屏、睡眠、切换深色模式。
• 搜索当前文件夹。
• QuickTime 录制。
• 移动到废纸篓。
• 创建替身。
• 系统隐藏文件开关。

如果系统询问是否允许 MouseBoost 控制某个 App，建议允许，否则对应脚本可能失败。

第三方依赖

部分功能依赖第三方 App：

• Office 转 PDF 需要 LibreOffice。
• OmniZip 集成功能需要 OmniZip 或 OmniZip Pro。
• iTerm2、Ghostty、cmux、Kaku 等终端入口需要对应 App 或服务存在。
• 发送到微信需要微信及系统分享服务启用。
• 使用第三方编辑器打开文件需要对应 App 已安装。

MouseBoost 通常会在缺少依赖时提示安装或打开失败。

高风险操作建议

以下操作建议先在少量测试文件上使用：

• 直接删除。
• 批量重命名。
• 批量移动。
• 解除嵌入文件夹。
• 图片旋转，因为它会保存回原文件。
• 清空废纸篓。
• App 卸载与残留文件删除。
• Git Add / Commit / Push 等脚本。

建议养成两个习惯：

• 对批量操作先看预览或先测试。
• 对重要文件先备份。