dsh-tavily

Readme

# dsh-tavily

中文 | [English](README.en.md)

[![awesome · DSH plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com) [![推荐 dshfind](https://img.shields.io/badge/%E6%8E%A8%E8%8D%90-dshfind-ffd700?labelColor=555555)](https://dshfind.com/zh/plugins/SZMY-haruhi/dsh-tavily?ref=badge)

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 Tavily 网页搜索。作为其网页搜索服务提供商。

## 安装

npm（稳定版，官方推荐）：

```sh
dsh plugin --profile web add dsh-tavily
```

也可以跟 GitHub（跟仓库最新提交）：

```sh
dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily
```

设置 → 插件 → 插件配置 → **Tavily 网页搜索**：打开开关即可。Key 可选，不填走无 Key。左下「连通测试」可确认现在能不能搜（无 Key 也测得通）。

**请更新到 0.3.1。** 0.3.0 在和其它客户端插件一起装时，可能让整个 Web 停在「Failed to load plugins」（设置卡按 list 槽注册，当前 DSH 要求 keyed `key`）。已修复。npm：

```sh
dsh plugin --profile web update dsh-tavily
```

GitHub 安装则再执行一次 `add github:SZMY-haruhi/dsh-tavily`。

<p align="center">
  <img src="docs/settings-zh.png" alt="Tavily 网页搜索设置：无 Key 时连通测试通过" width="560" />
</p>

钉 commit：

```sh
dsh plugin --profile web add github:SZMY-haruhi/dsh-tavily#<commit>
```

卸载：

```sh
dsh plugin --profile web remove dsh-tavily
```

> `dsh.bundle` · 预构建 `lib/` · git 安装无需 `allowBuilds`



## 特点

- 设置卡开关：关 = 官方 DeepSeek，开 = Tavily，不用卸包
- 无 Key 走 Tavily keyless；有 Key 走 `Authorization: Bearer`
- 左下连通测试：真打一次 Tavily（`max_results: 1`）；无 Key 走 keyless，有 Key 走账号档（消耗 1 积分）
- 超时、中止、官方 Host 锁定、丢掉无 url 的结果
- Key / 开关写在 credentials，不写设置文件



## 行为


| 开关    | Key | `web_search`   |
| ----- | --- | -------------- |
| 关（默认） | —   | 官方 DeepSeek    |
| 开     | 未填  | Tavily keyless |
| 开     | 已填  | Tavily 账号档     |


Provider id：`tavily`。

## 凭证


| 引用                      | 含义                   |
| ----------------------- | -------------------- |
| `TAVILY_API_KEY`        | 可选。有则走账号档；无则 keyless |
| `TAVILY_SEARCH_ENABLED` | 有此项则为开；删除即关          |


可写在 `$DSH_HOME/.credentials.yaml`。不要把真实钥匙提交进仓库。

## 更新

- **2026-08-17** **0.3.1（请更新）** 修复：与其它客户端插件同时安装时，Web 可能卡在「Failed to load plugins / dsh-tavily」（`settings.plugin.item` 需 `key`，不能再用 `id`/`order`）。设置卡命名空间 `web-search-tavily`，不覆盖官方网页搜索卡。开关与 Key 仍走 credentials。
- **2026-08-17** 设置卡左下增加连通测试。无 Key 也可测（走 Tavily keyless）；有已存 Key 则走账号档，消耗 1 积分。不改开关、不占用保存。

---



## Author

<a href="https://tonkatsu258.vercel.app/index.html">
  <img src="docs/avatar.png" width="96" height="96" alt="tonkatsu258" />
</a>

**感谢star❤️**
**[tonkatsu258](https://tonkatsu258.vercel.app/index.html)** · [个人网站](https://tonkatsu258.vercel.app/index.html)