dsh-web-summary:让 DeepSeek Harness 智能体抓取并摘要公开网页的 Host 工具插件

前言

做智能体应用时常遇到这种情况:用户丢来一个链接,希望模型直接读一下页面内容并给出摘要。但 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 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜