# DeepSeek Harness

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

Canonical URL: https://s1.dev/zh/docs/integrations/deepseek-harness

`dsh-s1` 是一个原生的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）插件，通过 Search1API 为你的 dsh Agent 提供实时网络访问——网页搜索、智能搜索、新闻搜索、可读页面获取、站点地图发现和热门话题。

与 MCP 桥接不同，该插件把这些能力注册为**一等 DSH 工具**——与 `read`、`bash` 和 `subagent` 处于同一层——并基于官方 [@search1api/client](https://www.npmjs.com/package/@search1api/client) SDK 在进程内运行。

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

## 安装

将插件添加到某个 DSH profile：

```bash
dsh plugin --profile web add dsh-s1
```

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

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

## 凭据

1. 在 [Search1API 仪表盘](https://app.s1.dev)中创建密钥。
2. 将其导出为 `S1_KEY`：

```bash
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`。参见[智能搜索](https://s1.dev/zh/docs/basic/ask)。

## 配置

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

| 键 | 默认值 | 说明 |
| --- | --- | --- |
| `search` | `true` | 实时网页搜索 |
| `ask` | `true` | 智能搜索（5 积分，45 秒超时） |
| `news` | `true` | 新闻聚合 |
| `crawl` | `true` | 页面抓取 |
| `sitemap` | `true` | 站点地图发现 |
| `trending` | `true` | 热门话题 |
| `skill` | `true` | 内置的 `s1` Skill |

## 积分

搜索和新闻请求每次消耗 1 积分；抓取页面时，每个成功抓取的页面额外消耗 1 积分。智能搜索每次请求消耗 5 积分。新账户无需信用卡即可获得 100 积分。当前费率参见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。

## 搜索过滤条件与结果字段

**0.2.0** 版本支持全部 19 个[搜索引擎](https://s1.dev/zh/docs/basic/search)和全部 6 个
[新闻来源](https://s1.dev/zh/docs/basic/news)，包括 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 路径适用于搜索/新闻；[热门](https://s1.dev/zh/docs/advanced/trending)保持其独立的响应结构。

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

## 源码

[github.com/superagents-lab/dsh-s1](https://github.com/superagents-lab/dsh-s1)
· [npm](https://www.npmjs.com/package/dsh-s1)
· [awesome-dsh-plugin](https://awesome-dsh-plugin.com/p/superagents-lab/dsh-s1/)