前言¶
DeepSeek Harness(DSH)的核心哲學是「一切皆插件」。在開發智能體或工作流時,處理外部信息源(如 RSS/Atom)通常需要自行編寫定時任務、解析邏輯和去重邏輯,成本較高。
dsh-rss-digest 是一個 DSH 插件,它將上述流程封裝爲一個插件包。它利用 DSH 的 LLM 能力進行智能摘要,通過定時器服務調度抓取,並將結果以 Markdown 格式輸出到對話或文件中。
插件簡介¶
這是一個 RSS/Atom 聚合、智能摘要和每日 Markdown 簡報 工具,以 DSH bundle 的形式提供。
- 維護者: JohnXu22786
- 分類: 聯網工具
- 許可證: MIT
- 核心價值: 將訂閱管理、定時抓取、去重、LLM 摘要和日報分發整合爲一個無依賴的核心邏輯層。
核心功能¶
-
訂閱管理
支持添加、移除、列出 RSS 2.0、Atom 和 RSS 1.0(RDF)源。數據存儲在本地,具有原子寫入和防損壞機制。支持在運行時啓用或禁用特定源。 -
定時抓取
基於配置的輪詢間隔、啓動時的抓取週期、請求超時、大小限制、重試次數以及項目保留上限進行抓取。 -
去重機制
採用精確匹配哈希結合 Token-Jaccard 相似度算法檢測近重複內容(支持 CJK 雙字分詞),並可通過閾值配置。 -
LLM 摘要
支持批量模式或單條模式,輸出語言支持中文或英文,並限制輸出長度。當模型不可用時,會自動降級爲抽取式摘要。 -
每日簡報
在指定的時間點(支持 IANA 時區)生成 Markdown 格式的日報。支持兩種投遞方式:推送到正在運行的對話會話,或寫入文件。 -
零依賴核心
核心邏輯(抓取、解析、去重、存儲、摘要)本身沒有任何依賴,僅集成層引用 DSH 包。
安裝與啓用¶
該插件以 npm 包的形式提供,安裝後通過 dsh.bundle 聲明和 cordis.patch.yml 自動生效。
- 安裝插件
在當前 DSH profile 中安裝:
dsh plugin --profile demo add dsh-rss-digest
-
配置加載
插件安裝後,loader 會自動讀取dsh.bundle聲明並應用cordis.patch.yml。你的 profile manifest 中的dsh.profile.bundles列表將包含dsh-rss-digest,patch 配置會插入插件行。 -
依賴說明
插件聲明瞭 peer dependencies(@deepseek-ai/cordis,@deepseek-ai/dsh-tools,@deepseek-ai/dsh-llm,@deepseek-ai/cordis-plugin-timer)。DSH profile 通常已包含這些依賴,若報錯可手動鏈接一次。
典型用法¶
插件提供了命令行工具和模型工具兩種調用方式。
命令行 (CLI)¶
插件內置了一個獨立 CLI,共享相同的核心邏輯,不依賴 Harness 環境:
# 添加訂閱源
dsh-rss-digest add https://hnrss.org/frontpage
# 立即抓取一次
dsh-rss-digest fetch
# 生成簡報(指定語言和輸出文件)
dsh-rss-digest digest --lang en --out digest.md
DSH 對話工具¶
在對話中,模型可以通過 ctx.tools 調用以下工具:
- rss_add: 訂閱新源。
- 示例:
[rss_add: https://hnrss.org/frontpage]
- 示例:
- rss_fetch: 立即抓取數據(自動去重)。
- rss_digest: 基於未摘要的內容生成 Markdown 簡報。
- 示例:
[rss_digest: language=zh]
- 示例:
配置示例¶
在 dsh.profile.bundles 對應的 cordis.patch.yml 中,可以調整投遞方式和時間:
- id: rss-digest
config:
summary:
language: zh
mode: batch
digest:
time: '08:30'
timezone: Asia/Shanghai
deliverTo: both # agents | file | both
適用場景與注意事項¶
- 適用場景: 需要自動獲取資訊摘要、構建個人知識庫日報、或爲 Agent 提供外部新聞輸入的開發者。
- 運行機制: 插件通過
ctx.timeout和ctx.interval進行調度。每日簡報通過Agent.followup推送到會話,或直接寫入digests/<day>.md。 - 無廣播 API: 由於 DSH Harness 沒有廣播 API,插件無法直接向所有用戶廣播,必須通過會話消息隊列或文件輸出。
- 生態說明: 此插件來自社區目錄,與 DeepSeek 或幻方官方無直接隸屬關係。
總結¶
dsh-rss-digest 通過將 RSS 處理流程標準化,降低了開發者構建自動化信息流的門檻。其核心邏輯的零依賴特性也保證了插件的高穩定性。無論是通過 CLI 獨立運行,還是作爲 DSH 插件集成,它都能提供從訂閱到摘要的一站式解決方案。