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 上獲取。