前言¶
做智能體應用時常遇到這種情況:用戶丟來一個鏈接,希望模型直接讀一下頁面內容並給出摘要。但 Host 側如果沒有註冊對應的工具,模型只能憑預訓練知識回答,或者你在對話裏手動粘貼正文,既麻煩也不可靠。
dsh-web-summary 是爲 DeepSeek Harness(DSH)寫的一個 Host 工具插件,解決的就是這個問題:安裝後它會向 agent 註冊一個名爲 fetch_page_summary 的工具,通過 HTTPS 抓取指定的公開網頁,把標題和可見內容的純文本摘要返回給模型。下面介紹它的功能、安裝方法和典型用法。
這是什麼¶
dsh-web-summary 由 lavenleo 維護,代碼在 GitHub 上開源,許可證爲 MIT(README 與 package.json 均有標明)。定位一句話:一個 DSH Host 工具插件,抓取公開網頁,把 <title> 和可見內容的純文本摘要返回給 agent。
當前版本 0.1.0,要求 Node >= 22;@deepseek-ai/cordis ^4.0.1 是可選的 peer 依賴。整個插件是純 ESM JavaScript,沒有構建步驟。
核心功能¶
按 README 的說明,插件只做一件事:註冊一個可供模型調用的工具 fetch_page_summary。具體行爲如下:
1、接受一個 https:// URL,以及可選的 maxChars 上限(默認 4000);
2、返回 { url, title, summary, truncated } 四個字段,正文已剝離腳本、樣式和標記,只保留可見文本;
3、僅接受 https:// 的公開網頁 URL。
實現是純 ESM JavaScript,無需構建步驟,Git 安裝和 npm 安裝都能直接使用。
安裝與啓用¶
README 給出的安裝命令是:
dsh plugin --profile <profile> add github:<owner>/dsh-web-summary
其中 <profile> 替換成你的 profile 名稱。也可以從 npm 安裝,無需拼接倉庫路徑:
dsh plugin --profile <profile> add dsh-web-summary
安裝完成後需要重啓 profile,工具纔會以 fetch_page_summary 的形式出現在 agent 可調用的工具列表裏。
環境方面注意:Node 版本需 >= 22;如果環境中存在 @deepseek-ai/cordis ^4.0.1 會作爲 peer 依賴使用,缺失也不影響(該依賴是可選的)。
典型用法¶
README 給出的示例很直接。向 agent 提問:
Summarize https://example.com
agent 會調用 fetch_page_summary,收到該頁面的標題,以及最多 maxChars(默認 4000)個字符的可見文本。truncated 字段會標明正文是否被截斷,模型可以據此判斷摘要的完整程度。
適用場景與注意¶
適合的場景:需要讓 agent 快速讀取一個公開網頁並提取標題和正文要點,比如總結一篇文章、覈對頁面內容;或者不想自己寫抓取和清洗邏輯,希望直接有一個現成工具可用。
幾點注意:
1、插件只接受 https:// 的公開網頁 URL,內網頁面和 http 鏈接不在支持範圍內。
2、默認 4000 字符的上限對長文可能不夠,需要更長內容時通過 maxChars 調整。
3、插件以當前 dsh 進程的權限運行,安裝前建議先檢查源碼與許可證。這個插件的源碼是純 ESM JavaScript,沒有構建步驟,通讀成本不高;README 還給出了開發自檢命令,可以確認文件能作爲 ESM 解析並導出一個 Cordis 插件:
node --check lib/index.js
許可證爲 MIT,可自由查看、使用和修改。
小結¶
dsh-web-summary 功能單一、實現剋制:一個工具、一個默認上限、四個返回字段,覆蓋「讓模型讀一個公開網頁」這個高頻小需求,也符合 DSH「一切皆插件」的思路——缺什麼能力,就裝一個小插件補上。
插件頁收錄於社區目錄 SkillHub(獨立站點,與 DeepSeek / 幻方無官方從屬關係):https://www.skillhub.cn/plugins/lavenleo/dsh-web-summary ;源碼倉庫:https://github.com/lavenleo/dsh-web-summary 。