前言¶
DeepSeek Harness 採用插件化架構，支持擴展功能。在進行模型推理開發時，開發者通常需要在多個提供商、多種模型規格之間快速切換。原生模型選擇器的功能相對基礎。dsh-model-palette 插件旨在提供一種全局、統一的模型選擇與配置方案。
插件定位¶
dsh-model-palette 是一個用於 DeepSeek Harness 的全局提供者感知模型命令面板插件，同時也提供可選的 OpenRouter 媒體工具。
該插件由 Jensen-Yao 維護，採用 MIT 許可證。它不依賴特定的瀏覽器環境，旨在提升模型選型與配置的效率。
核心功能¶
全局命令面板¶
插件的核心交互方式是全局快捷鍵。在 Web UI 的任意位置按下 Alt+M，即可喚起一個獨立的文檔級對話框。該面板支持模糊搜索，可覆蓋模型名稱、ID、提供者名稱及 ID。用戶可以使用方向鍵導航，按回車鍵選擇。
提供者過濾器與目錄¶
界面左側提供提供者過濾器側邊欄。側邊欄實時顯示每個提供者下的模型數量，並包含視覺錯誤指示器。點擊任意提供者可篩選模型，點擊“All providers”可重置。在配置面板中，提供者以卡片網格形式展示，包含品牌圖標、模型計數和協議徽章。
推理努力選擇器¶
插件底部提供統一的推理努力選擇器，支持 off 到 max 多個級別。如果當前模型未聲明這些級別，選擇後會在請求中動態添加 reasoningEfforts 聲明。該功能支持針對每個模型或提供者進行自定義配置。
模型配置與模板¶
用戶可以直接在 UI 中添加、編輯或刪除提供者配置。插件內置模板庫，支持 OpenAI 兼容、Responses、Anthropic 等協議，以及 OAuth 和 API Key 模板。配置項包括提供者 ID、顯示名稱、基礎 URL、協議類型及憑證引用。
模型預設與在線刷新¶
插件捆綁了 469 個由廠商權威提供的模型預設，涵蓋 OpenAI、Anthropic、Google、DeepSeek 等多家廠商。這些數據支持在線刷新，確保時效性。在應用預設時，面板會顯示上下文窗口、輸出限制和推理級別等信息。
OpenRouter 媒體工具（可選）¶
插件支持可選的 OpenRouter 媒體工具，包括圖像和視頻生成。用戶可以在側邊欄配置視圖中啓用此功能。通過該工具，用戶可以直接提交提示詞生成圖像或視頻，無需將提示詞發送至對話流中。
安全性¶
插件具備安全防護機制。API 密鑰默認遮罩存儲在 DSH 憑證服務中。憑證的顯示僅允許在本地迴環連接（127.0.0.1 或 localhost）下進行。插件對所有 API 請求實施 CSRF 保護，OpenRouter 憑證不會返回至瀏覽器端。
安裝與啓用¶
安裝該插件需要執行以下命令：
dsh plugin --profile web add github:Jensen-Yao/dsh-model-palette#v0.12.0
安裝完成後，需重啓 dsh web 服務。
典型用法¶
- 喚起面板：重啓後，在界面任意位置按下
Alt+M打開命令面板。 - 配置提供者：在側邊欄點擊配置視圖，選擇模板創建新提供者。配置完成後，點擊“Test connection”按鈕驗證運行時密鑰，系統會自動發現並添加模型。
- 使用媒體工具：若需使用 OpenRouter 圖像或視頻生成功能，需在側邊欄配置視圖中啓用“OpenRouter Media Tools”。
注意事項¶
- 密鑰安全：API 密鑰存儲在 DSH 服務中，且默認遮罩。無法通過跨站訪問查看已存儲的密鑰。
- 付費限制：OpenRouter 媒體工具默認阻止付費生成。對於非免費模型，使用前需確認一次性費用。
- 循環回顯限制：僅允許在本地迴環地址下查看憑證，遠程訪問會被阻止。
總結¶
dsh-model-palette 爲 DeepSeek Harness 提供了一個全局、可視化的模型管理與配置入口。它通過統一快捷鍵和豐富的配置選項，簡化了多提供商模型的切換流程。相關文檔與源碼位於：GitHub。
