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 生態中的接入問題。它提供了從訂閱管理、內容過濾到安全通知的一整套流程，適合需要自動化監控信息流的開發者或用戶。
