本頁目錄
自訂控制列按鈕
概覽
控制列分為兩個區塊：
- 左側（檔案層級）： 與外部應用程式整合及快速操作（例如「用...開啟」、「在檔案總管中顯示」）。這些可在
設定 - 控制項中設定。 - 右側（預覽層級）： 視窗檢視控制項（例如旋轉、靜音、縮放）。
本指南專注於擴充左側區塊。
新增控制項
在 設定 - 控制項 中，您可以管理內建按鈕、建立自訂動作或安裝控制列外掛。
1. 自訂動作
- 點擊動作列表下方的 + 並選取要執行的程式或指令碼。
- 在右側面板中設定動作詳細資訊：
- 名稱：工具提示中顯示的名稱。
- 執行檔：目標執行檔 (
.exe) 的路徑。 - 引數：命令列引數。使用如
"${input_file}"等佔位符來傳遞檔案路徑。 - 檔案格式：目標副檔名（例如
png,zip）或特殊權杖（例如${type_folder}）。 - 成功啟動後關閉預覽：外部程式成功啟動後立即關閉預覽視窗。Seer 不會等待該程式結束。
2. 控制列外掛
控制列外掛提供封裝好的動作套件。它們與自訂動作分開，後者使用的是您電腦中既有的程式或指令碼。
官方控制列外掛
官方控制列外掛套件已統一彙整至下載中心，請前往 外掛下載 - 控制列外掛 下載所需外掛套件（.zip）。下載後無需解壓縮，可在 設定 > 控制列 中直接匯入使用。
安裝下載的套件
- 在
設定 > 控制項中，點擊列表下方的 + 按鈕。 - 直接選取下載的
.zip壓縮檔，或選取完整解壓縮套件中的plugin.json檔案。 - 在詳細資訊面板中檢視匯入動作支援的格式與行為。
- 點擊確定以儲存並使用。點擊取消將放棄匯入。
若匯入的套件屬於其他功能類型，Seer 會自動引導您前往對應的設定頁面。
管理動作
- 重新排序：在列表中拖曳項目以調整按鈕在控制列上的顯示順序。
- 切換啟用狀態：選取動作並在其詳細資訊中變更已啟用，然後儲存設定。
- 自訂覆寫：對於已安裝的外掛，您可以隨時自訂其相符的檔案格式與 CLI 引數，或重設為預設值。
- 內建按鈕：內建動作（用預設應用程式開啟、在檔案總管中顯示、同類型瀏覽）可個別切換顯示與否。
佔位符與特殊權杖
1. 命令列引數佔位符
Seer 提供內建權杖，在啟動外部工具時會在執行時期動態解析：
| 佔位符 | 說明 | 範例 |
|---|---|---|
${input_file} |
目前預覽檔案或資料夾的絕對路徑。 | C:\Users\Username\Documents\file.zip |
${7z} |
隨附之 7z.exe 的絕對路徑，亦可在【可執行程式】路徑中直接填寫。 |
C:\Program Files\Seer\plugins\7z.exe |
${seer_exe} |
Seer.exe 的絕對路徑。 |
C:\Program Files\Seer\Seer.exe |
${seerviewer_exe} |
SeerViewer.exe 的絕對路徑。 |
C:\Program Files\Seer\SeerViewer.exe |
${seer_dir} |
包含 Seer.exe 的目錄。 |
C:\Program Files\Seer |
${screenshot} |
目前檢視截圖的暫存 PNG 絕對路徑。 | C:\Users\Username\AppData\Local\Temp\Seer\screenshot\view_1.png |
如果路徑可能包含空格，請用雙引號將佔位符括起來："${input_file}"。
需要編寫自訂控制列外掛？請參閱 外掛開發與實現 取得完整的預留位置與比對標記矩陣，包括各類外掛所支援的預留位置範圍。
2. 檔案格式特殊權杖
在檔案格式欄位中使用這些權杖以進行更廣泛的比對：
| 權杖 | 說明 |
|---|---|
${type_folder} |
比對目錄與資料夾。 |
${type_file} |
比對所有檔案（包括無副檔名的檔案）。 |
${type_all} |
比對所有項目（同時比對檔案與資料夾）。 |
${type_pdf} |
比對 PDF 文件。 |
${type_image} |
比對圖片檔案，與內建圖片檢視器的分類一致。 |
${type_media} |
比對音訊/視訊檔案，與內建媒體檢視器的分類一致。 |
${type_web} |
比對網頁檔案（HTML 與 Markdown），與內建 HTML 檢視器的分類一致。 |
${type_text} |
比對文字/程式碼檔案，與內建文字檢視器的分類一致。 |
${type_none} |
比對不屬於以上任何類別的檔案（例如壓縮檔、執行檔）。 |
注意：權杖不區分大小寫，亦可與副檔名以空格或逗號合併使用（例如 png jpg ${type_folder}）。${type_*} 類別權杖依副檔名分類，使用與內建檢視器一致的副檔名表（包含 設定 - 類型 中的自訂支援/排除清單），因此控制項目的比對範圍與內建預覽始終一致。類別權杖只比對檔案，如需同時比對資料夾請與 ${type_folder} 組合。
3. 設定範例：使用 7-Zip 解壓縮檔案
若要新增使用隨附 7-Zip 解壓縮檔案的按鈕：
- 執行檔：
${7z}（或瀏覽至您自己的7z.exe）。 - 引數：
x "${input_file}" -r -y -o"C:\Output\Path\" - 檔案格式：
zip rar 7z tar gz
參數詳細說明：
* x：保留完整路徑進行解壓縮。
* "${input_file}"：目標檔案。
* -r：遞迴處理子目錄。
* -y：自動確認所有提示（覆寫）。
* -o"..."：輸出目錄。