前言¶
在 DeepSeek Harness（DSH）裏配置多家模型供應商後，輸入區若用平鋪列表展示全部模型，條目會很長，切換時也容易看錯行。宿主仍提供模型目錄、會話選擇與 /model 命令，但默認選擇界面未必按「先供應商、後模型」組織。社區插件 dsh-model-picker-2level（維護者 weiYe-exployer，GitHub 倉庫 weiYe-exployer/dsh-model-picker-2level）替換輸入區的模型選擇 UI：先選供應商，再選模型，並保留全局搜索與思考強度選擇。下面介紹它的定位、能力與安裝用法。
這是什麼¶
dsh-model-picker-2level 是面向 DSH 的輕量客戶端插件，npm 包名爲 @codewei823/dsh-model-picker-2level（當前資料中版本 0.1.6）。它不新增供應商或 API Key 管理，只使用 Harness 已有的模型目錄和會話選擇能力，替換 Web 輸入區的模型選擇界面；內置 /model 命令保持可用。SkillHub 目錄分類爲「模型推理」，簡介爲：A two-level model picker for DeepSeek Harness.
核心功能¶
資料中明確列出的能力如下。
| 能力 | 說明 |
|---|---|
| 兩級導航 | 供應商頁顯示模型數量與當前使用標記；模型頁只列出該供應商下的模型 |
| 分層搜索 | 首頁搜索跨全部供應商；進入某供應商後僅搜索本家；支持大小寫無關與模糊匹配 |
| 思考強度 | 對支持推理的模型選擇強度；成功選擇的偏好在當前應用進程內按供應商與模型記憶 |
| 當前項提示 | 高亮當前供應商與模型，切換後同步更新輸入區顯示 |
| 鍵盤操作 | ↑↓ 移動，Enter 打開或確認，Esc 清空搜索、返回或關閉 |
| 界面適配 | 跟隨宿主主題，窗口變化時重新定位，點擊外部關閉 |
| 錯誤反饋 | 選擇失敗時保留菜單；目錄不可用時提供診斷與重試入口 |
子代理會話中模型按鈕會被禁用，不能從該入口切換模型。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議閱讀倉庫源碼與 MIT License。DSH 社區插件目錄在 SkillHub，與 DeepSeek / 幻方無官方從屬關係。
通過 npm 安裝（desktop 爲 profile 示例，請換成你實際使用的 profile）：
dsh plugin --profile desktop add @codewei823/dsh-model-picker-2level
在插件源碼目錄內本地安裝：
dsh plugin --profile desktop add .
或安裝本地歸檔（路徑替換爲實際文件）：
dsh plugin --profile desktop add ./plugin.tgz
安裝後需重啓整個 Harness；客戶端模塊沒有熱重載。插件無需構建，本地安裝不需要先安裝開發依賴。
卸載：
dsh plugin --profile desktop remove @codewei823/dsh-model-picker-2level
卸載後同樣重啓 Harness，恢復宿主原有模型選擇器。
典型用法¶
經過上面的安裝與重啓，可按 README 中的步驟操作：
- 點擊輸入區的模型按鈕，查看供應商列表。
- 選擇供應商，進入該供應商的模型列表；單純瀏覽不會改變當前模型。
- 點擊目標模型，成功後菜單關閉，輸入區顯示新選擇。
- 需要調整推理強度時，在供應商首頁打開「思考強度」，選擇可用檔位。
首頁搜索跨全部供應商；進入供應商後搜索範圍限定在本家。清空搜索會恢復當前頁列表。供應商按宿主規則排列，賬號和官方供應商優先，其餘保持目錄順序。
鍵盤（節選）：
| 按鍵 | 行爲 |
|---|---|
| ↑ / ↓ | 移動列表高亮，不提交選擇 |
| Enter | 在模型按鈕上打開菜單；進入高亮供應商或確認模型 / 強度 |
| Esc | 搜索有文字先清空；爲空時返回供應商首頁，首頁則關閉 |
| Tab / Shift+Tab | 保留瀏覽器原有焦點行爲 |
輸入法組字確認不會觸發選擇。更細說明見倉庫 用戶指南。
適用場景與注意¶
適合誰：已在 DSH 中配置多供應商、經常在 Web 界面（含桌面客戶端內嵌 Web UI）切換模型，且希望用兩級列表縮小範圍的開發者。
運行環境（資料聲明）：DSH 運行時當前聲明支持 0.2.1-rc.3，可通過 dsh --version 查看；界面面向 Harness Web。供應商與模型以 Harness 配置並暴露到模型目錄的內容爲準。其他運行時版本與平臺的兼容性尚未聲明。
常見問題摘要：
- 安裝後界面無變化：確認插件裝到當前 profile，並重啓整個 Harness。
- 無需重新配置供應商或 API Key。
- 思考強度偏好僅在當前進程內有效；應用重啓後會話實際選擇以宿主恢復狀態爲準。
- 切換失敗時菜單保留錯誤信息；「重試」行爲分選擇失敗條（重載目錄）與目錄不可用診斷（重新解析目錄服務）兩種。
已知限制：無插件配置面板與打開 / 切層動畫；讀屏對高亮項宣佈尚不完整；尚無獨立「刷新全部目錄」按鈕；宿主升級可能影響兼容性。
結尾¶
dsh-model-picker-2level 在不改動 Harness 模型目錄與憑證的前提下，把模型切換收成「供應商 → 模型」兩步，並保留搜索與思考強度，適合多供應商日常開發。目錄頁：SkillHub · dsh-model-picker-2level；源碼與文檔：GitHub · weiYe-exployer/dsh-model-picker-2level。
