前言¶
DSH(DeepSeek Harness)的模型行通常只有四項配置:模型 ID、名稱、上下文窗口、最大輸出 token。思考強度(reasoningEffort)和輸入模態通常在連接級別統一配置。現實中,不同模型支持的檔位可能不同(有的只支持低/高,有的不支持思考),統一配置會導致選了無效檔位或靜默失效。該插件將思考強度和輸入模態下放到模型行級別,允許單獨設置。
插件簡介¶
名稱:dsh-model-extended
作者:lengxiaoyu6
分類:模型推理
許可:MIT
核心價值:給 dsh 模型目錄裏的每一行模型,單獨設置它的思考強度範圍和輸入模態。
核心功能¶
- 爲模型目錄中的每一行模型單獨設置思考強度範圍。
- 爲每一行模型單獨設置支持的輸入模態。
- 支持 UI 勾選框選擇檔位。
- 支持顯式聲明模型無思考能力。
- 在請求發出前校驗強度和模態。
- 支持自定義提供商的字段映射(如 pi-ai)。
安裝¶
本插件依賴本地已安裝的 dsh。安裝後需重啓 dsh 並刷新頁面。
dsh plugin --profile web add github:lengxiaoyu6/dsh-model-extended
配置與用法¶
DeepSeek 目錄配置¶
在 ~/.dsh/settings.yaml 中配置模型。字段包括 inputModalities 和 reasoningEfforts。
llm-deepseek:
models:
- id: deepseek-v4.1-flash
name: DeepSeek-V41-Flash
contextWindow: 1000000
inputModalities: [text, image]
reasoningEfforts: [low, high]
defaultReasoningEffort: high
reasoningEfforts:字符串數組表示支持的檔位。false表示明確不支持思考。省略則交給適配器。defaultReasoningEffort:省略或不在範圍內時,保留適配器默認。inputModalities:支持的輸入,省略則交給適配器。
自定義提供商配置¶
自定義提供商(如 pi-ai)使用適配器自己的字段名和檔位表。
llm-pi-ai:
providers:
kiro:
models:
- id: claude-opus-4-6
input: [text, image]
reasoningEfforts:
off: # 空值 = 支持"不思考"
low: low
high: high
- 檔位值是請求裏發送的拼寫,不是界面顯示的檔位名。
- 檔位名稱由適配器決定,不隨界面語言變化。
YAML 注意事項¶
dsh 使用 YAML 1.2 解析器,允許不帶引號的字符串 off。如果使用遵循 YAML 1.1 的工具(如 PyYAML)重寫 settings.yaml,off 會被誤解析爲布爾值 false,導致配置失效或報錯。
注意事項¶
- 重啓生效:安裝後必須重啓 dsh 並刷新頁面。
- 作用範圍:疊加層僅對通過設置命名空間配置的 provider 生效。
- 檔位名稱:檔位名稱由適配器決定,與界面語言無關。
- 撤銷補丁:插件通過修改文件實現,卸載前需先運行
revert命令。
結語¶
該插件通過包裝適配器和補丁編輯器,將思考強度和模態配置下沉到模型行,解決了連接級配置與模型實際能力不匹配的問題。更多細節可參考 GitHub。