前言¶
在 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
