前言¶

DeepSeek Harness (DSH) 的 ctx.web 接口通過 WebSearchProvider 實現聯網搜索。現有的第一方 Exa 提供者無法啓用 Exa Dynamic Highlights，原因在於請求體被硬編碼且缺少必需的 Exa-Beta 請求頭。qp-exa-dynamic 插件填補了這一空白，爲 DSH 提供了完整的 Exa 支持，默認開啓動態高亮，並允許在運行時調整搜索策略。

功能¶

該插件是一個 Exa-backed WebSearchProvider，提供以下能力：
* Exa Dynamic Highlights：默認開啓。不同於簡單的截斷，它會根據文檔的相關性分配上下文預算。
* 運行時配置：通過 /exa 命令，可以在不重啓進程的情況下調整高亮開關、檢索類型和結果數量。
* exa_search 工具：插件註冊了一個獨立的模型工具 exa_search，其結果上限爲 1-50，不受 ctx.web 默認上限的限制。
* 檢索類型：支持 keyword、neural、fast、instant、auto 等類型。

安裝¶

使用官方安裝命令添加插件：

dsh plugin --profile web add qp-exa-dynamic

配置¶

1. 覆蓋 Provider：安裝後，需要在 profiles/web/cordis.patch.yml 中覆蓋 web 配置以選擇此提供者：

- id: web
  name: '@deepseek-ai/dsh-web'
  config:
    searchProvider: exa
    fetchProvider: http

2. 提供 API Key：通過環境變量 EXA_API_KEY 或插件配置文件直接提供。插件默認讀取 apiKeyEnv（默認值爲 EXA_API_KEY）。

用法¶

• 命令行：在 DSH 的 composer 中輸入 /exa 可查看或切換狀態。例如：
  • /exa type deep：設置檢索類型爲 semantic。
  • /exa results 3：設置結果數量爲 3。
• 工具調用：在模型側可以直接調用 exa_search 工具：

    exa_search(query, maxResults: 20)

注意¶

• dynamicHighlights 和 highlightsMaxCharacters 是互斥的。
• 插件版本爲 0.1.0，許可證爲 MIT。

結尾¶

該插件通過修復第一方提供者的限制，使 DSH 能夠利用 Exa 的動態高亮和高級檢索能力，並通過工具接口給予模型更靈活的調用能力。