前言¶
DeepSeek Harness（DSH）采用插件化架构，智能体在调用 web_search 工具时需要配置相应的搜索后端。本插件旨在解决这一配置成本，它复用 WorkBuddy 桌面 App 的登录态，将云端 agentic 检索能力接入 DSH 的 web_search 工具。用户无需申请 API Key，也不需要安装其他 DSH 插件即可直接使用搜索功能。
核心功能¶
本插件通过以下方式实现零配置接入：
* 复用登录态：直接使用 WorkBuddy 桌面端的登录状态，无需额外的 API Key。
* 云端检索：调用 WorkBuddy 的云端 agentic 检索服务。
* 带引用综述：返回包含引用来源的综述文本，便于核查。
* 零硬依赖：纯 ESM 模块，无构建步骤，不依赖其他 DSH 插件即可完整工作。
* 安全设计：对凭据文件只读，token 续期仅在内存中完成，不回写磁盘，避免与其他插件冲突。
安装与启用¶
在安装前，请确保满足以下前置条件：
* 已安装并登录 WorkBuddy 桌面 App（国内版或国际版）。
* Node.js 版本 >= 20。
执行以下命令完成安装：
dsh plugin --profile web add dsh-workbuddy-websearch
安装完成后，重启 DSH 即可生效。重启后，模型在调用 web_search 时将自动走 WorkBuddy 的搜索接口。
典型用法¶
安装并重启 DSH 后，无需任何额外操作，直接在对话中发起搜索请求即可：
dsh --profile web "帮我搜一下最近的 XX 进展"
安装成功后，可以通过以下命令核验配置是否生效：
dsh --profile web --dump-config | grep -i workbuddy-websearch
适用场景与注意¶
本插件主要适用于需要快速接入联网搜索能力的 Windows/macOS 开发者。
功能限制¶
- 仅支持搜索：本插件仅提供
web_search（联网搜索）功能，不提供web_fetch（抓取指定 URL）功能。 - 平台限制：
- Windows x64（稳定）。
- macOS（实验性）。
- 不支持：32 位 Windows、Linux、WSL、鸿蒙。
插件冲突¶
- 注册 ID 唯一性：同一个搜索 provider id 只能有一个插件注册。本插件注册的 ID 为
workbuddy-agentic。若同时安装了注册了相同 ID 的其他插件（如旧版本或 fork 版本），只有其中一个会生效，另一个会静默不激活。
短结尾¶
该插件通过复用 WorkBuddy 桌面端的现有资源，为 DSH 提供了无需额外配置的联网搜索能力。适合希望在现有工作流中快速增加搜索功能的用户。
