前言¶

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 的智能体工作流深度整合，通过原生服务和环境感知，为本地知识收集提供了标准化的插件方案。