前言¶
DeepSeek Harness (DSH) 是一個 OpenAI 兼容的適配器，其配置主要通過 settings.yaml 文件管理。DSH 的模型頁面僅編輯了端點、憑證和模型列表等常見字段，許多決定請求成敗的關鍵配置——如重試策略、超時設置、請求頭、User-Agent 以及推理（Reasoning）的具體參數——隱藏在 YAML 文件中，無法通過界面直接操作。
DSH 的核心理念是“一切皆插件”。dsh-advanced-provider-settings 插件旨在解決這一痛點，它通過 WebUI 將這些隱藏的配置項暴露出來，允許在不直接編輯 YAML 文件的情況下，對 Provider 進行精細化管理。
插件簡介¶
這是一個由 misswell 維護的 WebUI 插件。它通過 DeepSeek Harness 的擴展插槽注入 UI，直接操作 llm-pi-ai 命名空間的設置，實現了對 Provider 級別配置的圖形化管理。該插件使用 DeepSeek Harness 內置的 revision-fenced settings transport 進行安全寫入，確保配置文件的註釋和未修改字段保持原樣。
核心功能¶
該插件支持從模型級到 Provider 級別的多維度配置：
-
思考等級映射
支持off,minimal,low,medium,high,xhigh,max等全等級配置。可以設置路由默認等級，也可以爲每個模型單獨配置等級映射，以及每級的 Token 預算。 -
第三方 DeepSeek 端點配置
針對非deepseek.com域名的第三方端點（如自建 vLLM、雲網關），允許手動聲明方言（dialect）、推理努力程度（reasoning effort）以及修正max_tokens字段的拼寫，從而確保請求格式符合端點要求。 -
模型級通道編輯
針對路由級別的models列表和目錄（catalog）路由採用不同的編輯通道。目錄路由可通過modelOverrides編輯顯示名稱、上下文窗口和最大輸出 Token。 -
Provider 級別配置
提供全局和單 Provider 的請求頭設置、User-Agent 預設（Chrome, Safari, Firefox 等）、重試策略（預設或自定義）、超時設置、傳輸方式、Vision 圖像預算以及 26 個兼容性標誌。 -
安全寫入機制
通過 revision-fenced settings transport，插件在不修改 Harness 源代碼、不進行 DOM 抓取、不修改node_modules的情況下，安全地將配置寫入 YAML 文件。
安裝與啓用¶
安裝該插件需要 Node.js 版本 >= 20。
dsh plugin add github:misswell/dsh-advanced-provider-settings
安裝完成後，插件會自動注入到 DSH 的 Web UI 中，並在模型列表和提供商卡片中顯示相應的編輯入口。
典型用法¶
該插件主要應用於以下場景：
-
對接第三方 DeepSeek 端點
當將 DSH 指向一個非官方域名（如公司代理或自建網關）時，插件允許你顯式聲明thinkingFormat爲deepseek，設置推理等級，並修正字段拼寫（如使用max_tokens而非 OpenAI 的max_completion_tokens），從而在請求發送前預覽並確保格式正確。 -
目錄路由模型覆蓋
如果路由引用了已安裝的目錄，插件允許你通過modelOverrides針對特定模型調整顯示名稱、上下文窗口大小和最大輸出 Token。 -
滿足網關白名單
某些網關客戶端有白名單限制。利用插件提供的 User-Agent 預設（如 Chrome、Safari、Firefox），可以滿足網關對客戶端標識的要求。
適用場景與注意¶
- 版本兼容性：該插件當前版本爲 v0.4.7，已針對 DeepSeek Harness 0.2.0-rc.2 和 0.2.1-alpha.4 進行了驗證。
- 權限與安全：插件運行在 DSH 進程的上下文中，安裝前應檢查其源代碼和許可證（MIT）。
- 功能範圍：該插件專注於 Provider 級別的通用配置，不涉及憑證管理等敏感信息的直接編輯。
結語¶
dsh-advanced-provider-settings 彌補了 DeepSeek Harness 在配置管理上的空白，將 YAML 中的深層配置轉化爲可視化的操作面板，降低了對接第三方 DeepSeek 端點的門檻，提升了調試和維護的效率。
