nitrazepam01/dsh-web-search-tavily

dsh-web-search-tavily

一个由 Tavily 支持的搜索提供程序捆绑包，用于 DeepSeek Harness（dsh）。它为 ctx.web 网络搜索接缝注册了一个 Tavily 后端，并附带一个可热切换的后端选择器（Tavily / DeepSeek 搜索）。

功能特性

- Tavily 提供程序 — 调用 POST /search 并将结果规范化为 { url, title, snippet, publishedAt }。Tavily 返回内容摘录，因此模型可以直接引用片段。
- 热后端切换器 — 一个委托提供程序（search-switch）位于 web 行之后，并在每次搜索时从 web-search 设置部分解析当前活动的后端。保存该部分立即生效：无需重启，无需重新加载 loader 行。
- 完整的 WebError 分类（WEB_PROVIDER_ERROR / WEB_PROVIDER_CREDENTIAL_MISSING / WEB_ABORTED）。
- 凭据解析链：字面量 apiKey → credentials 服务 → 启动环境。
- 设置部分：
- web-search-tavily — apiKey / apiKeyEnv / baseURL / maxResults
- web-search — backend 选择（tavily | deepseek-official）

安装

从 git 安装（推荐 — 纯 JS，无需构建步骤，无需 allowBuilds）
dsh plugin --profile web add github:nitrazepam01/dsh-web-search-tavily

从 npm 安装
dsh plugin --profile web add dsh-web-search-tavily

从本地检出安装
dsh plugin --profile web add ./dsh-web-search-tavily

安装后重启 dsh web（捆绑包层在启动时冻结）。卸载：dsh plugin --profile web remove dsh-web-search-tavily。

配置

1. 凭据

将你的 Tavily 密钥存储在 $DSH_HOME/.credentials.yaml 中：

TAVILY_API_KEY: tvly-your-key

2. 后端选择

web 行的 searchProvider 由此捆绑包设置为 search-switch（委托提供程序）。当前活动的后端位于 $DSH_HOME/settings.yaml 的 web-search 部分，并且保存时热重载：

web-search:
backend: tavily            # tavily | deepseek-official

- tavily — 本插件的 Tavily 提供程序（结果带有内容摘录）
- deepseek-official — 委托给随附的 web-search-deepseek 提供程序（DeepSeek Anthropic 兼容的 Messages 端点；无摘录）

3. Tavily 选项（web-search-tavily 部分）

| 字段 | 默认值 | 描述 |
|---|---|---|
| apiKey | 无 | 字面量密钥（机密，通过凭据域存储） |
| apiKeyEnv | TAVILY_API_KEY | 凭据引用名称 |
| baseURL | https://api.tavily.com | Tavily REST 端点 |
| maxResults | 5 | 每次搜索的最大结果数 |

工作原理

web_search tool → ctx.web (searchProvider: search-switch)
→ switcher delegates by web-search.backend:
tavily            → this plugin's provider → POST https://api.tavily.com/search
deepseek-official → shipped provider       → Anthropic Messages + web_search_20250305
为什么使用委托提供程序，而不是直接编辑 web 行？修改 web 行的配置会重启 dsh-web 插件并销毁所有已注册的提供程序（Cordis 的 Fiber.update → restart 语义）。切换器仅将选择保留在设置层，从而完全避开这一风险。

开发

Install a local checkout into a profile
dsh plugin --profile web add ./dsh-web-search-tavily

Inspect the composed config without booting
dsh --profile web --dump-config

dsh web

许可证

MIT