dsh-keyless-search

English | 中文

为 DeepSeek Harness 提供免密钥的网页搜索。

它让内置的 web_search 工具在 无需 API Key、无需账号、无需任何配置 的情况下直接可用。dsh-base 默认把该能力接口指向 DeepSeek 自托管的搜索提供方，需要 DEEPSEEK_API_KEY；没有这个 Key 时，web_search 会报错：

DeepSeek search has no API key for "DEEPSEEK_API_KEY"

本 bundle 注册一个免密钥的提供方，并把接口重新指向它。

安装

dsh plugin --profile <your-profile> add dsh-keyless-search

这就是全部安装步骤。本包声明了 dsh.bundle，因此 dsh plugin add 会把它追加到 dsh.profile.bundles 中——位置在 @deepseek-ai/dsh-base 之后，这正是它覆盖 web 那一行能生效的原因。不需要手改任何 YAML。 新开一个会话即可验证：提供方会在会话启动、工具列表组装时注册。

卸载：

dsh plugin --profile <your-profile> remove dsh-keyless-search

后端

按顺序尝试，第一个返回非空结果的后端即被采用。

为什么 Bing 后端默认关闭

这两个后端请求的是 Bing 的搜索结果端点，而 Bing 的 robots.txt 对 User-agent: * 明确禁止了 /search：

User-agent: *
Disallow: /search
Disallow: /Search

RSS 版本只是同一路径加上 ?format=rss，因此受同一条规则约束。它确实是这里最稳的解析方式——结构化 feed，没有会变动的页面结构——这也是它仍被保留的原因。但把一个搜索引擎抓取器作为默认行为发布，等于在用户不知情的情况下，让每个人的流量都参与了这个决定。所以它被设为手动开启，启用它应当被视为对该取舍深思熟虑后的选择。

相比之下，tavily 与 firecrawl 是厂商官方文档化的免密钥服务。Tavily 的 keyless 页面 写明「No account, no API key, no configuration」，并说明免密钥响应与带密钥响应的 schema 完全一致。这两个后端都不抓取任何人的搜索结果页。

配置

所有配置项均为可选。

# 写在某个 profile 的 cordis.patch.yml 里，用于覆盖 bundle 的默认值：
- id: keyless-search
  name: dsh-keyless-search
  config:
    searchBackends: tavily,firecrawl
    timeoutMs: 15000
    debug: false
    bingHost: cn.bing.com
    bingMarket: zh-CN

环境变量覆盖：KEYLESS_SEARCH_BACKENDS、KEYLESS_SEARCH_TIMEOUT_MS、 KEYLESS_SEARCH_DEBUG=1。

之后想加 Key

两家厂商官方文档化的升级路径都无需改动配置。设置 TAVILY_API_KEY 或 FIRECRAWL_API_KEY，提供方会自动携带——这些免费 Key 能提高限额（Tavily：每月 1,000 credits，无需信用卡）。当 Tavily 存在 Key 时，x-tavily-access-mode: keyless 提示会被省略，因为带密钥的请求不应携带它。

行为特性

• 失败时如实报错。 若所有后端都失败，提供方会抛出携带每个后端具体原因的异常，而不是返回一个「空成功」，因此限流或厂商侧变更都是可见的，不会静默。传输层错误会从 cause 中解出真实原因，DNS 错误、TLS 拒绝、超时不再一律显示为 fetch failed。
• 可归因。 开启 debug: true 后，每次查询都会记录是哪个后端服务了它。
• 限流是真实存在的。 免密钥通道免费但按设计有限流。「降级链 + 一个 Key」才是预期做法，而不是绕过手段。
• 零依赖。 本模块没有任何静态 import，因此即使所在 profile 解析不到任何 harness 包也能加载。唯一的运行时 import 是用于获取错误类的 @deepseek-ai/dsh-web，并带有形状兼容的兜底实现。

作用范围

本 bundle 只注册搜索提供方。它不触碰 web_fetch，也不提供任何抓取提供方。

如果你机器上的 web_fetch 报 resolves to a non-public IP address，那是你本地网络环境的另一个独立问题，解法是配置而非代码——见下。

const route = proxyRouteFor(url);
if (route.proxied && !isNonPublicIpLiteral(url.hostname))
  return await publicHttpNetwork.requestVia(route.dispatcher, url, headers, signal);
const addresses = await this.resolveAddresses(url.hostname, signal); // 代理路径会跳过这一步

# ~/.dsh/.env —— 请改成你自己本地代理的地址与端口
HTTP_PROXY=http://127.0.0.1:7897
HTTPS_PROXY=http://127.0.0.1:7897

环境要求

• Node ≥ 18（需要 fetch、AbortSignal.any、AbortSignal.timeout）
• 一个组合了 @deepseek-ai/dsh-base 的 DSH profile

许可证

MIT