前言¶
在 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
