前言¶
在 DeepSeek Harness（DSH）里做日常对话和智能体开发时，模型接入往往要自己做一层：API Key 怎么存、模型列表怎么维护、订阅额度怎么看见、多个 Key 出问题时怎么切。若你已经有 Mistral 的 Vibe Pro 或 Team 订阅，官方聊天端和通用 OpenAI 兼容客户端都能用，但 DSH 的插件化 llm 路由、凭据托管和输入框工具栏并不会自动接上 Mistral。
下面介绍社区插件 dsh-mistral-pro（维护者 01NGVI-QINGYI）：它在 DSH 内注册 mistral-pro 提供方，把请求转到 https://api.mistral.ai/v1/chat/completions，并附带多账号故障切换、模型目录管理和输入框侧的额度面板。
这是什么¶
dsh-mistral-pro 归类为模型推理插件。当前版本 0.1.2，许可证 MIT。它解决三件事：
- 用 DSH 凭据系统保存 API Key（可选管理站 Cookie 兜底读额度），在设置页完成账号与模型配置。
- 对话经插件适配器转为 OpenAI 兼容格式，流式解析 SSE，并按要求还原历史消息中的 reasoning / thinking 块。
- 在输入框工具栏增加
● Mistral入口，展示订阅与账单相关额度；多账号按列表优先级调用，流式开始前可自动容灾。
插件以当前 DSH 进程的权限运行。安装前应自行审阅 GitHub 仓库 源码与许可证；社区目录页见 SkillHub（独立站点，与 DeepSeek / 幻方无官方从属关系）。
环境与安装¶
环境要求（来自 README）：
- DSH
>= 0.2.1-rc.5 - Node
^22.19.0 || >=24.0.0
推荐在插件目录打包成 tarball 后安装：
npm pack
dsh plugin --profile desktop add /absolute/path/to/dsh-mistral-pro-0.1.0.tgz
本地开发也可直接挂载目录（会创建符号链接；仓库内预置了指向当前 profile 共享依赖的 node_modules/@deepseek-ai/* 软链，打包 tarball 时不包含）：
dsh plugin --profile desktop add /absolute/path/to/dsh-mistral-pro
安装后到 DSH 插件 页面启用 dsh-mistral-pro，刷新页面即可。
添加账号与验证¶
打开 设置 → Mistral Pro → 账号：
- 点击「添加账号」，填写名称（仅用于展示和排序）。
- 「凭据引用」填环境变量名，例如
MISTRAL_API_KEY。 - 在密码框粘贴 API Key，点击「设置 Key」。Key 写入 DSH 凭据存储，前端不回显。
- 点击「测试」，调用一次
/v1/models验证连通性。
API Key 可在 Mistral Code › Vibe CLI 页面创建。同一 Key 可用于免费档、订阅套餐和按量付费；调用时优先扣套餐内月度额度，用尽后再按量计费。
配置多个账号时按列表顺序调用，可用 ↑ / ↓ 调整优先级；第一位且已启用的为主账号。容灾切换后，可用账号会在当前进程内临时提为首选，不改写配置文件；进程重启后恢复为配置顺序。
模型目录与选择¶
在 设置 → Mistral Pro → 模型 中，插件合并展示内置模型列表与 /v1/models 返回值。可取消「显示」以从选择器隐藏；上下文窗口、最大输出长度和默认 reasoning_effort（思考强度）可按模型单独设置。
有 Key 时以 /v1/models 为准，同一模型的别名会合并。README 中列出的内置示例包括 mistral-large-4（上下文 1M，思考强度 low / medium / high）、mistral-small-2603、mistral-medium-3-5、zai-glm-5-3 系列、deepseek-v4-1-flash-1017、ministral-3-*、codestral-25-08 等；mistral-large-2512、devstral-2512、mistral-medium-2508 默认隐藏，需要时可在列表中开启。
额度面板¶
输入框工具栏右侧（OpenCode Go 胶囊旁）会出现 ● Mistral 按钮。点击可查看：
- 各周期额度的使用比例、已用 / 总量及重置倒计时；
- 预付余额与当月 API 账单消耗；
- 手动刷新与上次更新时间。
按钮默认展示第一个匹配 Vibe、monthly 或 plan 的额度窗口。页面在后台时暂停轮询，回到前台立即刷新。
额度数据优先来自 api.mistral.ai/v1/billing/budget，使用已保存的 API Key，无需额外配置。若 Key 无 usage 权限（账单接口 403），可在 设置 → Mistral Pro → 高级设置 粘贴 Mistral Admin 的完整 Cookie（需含 ory_session_*；含 csrftoken 时插件会自动附带 X-CSRFTOKEN）。Cookie 路径会请求管理站点的订阅与账单接口；单个接口失败不影响其余展示。
请求路径与容灾规则¶
llm 服务将对话交给插件后，POST 到 Mistral 的 chat completions 端点，逐行解析 SSE 为 DSH 的 StreamChunk。
多账号切换仅在流式输出开始前触发：
- 401 / 403、429、额度耗尽、Key 缺失或格式错误时，自动尝试下一个账号；原账号默认冷却 300 秒（可在高级设置中调整）。
- 一旦已产出正文、思考内容或工具调用，报错时直接中止，不再中途换号，避免两个账号的回复拼接。
高级设置中还有自动容灾开关、超时、目录刷新、输出上限、代理、按钮显示模式、刷新间隔等项；改动后立即生效，无需重启插件。
调试与隐私¶
插件注册同源只读路由，便于排查，例如：
| 路由 | 说明 |
|---|---|
/plugins/dsh-mistral-pro/health |
账号就绪、provider、模型数量 |
/plugins/dsh-mistral-pro/usage?account=&force=1 |
聚合额度快照 |
/plugins/dsh-mistral-pro/test?account= |
指定账号测 /v1/models |
对话内容仅发往你配置的 Mistral API 端点；拉模型目录只带 API Key 与 User-Agent；额度查询在 Key 不足时走你填入 Cookie 对应的管理站点。Key 与 Cookie 保存在宿主凭据系统中。
已知限制包括：账单相关接口无公开文档，上游字段变更可能导致部分窗口无法识别；图片输入依赖 DSH 的 attachments 服务；代理功能要求宿主可解析 undici。
适用场景¶
适合已在 DSH 桌面 profile 中开发、并持有 Mistral Vibe Pro / Team（或可用 API Key）的开发者：希望模型选择器里稳定出现 Mistral 目录、需要多 Key 冷备、希望在写提示词时顺便看一眼订阅额度。
若你只用单一 Key、不关心额度面板，最小路径仍是：安装启用 → 添加一个账号并测试 → 在模型页按需打开显示项 → 在对话里选用对应模型。
结尾¶
dsh-mistral-pro 把 Mistral 订阅接入 DSH 的 llm 与设置体系：路由、凭据、模型元数据、容灾和额度展示放在同一套插件里完成，减少自行拼 OpenAI 兼容客户端和维护脚本的成本。
- 目录页：https://www.skillhub.cn/plugins/01NGVI-QINGYI/dsh-mistral-pro
- 源码与文档：https://github.com/01NGVI-QINGYI/dsh-mistral-pro
