前言¶

DeepSeek Harness (DSH) 的插件化架構允許在 Web UI 中嵌入自定義組件。OpenBook 是一個本地優先的 RSS 閱讀器和知識收集器，作爲 DSH 插件重構。它解決了在智能體工作流中直接管理訂閱源、閱讀全文及整理筆記的需求，將所有功能運行在 dsh 插件運行時中，作爲原生 Cordis 服務。

核心功能¶

OpenBook 在會話視圖環中提供 RSS 標籤頁，採用三欄閱讀器佈局。主要特性包括：

• 三欄閱讀界面：包含訂閱源側邊欄，支持按日期分組的文章隊列、全文閱讀、收藏與筆記。
• 快捷導航：側邊欄提供 RSS 標籤頁的快捷入口，點擊即可跳轉。
• 筆記與狀態：提供 Notes（筆記/高亮）和 Status（同步統計、活動流）標籤頁。
• 環境感知：打開文章時，內容會被注入到會話的 Agent 上下文中，模型無需額外輪詢即可瞭解閱讀狀態。
• 討論交互：支持對文章進行總結、翻譯或提取要點，操作會將文章推入對話流，視圖自動切回 Chat 標籤頁查看回復。選中特定文本可將其作爲高亮段落附加。
• 同步節點：同步運行結果以緊湊卡片形式呈現於聊天流中。
• Agent 工具與命令：
  • 工具：Agent 可調用 rss_list_feeds, rss_sync, rss_search, rss_read_article, rss_materialize, rss_save_note, rss_export_review, 以及 book_index, book_recent, book_article, book_search。
  • 指令：提供 /feeds, /read, /search, /recent, /notes, /favorites, /stats, /open, /materialize, /sync, /export-review, /review, /activity, /book, /doctor 等指令。

安裝與啓用¶

通過 DSH 插件 CLI 安裝。無需 npm 賬號即可通過 tarball 安裝。

dsh plugin add https://github.com/rocklau/dsh-rss-reader/releases/download/v0.1.0-rc.1/openbook-dsh-rss-reader-0.1.0-rc.1.tgz

此命令會將 openbook-rss 條目注入到 Web 側邊欄。插件會自動聲明 dsh.bundle 和 dsh.client，無需額外配置即可在 dsh web 運行時中加載。

典型用法¶

1. 跳轉閱讀：點擊側邊欄的 RSS 快捷方式，直接進入 RSS 標籤頁瀏覽文章。
2. 討論文章：在 RSS 視圖中點擊文章的討論操作，文章內容會被推入對話，視圖自動返回 Chat 標籤頁，模型將基於文章內容生成回覆。
3. 查看同步狀態：在 Chat 流中，同步操作會以卡片形式展示，提供同步進度和結果概覽。

適用場景與注意事項¶

• 運行環境：插件以原生 Cordis 服務形式運行在 DSH 插件運行時中，不需要單獨的 HTTP 服務進程。
• 數據存儲：數據存儲在 SQLite 數據庫 (openbook.db) 和 Markdown 文件中，目錄由 dataDir 配置決定。
• 安全限制：默認開啓 SSRF 防護，攔截 DNS 私有範圍（如 localhost, 192.168.x.x 等）的訂閱源，除非在配置中顯式開啓 allowPrivateFeeds。

結語¶

OpenBook 將傳統的 RSS 閱讀器邏輯與 DSH 的智能體工作流深度整合，通過原生服務和環境感知，爲本地知識收集提供了標準化的插件方案。