在 DeepSeek Harness (DSH) 中配置模型能力通常需要手動編輯 settings.yaml 文件,流程繁瑣且容易出錯。DSH 插件 dsh-awesome-model-setting 在設置面板新增了“模型能力”頁面,允許用戶通過圖形界面直接聲明模型的輸入模態、上下文窗口、最大輸出 token 及圖像配額,無需觸碰配置文件。
核心功能¶
- 在設置面板增加“模型能力”頁面。
- 圖形化編輯模型能力(輸入模態、上下文窗口、最大輸出 token、圖像預算)。
- 顯示合併後的生效值(你的設置文檔與適配器目錄合併)。
- 支持從供應商加載模型列表。
- 支持重置爲默認參數。
- 支持恢復路由默認值。
安裝與啓用¶
1、使用官方安裝命令添加插件:
dsh plugin --profile web add github:Kazusa1085/dsh-awesome-model-setting
2、重啓 DSH Web 服務。
3、打開設置,進入“模型能力”頁面。
典型用法¶
- 獲取模型列表:在頁面中,每條已註冊的路由分組下都有“從供應商加載”按鈕。點擊後,插件會詢問適配器該路由能提供哪些模型。對於適配器自帶目錄的路由,列表來自本地;對於手工聲明的路由(如本地服務器),插件會向
baseURL/models端點發起請求(等待上限 15 秒)獲取模型清單。清單中會標記模型狀態爲“已聲明”、“加入”或“目錄提供”。 - 編輯能力參數:直接在圖形界面修改輸入模態、上下文窗口、最大輸出 token 或圖像預算。保存後,生效值爲你的配置與適配器目錄的合併結果。
- 使用默認值:數字輸入框(上下文窗口、最大輸出、圖像預算)若留空,表示從文檔中移除該字段,改用默認值。此時輸入框會顯示佔位文案“使用路由默認值”,但生效值仍會顯示在標籤中(如
繼承 <value>)。 - 恢復路由默認值:此按鈕僅在你聲明的輸入模態確實與適配器默認不同時出現。點擊後會將該模型的能力字段(模態、上下文、輸出、圖像預算)恢復爲路由默認聲明。該操作是暫存的,需點擊保存後寫入。
- 重置爲默認參數:此按鈕僅出現在適配器自帶目錄的路由上,點擊會將該路由下所有模型的參數重置爲默認值。它不會修改模型列表或顯示名稱。
適用場景與注意事項¶
- 該插件適用於需要精細化管理多模態模型配置的場景,特別是適配器自帶目錄(如
llm-pi-ai)與手工聲明路由並存的情況。 - 顯示的數值爲“生效值”,即你的配置與適配器目錄合併後的結果。
- “恢復路由默認值”按鈕僅在你聲明的輸入模態確實與適配器默認不同時出現。
- “重置爲默認參數”僅出現在適配器自帶目錄的路由上,對手工添加的供應商(本地服務)不顯示,因爲沒有自帶默認值可回退。
- 修改能力來自目錄聲明(顯示“路由聲明”標籤)的模型時,會先彈出確認框詢問是否覆蓋。
- 插件以當前 DSH 進程權限運行,請確保對源碼和許可證(MIT)有了解。
該插件通過圖形化界面簡化了模型能力的配置流程,將配置項的變更邏輯從文件編輯轉化爲直觀的操作。