BlueHarvest 是一款专为 macOS 系统设计的实用工具软件，其主要功能是自动且静默地清理来自网络卷、外部驱动器（如U盘、移动硬盘）或特定文件夹中的 macOS 系统元数据文件（例如 .DS_Store 和 ._ 开头的资源派生文件）。这些文件在跨平台文件共享时可能造成混乱或隐私泄露，BlueHarvest 通过持续监控和自动删除，确保文件系统的整洁与兼容性。

核心价值： BlueHarvest 并非传统的创作或编辑软件，而是一个系统增强与维护工具。它通过后台服务运行，其“核心界面”实质上是其配置面板，用户通过它来设定清理规则，之后的操作主要由软件自动完成。

一、软件核心界面与工作区详解

BlueHarvest 的主界面是一个集中的偏好设置面板，结构清晰，主要分为以下几个区域：

菜单栏图标区： 软件启动后，会在屏幕顶部菜单栏显示一个收割机图标。这是软件的主要控制中心，点击可快速启用/禁用清理功能、查看最近活动或打开主设置窗口。
主设置窗口（工作区）：
- “Folders & Disks”（文件夹与磁盘）列表： 这是核心配置区。以列表形式显示用户已添加的、需要被监控和清理的目标文件夹或磁盘卷。
- “Add”（添加）与“Remove”（移除）按钮： 用于管理上述列表。
- “Settings”（设置）选项卡： 包含详细的清理行为选项。
  - 清理文件类型选择： 可勾选需要删除的元数据类型，如 .DS_Store， ._* 资源派生文件，以及 AppleDouble 文件夹等。
  - 清理触发条件： 设置是在文件“关闭时”还是“移动时”进行清理。
  - 排除列表： 可以指定某些特定文件或文件夹不被清理。
- 状态显示区： 通常在主窗口底部或通过菜单栏图标，显示软件当前是否处于“Active”（激活）状态。

二、完整操作流程：从配置到自动清理

BlueHarvest 的操作流程不是线性的项目创作，而是一次性配置与持续监控的过程。

1. 启动与初始配置

操作： 首次从“应用程序”文件夹打开 BlueHarvest 后，软件会请求辅助功能权限（以便监控文件系统），请务必在系统偏好设置 > 安全性与隐私中授予。随后主设置窗口会自动打开。

2. 添加需要监控的清理目标

目的： 告诉软件需要清理哪些位置的文件。

具体步骤：

在主设置窗口的 “Folders & Disks” 区域，点击下方的 “Add…” 按钮。
在弹出的 Finder 选择窗口中，导航至你想要清理的目标。这可以是：
- 整个外部磁盘（如“NO NAME”移动硬盘）
- 网络卷（如“Time Machine”备份磁盘）
- 特定文件夹（如“共享文件夹”）
选中目标后，点击 “Open”。该目标便会添加到监控列表中。

快捷键提示： 此步骤主要通过鼠标点击完成，无特定快捷键。但你可以使用 Command + Shift + G 在 Finder 选择窗口中快速输入路径。

3. 细化清理设置

目的： 定制清理行为，满足个性化需求。

具体步骤：

点击主设置窗口顶部的 “Settings” 选项卡。
在 “When using these disks and folders:” 部分，勾选你希望删除的文件类型。通常保持默认全选即可应对大多数情况。
在 “Remove items” 部分，选择清理触发时机。推荐使用默认的 “When files are closed”（当文件关闭时）。
（可选）在 “Except these files and folders:” 部分，点击“Add”添加需要排除清理的特定项目。

4. 激活与运行

目的： 启动自动清理服务。

具体步骤：

确保主设置窗口左下角或菜单栏图标显示软件状态为 “Active”。如果显示为“Inactive”，点击旁边的按钮或通过菜单栏图标菜单勾选 “Enable BlueHarvest” 来激活它。
至此，配置完成。 软件将在后台运行。当你向已监控的磁盘或文件夹写入、复制或移动文件时，BlueHarvest 会根据你的设置，自动、静默地删除伴随产生的元数据文件。

5. 查看活动与导出日志

目的： 确认软件工作状态或排查问题。

具体步骤：

点击菜单栏的 BlueHarvest 图标。
选择 “Show Recent Activity…”，可以查看最近清理了哪些文件。
在主设置窗口的“Settings”选项卡底部，可以找到日志级别设置和 “Open Log File…” 按钮，用于查看详细日志。

注意： BlueHarvest 没有传统意义上的“项目导出”功能。它的“产出”是保持目标位置的清洁。日志可以视为其运行记录的“导出”。

三、常用功能进阶技巧

针对特定文件夹的精细控制： 与其监控整个磁盘，不如只添加你用于跨平台共享的特定文件夹（如“桌面上的共享文件夹”），这样可以减少不必要的系统监控，更精准高效。
利用排除列表保护关键文件： 如果你担心某些特定文件（如包含“._”前缀但实际有用的文件）被误删，务必将其添加到“Settings”中的排除列表。
菜单栏快速开关： 日常使用中，无需打开主窗口。直接通过菜单栏图标即可全局启用或禁用 BlueHarvest，便于临时暂停清理操作。
处理已存在的元数据文件： BlueHarvest 主要监控新产生的操作。若要清理一个已存满 .DS_Store 的磁盘，一个技巧是：先禁用 BlueHarvest，然后重新启用，并确保该磁盘已在监控列表中。有时重新挂载磁盘或手动触发文件操作（如复制一个无关文件进去）可以加速清理过程。

四、常见问题与解决方案

问题： BlueHarvest 似乎没有工作，元数据文件仍然存在。

解决： 1) 检查菜单栏图标，确认软件状态为“Active”。2) 确认目标磁盘或文件夹已正确添加到“Folders & Disks”列表。3) 检查系统偏好设置 > 安全性与隐私 > 隐私 > 辅助功能，确保 BlueHarvest 已被勾选。4) 尝试重启 BlueHarvest 或你的 Mac。
问题： 不小心把重要位置添加到了监控列表。

解决： 在主设置窗口的“Folders & Disks”列表中选中该项目，点击下方的 “Remove” 按钮即可将其从监控列表中删除。
问题： 需要清理的磁盘是网络驱动器或非 HFS+/APFS 格式（如 NTFS、exFAT）。

解决： BlueHarvest 完全支持网络卷和常见格式（FAT32、exFAT等）。确保网络连接稳定，并将该卷宗像本地磁盘一样添加到监控列表即可。
问题： 菜单栏图标不见了。

解决： 打开 BlueHarvest 主设置窗口，通常在“Settings”或通用偏好中会有“Show menu bar icon”的选项，请确保其被勾选。

五、 BlueHarvest for Mac 快捷键汇总表

由于 BlueHarvest 是后台服务型软件，其快捷键主要集中在全局控制和导航上。

功能描述	快捷键 (Mac)	适用位置
打开主设置窗口	`Command + ,` （或通过菜单栏图标）	软件运行时
隐藏/显示主设置窗口	`Command + H`	主设置窗口激活时
关闭当前窗口	`Command + W`	主设置窗口激活时
退出 BlueHarvest	`Command + Q`	软件运行时
在 Finder 选择窗口中前往文件夹	`Command + Shift + G`	点击“Add…”按钮后的路径选择对话框
（系统级）打开辅助功能权限面板	`无直接快捷键`，需手动进入：系统设置 > 隐私与安全性 > 辅助功能	首次安装配置时