前言¶

在 DeepSeek Harness（DSH）桌面端裏，輸入框上方的模型位默認是一長條扁平列表，幾十個模型擠在一起，切換提供商時要反覆滾動。模型能力（上下文長度、輸出上限、視覺、推理檔位）往往要到設置頁裏改，改完是否真正寫進運行時配置，也不總在界面上直觀可見。

下面介紹社區插件 dsh-model-hub（維護者 zyqchanel-06）：把模型位換成左提供商、右模型的雙欄佈局，並在懸停時彈出能力卡，改動會寫回與設置頁相同的模型聲明路徑，並通過回讀確認是否生效。倉庫爲成品插件，零構建、零 npm 依賴（React 由宿主提供）。

這是什麼¶

dsh-model-hub 是 DSH 的「模型中心」插件，分類屬於模型推理。它接管輸入框上的 conversation.input.model 槽位（優先級影子覆蓋），不改宿主主 UI；卸載或關閉後內置選擇器會恢復。

宿主側以 cordis 插件形式掛載 /model-hub/api/*，讀寫運行時模型目錄並通過 DSH settings 橋寫入 llm-pi-ai.providers 下的模型聲明；瀏覽器側以 classic script 注入 client.js（約 3100 行，含 CSS）。README 註明適配 DSH 桌面版 0.2.1-rc.2（2026-10-23 實測）。當前 package 版本爲 0.1.0，許可證 MIT。

目錄頁：https://www.skillhub.cn/plugins/zyqchanel-06/dsh-model-hub
源碼：https://github.com/zyqchanel-06/dsh-model-hub

核心功能¶

模型選擇界面¶

左欄爲提供商：支持拖拽排序、置頂並持久化；只顯示「有模型或已聲明」的渠道，其餘隱藏。右欄爲當前提供商下的模型列表。

搜索框可跨全部提供商按模型名或 ID 模糊匹配；當前提供商的命中排在最前，右欄底部可展開其他渠道的相似模型。鍵盤支持 ↑ ↓ 與 Enter 選模型，焦點可留在搜索框；支持亮/暗主題、prefers-reduced-motion 與 Tab 等操作。

懸停模型行約 120ms 後會出現寬約 200px 的懸浮能力卡，跟隨鼠標出現後釘住，可移上去繼續操作。卡片上與設置頁對齊的項包括：

• 上下文檔位：128K / 256K / 1000K
• 輸出檔位：128K / 256K
• 輸入類型：文本 / 圖片
• 推理等級：關 / 低 / 中 / 高（四檔）

若在設置頁手寫了非標準數值，卡片會標註並高亮，提示例如是否多打了 0。

提供商與模型管理¶

左欄底部「＋ 添加模型提供商」打開全屏表單，字段包括 id、顯示名、API 協議、Base URL、Key 環境變量名。保存後默認不拉取模型；新渠道以「待選模型」草稿形式出現在左欄，草稿保存在 ~/.dsh/model-hub/prefs.json，不直接改 DSH 主配置，可刪除。

模型列表右下角刷新按鈕會向端點詢問可用模型，進入可搜索、可勾選、支持全選/取消全選的候選界面；確定後才把「渠道 + 勾選模型」一次性落盤。單個模型可 hover 刪除（二次確認）；僅剩最後一個可刪模型時刪除按鈕置灰，刪掉後可通過刷新再加回。

可靠性設計¶

能力改動寫入模型配置後會回讀運行時確認；寫不進或未生效會報 NOT_EFFECTIVE 並回滾。客戶端渲染失敗時會自動讓出槽位、交回內置選擇器並給出可見提示。推理等級在能力卡上提交的是會話級 reasoningEffort；若當前會話模型不是卡片上的模型，一次點擊可同時切換模型並應用檔位（界面有提示）。

安裝與啓用¶

插件以當前 DSH 進程權限運行，安裝前建議自行審閱源碼與 MIT 許可證。官方推薦用 CLI 或 GUI 從 GitHub 安裝：

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

dsh 不在 PATH 時，可使用安裝目錄下的 CLI，或在 GUI 側邊欄「插件」→ 添加插件，粘貼 Git 地址或包名。本地開發可用絕對路徑：

dsh plugin --profile desktop add "<本目錄絕對路徑>"

倉庫還提供可審計的 PowerShell 腳本（tools/install.ps1、tools/uninstall.ps1），對 package.json 與 cordis.patch.yml 的改動範圍有校驗，詳見倉庫 tools/README.md。

裝完後的生效方式（README 強調）：

僅關閉而不卸載：在 cordis.patch.yml 將 enabled 設爲 false，宿主 API 停用，內置模型選擇器恢復。

典型用法¶

安裝並刷新頁面後，點擊輸入框上的模型位打開模型中心。左欄點擊或用 ← → 切換提供商；在搜索框輸入關鍵字跨渠道查找。懸停模型行打開能力卡，點選檔位或開關後，配置寫入並與運行時覈對，成功則立即生效。

左欄拖拽或右鍵/行尾圖釘可調整提供商順序。新增渠道後先保存草稿，再用刷新拉模型並勾選落盤。診斷可用同源 API，例如 GET /model-hub/api/health、GET /model-hub/api/catalog；寫能力用 POST /model-hub/api/model（要求 Content-Type: application/json）。

適用場景與注意¶

適合經常在 DSH 裏切換多家提供商、並希望在與設置頁同一處聲明裏快速改上下文/輸出/視覺/推理檔位的用戶。偏好與草稿在 ~/.dsh/model-hub/prefs.json；模型能力真正落在 profile 的 cordis.patch.yml → llm-pi-ai.providers.<提供商>.models[]。

已知限制（來自 README）：

• /model 斜槓命令彈窗仍是內置 UI；新 UI 只接管輸入框模型位。
• DSH 不允許「沒有模型的渠道」；新建渠道在勾選模型前僅出現在本插件面板。
• 對上游不支持的模型強開視覺或推理檔位，請求時可能由上游報錯，需自行承擔。
• 升級插件後宿主側需重啓 DSH（lib/host/* 無熱重載）。

SkillHub 目錄與 GitHub 均爲社區生態入口，與 DeepSeek / 幻方無官方從屬關係；星標與驗證狀態以倉庫 README「驗證狀態」一節爲準。

結尾¶

dsh-model-hub 把模型列表從「長條擠在一起」改成雙欄 + 懸浮能力卡，並強調改動回讀與失敗降級，適合作爲 DSH 桌面端日常選模與調能力的補充界面。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。