前言¶
在 DeepSeek Harness（DSH）中，web 能力通過 ctx.web 暴露，agent 側通常繼續使用 web_search 工具。如果希望把搜索後端切換到 Microsoft Web IQ，又不想新增一個模型可見工具，@edwindigital/dsh-web-search-microsoft-webiq 提供了一個 provider 和配置卡片。
下面介紹這個插件的定位、核心功能、安裝命令和啓用方式。
這是什麼¶
@edwindigital/dsh-web-search-microsoft-webiq 是 EdwinDigital 維護的 DSH 插件，許可爲 MIT。它面向 harness 的 web capability（ctx.web）提供 Microsoft Web IQ-backed WebSearchProvider，調用 Web Search v3 REST endpoint，並把 query-relevant passages 映射爲 WebSearchResult，供 @deepseek-ai/dsh-tool-web 使用。
這個包有兩個部分：Host half 註冊 provider microsoft-webiq；browser half 在 Plugins 設置頁添加一個 package-local card。它不註冊 webiq_search 或其他 model-facing tool，agent 調用繼續使用現有的 web_search 工具。
它也不會靜默替換已有搜索 provider。只有在 Plugins 卡片中打開 Use Web IQ for web search，或顯式配置 web.searchProvider: microsoft-webiq 後，該 provider 纔會被選擇。
核心功能¶
- 爲
ctx.web提供名爲microsoft-webiq的 Microsoft Web IQ provider。 - 調用 Web Search v3 REST endpoint，並將 query-relevant passages 映射爲
WebSearchResult。 - 在 Plugins 設置頁提供配置卡片；卡片中的開關用於選擇 Web IQ。
- 不新增模型可見工具；agent 側繼續使用
web_search。 - 不自動替換已有 provider；選擇必須由卡片開關或配置項顯式完成。
安裝與啓用¶
安裝前先申請 key。Web IQ 目前對部分 Azure 客戶 limited access，key 不是 self-service；安裝前需要通過 waitlist 申請一個 key。如果沒有可解析的 key，provider 仍會註冊，但搜索會失敗並返回 WEB_PROVIDER_CREDENTIAL_MISSING。
該包不在 npm 上，列表頁也沒有 prebuilt tarball，因此安裝從源碼進行：
dsh plugin --profile web add github:EdwinDigital/dsh-web-search-microsoft-webiq
也可以在 dsh-market 中安裝：打開 Settings → Plugin Market，搜索 webiq，然後從 Browser & web 分類下的條目安裝。
啓用 provider 有兩種方式：
- 在 Plugins 卡片中選擇 Use Web IQ for web search。
- 顯式配置：
web:
searchProvider: microsoft-webiq
如果之前安裝過舊包名 @deepseek-ai/dsh-web-search-microsoft-webiq，需要先移除舊包，再安裝新包，然後重啓運行中的 server：
dsh plugin --profile web remove @deepseek-ai/dsh-web-search-microsoft-webiq
dsh plugin --profile web add github:EdwinDigital/dsh-web-search-microsoft-webiq
典型用法¶
下面是一組可重複的操作：
- 確認已經擁有可用於 Web IQ 的 key。
- 安裝插件包。
- 在 Plugins 卡片中選擇 Web IQ，或寫入
web.searchProvider: microsoft-webiq。 - 讓 agent 按原有方式調用
web_search。 - 如果搜索返回
WEB_PROVIDER_CREDENTIAL_MISSING，檢查 key 是否可解析。
卡片中的密碼字段在加載後和保存成功後都會保持空白；卡片只報告 key 已存儲。看到 WEB_PROVIDER_CREDENTIAL_MISSING 時，問題通常是 key 無法解析，而不是 provider 沒有註冊。
適用場景與注意¶
這個插件適合需要在 DSH 的 web 能力中使用 Microsoft Web IQ，同時希望保留 web_search 工具不變的開發者。它不改變 agent 側工具名，只替換搜索 provider 的後端。
注意：
- 插件以當前 dsh 進程權限運行。安裝前應檢查源碼與 MIT 許可證。
- Web IQ 不是自助 key 服務；安裝前需通過 waitlist 申請 key。
- 沒有可解析 key 時，provider 會註冊，但搜索會失敗。
- 它不會靜默替換已有 provider；選擇需要卡片開關或配置項。
- peer harness dependencies 是 optional；在 profile 中執行
pnpm peers check時可能會報告它們 missing。這可以理解爲預期狀態，真正有意義的加載信號是 dsh boot。
鏈接¶
目錄頁：https://www.skillhub.cn/plugins/EdwinDigital/dsh-web-search-microsoft-webiq
GitHub：https://github.com/EdwinDigital/dsh-web-search-microsoft-webiq
