前言¶

在 DeepSeek Harness（DSH）的插件生態裏，配置模型能力通常需要落到 provider route 的聲明上。對使用 OpenAI-compatible providers 的 DSH 用戶來說，reasoningEfforts 和 input 這類字段如果不在設置頁中聲明，模型選擇器看不到 effort 控制，圖片會話也可能因爲模型未聲明 image 而被拒絕。

better-model-provider 解決的是這個問題：把按模型的能力聲明做成一個 settings section，減少直接編輯 YAML 的步驟。它由 sanshanya 維護，許可證爲 MIT。DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

better-model-provider 是一個 DSH web 插件，用於在 DSH 設置中聲明和編輯單個模型的能力。自定義模型上編輯 declarations，官方目錄路由上保存 sparse overrides；provider 配置仍留在官方 Models 頁面管理。

已覈實的兼容性聲明爲 dsh 0.1.x line，契約爲：

@deepseek-ai/dsh-api-remotes >=0.1.0-rc.7 <0.2.0

核心功能¶

下面介紹已覈實的主要能力。

編輯 reasoning effort¶

• 對模型的 reasoningEfforts 做聲明。
• 選擇 Custom 後，可勾選需要的層級。
• 需要提供 “off” 時，可勾選 off。

編輯 input modalities¶

• 對請求模態做聲明，例如 text / image。
• 視覺模型需要在 input modalities 勾選 image，否則發送圖片會被拒絕。

編輯 token capacities¶

• 可編輯 contextWindow / maxTokens。
• 支持 K/M 記法，例如 380K、1M。
• Apply 後修改立即生效。

官方目錄路由¶

• 通過 Manage official models 編輯官方模型。
• 每次只保存與官方默認值的差異，其他部分繼續跟隨 catalog 更新。
• 可用 Reset to official defaults 撤銷單個模型的全部編輯。

未配置路由¶

• 通過 Manage official providers (N) 展開 installed-but-unconfigured routes。
• 選擇一項並應用首個修改即可創建路由。
• API key 仍需在官方頁面配置。

邊界¶

• Dedicated-adapter apps（built-in DeepSeek / OpenAI Codex）在其自身設置頁聲明能力，不出現在此插件頁面。
• 契約之外的 surfaces 會靜默降級。

安裝與啓用¶

插件會以當前 dsh 進程權限運行，安裝前請檢查源碼、許可證和注入腳本。確認使用後執行：

dsh plugin --profile web add github:sanshanya/better-model-provider#master

安裝後重啓 web：

Restart dsh web

Settings sidebar 會新增 Model capabilities。

如果安裝默認分支，會從源碼構建，並打印一個需要添加的 pnpm allowBuilds key，然後重新運行 add。本地 link: install 需要先：

npm install && npm run build

卸載：

dsh plugin --profile web rm better-model-provider

典型用法¶

下面按操作順序說明。

1. 先在官方 Models 頁面配置 provider 和 API key。該插件頁面不重複管理 keys 和 route lifecycle。
2. 展開模型行並編輯能力：
   - Reasoning effort 選 Custom，勾選所需層級；需要 off 時勾選 off。
   - 視覺模型在 input modalities 勾選 image。
   - Capacities 可寫 380K、1M，然後 Apply。
3. 官方模型通過 Manage official models 編輯。保存的只是差異，可用 Reset to official defaults 恢復。
4. 對 installed-but-unconfigured routes，通過 Manage official providers (N) 展開，選擇一項並應用首個修改，路由即創建；API key 仍回官方頁面配置。

適用場景與注意¶

適合在 DSH web 中管理 OpenAI-compatible provider 模型能力的用戶，尤其是需要按模型調整 reasoning effort、image input 和 token capacities 的場景。

注意：

• API key、provider 和 route lifecycle 仍在官方 Models 頁面管理。
• 本插件頁面只編輯能力聲明和官方路由差異。
• 契約之外的 surfaces 會靜默降級。
• 插件運行權限等同於當前 dsh 進程，安裝前需要自行審查源碼和許可證。

鏈接¶

GitHub：https://github.com/sanshanya/better-model-provider

目錄頁線索：https://www.skillhub.cn/plugins/sanshanya/better-model-provider