导出配置文件

导出配置文件将文件格式、画质等级与目标文件夹整合在一个名称之下。

这是 JPGBoost 所有自动化功能的共同基础。只需配置一次，即可在任何需要导出的场景中重复使用。

Free 版已包含

此功能在 JPGBoost Free 和 Pro 中均可使用，但有一项限制：Free 只允许保留一个配置文件。修改、重命名或同名覆盖始终可行，被拒绝的只是新建第二个配置文件。而配置文件所驱动的处理仍会计入 Free 的上限：每天 50 张、每个文件 5 MB。JPGBoost Pro 取消所有这些限制。

配置文件的作用

导出配置文件带有一个名称，并保存以下三项信息：

  • 输出格式（PNG、JPEG、HEIC、AVIF、WebP 或 JPEG XL 之一）；
  • 1 到 100 之间的画质；
  • 目标文件夹（可选）。

一旦创建，该配置文件即可被应用程序、命令行、本地 API、快捷指令以及监控文件夹识别。这样一来，您就无需在每个脚本中重复设置相同的选项。

创建配置文件

  1. 打开设置（⌘,），然后进入配置文件标签页。
  2. 创建一个新配置文件，并为其取一个清晰易懂的名称，例如 Web JPEG 或客户交付。
  3. 选择输出格式与画质。
  4. 如有需要，可通过原生选择器选择目标文件夹。
  5. 保存后，该配置文件会立即在各处生效。
无需打开应用即可创建配置文件

在服务器或安装脚本上，CLI 可直接创建或更新配置文件：jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./compressed。若名称已被使用，则会替换已有的配置文件，其行为与应用程序中的操作一致。

带目标位置的配置文件不仅仅是一种便利

在配置文件中设定目标文件夹，是在快捷指令应用中稳定固定输出文件夹的唯一可靠方法。请参阅快捷指令与 AppleScript指南。

在应用中应用配置文件

主窗口的工具栏中提供了一个配置文件菜单。它会将配置文件的格式与画质应用到当前的图片组，并始终显示当前所应用的配置文件名称。

在其他场景中重复使用配置文件

同一个配置文件可以通过名称，在任何入口方式中被调用：

入口方式调用方式
应用程序工具栏中的配置文件菜单
命令行--profile "Web JPEG"
本地 API/v1/settings 与 /v1/export 中的 profile 字段
快捷指令操作的 Export Profile 参数
AppleScript参数 profile "Web JPEG"
监控文件夹在文件夹设置中选择的配置文件

优先级规则

导出配置文件仅会补充缺失的设置。任何被明确指定的值，都会优先于配置文件中的对应值。此规则适用于 JPGBoost 的所有场景。

# 配置文件提供了格式、画质和文件夹
jpgboost-cli --profile "Web JPEG" *.png

# 此处 --output 优先于配置文件中的文件夹
# （配置文件的格式与画质仍会继续生效）
jpgboost-cli --profile "Web JPEG" --output ./another-folder *.png

对于监控文件夹而言，规则略有不同：监控文件夹中设置的目标文件夹，始终优先于配置文件中的目标文件夹。

默认配置文件

一次只能有一个配置文件被标记为默认，操作路径为设置 → 配置文件。这是当完全没有指定任何配置文件名称时 JPGBoost 所应用的配置文件，这与上文的优先级规则不同，后者假定已经明确指定了某个配置文件。

这一机制尤其适用于 Spotlight 中通过通用语句调用、且未构建任何手动快捷指令的"压缩图片"操作。这种未经处理的调用除所选文件外不携带任何参数，因此完全依赖默认配置文件来提供格式、画质与目标文件夹。完整流程请参阅快捷指令与 AppleScript指南。

同样的机制也适用于未使用 --profile 的命令行、未使用 profile 参数的 AppleScript，以及没有专属配置文件的监控文件夹。

仅可在应用中设置

默认标记只能在设置 → 配置文件中设置，绝不能通过本地 API 或 CLI 设置。通过 POST /v1/profiles 或 jpgboost-cli --create-profile 创建或更新配置文件，会保留其现有的默认状态原样不变，绝不会将其重置。

配置文件的存储位置

配置文件保存在应用程序、CLI 与 API 共享的单一文件中：

~/Library/Application Support/JPGBoost/exportProfiles.json

正是这种共享机制，使得在界面中创建的配置文件能够立即在脚本中使用，反之亦然。

完整示例

目标：每周向同一文件夹交付针对网页优化的图片，且始终使用相同的设置。

  1. 创建 Web JPEG 配置文件：格式为 JPEG，画质为 70，目标位置为 ~/Pictures/media。
  2. 在应用中，通过工具栏将其应用到一组图片，以直观查看结果。
  3. 确认满意后，即可在脚本中调用该配置文件，无需重复设置。
# 命令行：无需重复设置，一切都来自配置文件
jpgboost-cli --profile "Web JPEG" ~/Pictures/week-12/*.png

# 本地 API：先应用配置文件，再导出到您的文件夹
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile": "Web JPEG"}' \
  http://127.0.0.1:51823/v1/export