RSS 訂閱來源
隨附於 Macro Deck追蹤 RSS 和 Atom 訂閱來源,在小工具中顯示最新文章,並在有新文章時做出回應。
訂閱來源清單小工具和精選文章小工具,顯示來自 Tech News 訂閱來源的範例文章
- 追蹤任何 RSS 2.0 或 Atom 訂閱來源,數量不限
- 訂閱來源清單和精選文章小工具
- 在點選的裝置上開啟文章
- 新文章和更新失敗的觸發條件
- 每個訂閱來源的關鍵字和分類篩選
RSS 訂閱來源整合可追蹤新聞網站、部落格、Podcast,以及其他任何發布 RSS 2.0 或 Atom 訂閱來源的內容。Macro Deck 會在背景檢查訂閱來源,保留最新的文章並顯示在小工具中。不需要帳戶,訂閱來源也可以加入任意數量。
小工具、動作和觸發條件
訂閱來源清單 小工具會列出最新文章的標題和日期,也可以顯示內文開頭和一張小圖。精選文章 小工具會以大尺寸顯示一篇文章和它的圖片,也可以輪流顯示最新的幾篇文章。每個小工具可以顯示所有訂閱來源、單一訂閱來源或一個訂閱來源群組。點選文章會在你點選的裝置的瀏覽器中開啟它,例如使用網頁用戶端的手機,或在對話方塊中顯示文章詳細資料。
更新訂閱來源 動作會立即檢查一個或所有訂閱來源。觸發條件會在訂閱來源出現 訂閱來源新文章、訂閱來源已更新、更新失敗,以及有人在小工具上點選文章時做出回應。它們執行的動作可以使用文章的值,例如 {{ event.title }} 或 {{ event.url }}。
每個訂閱來源也會提供變數,例如 feeds_<feed>_latest_title 和 feeds_<feed>_unread_count,另外還有合計所有訂閱來源的 feeds_all_unread_count。
設定範例:
- 使用群組
News的 訂閱來源清單 小工具,顯示三個新聞網站的最新文章。 - 每 10 秒切換到最新五篇文章中下一篇的 精選文章 小工具。
- 針對 Podcast 訂閱來源、在 訂閱來源新文章 時執行的自動化,透過 Discord Webhook 整合的 傳送 Discord Webhook 訊息 將單集標題發布到 Discord 頻道。
- 在晨間例行開始前執行 更新訂閱來源 的按鈕。
更新方式
每個訂閱來源會依各自的間隔檢查,預設為每 30 分鐘一次,最短間隔為 5 分鐘。Macro Deck 會詢問伺服器訂閱來源自上次檢查後是否有變更,因此沒有變更的訂閱來源幾乎不會造成負擔。檢查失敗時,Macro Deck 會在 1 分鐘後重試,之後每次失敗都會等待更久,最長 1 小時。小工具會在每次重新整理後自動更新,而且只顯示 Macro Deck 已擷取的內容,因此增加小工具並不會增加請求。
加入訂閱來源時其中已有的文章永遠不會觸發 訂閱來源新文章,重新啟動後也不會再次觸發。為了安全起見,除非你為該訂閱來源允許,否則 Macro Deck 會拒絕區域網路和私人網路中的訂閱來源位址。
需要準備
- 在 Windows、macOS 或 Linux 上執行的 Macro Deck 3
- 執行 Macro Deck 的電腦需連上網際網路
- RSS 2.0 或 Atom 訂閱來源的位址
開始設定
步驟 1: 開啟 RSS 訂閱來源整合
在 Macro Deck 的側邊欄中按一下 整合,然後按一下 RSS 訂閱來源。在 概覽 分頁的 設定 區段中按一下 新增設定。開啟右上角的開關也會開啟相同的對話方塊。
步驟 2: 新增訂閱來源
填寫 新增訂閱來源 對話方塊:
- 訂閱來源位址:訂閱來源的位址,通常是網站 RSS 圖示背後的連結,例如
https://example.com/feed.xml。 - 設定名稱:訂閱來源在小工具、觸發條件和變數中的名稱。留空則使用訂閱來源本身的標題。
- 群組:選填,例如
News。屬於同一群組的訂閱來源可以在一個小工具中一起顯示。 - 重新整理間隔(分鐘):Macro Deck 檢查訂閱來源的頻率,最短 5 分鐘。
在 進階設定 下,可以設定 僅限包含下列內容的文章、略過包含下列內容的文章 和 僅限下列分類(皆為以逗號分隔的清單),以及供你自己網路中的訂閱來源使用的 允許區域網路位址。按一下 繼續。Macro Deck 會在儲存前先讀取一次訂閱來源。
- 訂閱來源位址:訂閱來源的位址,通常是網站 RSS 圖示背後的連結,例如
步驟 3: 視需要新增更多訂閱來源
每增加一個訂閱來源,就再按一下 新增設定。設定清單會顯示每個訂閱來源上次重新整理是否成功。
步驟 4: 新增訂閱來源小工具
在 面板 頁面上,於面板解鎖時(右上角顯示 鎖定 按鈕)新增 訂閱來源清單 或 精選文章 小工具。在 顯示 下選擇 所有訂閱來源、單一訂閱來源 或 單一群組,並設定 文章數、顯示描述、顯示圖片 和 點選時。
步驟 5: 在按鈕上加入重新整理動作
若要隨時檢查新文章,請在 面板 頁面上按一下按鈕。編輯器開啟時會選取 短按。按一下 + 新增動作,在 新增動作 對話方塊左側選擇 RSS 訂閱來源,然後選擇 更新訂閱來源。選擇一個 訂閱來源,或留空以重新整理所有訂閱來源。
步驟 6: 檢查結果
讀取訂閱來源後,小工具就會顯示最新文章。點選文章即可在你點選的裝置上開啟。加入訂閱來源後才送達、且你尚未點選的文章會以粗體顯示。
動作1
可放在按鈕上,或從流程中執行。
- 更新訂閱來源
- 立即在所有訂閱來源或僅在所選訂閱來源中檢查新文章,並最多等待 2 分鐘取得結果。
觸發器4
按鈕或流程可以對這些事件做出反應。
- 訂閱來源新文章
- 訂閱來源中出現了先前沒有的文章。一次有許多新文章時,會為最新的 20 篇觸發。
- 訂閱來源已更新
- 重新整理時訂閱來源的文章有所變更。會附帶最新的文章。
- 訂閱來源更新失敗
- 無法重新整理訂閱來源,並附帶
timeout或http-404等錯誤代碼。 - 已開啟訂閱來源文章
- 有人在訂閱來源清單或精選文章小工具上點選了文章。可選擇僅限單一小工具。
變數7
在按鈕和小工具上顯示這些值,或在條件中使用。
feeds_<feed>_latest_title,feeds_<feed>_latest_url,feeds_<feed>_latest_description,feeds_<feed>_latest_author- 訂閱來源最新文章的標題、連結、描述和作者。
feeds_<feed>_latest_published- 最新文章的發布時間,採用 ISO 8601 格式。
feeds_<feed>_item_count- Macro Deck 為該訂閱來源保留的文章數量,最多 50 篇。
feeds_<feed>_unread_count- 加入訂閱來源後才送達、且尚未在小工具中點選過的文章數量。
feeds_<feed>_last_updated- 上次成功檢查訂閱來源的時間,採用 ISO 8601 格式。
feeds_<feed>_update_status- 上次檢查的結果:
ok、not-modified、error,首次檢查前則為pending。 feeds_all_item_count,feeds_all_unread_count- 所有訂閱來源合計的文章數量和未讀文章數量。
小工具2
從小工具選擇器將這些小工具加入面板。
- 訂閱來源清單
- 列出所有訂閱來源、單一訂閱來源或單一群組中最多 10 篇最新文章。
- 精選文章
- 以大尺寸顯示最新文章和它的圖片,也可以輪流顯示最新的幾篇文章。
常見問題
點選文章後,會在哪裡開啟?
使用 在瀏覽器中開啟 時,文章會在你點選的裝置的瀏覽器中開啟,而不是在執行 Macro Deck 的電腦上。如果該裝置無法開啟連結,例如硬體面板,Macro Deck 會改為顯示含有位址的詳細資料。若要變更,請在 點選時 下選擇 顯示詳細資料 或 僅執行小工具的動作。
為什麼 Macro Deck 會拒絕我的訂閱來源位址?
Macro Deck 會拒絕區域網路和私人網路中的位址,例如 localhost 或 192.168.…,訂閱來源重新導向到這些位址時也一樣。如果訂閱來源由你自己提供,例如來自 NAS,請在該訂閱來源的 進階設定 下開啟 允許區域網路位址。其他錯誤會說明訂閱來源未及時回應、無法連線、不是 RSS 或 Atom 訂閱來源,或大於 5 MB。
變數是如何命名的?
每個訂閱來源的變數會以加入時的設定名稱命名,例如 feeds_tech_news_latest_title。之後重新命名設定,變數名稱仍會保持不變。整合的 變數 分頁會顯示確切的名稱。
為什麼舊文章沒有觸發訂閱來源新文章?
加入訂閱來源時其中已有的文章永遠不會觸發 訂閱來源新文章,被篩選條件排除的文章也會視為已看過。變更訂閱來源的位址會重新開始,就像加入了新的訂閱來源一樣。
Macro Deck 會傳送什麼給訂閱來源的伺服器?
Macro Deck 只會連線到你加入的訂閱來源及其圖片所在的伺服器,傳送的只是擷取訂閱來源的一般請求。文章文字會以純文字顯示,訂閱來源中的指令碼或內嵌內容永遠不會執行。
更多「智慧家庭和網路」整合
Home Assistant
隨附於 Macro Deck切換燈光、執行場景和指令碼,並在面板上顯示 Home Assistant 的即時狀態。
AdGuard Home
隨附於 Macro Deck開啟、關閉或暫停 AdGuard Home 防護,並在面板上顯示統計資料。
HTTP
隨附於 Macro Deck從按鈕傳送 HTTP 請求,並將回應中的值儲存到變數。
天氣
隨附於 Macro Deck在面板上顯示各個地點的目前天氣和預報,不需要 API 金鑰。