前言¶

在 DeepSeek Harness（DSH）裏做需要實時信息的智能體會話時，模型常會調用 web_search。若沒有可用的搜索後端，這個工具要麼不出現，要麼無法返回結果。官方或第三方方案往往還要額外綁定 DeepSeek Key、Vibe 等組件。

dsh-mistral-search 是 Burntgogi 維護的社區插件，把 Harness 的 web_search 請求轉給 Mistral API 的內置聯網搜索能力，只消耗你配置的 Mistral API Key。下面介紹它的工作方式、安裝步驟、配置項，以及啓用前需要了解的安全與費用邊界。

這是什麼¶

• 名稱：dsh-mistral-search（npm 包名同插件 id）
• 維護者：Burntgogi（非 DeepSeek、非 Mistral 官方項目）
• 分類：聯網工具
• 許可證：MIT（見倉庫 LICENSE）
• 當前發佈版本：v0.1.2（package.json）；README 標明在 DSH 0.2.2-rc.1 上 verified

一句話：會話模型發起 web_search 時，Harness 把每條查詢經插件送到 Mistral；Mistral 側用其內置 web search 工具取回結果，再交給模型。沒有 Mistral Key 時，Harness 會對模型隱藏 web_search。

工作原理¶

Mistral 沒有單獨、且不經過模型的「純搜索 API」文檔。因此插件對每條搜索詞發起一次短對話，從返回裏提取內置 web search 工具找到的結果。

資料說明（2026 年 11 月觀測）：請求裏使用 store: false，要求 Mistral 不保留該對話；響應中的結果標註 source: brave，暗示查詢可能經 Brave Search，但 Mistral 未在公開文檔中寫明這一點。

一次調用裏 Harness 最多可帶 4 條查詢；插件失敗時最多再試一次（單次等待上限 12 秒，兩次嘗試間隔最多 5 秒，合計不超過 Harness 默認 30 秒工具超時）。若 Mistral 側用不同關鍵詞搜了，插件會保留結果並告知會話模型。

啓用後插件會把自身登記爲 searchProvider。若在 Harness 聯網設置裏改過該項，需要改回 dsh-mistral-search，否則可能出現 WEB_PROVIDER_CONFIGURED_MISSING。

核心功能（已文檔說明的部分）¶

1. 承接 web_search：作爲 DSH 的搜索提供方，對接 Mistral 內置聯網搜索。
2. 僅需 Mistral Key：密鑰存入 Harness 憑證庫或環境變量；不需要 DeepSeek Key，也不需要 Vibe 程序。
3. 可配置模型與端點：通過 cordis.patch.yml 可選設置 model、apiKeyEnv、baseURL（默認 mistral-small-latest、MISTRAL_VIBE_API_KEY、https://api.mistral.ai/v1）。
4. 安裝與移除：支持 Web 配置 web profile 的 CLI，以及 Desktop 應用內「Plugins → Add plugin」；移除命令見下文。

安裝與啓用¶

1、準備 Mistral API Key¶

將 Mistral Key 存入 Harness 憑證庫，名稱爲 MISTRAL_VIBE_API_KEY；或在啓動 Harness 前設爲同名環境變量。若要用別的變量名，在配置裏改 apiKeyEnv。沒有 Key 時，Harness 不會向模型暴露 web_search。

2、Web 環境¶

在 web profile 下執行倉庫 README 給出的安裝命令，然後重啓 Web 服務：

dsh plugin --profile web add github:Burntgogi/dsh-mistral-search#v0.1.2

3、Desktop 應用¶

在應用中打開 Plugins → Add plugin，填入下面地址；安裝完成後點 Enable now。Desktop 由應用管理 profile，不能使用 dsh plugin --profile desktop（會被拒絕）。

https://github.com/Burntgogi/dsh-mistral-search#v0.1.2

4、可選配置¶

在對應 profile 的 cordis.patch.yml 中寫入（字段均可選）：

- id: dsh-mistral-search
  name: dsh-mistral-search
  config:
    model: mistral-small-latest
    apiKeyEnv: MISTRAL_VIBE_API_KEY
    baseURL: https://api.mistral.ai/v1

README 記載：2026 年 11 月用 Vibe Key 測試時，mistral-small-latest 可用；deepseek-v4-1-flash-1017、ministral-3b-latest、ministral-14b-latest 返回 HTTP 400（code 3004）。部分模型不接受內置 web search，以你賬號下的模型卡爲準。

5、更新與移除¶

• 環境要求：DeepSeek Harness 0.2.2-rc.1 及以上；README 僅聲明在 0.2.2-rc.1 上 verified，更高版本需以 README 更新爲準。
• 更新：用帶新版本 tag 的地址再次 add。
• 移除（Web）：

dsh plugin --profile web remove dsh-mistral-search

Desktop 在 Plugins 界面刪除。移除插件會去掉它添加的 searchProvider pin；若你曾手動保存過該值，需自行清理。

典型用法¶

插件不提供單獨 CLI「搜一下」的入口，用法是：在 DSH 會話中讓模型使用 web_search（例如問需要最新網頁信息的問題）。Harness 把查詢交給本插件，插件請求 Mistral，再把結果（或阻斷提示、錯誤、一次重試後的結果）返回會話。

一次 web_search 調用最多 4 條查詢，每條單獨計費；重試會多一次 API 請求。README 中 2026 年 11 月小樣本：單次查詢約 800 input tokens、約 5 000–8 500 search result tokens、約 20–70 output tokens（未單獨測插件佔用的套餐份額）。

費用¶

Mistral 聯網搜索不免費，扣費遵循你組織在 Mistral 控制台中的套餐與 pay-as-you-go 設置；插件無法讀取這些設置。請在 Mistral 文檔 API keys 與 Subscriptions 自行覈對。開啓按量付費時，模型被誘導反覆搜索可能消耗 prepaid credits。

適用場景與注意¶

適合：已在用 DSH，手頭有 Mistral API Key，希望用 Mistral 側內置搜索完成 web_search，且接受 Mistral 作爲唯一搜索引擎（失敗不會 fallback 到其他引擎）。

不太適合：需要研究 prompt injection 等可能被 Mistral 攔截的主題（README 舉例若干查詢在 2026 年 11 月被 block）；需要與其他搜索後端熱切換且未正確配置 searchProvider 的場景。

安全（README 強調，啓用前建議通讀）：

• 網頁內容可能含 prompt injection；在全權限會話中風險最高，建議使用需審批的權限（如 workspace write），但這不能消除風險。
• 模型可能把工作內容寫進搜索詞，搜索詞會發往 Mistral；涉敏工作應關閉插件。
• 插件不限制搜索次數；按量付費時可能造成意外消耗。
• 懷疑 Key 泄露時，在 Mistral 控制台輪換 Key。

其他限制：

• 同一調用中一條查詢被攔截時，其餘查詢仍會執行；Harness 合併來源列表，可能出現標題與來源不一致。
• 結果優先取自 Mistral 未公開文檔的 info.result，缺失時回退 citation chunks；再缺失則報錯，不會當作「空結果」。
• 搜索卡片中的 HTML 可能以純文本顯示（插件透傳 Mistral 摘要）。

插件以當前 DSH 進程權限運行。安裝前應查看倉庫源碼與 MIT 許可證，自行判斷是否信任維護者與依賴（如 @deepseek-ai/schemastery）。

結尾¶

dsh-mistral-search 把 DSH 的 web_search 接到 Mistral 內置聯網搜索，配置路徑清晰：準備 MISTRAL_VIBE_API_KEY、按 profile 安裝 v0.1.2、必要時改 cordis.patch.yml。啓用聯網前務必閱讀 README 中的 Security 與 Cost 小節。

• 社區目錄頁：https://www.skillhub.cn/plugins/Burntgogi/dsh-mistral-search
• 源碼與完整說明：https://github.com/Burntgogi/dsh-mistral-search