前言¶
DeepSeek Harness (DSH) 的 llm-pi-ai provider 允許用戶手動添加自定義供應方，但默認狀態下，這些自定義渠道缺失了部分官方渠道纔有的能力，例如 User-Agent 控制、推理等級切換和圖片輸入聲明。
dsh-provider-pro 是一個由 Mortal520 維護的插件，它爲這些手動添加的供應方補上了上述能力。它通過數據層的自動補全和運行時的配置覆蓋，實現了零逐模型配置的開箱即用體驗。
核心功能¶
本插件主要提供以下四種能力：
- 自定義 User-Agent
爲每個自定義供應方設置請求 UA。這會覆蓋 DSH 內置的 attribution 頭，可用於應對按 UA 限流的供應方，或禁止非官方終端訪問的策略。 - 推理等級切換
在對話模型選擇器中提供與官方渠道相同的下拉菜單（off/low/medium/high/max）。數據層會自動爲缺少reasoningEfforts的自定義模型補全五檔詞典，無需手動配置。 - 圖片輸入聲明
在模型卡片中提供“支持圖片輸入”複選框。勾選後，插件會將input: [text, image]寫入模型配置，使 DSH 允許向該模型附加圖片。 - 一鍵全量探測與測活
提供內置的探測功能，針對每個模型進行三項實測：- 上下文窗口：拉取並回填
contextWindow/maxTokens。 - 角色兼容：測試
developer角色兼容性，若被拒且system可用，自動修復。 - 圖片輸入與延遲：發送真實流式請求驗證圖片接受情況及首 token 延遲。
- 上下文窗口：拉取並回填
安裝與啓用¶
插件需要 DSH Desktop 2.0.15+ 環境運行。
使用以下命令安裝（需指定 --profile desktop）：
dsh plugin --profile desktop add github:Mortal520/dsh-provider-pro
如果上述命令因構建權限問題失敗，也可以直接使用倉庫內已提交的構建產物：
# 本地倉庫方式
dsh plugin --profile desktop add ./dsh-provider-pro
# tarball 方式（需先 pnpm pack）
dsh plugin --profile desktop add ./dsh-provider-pro-0.6.1.tgz
安裝完成後，必須重啓 DSH Desktop 應用 才能使插件生效。
使用方法¶
安裝後，在 DSH 的「設置」頁面中找到「模型增強」部分（通常位於「模型」下方）。
- 開啓總開關：
找到“爲全部自定義模型啓用推理等級切換”開關並打開。關閉後，自動補全的檔位會被移除。 - 配置 User-Agent：
爲每個供應方填寫 User-Agent 並保存。留空保存即清除覆蓋。 - 聲明圖片輸入：
在模型卡片中勾選“支持圖片輸入”複選框。 - 實測：
點擊模型旁的“探測”按鈕，進行全量測活。
注意事項¶
- 環境要求：必須使用 DSH Desktop 2.0.15+（對應 dsh-* 0.1.7-rc.2 版本）。舊版設置模型（settings.yaml 退役）將無法使用。
- UI 語言限制：對話模型選擇器內部的檔位名（如 Off / Minimal / Max）是
dsh-llm-pi-ai硬編碼的英文，第三方插件無法修改。中文功能僅限於本插件的設置頁。 - 補檔器生效範圍：推理等級的自動補檔器只對手聲明
models[]的條目生效，不觸碰modelOverrides與官方渠道。
總結¶
dsh-provider-pro 通過插件化的方式，將官方渠道的高級配置能力（UA、推理等級、圖片輸入）下放到了自定義供應方，解決了手動配置繁瑣的問題。適合需要在 DSH 中集成自定義 API，但又希望保持官方渠道同等交互體驗的用戶。
