前言¶
DeepSeek Harness 的 ctx.web 模块需要一个搜索提供商。如果你需要接入 Synthetic Search，这个插件提供了注册 provider 并将响应映射到 Harness 词汇表的功能。它属于 Host-plane 插件，需要配合现有的 @deepseek-ai/dsh-tool-web 工具使用。
这是什么¶
这是一个基于 Synthetic Search 的 WebSearchProvider 和配置卡片。插件维护者为 auggie246。它将 synthetic provider 注册到 Harness 的 web 服务中，不直接提供模型侧工具，而是作为后端支撑。
核心功能¶
- 注册服务：将 synthetic provider 注册到 web 服务。
- 响应映射：将 Synthetic 的搜索响应字段映射到 Harness 的词汇表。
- 凭据管理：支持通过设置卡片或
SYNTHETIC_API_KEY环境变量配置 API Key。 - 兼容性：与
@deepseek-ai/dsh-tool-web完全兼容。
安装与启用¶
在安装前，请确保环境满足以下要求：
- DeepSeek Harness 版本：0.1.1-rc.2, 0.1.2-rc.1, 0.1.5-rc.2, 或 0.1.7-rc.2（需包含 web profile）。
- Node.js 版本：22.12 或更新。
执行以下命令安装插件到 web profile：
dsh plugin --profile web add @auggieteo/dsh-synthetic-web-search
安装完成后，该插件会自动将 web.searchProvider 切换为 synthetic，并替换默认的 deepseek-official 选择。安装后需要重启 DSH web profile 以使配置生效。
典型用法¶
配置凭据¶
插件提供两种配置方式：
- 界面配置：在 DSH 设置中进入“插件配置”，找到“Synthetic web search”，输入 API Key 并保存。
- 环境变量：在启动环境变量中设置
SYNTHETIC_API_KEY。
请求映射¶
插件会将 Synthetic API 的响应字段映射到 Harness 词汇表，对应关系如下：
| Synthetic 字段 | Harness 字段 |
|---|---|
url |
url |
title |
title |
text |
snippet |
published |
publishedAt |
插件会忽略非 URL 条目和无效结果。
适用场景与注意¶
- 运行环境：这是 Host-plane 插件，不提供模型侧工具，必须在 DSH 进程权限范围内运行。建议在安装前检查源码。
- 版本限制：仅支持特定版本的 DeepSeek Harness 和 Node.js。
- 许可证：MIT 许可证。
- 行为：安装后会自动接管搜索 provider，如需切换回其他 provider，需使用更高优先级的 profile 或
--patch覆盖。
总结¶
该插件解决了 DeepSeek Harness 在 ctx.web 调用 Synthetic Search 时的 provider 注册与响应适配问题。通过简单的配置，开发者即可在 DSH 中使用 Synthetic 的搜索能力。
