前言¶

在 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