前言¶
做智能體開發或日常技術跟進時,信息往往分散在瀏覽器標籤、Feedly 或各類 Feed 裏;想在 DSH 對話裏問「今天訂閱有什麼新內容」,又得自己複製鏈接或口頭羅列源站。DeepSeek Harness 走插件化路線,社區目錄裏有不少聯網類能力,但專門把 RSS/Atom 訂閱做成「可讀的界面 + 可調用的工具」的並不多。dsh-feeds(維護者 michaelfeng,分類:聯網工具)把 Feedly 式閱讀搬進 DSH:左側邊欄增加全局面板「信息源」,同時爲 Agent 註冊 feeds 工具。下面按定位、能力、安裝、用法和注意事項說明。
這是什麼¶
dsh-feeds 是面向 DeepSeek Harness 的社區插件(MIT,當前版本 1.2.3)。它解決兩件事:在 Desktop / Web GUI 裏用三欄閱讀器管理訂閱;在對話中通過 feeds 工具查詢摘要、讀正文、導入 OPML、增刪源等。Feedly 只是導入路徑之一,任意標準 OPML、RSS 2.0 / Atom / RDF / JSON Feed 地址,以及頁面聲明瞭 alternate feed 的網站都可以訂閱。
資料標明狀態爲 Preview(源碼預覽版),適配 Harness 0.2.2-rc.1,在 macOS 上實機驗證;Windows / Linux 未實機驗證,且尚未發佈 npm 包。
核心功能¶
訂閱與格式。 支持 Feedly OPML 或任意標準 OPML(界面導入可選合併或替換,替換需確認);對話或界面可新增單個 RSS;網站帶 feed 鏈接時可直接填站點地址。不支持需 Cookie / 登錄 / 自定義請求頭的私有源;不回寫 Feedly 已讀(需 Feedly Pro API,當前未接)。
閱讀與管理。 三欄:來源導航、按來源摺疊同一天更新、右側頁內讀正文(RSS 全文優先,失敗則網頁提取);分類 / 未讀 / 稍後讀篩選、全文搜索、批量已讀可撤銷、快捷鍵與篩選位置記憶。訂閱源面板可看抓取狀態、移動分類、單源刷新、界面內新增與 OPML 導入。
與模型打通。 Agent 調用 feeds(digest、sources、refresh、article、import、add 等);文章面板「用 DSH 總結」把提問插入輸入框,不自動發送。
本地優先。 訂閱、已讀、稍後讀存本機(默認 ~/.dsh/feeds/state.json),無遙測。可選配置 allowPrivateHosts 默認關閉,拒絕解析到內網/環回的源與正文。
安裝與啓用¶
前置:已安裝 DeepSeek Harness(profile bundle 機制,Desktop 或 Web GUI)。僅開發/測試插件本身需要 Node.js 22+。
官方 README 要求先把倉庫放到本機,再在 DSH 裏由 Agent 安裝 bundle(路徑換成你的目錄):
plugin_manager install_bundle /absolute/path/to/dsh-feeds
安裝後刷新 Web 頁面。左側邊欄會出現 「信息源」,與 Plugins、Automation tasks 同一組,排在 Automation tasks 之後、More 之前;這是用戶級全局面板,切換會話不影響訂閱瀏覽。
- 升級:
plugin_manager remove_bundle dsh-feeds,再重新install_bundle本機路徑。 - 卸載:
plugin_manager remove_bundle dsh-feeds;數據仍在dataDir,可自行刪除。
可在 cordis.patch.yml 中調整,例如:
- id: feeds
config:
dataDir: !!js dshHomePath('feeds') # 狀態目錄(state.json)
refreshMinutes: 30 # 快照過期後自動後臺刷新
# allowPrivateHosts: true # 默認 false:內網 RSS 需顯式開啓
插件以當前 DSH 進程權限運行,安裝前建議閱讀倉庫源碼、LICENSE 與 SECURITY.md。
典型用法¶
- 在 Feedly 導出 OPML:https://feedly.com/i/opml(或 Settings → Import/Export)。
- 對話中說:
幫我導入 ~/Downloads/feedly-xxx.opml;或在「信息源 → 訂閱源 → 導入 OPML」填路徑並選合併/替換。 - 新增單源:界面「+ 新增訂閱」,或對話:
幫我訂閱 https://example.com/feed.xml,放到「研究」分類。 - 點「信息源」→ 信息流 / 訂閱源,按分類、來源、未讀、稍後讀瀏覽;點條目在右側讀正文。
Agent 側常用 feeds 動作示例(參數見 README 工具表):
digest:按sinceHours(默認 24)、limit(默認 60)等拉最新條目。sources:查看分類、訂閱與未讀數、抓取錯誤。article+itemId:讀單條正文。
界面快捷鍵包括 j/k 選擇、m 切換已讀、/ 搜索、r 刷新等。
適用場景與注意¶
適合誰。 已在用 RSS/OPML 跟進技術博客與資訊,又希望同一套訂閱既能安靜閱讀,也能在 DSH 裏讓模型做摘要或回答「最近 24 小時有什麼」的開發者。
限制與排查。 若界面顯示 “Feeds are unavailable”,多爲頁面拿不到 Host 的 /api/feeds/*;可重試或刷新,仍失敗則重啓 DSH。診斷文件 ~/.dsh/feeds/last-boot.json 正常約爲 {"connection":true,"routes":11}。部分源 404/403 等屬源站問題,失敗不會清空已緩存條目。圖片防盜鏈時面板會提示加載失敗。
路線圖(1.0 之前)包括 npm 發佈、認證私有源、更多語言、可選 Feedly API 雙向已讀等,以倉庫 CHANGELOG / README 爲準。
結語¶
dsh-feeds 把訂閱閱讀與 Agent 查詢接到同一套本地狀態上,適合把「信息源」留在 Harness 側邊欄、把「今天有什麼新文章」交給對話的場景。插件目錄與源碼: