superagents-lab/dsh-s1

dsh-s1

Awesome DSH Plugin

为 DeepSeek Harness（DSH）提供的原生 s1 工具。

与 MCP 服务器（search1api-mcp，一个以 mcp__search1api__ 形式呈现的通用桥接）或 CLI 技能（教导模型通过 shell 调用 s1）不同，本包注册的是一等 DSH 工具，命名为 s1_——与 read、bash、subagent、workflow 处于同一层级。调用在进程内针对官方 @search1api/client SDK 运行。

工具

| 工具 | 由以下支持 | 状态 |
|------|-----------|--------|
| s1_search | Search1API.search() | ✅ |
| s1_news | Search1API.news() | ✅ |
| s1_crawl | Search1API.crawl() | ✅ |
| s1_sitemap | Search1API.sitemap() | ✅ |
| s1_trending | Search1API.trending() | ✅ |

尚未实现：s1_screenshot（需要 DSH 附件/图像支持）和 s1_deepcrawl（长轮询任务）。

DeepSeek Harness 中的 s1_crawl

技能

本包还捆绑了一个 s1 技能（ctx.skills.register），它教导模型如何选择正确的工具并调整参数——快速查找与深度研究、来源/时效性信号、中文查询的引擎选择，以及何时在搜索结果后跟进 s1_crawl。它随工具一起注册，并可通过 skill: false 独立禁用。

架构

@search1api/client  (official SDK, in-process)
│ import
dsh-s1              (Cordis plugin: name/inject/apply)
│ loaded by the s1-tools row in cordis.patch.yml
ctx.tools.register(defineTool({ name: "s1_search", ... }))
│
DSH model sees s1_search as a native tool

本包既是捆绑包（其 dsh.bundle.patch → cordis.patch.yml），也是插件（其主入口导出 name/inject/apply）。该补丁插入一行引用本包自身的加载器：

- insert:
- id: s1-tools
name: 'dsh-s1'

安装到 DSH 配置文件

首先发布（或 npm link / 本地路径）本包，然后：

dsh plugin --profile web add dsh-s1

对于本地检出，使用路径规范（插件命令会将相对路径锚定到你调用时的目录）：

cd /Volumes/More/Products/search1api/ecosystem/dsh-s1
npm run build                      # produce lib/index.js + lib/index.d.ts
cd ~/.dsh
dsh plugin --profile web add file:/Volumes/More/Products/search1api/ecosystem/dsh-s1

dsh plugin 会协调 dsh.profile.bundles：由于本包声明了 dsh.bundle.patch，它会自动追加到配置文件的捆绑包栈中。

身份验证

SDK 会延迟读取其密钥，因此缺少密钥会导致工具调用失败（而非插件激活失败）。凭据变量恰好有一个：

export S1_KEY=...

OAuth（路线图——尚未实现）
s1 的 API 对 API 密钥和 OAuth 访问令牌都接受 Authorization: Bearer ，因此传输层对令牌类型不敏感。OAuth 流程（浏览器登录、PKCE、令牌存储、刷新）目前仅存在于 search1api-cli（s1 login + auth.ts）中；@search1api/client 尚未暴露该流程。DSH 插件将通过复用或下沉该流程来支持 OAuth，而不是重新实现它——此项与本骨架分开跟踪。

配置

| 键 | 默认值 | 描述 |
|-----|---------|-------------|
| search | true | 注册 s1_search。 |
| news | true | 注册 s1_news。 |
| crawl | true | 注册 s1_crawl。 |
| sitemap | true | 注册 s1_sitemap。 |
| trending | true | 注册 s1_trending。 |
| skill | true | 注册捆绑的 s1 技能。 |

开发

npm install
npm run typecheck
npm run build