匯出設定檔
匯出設定檔將檔案格式、畫質等級與目標資料夾整合在一個名稱之下。
這是 JPGBoost 所有自動化功能的共同基礎。只需設定一次，即可在任何需要匯出的場景中重複使用。
此功能在 JPGBoost Free 和 Pro 中皆可使用，但有一項限制：Free 只允許保留一個設定檔。修改、重新命名或同名覆寫始終可行，被拒絕的只是新建第二個設定檔。而設定檔所驅動的處理仍會計入 Free 的上限：每天 50 張、每個檔案 5 MB。JPGBoost Pro 取消所有這些限制。
設定檔的作用
匯出設定檔帶有一個名稱，並儲存以下三項資訊：
- 輸出格式（PNG、JPEG、HEIC、AVIF、WebP 或 JPEG XL 之一）；
- 1 到 100 之間的畫質；
- 目標資料夾（可選）。
一旦建立，該設定檔即可被應用程式、命令列、本機 API、捷徑以及監控資料夾識別。這樣一來，您就無需在每個指令碼中重複設定相同的選項。
建立設定檔
- 開啟偏好設定（⌘,），然後進入設定檔分頁。
- 建立一個新設定檔，並為其取一個清楚易懂的名稱，例如 Web JPEG 或客戶交付。
- 選擇輸出格式與畫質。
- 如有需要，可透過原生選擇器選擇目標資料夾。
- 儲存後，該設定檔會立即在各處生效。
在伺服器或安裝指令碼上，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對於監控資料夾而言，規則略有不同：監控資料夾中設定的目標資料夾，始終優先於設定檔中的目標資料夾。
設定檔的儲存位置
設定檔儲存在應用程式、CLI 與 API 共用的單一檔案中：
~/Library/Application Support/JPGBoost/exportProfiles.json正是這種共用機制，使得在介面中建立的設定檔能夠立即在指令碼中使用，反之亦然。
完整範例
目標：每週向同一資料夾交付針對網頁最佳化的圖片，且始終使用相同的設定。
- 建立 Web JPEG 設定檔：格式為 JPEG，畫質為 70，目標位置為
~/Pictures/media。 - 在應用程式中，透過工具列將其套用到一組圖片，以直觀查看結果。
- 確認滿意後，即可在指令碼中呼叫該設定檔，無需重複設定。
# 命令列：無需重複設定，一切都來自設定檔
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