前言¶

在 DSH 中使用搜索类能力时，如果希望模型直接把 s1_search、s1_news、s1_crawl 等工具调用起来，dsh-s1 提供了一条更直接的插件路径：它把 s1 相关能力注册为 DSH 的一级工具，而不是让模型额外执行 shell 命令。下面介绍它的定位、能力、安装方式和注意事项。

这是什么¶

dsh-s1 是 superagents-lab 维护的 DeepSeek Harness（DSH）插件，用于把 s1 能力注册为 s1_* 形式的一级工具。

基本信息：

• 许可证：MIT
• Node 要求：>=20.0.0
• GitHub：https://github.com/superagents-lab/dsh-s1

核心能力¶

dsh-s1 注册以下工具：

• s1_search
• s1_news
• s1_crawl
• s1_sitemap
• s1_trending

它还会注册一个 bundled s1 skill，用于帮助模型理解如何选择合适的 s1 工具和参数。

当前未实现：

• s1_screenshot
• s1_deepcrawl

安装与启用¶

如果使用已发布或可直接安装的包，执行：

dsh plugin --profile web add dsh-s1

如果使用本地 checkout，可以先构建，再用文件路径添加到指定 profile：

cd /Volumes/More/Products/search1api/ecosystem/dsh-s1
npm run build
cd ~/.dsh
dsh plugin --profile web add file:/Volumes/More/Products/search1api/ecosystem/dsh-s1

这里的 npm run build 用于生成本地构建产物；后面的 dsh plugin 命令负责把本地路径注册到 web profile。

认证¶

dsh-s1 使用一个凭据变量：

export S1_KEY=...

需要注意：缺少 S1_KEY 时，工具调用会失败，而不是插件激活失败。

OAuth 流程尚未实现。

开发与构建¶

本地开发时可以按以下步骤执行：

npm install
npm run typecheck
npm run build

npm run typecheck 用于类型检查，npm run build 用于生成可加载的构建产物。

适用场景与注意¶

dsh-s1 适合需要把 s1 搜索、新闻、抓取、站点地图和趋势能力接入 DSH profile 的场景。

安装前建议检查源码、许可证和依赖环境；插件会以当前 dsh 进程权限运行。

另外，不要把 s1_screenshot 和 s1_deepcrawl 当成已可用能力。

链接¶

GitHub：

https://github.com/superagents-lab/dsh-s1