Search1API文档

DeepSeek Harness

通过原生 dsh-s1 插件让 DeepSeek Harness Agent 实时访问网络——网页搜索、智能搜索、新闻、页面读取、站点地图发现和热门话题,都作为一等 dsh 工具提供。

dsh-s1 是一个原生的 DeepSeek Harness(DSH)插件,通过 Search1API 为你的 dsh Agent 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。

与 MCP 桥接不同,该插件把这些能力注册为一等 DSH 工具——与 read、bash 和 subagent 处于同一层——并基于官方 @search1api/client SDK 在进程内运行。

内置的 s1 Skill 会告诉模型何时搜索、何时抓取、何时深入研究,以及快速查询和深度研究分别适合哪些参数。

安装

将插件添加到某个 DSH profile:

dsh plugin --profile web add dsh-s1

如果使用本地检出的代码,先构建包,再使用路径形式指定:

cd /path/to/dsh-s1
npm run build
cd ~/.dsh
dsh plugin --profile web add file:/path/to/dsh-s1

凭据

  1. 在 Search1API 仪表盘中创建密钥。
  2. 将其导出为 S1_KEY:
export S1_KEY=...

SDK 会延迟读取密钥,因此缺少密钥时失败的是工具调用,而不是插件激活。

Agent 能做什么

  • 实时网页搜索,覆盖 Google、Bing、DuckDuckGo、Reddit、GitHub、YouTube、arXiv 等
  • 智能搜索(s1_ask),只需 query;由服务端选择来源和过滤条件
  • 新闻,聚合多个来源
  • 页面抓取,从公开 URL 提取干净的内容
  • 站点地图发现,梳理网站的 URL 或全部公开链接
  • 热门话题,呈现当下的热点

所有操作都是只读的。搜索结果包含来源 URL,Agent 可以接着抓取这些 URL。

s1_ask 会保留 query、intent、结果的 source 和 relevance,以及可选的 errors。参见智能搜索。

配置

每项能力都可以在插件配置中单独禁用:

键默认值说明
searchtrue实时网页搜索
asktrue智能搜索(5 积分,45 秒超时)
newstrue新闻聚合
crawltrue页面抓取
sitemaptrue站点地图发现
trendingtrue热门话题
skilltrue内置的 s1 Skill

积分

搜索和新闻请求每次消耗 1 积分;抓取页面时,每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见积分与限制。

搜索过滤条件与结果字段

0.2.0 版本支持全部 19 个搜索引擎和全部 6 个 新闻来源,包括 Bing China、Yandex、Grokipedia 和 Reuters。 time_range 支持 day、week、month 和 year;page 支持搜索 分页。这些过滤条件适用于搜索/新闻;智能搜索只接受 query。

引擎特有的结果字段位于可选的 metadata 中:GitHub 搜索提供 metadata.kind、metadata.stars、metadata.language 和 metadata.num_comments; Hacker News 搜索提供 metadata.story_url、metadata.points 和 metadata.num_comments。可选的 published_date 保留在结果顶层。 HTTP 响应级的 searchParameters 描述实际执行的请求;DSH 返回映射后的结果列表。这些 metadata 路径适用于搜索/新闻;热门保持其独立的响应结构。

DSH 会把每条结果的 API link 映射为 url,并保留 metadata 和 published_date。

源码

github.com/superagents-lab/dsh-s1 · npm · awesome-dsh-plugin

本页内容