STARDUSTLC666/dsh-rss

English

dsh-rss

agent 的资讯雷达：订阅管理 + RSS/Atom 抓取解析。

DSH（DeepSeek Harness）的 RSS/Atom 订阅工具插件：管理订阅源，抓取并解析 RSS 0.9x / 1.0 / 2.0 与 Atom，给模型提供五个可直接调用的工具。

安装

dsh plugin --profile web add dsh-rss

安装后重启 Web 服务即可。

配置

在你自己的 profile 的 cordis.patch.yml 里覆盖本插件行（缺省时插件也能加载，只是全部用默认值）：

- id: rss
  name: 'dsh-rss'
  config:
    # proxyUrl: http://127.0.0.1:7890   # 部分订阅源需要特殊代理（梯子）才能访问时启用
    timeoutMs: 15000                     # 抓取超时（毫秒，默认 15000）
    # maxBodyBytes: 5242880              # 订阅源体积上限（默认 5MB，防超大响应）
    # userAgent: 'dsh-rss/0.1.0'         # 自定义抓取 UA
    # feedsYaml: |                        # 可选：预置订阅列表（也可用 rss_add 工具添加）
    #   - url: https://example.com/feed.xml
    #     name: 示例订阅
    #     category: 技术

工具一览

工具	作用	关键参数
rss_list	列出已订阅源	无
rss_add	添加订阅（先抓取校验地址）	url 必填；name/category 可选
rss_remove	删除订阅	url 或 name 至少一个
rss_fetch	抓取解析订阅源，返回源信息与条目	url 或 name 至少一个；limit 1-100 默认 20
rss_check	校验地址是否为可解析的订阅源	url 必填

示例

rss_add { url: https://example.com/feed.xml, name: 我的订阅 }
rss_fetch { name: 我的订阅, limit: 10 }
rss_check { url: https://example.com/feed.xml }

订阅存储

订阅列表保存在 settings 的 dsh-rss 命名空间（feedsYaml 字段）里：rss_add / rss_remove 会自动读写并持久化，重启后仍在；也可以在配置里用 feedsYaml 预置初始订阅。同名订阅请用 url 区分。

特殊代理（梯子）

大部分订阅源可以直接访问；少数订阅源需要特殊代理（梯子）才能连通。遇到 抓取失败 且提示需要代理时，把 proxyUrl 配成你的本地代理地址（如 http://127.0.0.1:7890）并重启即可。代理只作用于本插件的抓取请求，不影响同进程其他插件。

解析能力

• RSS 2.0 / RSS 1.0（RDF）/ Atom 三种格式，统一归一化输出
• 实体解码、CDATA、content:encoded、dc:creator、itunes 等常见字段
• RFC 822 / ISO 8601 日期统一转 ISO 8601 UTC（pubDate），原始文本保留在 pubDateRaw
• 相对链接按订阅源地址解析成绝对链接
• 摘要去 HTML 标签并截断到 500 字符；正文全文读取在后续版本提供
• 安全：不解析 DTD/外部实体，内容只做文本抽取；响应体积上限 5MB；抓取超时可配

开发

pnpm install
pnpm test       # 构建 + 47 个测试

发布前门禁：危险模式扫描、manifest 自检、pnpm audit --prod、全量测试，以及全新 profile 的真实启动冒烟测试。

License

MIT