Vault Feed Reader 專案介紹
Vault Feed Reader 是一款 Obsidian 桌面版 RSS／Atom 閱讀插件，目標是「大量瀏覽、精選保存」：先在閱讀器裡查看訂閱文章，再把值得留下的內容存成 vault 裡的 Markdown 筆記。
這讓資訊接收與個人知識整理可以在同一個工作環境完成。閱讀器負責更新、篩選與閱讀狀態；保存後的筆記則能加入自己的註解、連結與後續整理。
適合怎樣的工作方式？
假設你訂閱了技術部落格、產品消息與長篇專欄，每天可以先用左側欄的「Today」快速瀏覽今日新訊。看到有興趣但暫時無法細讀的篇章，一鍵加入「稍候閱讀（Read Later）」；特別具啟發性、想長期參考的內容，加入「我的最愛（Favorite）」；確定要沉澱整理時按下 s，將來源提供的正文或摘要保存成 Markdown，之後就能像一般 Obsidian 筆記一樣自由編輯與雙鏈連結。
瀏覽單一來源時，文章以雜誌卡片呈現，附上縮圖、作者、時間與摘要，並依日期分組；切換到資料夾或全部文章時則改用精簡清單，方便快速掃過大量標題。
插件不要求 Feedly 或其他服務帳號，只需要可公開存取的 HTTP(S) RSS／Atom 網址。同一來源可以放進多個資料夾，文章與已讀狀態仍共用一份。
核心功能
- 集中閱讀與導覽：側邊欄精簡為 Today、Saved、Favorite 與 Read Later 四大捷徑；清單頂部分開提供讀取狀態（全部／未讀／已讀）與檢視範疇（今日／已保存／我的最愛／稍候閱讀）篩選，並支援標題搜尋。
- 雜誌式瀏覽：單一來源以卡片顯示縮圖、作者、時間與摘要，並依日期分組。
- 純圖示工具列與狀態即時偵測：文章工具列精簡為純圖示，儲存/開啟筆記按鈕具備 Vault 筆記偵測，若文章已保存會呈現已勾選書籤並以主題色彩突顯。
- 我的最愛與稍候閱讀：Vault 內以 JSON 格式儲存完整文章快照與中繼資料，換電腦或同步時隨 Vault 攜帶，且稍候閱讀手動移除不隨讀取自動消失。
- 鍵盤操作：使用
j/k移動、Enter閱讀、m切換已讀、s保存。 - 精選保存：文章轉為 Markdown；重複保存會開啟既有筆記，保留人工編輯。
- 訂閱搬移：支援 YAML、TOML 與 OPML 匯入／匯出。
- 全文與 AI 摘要：保存後在 Markdown 筆記上擷取公開原文，透過本機 CLI 產生摘要與主題標籤，也可搭配 Web Clipper 筆記。
- 筆記模板：可設定檔名、內文與自訂 Properties，讓新文章符合自己的整理方式。
- 自訂存放位置：可調整 Feed Reader 根目錄，更換時能選擇搬移原有資料，或在新位置建立新的空白來源。
資料放在哪裡？
訂閱、閱讀狀態、我的最愛／稍候閱讀清單與保存筆記都留在 vault（例如 Feed Reader/state/favorites.json 與 read-later.json）。文章正文與中繼資料則放在本機 IndexedDB 快取，每個來源最多保留最新 500 篇。
兩者用途不同：快取支援日常瀏覽，保存筆記與清單才是你主動留下的資料。快取淘汰不會刪除已讀紀錄、收藏清單或保存筆記；已保存與收藏清單皆具備備援，不依賴原文章仍在快取中。
使用範圍
外掛僅支援桌面版 Obsidian，宣告最低版本為 1.8.7，可直接在 Obsidian 內搜尋安裝，或從 GitHub Releases 下載安裝檔手動安裝。目前版本為 0.6.0。
閱讀器與 s 保存使用 feed 提供的正文或摘要；需要完整內容時，可開啟保存後的 Markdown 筆記，另行執行全文擷取或 AI 摘要命令。全文擷取限公開 HTML，不處理網站登入、動態 JavaScript 或付費牆；遠端圖片不保證離線顯示。
AI 摘要沿用本機 CLI 的登入與模型設定，可能將文章送往其設定的雲端模型。操作詳見 05 Vault Feed Reader 全文擷取與 AI 摘要設定。
系列導覽
- 本篇：專案定位與功能概覽。
- 02 Vault Feed Reader 安裝與日常閱讀：從安裝到第一次保存文章。
- 03 Vault Feed Reader 訂閱管理與筆記模板：訂閱搬移、資料備份與模板範例。
- 04 Obsidian RSS 插件比較：比較 RSS Dashboard、Rho Reader 與本專案的使用取捨。
- 05 Vault Feed Reader 全文擷取與 AI 摘要設定：本機 Agent 設定、三種命令與 Web Clipper 範例。