DeepSeek Harness (DSH) 的核心设计理念是“一切皆插件”。在开发或日常使用中,监控 RSS 订阅源以获取最新信息是常见需求。dsh-rss-monitor 是一个原生插件,为 DSH 提供了多源订阅、关键词过滤、定时检查去重以及新条目邮件通知的能力,同时通过原生设置页集成,提供了四页签的中英双语体验。
核心功能¶
该插件专注于订阅管理的实用性与安全性,具备以下能力:
- 多源订阅:支持 RSS 2.0 与 Atom 格式。
- 关键词过滤:每源可独立设置“包含”或“排除”关键词(匹配标题与摘要),多个关键词用逗号分隔。
- 定时检查:检查间隔 1–1440 分钟可调,默认为 5 分钟;支持顶部开关启停监控。
- 智能去重:使用
md5(feedUrl\|guid\|\|link\|\|title)前 16 位作为稳定 ID,配合环形窗口记录上 1000 条条目。 - 邮件通知:支持 SMTP(SSL 465),邮件内容为 HTML 模板(带缩略图),具备指数退避重试机制。
- 原生设置页:通过 slots 注入 DSH 设置界面,包含概览、RSS 源、邮件通知、运行设置四个标签页,支持中英双语。
- 概览面板:实时显示运行状态、上次/下次检查时间、最新发现条目(带缩略图)及检查历史。
- 显示条数可调:最新发现与检查历史各可设置 1–100 行显示条数。
- 自动刷新:设置页每 15 秒拉取状态,数据无变化时不重渲染。
- 凭据安全:SMTP 密码仅存储于 DSH 凭据库(
DSH_RSS_SMTP_PASS_*),配置文件中仅存引用,不落盘明文。 - 时间窗口:支持按星期 + 时间段触发检查,仅在窗口期内执行监控与通知。
安装与启用¶
DSH Desktop 安装必须使用精确版本(如 @0.2.10)和 --save-exact 标志,否则会静默跳过。使用 CLI 安装前必须完全退出 DSH Desktop。
dsh plugin --profile desktop add -wE "dsh-rss-monitor@0.2.10"
安装完成后,确保 Desktop profile 的 package.json 使用 UTF8NoBOM 编码,否则可能导致 DSH 无法启动。启动 DSH 后,在设置中找到“RSS 监控”即可启用。
典型用法¶
- 添加 RSS 源:进入“RSS 源”页签,点击“添加 RSS 源”,输入名称与 URL,设置包含/排除关键词,点击“测试连接”确认可用后保存。
- 配置邮件通知:进入“邮件通知”页签,填写 SMTP 主机、端口、账号、密码(需使用授权码)及收件人,保存后点击“发送测试邮件”验证。
- 调整运行设置:进入“运行设置”页签,修改检查间隔(默认 5 分钟)与显示条数(1–100 行),通过顶部开关启停监控。
- 查看概览:在“概览”页签查看运行状态、最新发现的条目及检查历史,支持一键清除记录。
- 设置时间窗口:在“运行设置”中勾选星期,设置开始/结束时间,启用窗口期自动检查功能。
注意事项¶
- 宿主版本要求:v0.2.9+ 版本要求宿主版本
dsh >= 0.1.2-rc.1。 - 跨午夜处理:时间窗口支持跨午夜场景(如 22:00-06:00),系统会自动正确处理。
- 权限说明:插件以当前 DSH 进程的权限运行。
总结¶
dsh-rss-monitor 通过原生设置页集成的方式,解决了 RSS 监控在 DSH 生态中的接入问题。它提供了从订阅管理、内容过滤到安全通知的一整套流程,适合需要自动化监控信息流的开发者或用户。