前言¶
在 DeepSeek Harness（DSH）裏寫 Composer 會話時，換模型往往要在一層層分組下拉里找供應商和具體模型。供應商一多，同一套 profile 裏配置的 key 和模型目錄都在，但交互路徑變長。下面介紹社區插件 dsh-model-quick-switch（npm 包名 @aichixiaojuzi/dsh-model-quick-switch）：它只替換輸入框工具行上的「模型」入口，用左供應商、右模型的雙欄面板做切換，排序、別名、收藏和最近使用都留在本機瀏覽器裏，選模型仍走 Host 官方的目錄與 session.selectModel，和 /model 彈窗保持一致。
這是什麼¶
維護者爲 aichixiaojuzi。插件定位是 Provider-first model switcher for the DSH composer——輸入框裏的雙欄模型切換器，所有供應商在左側一級可見。分類上屬於社區目錄裏的「模型推理」類插件；源碼與說明見 GitHub 倉庫，目錄頁見 SkillHub 插件頁。當前 npm 版本爲 0.2.0，許可證 MIT，要求 dsh >= 0.2.1-rc.4。
它解決什麼問題¶
官方模型菜單按分組嵌套時，多個供應商要逐層展開。該插件把所有真實供應商放進左欄一級列表（另有「收藏」「最近」入口），鼠標掃過左側行即切換右側模型列表，點選即切換。支持拖拽或鍵盤調整供應商與模型順序、本機別名、星標收藏、最近 12 次成功切換記錄，以及按名稱/別名/供應商名的模糊搜索。子代理等會話不可用時插件會主動留空，把席位交還官方控件。
核心功能¶
雙欄與選中態¶
左列：收藏、最近、全部供應商（一級可見）。右列：當前供應商下的模型。已選模型與左側當前供應商使用同一種高亮（實心底色 + 左側品牌色豎條）；鼠標懸停僅臨時底色，移開後只保留當前選中行。
排序與收藏¶
供應商順序、各供應商內模型順序、收藏順序均可拖拽；鍵盤用戶可用 Alt + ↑/↓ 移動當前行。模型行右側星標可收藏；每次成功切換會記錄最近 12 個模型。頂部搜索框跨供應商匹配模型名、供應商名及別名。
右鍵菜單¶
左側真實供應商行右鍵：重命名（本機顯示別名）、打開面板時默認選它、置頂/上移/下移、重置該組模型順序、全部加入收藏或清空該組收藏、刷新供應商與模型、從面板刪除（僅影響本地面板，profile 配置不動，底部可恢復）。
右側模型行右鍵：重命名、恢復原名、收藏/取消收藏（與星標同效）。
推理強度與其它¶
選中模型後，行下方可展開該模型適配器聲明的推理強度檔位並切換。目錄自帶的模型 badge（如「新」）會顯示在名稱旁。面板支持完整鍵盤導航（↑/↓、Home/End、PageUp/PageDown、Enter、Esc）。某供應商目錄加載失敗時不佔左欄列表，錯誤仍保留在目錄中，可通過刷新重試。列表頭 ↻ 與打開面板時會重新解析當前會話已配置的供應商與模型，新加 key 或供應商無需重啓應用。
數據邊界¶
選擇邏輯使用官方 ctx.modelDirectories 與同一 session.selectModel；Host 拒絕會在面板底部紅字提示。順序、別名、默認供應商、收藏、最近、已刪除供應商列表保存在瀏覽器 localStorage（鍵名 dsh.model-quick-switch.v1），不寫 profile、不新增 Host 路由。插件不聯網、不上報、不讀密鑰，只讀 Host 已下發的模型目錄。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認符合你的環境策略。
桌面端（profile 名爲 desktop）：
dsh plugin --profile desktop add @aichixiaojuzi/dsh-model-quick-switch
Web 端（profile 名爲 web）：
dsh plugin --profile web add @aichixiaojuzi/dsh-model-quick-switch
也可在 GUI 插件市場搜索 dsh-model-quick-switch 安裝。裝好後刷新頁面，輸入框工具行原模型入口即變爲雙欄面板入口。
本地開發聯調時，README 提供從源碼 link 安裝的方式（需自行 clone 到本地路徑後使用 link: 前綴），本文不展開 clone 步驟。
典型用法¶
- 打開 Composer 新會話，在輸入框工具行點擊原「模型」位置，展開雙欄面板。
- 在左欄點選或懸停供應商，在右欄點選目標模型；若模型支持多檔推理強度，在展開區點選檔位。
- 常用模型點右側星標進入「收藏」；需要時用頂部搜索跨供應商定位。
- 在 profile 裏新增供應商或模型後，左欄供應商右鍵選「刷新供應商與模型」，或打開面板時的自動解析即可，無需重啓 DSH。
- 左欄某供應商暫不想出現在面板裏時，右鍵「從面板刪除」；需要時在左欄底部「已刪除 N 個 · 恢復」找回。
卸載時在插件頁禁用 bundle，官方模型選擇器會恢復。若要一併清除收藏與排序，刪除瀏覽器 localStorage 中的 dsh.model-quick-switch.v1 即可。
適用場景與注意¶
適合在 DSH Web 客戶端長期維護多供應商、多模型，且希望在一級列表裏快速切換的開發者。窄屏下觸發按鈕仍顯示模型名（超出省略），不做圖標化收縮。「重命名」僅改本機顯示名，不改底層 id，也不改寫 Host 目錄名稱。收藏裏若某模型暫時從目錄消失，鍵仍保留，重新出現後會回到收藏。
DSH 生態理念是「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文所述安裝與能力均以倉庫 README 與 package.json 爲準。
結尾¶
dsh-model-quick-switch 用供應商優先的雙欄 UI 縮短 Composer 裏換模型的路徑，同時不替代 Host 的模型目錄與選模 API。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub：aichixiaojuzi/dsh-model-quick-switch。
