Skip to content

URI 通訊協定(swiftlist://)

SwiftList 會自動把自己註冊為 swiftlist:// 連結的處理常式——不需要額外的安裝步驟,第一次執行時就會自動完成註冊。這樣任何能開啟連結的東西(瀏覽器、捷徑、別的程式、指令碼)都能直接跳到 SwiftList 的某個具體位置,而不是只能靠熱鍵觸發。

如果 SwiftList 還沒執行,開啟一個 swiftlist:// 連結會先啟動它,再執行這個連結指向的操作。如果已經在執行,正在執行的那個執行個體會直接處理這個連結——不會再啟動第二份處理程序。

支援的連結

連結作用
swiftlist://啟用快速搜尋視窗——效果和用熱鍵叫出它一樣。
swiftlist://search/[關鍵字]啟用快速搜尋視窗,並預先帶入 [關鍵字]
swiftlist://fullsearch/[關鍵字]開啟完整搜尋視窗,並預先帶入 [關鍵字]
swiftlist://settings/page/[分區]開啟設定視窗,並切到指定的頂層分區。
swiftlist://settings/entry/[序號]開啟設定視窗,並直接跳轉到某一項具體設定,並高亮顯示。
swiftlist://search/report
swiftlist://settings/page/Appearance

第一個會啟用快速搜尋視窗,並已經用「report」篩選好;第二個會直接開啟設定視窗的「外觀」頁。

[分區] 對應側邊欄頂層的某一項:ServiceIndexGeneralAppearanceHotkeysPluginsFavoritesHistoryStartupPanelAbout——不區分大小寫。

[序號] 不是給人手動輸入用的——它是設定搜尋在你選中某項設定結果時自己產生的一個數字,選中結果會自動帶上這個序號,原樣跳轉回那一項設定。這個序號在重新啟動之間並不穩定,不要指望某個具體數字每次都對應同一項設定。

無法識別的連結

任何比對不上已知路由的連結——打錯了字、分區不存在、swiftlist:// 後面跟了一堆亂七八糟的內容——都會被直接忽略。由於任何網站或程式都能在你不知情的情況下叫用這個通訊協定,一個錯誤或異常的連結不應該產生任何出人意料的效果;這類情況只會記進記錄方便你自己排查,除此之外什麼都不會發生。