DeepSeek Harness Web Search Plugin：源可追溯的 Brave / Tavily 搜索与提取

前言¶

DeepSeek Harness 的原生模型搜索能力在信息发现阶段很有用，但研究工作流通常需要稳定的工具契约和可检查的源轨迹。本插件将源可追溯的 Brave + Tavily 实时网络搜索和 URL 提取打包为 DeepSeek Harness 的原生插件。它通过返回提供者、域名、排名、访问时间、源日志、提取哈希和可见的降级通知，而不是隐藏提供者路由，来提供透明的搜索体验。

核心功能¶

插件在 web profile 中安装一个原生 Harness bundle，提供以下工具：

• web_search：路由 Brave/Tavily 实时搜索。
• web_extract：使用 Tavily 进行干净的 URL 提取。
• provider_status：本地、密钥安全的配置检查（不发起提供商请求）。
• health_check：显式探针 auth、配额、速率限制、超时。
• MCP bundle：捆绑 mcp-cctb-search。
• TaroCub：可选集成。

安装与配置¶

1. 确保已安装 DeepSeek Harness dsh，并激活 web profile。
2. 安装插件：

    dsh plugin --profile web add github:cloveric/deepseek-harness-web-search-plugin

3. 重启 Harness。
4. 在启动 Harness 的环境变量中设置 API 密钥：

    export BRAVE_API_KEY="..."
    export TAVILY_API_KEY="..."

注意：`BRAVE_SEARCH_API_KEY` 也可以作为 `BRAVE_API_KEY` 的别名使用。插件不会将密钥写入 Harness profile。

使用示例¶

1. 启动 web profile：

    dsh web

2. 在 Harness 会话中，调用状态检查（不消耗配额）：

    mcp__cctb_search__provider_status

3. 进行健康检查（显式探针）：

    mcp__cctb_search__health_check

可用的 MCP 工具包括：
*   `mcp__cctb_search__web_search`
*   `mcp__cctb_search__web_extract`
*   `mcp__cctb_search__provider_status`
*   `mcp__cctb_search__health_check`

安全与限制¶

• 密钥仅在环境变量中读取，从不写入 Harness profile，也不从 provider_status 返回。
• web_extract 仅接受 HTTP(S) URL。
• 项目采用 MIT 许可证。

结尾¶

本插件通过将实时搜索能力整合到 DSH 生态系统中，为需要可靠和可追溯信息的研究工作流提供了支持。源代码和文档可在 GitHub 上获取。