前言¶
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 的搜索能力。
