外掛開發與實作

使用 AI 助手建置外掛

替換下方的需求佔位符，然後向您的程式設計助手傳送完整指令：

請閱讀並遵循位於 https://raw.githubusercontent.com/ccseer/Seer-Plugins/refs/heads/master/plugin_development_guide.md 的 Seer 外掛開發指南。將其視為架構、plugin.json、實作、驗證和打包的唯一事實來源。如果該指南不可用，請在繼續之前停止並報告。

在開始任何工作之前，請檢查下方的 Requirement（需求）。如果其缺失、為未變更的佔位符文字或過於模糊而無法實作，請提出一個澄清問題並等待。請勿推測缺失的需求。

明確後，選擇 Convert 或 DLL 並簡要說明理由，然後在當前工作區中實作一個完整的、可安裝的外掛。請勿修改 Seer 本身，也不要僅停留在計劃或程式碼片段上。

遵循指南中所有適用的驗證步驟並報告實際結果。儘可能執行應用內 Seer 預覽測試；否則請明確說明未進行執行階段驗證。

Requirement: [將此佔位符替換為外掛請求。]

轉換類型外掛

Seer 將轉換類型外掛視為外部執行程式。當觸發檔案時，Seer 執行設定的程式，並透過佔位符傳遞檔案路徑。

佔位符變數

• ${input_file}: 來源檔案的絕對路徑。
• ${output_file}: 外掛儲存處理後輸出的基礎檔案路徑（須追加目標副檔名，例如 ${output_file}.json）。
• ${use_backslash}: 可選標記，將路徑分隔符格式化為 Windows 原生反斜線 (\)。
• ${seer_dir}: Seer.exe 所在的目錄路徑。
• ${seer_exe}: Seer.exe 的絕對路徑。
• ${7z}: Seer 隨附的 7z.exe 絕對路徑。

執行工作流程

1. 觸發： 使用者對檔案按 空白鍵。
2. 解析： Seer 辨識與檔案副檔名相關聯的外掛。
3. 執行： Seer 執行可執行程式（例如 ApkMetaInfo2Json.exe "${input_file}" "${output_file}.json"）。
4. 顯示： 程序退出後，Seer 讀取與 ${output_file}.* 匹配的生成檔案，並使用輸出副檔名對應的內建渲染器進行展示。

支援的可執行檔案與指令稿類型

轉換類型外掛可以是任何能夠透過 CLI 處理輸入/輸出的可執行檔案：

• 指令稿：
  • CMD 指令稿：cmd_rename
  • BAT 指令稿：bat_epub
  • PowerShell 指令稿：.ps1（透過 powershell.exe 開箱即用支援）
• 第三方工具：
  • dll_lib_exports：Windows 系統實用工具
  • ImageMagick
  • exiftool
• 自訂程式：
  • Torrent2Json
  • ApkMetaInfo2Json

暫存檔案管理

外掛通常會產生中間檔案。

• 自動清理： 預設情況下，Seer 會自動清理超過 21 天的暫存檔案。
• 強制刪除： 在命令參數中追加 ${no_cache} 可指示 Seer 繞過轉換結果快取，並將暫存輸出儲存至自動刪除目錄（autodel/），該目錄會在 Seer 退出時自動清空。

DLL 類型外掛

對於效能要求高或深度整合，Seer 支援基於 C++/Qt 編譯為動態庫的 DLL 外掛。

參考範例專案

有關外掛介面的實作，請參閱以下官方儲存庫：