前言¶
做智能体开发或日常技术跟进时,信息往往分散在浏览器标签、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 侧边栏、把「今天有什么新文章」交给对话的场景。插件目录与源码: