DeepSeek Harness 模型中心插件：雙欄選擇與能力卡

前言¶

DeepSeek Harness（DSH）以「一切皆插件」爲理念，社區目錄與官方渠道相互獨立。在本地多模型或自建渠道場景下，輸入框上的模型列表往往又長又平、信息密度不足。dsh-model-hub 插件針對這一痛點，提供雙欄佈局與懸浮能力卡，讓模型選擇與能力調整更直觀。

插件定位¶

名稱：dsh-model-hub
維護者：xfjsssq
分類：客戶端
核心價值：把原生長列表替換爲雙欄選擇器（左提供商 / 右模型）+ 懸浮能力卡，並支持在面板中管理提供商與模型；零構建、零 npm 依賴。

核心功能¶

雙欄模型選擇¶

左欄：提供商列表，支持拖拽排序 / 置頂，持久化；僅顯示「有模型或已聲明」的提供商。
右欄：當前提供商的模型列表。
跨提供商搜索：輸入時按模型名或 ID 模糊匹配，當前提供商結果優先；清空後回到所選提供商。

懸浮能力卡¶

尺寸約 200px，跟隨鼠標出現後「釘住」，可繼續操作。
能力檔位：上下文窗口（128K / 256K / 1000K）、輸出檔位（128K / 256K）、輸入類型（文本 / 圖片）、推理等級（關 / 低 / 中 / 高）。
非標準值會高亮並提示，例如設置頁手打一千萬時會提示「確認是否多打了 0」。

提供商與模型管理¶

左欄底部「＋添加模型提供商」：全屏表單（id / 顯示名 / API 協議 / Base URL / Key 環境變量名）。
新增渠道默認爲「待選模型」狀態，草稿保存在插件自己的 prefs.json，不改動 DSH 配置；可刪除。
模型列表右下角「刷新」按鈕：詢問端點模型列表 → 候選界面（可搜索、可勾選、全選 / 取消全選）→ 確定後原子落盤。
單個模型刪除：hover 出現刪除入口，二次確認；只剩最後一個時按鈕置灰；刪掉後刷新可加回。

可靠性與兼容性¶

能力改動寫入模型配置後回讀運行時確認；若未生效會報 NOT_EFFECTIVE 並回滾。
渲染失敗時自動交回內置選擇器並給出提示，不白屏。
支持亮 / 暗主題、prefers-reduced-motion 以及鍵盤操作（↑↓ / Enter / Esc / Tab）。

安裝與啓用¶

官方 CLI / GUI（推薦）¶

# 從 GitHub 安裝
dsh plugin --profile desktop add github:xfjsssq/dsh-model-hub
dsh plugin --profile desktop add github:xfjsssq/dsh-model-hub#v0.1.0

# 本地目錄（開發）
dsh plugin --profile desktop add "<本目錄絕對路徑>"

dsh 不在 PATH 時，可使用安裝目錄裏的 CLI 或通過 GUI 添加插件。

效果生效時機¶

宿主側 API（/model-hub/api/*）：安裝後立即生效，無需重啓宿主。
客戶端 UI（輸入框上的模型位）：刷新頁面一次（桌面端 Ctrl+Shift+R）。
插件自身的宿主代碼更新（升級版本後）：需要重啓 DSH。

關閉插件（不卸載）¶

編輯 cordis.patch.yml，將 enabled 改爲 false。宿主 API 停用、客戶端條目不再註冊，內置選擇器自動恢復。

典型用法¶

點擊輸入框上的模型位：打開模型中心。
左欄點擊或 ← / →：切換提供商。
搜索框輸入：跨全部提供商按模型名 / ID 模糊匹配，結果按提供商分組。
↑ ↓ + Enter：鍵盤選模型（焦點留在搜索框）。
懸停模型行約 120ms：浮出能力卡。
能力卡點擊檔位 / 開關：寫入模型配置 → 回讀運行時確認 → 立即生效；若不匹配會顯示 NOT_EFFECTIVE 並回滾。
能力卡點擊推理等級：提交會話級 reasoningEffort；若非當前模型，一次點擊同時切換模型並應用檔位。
左欄拖拽 / 右鍵或行尾圖釘：調整提供商順序 / 置頂，立即持久化。

已知限制¶

/model 斜槓命令的彈窗仍爲內置 UI；新 UI 僅接管輸入框上的模型位。
DSH 不允許「沒有模型的渠道」：新建渠道爲草稿狀態，勾選模型後才落盤；此前不會出現在 DSH 內置選擇器中。
廠家目錄自帶的渠道，刪掉模型後仍會列出（目錄繼續供模型），只是標記變爲非聲明態，刪除入口消失。
強開上游不支持的視覺或推理檔位，請求時可能報錯；卡片有提示。
不支持 reasoningEfforts: false；要表達「不推理」請傳 null。
提供商排序 / 置頂與草稿保存在 ~/.dsh/model-hub/prefs.json；能力值每次打開重新拉取。
升級插件後宿主側需要重啓 DSH（lib/host/* 不熱重載）。

適用場景與注意事項¶

適合需要同時管理多個提供商、自定義上下文與輸出檔位、或需要直觀能力預覽的開發者。
插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證（MIT）。
新建渠道需通過插件面板勾選模型後落盤；在此之前不會出現在 DSH 內置選擇器中。

結語¶

dsh-model-hub 在不改動宿主 UI 的前提下，通過雙欄選擇器與懸浮能力卡提升了模型選擇的可用性，並通過回讀確認與降級機制保障可靠性。適合需要精細管理模型能力與多渠道配置的場景。

目錄頁：https://www.skillhub.cn/plugins/xfjsssq/dsh-model-hub
GitHub：https://github.com/xfjsssq/dsh-model-hub