配置參考

FlowPick 提供了豐富的配置選項，涵蓋下載行為、篩選規則、儲存策略和介面偏好。本文件逐一說明每個配置項的作用、預設值和適用場景。

快速參考

配置入口

配置分為兩個層級，適應不同的使用場景：

儲存與同步：

• 擴充功能設定儲存在 chrome.storage.sync 中，登入 Chrome 帳號後會自動同步到其他裝置
• 下載面板的配置僅存在於目前分頁工作階段中，重新整理頁面後恢復預設
• 儲存目錄名稱快取在 localStorage 的 flowpick_save_dir_name 鍵中，不會跨裝置同步

下載配置

並行執行緒數

控制同時下載的分片數量。更高的並行數可以提升下載速度，但也會增加網路頻寬佔用和瀏覽器記憶體壓力。

選擇建議：

實際並行數不會超過分片總數。例如只有 3 個分片時，即使設定為 8，也只會啟動 3 個下載任務。

輸出格式

串流媒體分片合併後的輸出容器格式。

選擇建議：

• 需要最大相容性（播放器、剪輯軟體、分享給他人）→ 選 MP4
• 追求最快合併速度，後續會用其他工具轉碼 → 選 TS
• 來源串流本身就是 TS 封裝且不需要二次處理 → 選 TS

MP4 輸出時，FlowPick 會自動加入 -movflags +faststart 標誌，將 moov atom 前置，使影片在下載完成前即可開始播放（適用於漸進式下載場景）。

儲存目錄

FlowPick 支援兩種檔案儲存策略：

策略一：瀏覽器預設下載目錄

不設定儲存目錄時，所有檔案透過瀏覽器的 Downloads API 儲存到系統預設下載資料夾。每次下載無需額外確認。

策略二：自訂儲存目錄（File System Access API）

點選下載面板中的「選擇儲存目錄」按鈕，授權一個資料夾後，所有後續下載將直接寫入該目錄，不再彈出儲存對話框。

目錄權限說明：

• 授權狀態透過 navigator.permissions.query() 靜默檢查，不會反覆彈窗
• 如果權限被撤銷（使用者手動在系統設定中移除），FlowPick 會自動降級到彈窗模式
• 目錄名快取在 localStorage 的 flowpick_save_dir_name 鍵中，僅用於 UI 顯示
• 自訂目錄不支援跨裝置同步，每台裝置需要單獨授權

檔案名稱

下載檔案的命名規則：

• 預設使用影片頁面標題或串流 URL 中的檔案名稱部分
• 支援手動編輯，在下載面板的檔案名稱輸入框中修改
• 特殊字元（如 \/:*?"<>|）會被自動替換為底線
• 如果目標目錄已存在同名檔案，瀏覽器會自動加入序號後綴（如 video (1).mp4）

篩選配置

自動偵測

控制擴充功能是否在頁面載入時自動掃描媒體資源。

開啟自動偵測會略微增加頁面載入時的 CPU 佔用，但通常可以忽略不計。

最小檔案大小

篩選掉小於指定閾值的資源，用於跳過廣告片段、縮圖和佔位圖片。

典型場景：

按類型篩選

在彈出視窗中按媒體類型篩選顯示結果：

按時長篩選

僅適用於影片和音訊資源。設定最小時長可以篩選掉極短的片段。

介面配置

主題模式

預設跟隨系統偏好。設定儲存在 chrome.storage.sync 中，會隨帳號同步。

通知

控制下載完成後的桌面通知行為：

通知使用瀏覽器的 Notifications API，首次使用時會請求權限。如果拒絕了通知權限，可以在瀏覽器設定中重新開啟。

進階配置

畫質選擇策略

對於自適應串流（HLS Master Playlist / DASH MPD），FlowPick 提供兩種畫質選擇方式：

畫質列表按位元率從高到低排序，顯示格式為：1080p · 5.2 Mbps · avc1.640028。

重試策略

分片下載失敗時的自動重試機制：

重試僅針對網路層面的暫存故障（逾時、連線重置）。HTTP 4xx 錯誤（如 403、404）不會觸發重試，會立即報告錯誤。

記憶體安全限制

為防止瀏覽器因記憶體不足而崩潰，FlowPick 內建了記憶體保護機制：

當預估檔案大小超過 Blob 上限時，FlowPick 會強制要求使用 File System Access API 或 StreamSaver 串流寫入，避免將整個檔案載入到記憶體中。

分片大小預估

在開始下載前，FlowPick 會取樣預估總檔案大小：

• 取樣數量：min(5, max(1, totalSegments × 0.1))
• 預估公式：avgSampleSize × totalSegments
• 用於判斷是否需要啟用串流寫入模式

場景化配置方案

根據不同使用場景，推薦以下配置組合：

日常影片下載

適合大多數使用者的預設配置：

大檔案/直播回放

下載超過 5GB 的直播回放或長影片：

圖庫批次下載

從圖庫網站批次下載圖片：

播客/音訊下載

下載播客節目或音訊檔案：

行動熱點/省流量

使用手機熱點或流量有限時：

配置重置

如需恢復所有設定為預設值：

1. 開啟擴充功能彈出視窗
2. 點選齒輪圖示進入設定
3. 點選 清除所有資料
4. 確認操作

此操作會清除：

• 所有 chrome.storage.sync 中的擴充功能配置
• localStorage 中快取的儲存目錄名稱
• 篩選預設和主題偏好

不受影響的資料：

• 瀏覽器的下載歷史記錄
• 已下載到本地的檔案
• 擴充功能本身（不會被解除安裝）

相關文件

• 安裝指南 — 擴充功能安裝和首次設定
• 使用方法 — 日常使用操作指南
• 格式轉換 — 輸出格式的詳細技術說明
• 影片偵測 — 媒體偵測原理與加密處理
• 下載引擎架構 — 並行控制、重試策略、記憶體管理
• 瀏覽器相容性 — 各瀏覽器 API 支援與降級策略