前言¶
DeepSeek Harness (dsh) 通过 web_search 工具为模型提供联网能力，后端选择通过 ctx.web 接口决定。默认情况下，搜索行为可能依赖内置端点。vincibeans/dsh-web-search-anysearch 插件为 dsh 注册了一个名为 anysearch 的 WebSearchProvider。当选择该后端时，它会调用 POST https://api.anysearch.com/v1/search；当未选择时，它会委托给官方 DeepSeek 搜索端点。该插件允许用户直接在 dsh 的插件设置卡片中切换这两个后端，并支持通过环境变量或 YAML 配置文件进行管理。
安装¶
使用官方命令将插件添加到 web 配置文件中：
dsh plugin --profile web add @wenqi_bian/dsh-web-search-anysearch@alpha
安装完成后，需要重启 dsh web，因为 profile bundles 和浏览器端在启动时读取。如需在重启前检查配置树，可使用：
dsh --profile web --dump-config
使用方法¶
安装并重启后，可以通过以下方式启用或切换搜索后端：
- 打开 Settings -> Plugins ->
@wenqi_bian/dsh-web-search-anysearch。 - 在开关中选择 AnySearch 或 official DeepSeek search。
- 保存设置。下次
web_search调用将使用所选的后端，无需重启进程。
其他配置方式¶
除了 GUI 操作，还支持以下方式：
* 环境变量：设置 DSH_WEB_SEARCH_PROVIDER=anysearch 后启动 dsh。
* YAML 补丁：在 profiles/web/cordis.patch.yml 中配置 searchProvider 为 anysearch。
AnySearch 支持匿名访问。若需提高速率限制，可在设置卡中填写 API key，它会存储在凭证域中；或者手动在 ANYSEARCH_API_KEY 引用下配置。
配置项说明¶
插件提供以下配置项（默认值）：
| 配置键 | 控制项 | 默认值 | 说明 |
|---|---|---|---|
searchProvider |
后端切换 | anysearch |
决定下一次 web_search 的后端，可选 anysearch 或 deepseek-official。 |
apiKeyEnv |
API key 字段 | ANYSEARCH_API_KEY |
卡片存储密钥的引用名称，每次搜索时解析。 |
apiKey |
unset | 手动写入配置的密钥，优先级高于环境变量引用。 | |
baseURL |
端点字段 | https://api.anysearch.com |
AnySearch 基础地址，/v1/search 会自动拼接。 |
凭证域的解析顺序为：$DSH_HOME/.credentials.yaml -> $DSH_HOME/.env -> 继承的环境变量。若两个字段都未设置，则进行匿名搜索。
限制与注意事项¶
- 版本要求：需要 dsh >= v0.1.5-alpha.1。
- 搜索范围：仅支持一般搜索，不支持垂直领域（如
finance.quote）。 - 官方后端：切换回官方后端时，需要配置
DEEPSEEK_API_KEY或使用 DeepSeek 账号登录（dsh 0.2.0 及以后）。 - API Key 安全：API key 字段为只写，已存储的密钥不会在界面上回显。移除密钥需在凭证存储中手动处理。
- 数据信任：查询结果发送至
https://api.anysearch.com或配置的端点，请将搜索结果视为不可信的外部数据。 - GUI 显示：插件配置页仅在 Web GUI 组合浏览器端且 bundle 列入 profile 时显示；Headless 配置文件模式下功能完整。
