前言¶

DeepSeek Harness (DSH) 的内置 web_search 工具通常通过 Anthropic 兼容端点 (web-search-deepseek) 运行，这会消耗 LLM 轮次。dsh-tinyfish-search 插件旨在解决这个问题，它通过 TinyFish Search API 接管 web_search，将请求转换为普通的 GET 请求，且不消耗模型调用。

插件定位¶

dsh-tinyfish-search 是 TinyFish 后端 web 搜索提供者。它由 maxwell-feng 维护，旨在解决 web_search 工具依赖 LLM 轮次的问题，提供更直接、无消耗的搜索能力。

核心能力¶

• Provider ID: 注册为 tinyfish。
• 请求方式: 每次搜索调用转换为 GET https://api.search.tinyfish.ai?query=...，并在 Header 中携带 X-API-Key。
• 结果标准化: 返回的 results[] (title / snippet / url / date) 被归一化为 seam 的便携源形状 WebSearchSource[]。
• 无消耗: 每次搜索不消耗 LLM 轮次。

安装与启用¶

安装该插件会自动接管内置的 web_search 工具。使用以下命令安装：

dsh plugin --profile web add dsh-tinyfish-search

安装后，插件会自动启用宿主级别的 tool-web 行，使 web_search 工具对所有配置文件中的 agent preset 可见。

注意事项¶

• 作用域说明: 重新启用 tool-web 行会让工具对所有 agent preset 可见（包括默认不携带 web 工具的预设，如 minimal）。如果某个 preset 单独挂载了 tool-web 行，该行的配置会覆盖全局注册。
• 兼容性检查: DeepSeek Harness 0.2.0-rc.2 会在加载插件前验证 peerDependencies。如果版本不匹配，DSH 会拒绝加载并提供诊断信息。
• 异常处理: 如果运行环境不在声明的依赖范围内，DSH 会拒绝该行并打印具体版本对。若需显式接受风险，需运行：

    dsh plugin allow-version dsh-tinyfish-search@0.14.0 --dsh-version <your-dsh-version> --accept-risk

• 定价: TinyFish Search 在任何钱包余额下均免费。

结语¶

该插件通过直接对接 TinyFish Search API，实现了零 LLM 成本的网页搜索。开发者无需修改代码，即可通过配置 API Key 启用该能力。更多详情可参考 GitHub 仓库。